Глобальный контекст.ПодключитьВнешнююКомпоненту (Global context.AttachAddIn)
Глобальный контекст (Global context)
ПодключитьВнешнююКомпоненту (AttachAddIn)
Доступен, начиная с версии 8.0.
Вариант синтаксиса: По идентификатору
Синтаксис:
ПодключитьВнешнююКомпоненту(<ИдентификаторОбъекта>)Параметры:
<ИдентификаторОбъекта> (обязательный)
Идентификатор объекта внешнего компонента в виде ProgID (Programmatic Identifier) реестра MS Windows (например: "AddIn.Scanner").
Должно соответствовать информации, находящейся в регистрационной базе данных системы (Registry).
Описание варианта метода:
Компонент должен быть выполнен по технологии COM и зарегистрирован в реестре MS Windows.Эти компоненты совместимы с компонентами 1С:Предприятия 7.7.
Внимание! Вариант метода не работает на сервере и во внешнем соединении.
Вариант синтаксиса: По имени и местоположению
Синтаксис:
ПодключитьВнешнююКомпоненту(<Местоположение>, <Имя>, <Тип>, <ТипПодключения>)Параметры:
<Местоположение> (обязательный)
Местоположение внешнего компонента.
В качестве местоположения может использоваться:
- путь к файлу внешнего компонента в файловой системе (недоступно на веб-клиенте), не ZIP-архив;
- полное имя макета, хранящего двоичные данные или ZIP-архив;
- URL к внешнему компоненту, в виде двоичных данных или ZIP-архива, в формате, аналогичном ПолучитьНавигационнуюСсылку.
<Имя> (обязательный)
Символическое имя подключаемой внешнего компонента.
Имя должно удовлетворять правилам именования встроенного языка.
<Тип> (необязательный)
Тип подключаемого внешнего компонента.
Не используется, если компонент упакован в ZIP-архив.
<ТипПодключения> (необязательный)
Тип подключения внешней компоненты.
В режиме совместимости конфигурации Версия8_3_20 и ниже, используется значение НеИзолированно.
В остальных случаях, на сервере используется Изолированно, а на клиенте - НеИзолированно.
Описание варианта метода:
Подключает компоненты, выполненные по технологии Native API и COM.Компонент может храниться в информационной базе или макете конфигурации в виде двоичных данных или в ZIP-архиве.
Для режимов запуска "Тонкий клиент" и "Веб-клиент", компонент должен быть предварительно установлен методом УстановитьВнешнююКомпоненту.
Возвращаемое значение:
Тип: Булево.Истина - подключение прошло успешно.
Описание:
Подключает внешний компонент к 1С:Предприятию.
Внешние компоненты могут храниться в информационной базе или макетах конфигурации в виде ZIP-архива или в виде двоичных данных, а также в файле файловой системы.
При работе на тонком клиенте и веб-клиенте компонент должен быть предварительно установлен.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Внешние компоненты могут быть выполнены по технологии Native API или COM. Компоненты, выполненные по технологии COM, совместимы с компонентами 1С:Предприятия 7.7.Веб-клиент может работать только с компонентами в информационной базе, упакованными в архив.
Тонкий клиент может работать с компонентами в информационной базе, упакованными в архив, и компонентами, расположенными в файловой системе.
Толстый клиент может работать со всеми вариантами хранения компонентов. При этом, если компонент установлен методом УстановитьВнешнююКомпоненту, то используется установленный компонент, а если не установлен, то компонент будет получен в момент подключения.
Сервер может работать со всеми компонентами. Компонент кэшируется на сеанс работы сервера.
Пример:
| Если ПодключитьВнешнююКомпоненту("AddinObject.Scanner") Тогда Сообщить("Компонента для сканера штрихкодов загружена"); Иначе Сообщить("Компонента для сканера штрихкодов не загружена"); КонецЕсли; |
См. также:
Глобальный контекст, метод ПодключитьВнешнююКомпонентуАсинхГлобальный контекст, метод ЗагрузитьВнешнююКомпоненту
Глобальный контекст, метод УстановитьВнешнююКомпоненту
Глобальный контекст, событие ОбработкаВнешнегоСобытия
Глобальный контекст, метод НачатьПодключениеВнешнейКомпоненты
Использование в версии:
Доступен, начиная с версии 8.0.