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