Руководство разработчика

Метод КОЛЛЕКЦИЯ_ОБЪЕКТОВ.ПОДКЛЮЧИТЬ

Метод ПОДКЛЮЧИТЬ позволяет связать значение типа КОЛЛЕКЦИЯ_ОБЪЕКТОВ с ранее созданной именованной выборкой. Выборка может быть создана в другой программе И++, но в той же клиентской сессии.

ФУНКЦИЯ ЛОГИКА: ПОДКЛЮЧИТЬ(СТРОКА: имя;
                           МАСКА_АН: маска = МАСКА_АН[])

Параметры

имя
Имя выборки, которое ранее указывалось как параметр метода ПОСТРОИТЬ.
маска
Маска для считывания объектов аналитики из коллекции. Эта маска используется при передаче данных с сервера в клиентский кэш. См. метод СЧИТАТЬ.

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

ДА – в случае успеха, НЕТ – в случае ошибки.

Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА. Если коллекции с указанным именем нет, то метод возвращает НЕТ, а ПОСЛ_ОШИБКА возращает код -1.

Замечание 1.

Метод ПОДКЛЮЧИТЬ освобождает ресурсы, занятые прежней выборкой. Если прежняя выборка была именованной, то она продолжает существовать.

Замечание 2.

Именованная выборка не освобождается при разрушении значения типа КОЛЛЕКЦИЯ_ОБЪЕКТОВ. Если выборка более не нужна, то ее следует освободить вызовом функции УДАЛИТЬ_КОЛЛЕКЦИЮ_ОБЪЕКТОВ.

Замечание 3.

Если клиентская сессия была прервана администратором или сервер был перезапущен, то все именованные выборки удаляются, а метод ПОДКЛЮЧИТЬ будет возвращать НЕТ. В этом случае, для восстановления доступа к данным, надо снова создать выборку методом ПОСТРОИТЬ.


См. также: