Глобальный контекст.НачатьПодключениеВнешнейКомпоненты

Глобальный контекст.НачатьПодключениеВнешнейКомпоненты (Global context.BeginAttachingAddIn)

Глобальный контекст (Global context)

НачатьПодключениеВнешнейКомпоненты (BeginAttachingAddIn)

Доступен, начиная с версии 8.3.6.

Вариант синтаксиса: По идентификатору

Синтаксис:
НачатьПодключениеВнешнейКомпоненты(<ОписаниеОповещения>, <ИдентификаторОбъекта>)
Параметры:

<ОписаниеОповещения> (необязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения со следующими параметрами:
<Подключено> – результат подключения, тип Булево.

<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<ИдентификаторОбъекта> (обязательный)
Тип: Строка.
Идентификатор объекта в виде подключа программного идентификатора ProgID реестра Windows. Например: "AddIn.Scanner".
Описание варианта метода:
Компонент должен быть выполнен по технологии COM и зарегистрирован в реестре Windows.
Эти компоненты совместимы с компонентами 1С:Предприятия 7.7.
Внимание! Вариант метода не работает на сервере и во внешнем соединении.
Вариант синтаксиса: По местоположению

Синтаксис:
НачатьПодключениеВнешнейКомпоненты(<ОписаниеОповещения>, <Местоположение>, <Имя>, <Тип>, <ТипПодключения>)
Параметры:

<ОписаниеОповещения> (обязательный)
Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после завершения со следующими параметрами:
<Подключено> – результат подключения, Тип: Булево.

<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<Местоположение> (обязательный)
Тип: Строка.
Местоположение внешнего компонента.
В качестве местоположения может использоваться:
путь к файлу внешнего компонента в файловой системе (недоступно на веб-клиенте), не ZIP-архив;

полное имя макета, хранящего двоичные данные или ZIP-архив;

URL к внешнему компоненту, в виде двоичных данных или ZIP-архива, в формате, аналогичном ПолучитьНавигационнуюСсылку.

<Имя> (обязательный)
Тип: Строка.
Символическое имя подключаемой внешнего компонента.
Имя должно удовлетворять правилам именования встроенного языка.

<Тип> (необязательный)
Тип: ТипВнешнейКомпоненты.
Тип подключаемого внешнего компонента.
Не используется, если компонент упакован в ZIP-архив.

<ТипПодключения> (необязательный)
Тип: ТипПодключенияВнешнейКомпоненты.
Тип подключения внешней компоненты.
Описание варианта метода:
Компонент может быть выполнен по любой технологии.
Внимание! Вариант метода не работает на сервере и во внешнем соединении.
Описание:

Начинает подключение к "1С:Предприятию" объекта внешнего компонента.
Внешние компоненты могут храниться в информационной базе или макетах конфигурации в виде ZIP-архива или в виде двоичных данных.
При работе на тонком клиенте и веб-клиенте компонент должен быть предварительно установлен.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:
Внешние компоненты могут быть выполнены по технологии Native API или COM.
Веб-клиент может работать только с компонентами в информационной базе, упакованными в архив.
Тонкий клиент может работать с компонентами в информационной базе, упакованными в архив, и компонентами, расположенными в файловой системе.
Толстый клиент может работать со всеми вариантами хранения компонентов. При этом, если компонент установлен методом УстановитьВнешнююКомпоненту, то используется установленный компонент, а если не установлен, то компонент будет получен в момент подключения.
Сервер может работать со всеми компонентами. Компонент кэшируется на сеанс работы сервера.
Пример:

НаКлиенте
Процедура Команда(Команда)
Подключить(Истина);
КонецПроцедуры

НаКлиенте
Процедура Подключить(УстановитьЕслиНеПодключено) Экспорт
НачатьПодключениеВнешнейКомпоненты(
Новый ОписаниеОповещения(
"ПослеПодключения",
ЭтотОбъект,
УстановитьЕслиНеПодключено),
"ОбщийМакет.ВнешняяКомпонента",
"ВнешняяКомпонента");
КонецПроцедуры

НаКлиенте
Процедура ПослеПодключения(Подключено, УстановитьЕслиНеПодключено) Экспорт
Если Подключено Тогда
// Внешняя компонента подключена

ИначеЕсли УстановитьЕслиНеПодключено Тогда
НачатьУстановкуВнешнейКомпоненты(
Новый ОписаниеОповещения(
"Подключить",
ЭтотОбъект,
Ложь),
"ОбщийМакет.ВнешняяКомпонента");
Иначе
// Не удалось установить или подключить

// внешнюю компоненту

КонецЕсли;
КонецПроцедуры

См. также:
Глобальный контекст, метод ЗагрузитьВнешнююКомпоненту
Глобальный контекст, метод НачатьУстановкуВнешнейКомпоненты

Использование в версии:

Доступен, начиная с версии 8.3.6.

Описание изменено в версии 8.3.22.

Методическая информация