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

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

Метод ПОСТРОИТЬ освобождает ресурсы, занятые прежней выборкой, и формирует новую на основании заданного фильтра и условий сортировки.

ФУНКЦИЯ ЛОГИКА: ПОСТРОИТЬ(СТРОКА: корн_код; 
                          ФИЛЬТР_ОБЪЕКТОВ: фильтр = ФИЛЬТР_ОБЪЕКТОВ[]; 
                          СОРТ_ОБ: сортировка = СОРТ_ОБ[];
                          МАСКА_АН: маска = МАСКА_АН[]; 
                          ДАТА_ВРЕМЯ: дата_время = РАБ_ДАТА_ВРЕМЯ; 
                          СТРОКА: имя = "")

Параметры

корн_код
Полный код объекта аналитики, дочерние объекты которого будут фигурировать в коллекции.
фильтр
Условия фильтрации. Поле корень должно быть пустым или равным указанному параметру корн_код. Поля фильтра искл_корень и подуровни игнорируются.
сортировка
Условия сортировки. Задает начальную сортировку, во время жизни коллекции сортировка может быть изменена методом СОРТИРОВКА.
маска
Маска для считывания объектов аналитики из коллекции. В эту маску не обязательно включать свойства, используемые в фильтре и сортировке. Для предварительной загрузки объектов в кэш на сервере автоматически используется объединенная маска для всех требуемых данных. Но при передаче данных с сервера в клиентский кэш используется только эта маска. См. метод СЧИТАТЬ.
дата_время
Дата и время актуальности, для которых будет выполняться считывание значений статических свойств.
имя
Указание имени позволяет создать долго-живущую выборку, которая не будет освобождена при разрушении объектного значения типа КОЛЛЕКЦИЯ_ОБЪЕКТОВ. В дальнейшем можно использовать такую выборку в другой программе, связав с ней КОЛЛЕКЦИЯ_ОБЪЕКТОВ с помощью метода ПОДКЛЮЧИТЬ. Когда выборка больше не нужна, то ее удаление выполняется явным вызовом функции УДАЛИТЬ_КОЛЛЕКЦИЮ_ОБЪЕКТОВ. Без явного удаления выборка существует до конца клиентской сессии.

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

ДА – в случае успешного построения выборки, НЕТ – в случае ошибки.

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

Вызов метода ПОСТРОИТЬ не приводит к передаче на клиентское место объектов аналитики выборки, но их текущее количество и порядок становятся известны.

Замечание

Имя выборки объектов аналитики в данный момент времени должно быть уникально в пределах текущей клиентской сессии. Попытка построения выборки с именем, которое уже занято, приведет к ошибке. После освобождения выборки можно снова построить выборку с таким же именем.


См. также: