Метод КОЛЛЕКЦИЯ_ОПЕР.ПОДКЛЮЧИТЬ
Метод ПОДКЛЮЧИТЬ позволяет связать значение типа КОЛЛЕКЦИЯ_ОПЕР с ранее созданной именованной выборкой. Выборка может быть создана в другой программе И++, но в той же клиентской сессии.
ФУНКЦИЯ ЛОГИКА: ПОДКЛЮЧИТЬ(СТРОКА: журнал;
СТРОКА: имя;
МАСКА_ОПЕР: маска = МАСКА_ОПЕР[])
Параметры
- журнал
- Имя журнала.
- имя
- Имя выборки, которое ранее указывалось как параметр метода ПОСТРОИТЬ. Имена должны быть уникальны вне зависимотси от журнала.
- маска
- Маска для считывания операций из коллекции. Эта маска используется при передаче данных с сервера в клиентский кэш. См. метод СЧИТАТЬ.
Возвращаемое значение
ДА – в случае успеха, НЕТ – в случае ошибки.
Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА. Если коллекции с указанным именем нет, то метод возвращает НЕТ, а ПОСЛ_ОШИБКА возращает код -1.
Замечание 1.
Метод ПОДКЛЮЧИТЬ освобождает ресурсы, занятые прежней выборкой. Если прежняя выборка была именованной, то она продолжает существовать.
Замечание 2.
Именованная выборка не освобождается при разрушении значения типа КОЛЛЕКЦИЯ_ОПЕР. Если выборка более не нужна, то ее следует освободить вызовом функции УДАЛИТЬ_КОЛЛЕКЦИЮ_ОПЕР.
Замечание 3.
Если клиентская сессия была прервана администратором или сервер был перезапущен, то все именованные выборки удаляются, а метод ПОДКЛЮЧИТЬ будет возвращать НЕТ. В этом случае, для восстановления доступа к данным, надо снова создать выборку методом ПОСТРОИТЬ.