1С-Предприятие 8.0. Практическое пособие разработчика

Построитель отчета


Построитель отчета является объектом встроенного языка, позволяющим выполнять различные настройки запроса в ходе выполнения программы. Такие настройки могут выполняться как средствами встроенного языка (в результате работы некоторого алгоритма работы программы), так и интерактивно, непосредственно пользователем. [208]

Исходными данными для построителя отчета является текст запроса. На его основании построитель отчета определяет, какие параметры будут доступны для настройки и каким образом возможна настройка состава и порядка итоговых данных. Затем происходит программное или интерактивное формирование этих настроек и вывод результатов в табличный документ, диаграмму, сводную таблицу или сводную диаграмму.

Формировать параметры настройки на основании текста запроса построитель отчета может двумя способами: автоматически и на основании указаний, расположенных в тексте запроса. [209]

Автоматически параметры настройки формируются вызовом метода ЗаполнитьНастройки() следующим образом:

·полями, доступными для выбора в качестве полей отбора, порядка или вывода в отчет (свойство "ДоступныеПоля"), становятся все поля из списка выборки и все их подчиненные поля,
·в список полей, выбранных для вывода в отчет (свойство "ВыбранныеПоля"), добавляются все поля из списка выборки,
·полями, доступными для выбора в качестве измерений, становятся все поля из предложения ИТОГИ ПО и все их подчиненные поля,
·в список измерений по строкам (свойство "ИзмеренияСтроки") добавляются все поля из предложения ИТОГИ ПО,
·в доступные отборы (свойство "Отбор") добавляются параметры виртуальных таблиц.

Вторым способом формирования параметров настроек построителя отчета является выделение их в тексте запроса. Для этого используются фигурные скобки "{ }". Фигурными скобками могут быть выделены параметры построителя отчета, а также некоторые синтаксические конструкции:

·ВЫБРАТЬ ... – описывает поля, которые пользователь сможет выбирать для вывода,
·ГДЕ ... – описывает поля, на которые пользователь может накладывать ограничения,
·УПОРЯДОЧИТЬ ПО ... – описывает поля для обозначения порядка,
·ИТОГИ ПО ... – описывает поля, по которым будут выводиться итоговые значения.

После того, как значения параметров указаны, вывод результатов запроса возможен как принудительно (используя методы Выполнить() и Вывести()), либо автоматически, если результаты выводятся в сводную таблицу. [210]



Содержание раздела