Получает массив описаний соединений кластера. Выполнение метода требует аутентификации одного из администраторов кластера.
Синтаксис
ПолучитьСоединения()Полное описание, параметры и ограничения
АдминистрированиеКластер.ПолучитьСоединения (AdministrationCluster.GetConnections)
АдминистрированиеКластер (AdministrationCluster)
ПолучитьСоединения (GetConnections)
Доступен, начиная с версии 8.3.14.
Синтаксис:
ПолучитьСоединения()
Возвращаемое значение:
Тип: Массив.
Массив элементов типа АдминистрированиеСоединение.
Для каждого соединения выдается только информация, не требующая аутентификации пользователей информационных баз.
Описание:
Получает массив описаний соединений кластера. Выполнение метода требует аутентификации одного из администраторов кластера.
Доступность:
Тонкий клиент, сервер, толстый клиент, интеграция.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
RAS: отключить единственное своё тестовое соединение
Объект соединения берётся из фактического массива кластера. Это принудительное отключение, а не освобождение локальной переменной.
Где и как запускать
Синтаксис в своей административной форме тонкого или толстого клиента либо серверном модуле. Соединение RAS относится только к выделенному собственному учебному серверу. Здесь соединения и изменения не выполнялись.
Подготовка
Подготовьте собственный отдельный учебный сервер 1С с RAS по 127.0.0.1:1545 и ровно одним своим кластером. Не направляйте пример на сервер рабочих пользователей.
В административной форме задайте строковые реквизиты ИмяАгента, ПарольАгента, ИмяАдминистратораКластера и ПарольКластера. Пароли вводятся в режиме пароля и не выводятся в сообщения. RAS аутентифицирует агента в порядке пароль, имя, а кластер — имя, пароль.
Административный код запускайте отдельно от целевой ИБ. В собственном учебном кластере оставьте одно специально открытое ненужное тестовое соединение с согласованным завершением.
Сервер = Новый АдминистрированиеСервера("127.0.0.1", 1545);
Сервер.ВыполнитьАутентификацию(ПарольАгента, ИмяАгента);
Кластеры = Сервер.ПолучитьКластеры();
Если Кластеры.Количество() <> 1 Тогда
ВызватьИсключение "Нужен ровно один собственный учебный кластер";
КонецЕсли;
Кластер = Кластеры[0];
Кластер.ВыполнитьАутентификацию(ИмяАдминистратораКластера, ПарольКластера);
Соединения = Кластер.ПолучитьСоединения();
Если Соединения.Количество() <> 1 Тогда
ВызватьИсключение "Нужно одно своё заранее согласованное тестовое соединение";
КонецЕсли;
Соединение = Соединения[0];
Соединение.Отключить();
Сообщить("Запрошено отключение своего тестового соединения");Разбор по шагам
Получите реальные соединения своего кластера.
Откажитесь при любом количестве, кроме подготовленного одного.
Вызовите отключение именно возвращённого соединения.
Как проверить результат
В коде не генерируется произвольный идентификатор соединения.
Пользователь тестового соединения может потерять несохранённую работу; это учитывается до запуска.
Ожидаемый результат
Это короткий синтаксический пример для указанного учебного стенда. Здесь он не выполнялся; сообщение после вызова не заменяет отдельную проверку фактического состояния.
На что обратить внимание
Отключение может повлиять на незавершённые действия клиента. Оно не является штатным сохранением формы.
Число элементов само по себе не доказывает владение — собственный отдельный стенд обязателен.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.