Глобальный контекст.УстановитьВнешнююКомпонентуАсинх (Global context.InstallAddInAsync)

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

УстановитьВнешнююКомпонентуАсинх (InstallAddInAsync)

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

Синтаксис:

УстановитьВнешнююКомпонентуАсинх(<Местоположение>)

Параметры:

<Местоположение> (обязательный)

Тип: Строка.
Строка, определяющая местоположение внешней компоненты.
В качестве строки может использоваться:

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

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

Тип: Обещание.
Результат выполнения обещания - Неопределено.

Описание:

Асинхронная функция. Доставляет объект внешнего компонента с сервера на клиент, после чего он становится доступен для метода ПодключитьВнешнююКомпонентуАсинх.

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

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

Примечание:

Метод работает только с компонентами, хранящимися в ZIP-архиве.

Пример:

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

НаКлиенте
Асинх Процедура Подключить()
    Подключено = Ждать ПодключитьВнешнююКомпонентуАсинх(
        "ОбщийМакет.ВнешняяКомпонента", "ВнешняяКомпонента");
    Если Подключено Тогда
        // Внешняя компонента подключена

    Иначе
        Ждать УстановитьВнешнююКомпонентуАсинх(
            "ОбщийМакет.ВнешняяКомпонента");
        Подключено = Ждать ПодключитьВнешнююКомпонентуАсинх(
            "ОбщийМакет.ВнешняяКомпонента", "ВнешняяКомпонента");
        Если Подключено Тогда
            // Внешняя компонента установлена и подключена

        Иначе
            // Не удалось установить или подключить

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

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

См. также:

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

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

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

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