Предусмотрено две одноименных функции: ВнешниеКомпонентыСервер.ПодключитьКомпоненту для вызова с сервера ВнешниеКомпонентыКлиент.ПодключитьКомпоненту для вызова с клиента

1. Для вызова с сервера

Подключает на сервере 1С:Предприятия внешнюю компоненту из хранилища внешних компонент, выполненную по технологии Native API или COM. В модели сервиса разрешено только подключение общих внешних компонент, одобренных администратором сервиса.

Синтаксис

Функция ПодключитьКомпоненту(Знач Идентификатор, Версия = Неопределено, ПараметрыПодключения = Неопределено) Экспорт

Параметры

• Идентификатор — Строка - идентификатор объекта внешней компоненты.
• Версия — Строка - версия компоненты.
• ПараметрыПодключения — см. ПараметрыПодключения.

Возвращаемое значение

Структура - результат подключения компоненты:

• Подключено - Булево - признак подключения;
• ПодключаемыйМодуль - ОбъектВнешнейКомпоненты - экземпляр объекта внешней компоненты;
  • ФиксированноеСоответствие из КлючИЗначение - экземпляры объектов внешней компоненты, указанные в ПараметрыПодключения.ИдентификаторыСозданияОбъектов: ** Ключ - Строка - идентификатор, ** Значение - ОбъектВнешнейКомпоненты - экземпляр объекта внешней компоненты.
• ОписаниеОшибки - Строка - краткое описание ошибки.

Пример вызова

Результат = ВнешниеКомпонентыСервер.ПодключитьКомпоненту(Идентификатор, Версия, ПараметрыПодключения)

Доступность

Сервер, Толстый клиент, Внешнее соединение

2. Для вызова с клиента

Подключает компоненту, выполненную по технологии Native API или COM на клиентском компьютере. Для веб-клиента предлагается диалог, подсказывающий пользователю действия по установке. Выполняет проверку возможности исполнения компоненты на текущем клиенте пользователя.

Синтаксис

Процедура ПодключитьКомпоненту(Оповещение, Идентификатор, Версия = Неопределено,
ПараметрыПодключения = Неопределено) Экспорт

Параметры

• Оповещение — ОписаниеОповещения - описание оповещения о подключении со следующими параметрами:
  • Результат - Структура - результат подключения компоненты: ** Подключено - Булево - признак подключения; ** ПодключаемыйМодуль - ОбъектВнешнейКомпоненты - экземпляр объекта внешней компоненты;
  • ФиксированноеСоответствие из КлючИЗначение - экземпляры объектов внешней компоненты, указанные в ПараметрыПодключения.ИдентификаторыСозданияОбъектов: *** Ключ - Строка - идентификатор внешней компоненты; *** Значение - ОбъектВнешнейКомпоненты - экземпляр объекта внешней компоненты. ** ОписаниеОшибки - Строка - краткое описание ошибки. При отмене пользователем пустая строка.
  • ДополнительныеПараметры - Структура - значение, которое было указано при создании объекта ОписаниеОповещения.
• Идентификатор — Строка - идентификатор объекта внешней компоненты.
• Версия — Строка - версия компоненты.
• ПараметрыПодключения — см. ВнешниеКомпонентыКлиент.ПараметрыПодключения.

Пример вызова

Оповещение = Новый ОписаниеОповещения("ПодключитьКомпонентуЗавершение", ЭтотОбъект);
ПараметрыПодключения = ВнешниеКомпонентыКлиент.ПараметрыПодключения();
ПараметрыПодключения.ТекстПояснения = 
    НСтр("ru = 'Для использования сканера штрихкодов требуется
               |внешняя компонента ""1С:Сканеры штрихкода (NativeApi)"".'");
ВнешниеКомпонентыКлиент.ПодключитьКомпоненту(Оповещение, "InputDevice",, ПараметрыПодключения);
&НаКлиенте
Процедура ПодключитьКомпонентуЗавершение(Результат, ДополнительныеПараметры) Экспорт
    ПодключаемыйМодуль = Неопределено;
    Если Результат.Подключено Тогда 
        ПодключаемыйМодуль = Результат.ПодключаемыйМодуль;
    Иначе
        Если Не ПустаяСтрока(Результат.ОписаниеОшибки) Тогда
            ПоказатьПредупреждение(, Результат.ОписаниеОшибки);
        КонецЕсли;
    КонецЕсли;
    Если ПодключаемыйМодуль <> Неопределено Тогда 
        // ПодключаемыйМодуль содержит созданный экземпляр подключенной компоненты.
    КонецЕсли;
    ПодключаемыйМодуль = Неопределено;
КонецПроцедуры

Доступность

Тонкий клиент, Толстый клиент