Подключает внешний компонент к 1С:Предприятию. Внешние компоненты могут храниться в информационной базе или макетах конфигурации в виде ZIP-архива или в виде двоичных данных, а также в файле файловой системы. При работе на тонком клиенте и веб-клиенте компонент должен быть предварительно установлен.
Синтаксис
ПодключитьВнешнююКомпоненту(<ИдентификаторОбъекта>)ПодключитьВнешнююКомпоненту(<Местоположение>, <Имя>, <Тип>, <ТипПодключения>)Примеры платформы
Если ПодключитьВнешнююКомпоненту("AddinObject.Scanner") Тогда
Сообщить("Компонента для сканера штрихкодов загружена");
Иначе
Сообщить("Компонента для сканера штрихкодов не загружена");
КонецЕсли;Полное описание, параметры и ограничения
Глобальный контекст.ПодключитьВнешнююКомпоненту (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.
Методическая информация
Практические примеры
Native API компонента: установка, подключение и проверка
ZIP-макет доставляется клиенту, затем подключается под своим символическим именем. Проверка подключения — отдельный булев вызов.
Где и как запускать
Синтаксический пример в клиентском модуле своей управляемой формы. Полные процедуры вставляются в модуль; короткий фрагмент без процедуры — в тело клиентского обработчика. Здесь ничего не устанавливалось и не выполнялось.
Подготовка
Добавьте общий макет УчебнаяКомпонента с двоичными данными ZIP-пакета вашей доверенной Native API компоненты для нужной ОС и разрядности.
В примере символическое имя подключения УчебнаяКомпонента, а поставляемый класс — Scanner. Это условие собственного учебного пакета, не встроенная поставка 1С. Для другого класса используйте его действительное имя из документации поставщика.
Установка компоненты может потребовать согласия пользователя. Здесь пакет не загружался, не устанавливался и не запускался.
Обычные синхронные вызовы должны быть разрешены в клиенте. ZIP включает сведения о технологии, поэтому отдельный Тип в этом варианте не задаётся.
Местоположение = "ОбщийМакет.УчебнаяКомпонента";
УстановитьВнешнююКомпоненту(Местоположение);
Подключено = ПодключитьВнешнююКомпоненту(Местоположение, "УчебнаяКомпонента");
Если Подключено Тогда
Работает = ПроверитьПодключениеВнешнейКомпоненты(Местоположение, "УчебнаяКомпонента");
Сообщить("Проверка подключения: " + Строка(Работает));
Иначе
Сообщить("Подключение не выполнено");
КонецЕсли;Разбор по шагам
Установите собственный ZIP-пакет из общего макета.
Подключите его под именем УчебнаяКомпонента.
Перед будущим использованием отдельно проверьте подключение.
Как проверить результат
Проверка выполняется только после Подключено = Истина.
Название макета и символическое имя совпадают в подключении и проверке.
Ожидаемый результат
Показан синтаксис для указанной подготовки. Здесь код не запускался; реальные результаты и побочные эффекты проверяются только при будущем осознанном выполнении в своём учебном приложении.
На что обратить внимание
Булев результат подключения не является тестом всех методов вашей компоненты.
Тонкий и веб-клиент требуют предварительной установки; допустимые способы хранения различаются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.