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