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