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