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

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

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

ФУНКЦИЯ ЛОГИКА: ПОСТРОИТЬ(СОРТ_ОБ: сортировка = СОРТ_ОБ[];
                          СТРОКА: имя = "")

Параметры

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

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

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

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

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

Замечание

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


См. также: