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