При разработке отчетов иногда возникает необходимость вывести отчет, данные для которого не могут быть получены с помощью языка запросов. Такая ситуация может возникнуть, например, если для расчета данных используется некий сложный алгоритм, или же данные, для вывода отчет получаются не из информационной базы, а, например из внешнего файла.
Построитель отчета предоставляет возможность вывода отчета из произвольного источника данных.
Основными областями применения построителя отчетов являются:
- стандартные и аналитические отчеты;
- произвольные выборки для обработки информации;
- создание отчетов пользователями без доработки в конфигурации.
В качестве источника данных для построителя отчета могут выступать:
- ТаблицаЗначений;
- РезультатЗапроса;
- ОбластьЯчеекТабличногоДокумента;
- Табличная часть;
- РегистрНакопленияНаборЗаписей;
- РегистрСведенийНаборЗаписей;
- РегистрБухгалтерииНаборЗаписей;
- РегистрРасчетаНаборЗаписей.
Для того чтобы построитель отчета выводил отчет для произвольного источника данных, достаточно установить описание источника данных в свойство построителя ИсточникДанных. Свойство построителя отчета ИсточникДанных может содержать значение типа ОписаниеИсточникаДанных.
Объект ОписаниеИсточникаДанных содержит сам источник данных, а также содержит описание колонок источника данных.
Каждое описание колонки источника данных содержит:
- Имя - имя колонки в источнике данных;
- ПутьКДанным - описание зависимости колонок друг от друга. Колонка, чей путь к данным получен через точку от пути к данным другого поля, считается реквизитом другой колонки. Если поле содержит через точку слово Представление, то данное поле считается представлением для колонки, от пути к данным которого получается представление. Примеры: Если колонка "Номенклатура" имеет путь к данным "Номенклатура", а колонка "Код" имеет путь к данным "Номенклатура.Код", то данная колонка будет считаться реквизитом колонки "Номенклатура". Колонка с путем к данным "Номенклатура.Представление" будет считаться представлением для колонки "Номенклатура";
- Поле - признак того, что данная колонка может быть использована в качестве поля отчета;
- Порядок - признак того, что по данной колонке возможно упорядочивание;
- Отбор - признак того, что на данную колонку возможно накладывать отбор;
- Измерение - признак того, что данная колонка может быть использовано как группировка отчета;
- Итог - строка, содержащая выражение для расчета итога. Для построителя отчета выражение данной строки соответствует выражению для вычисления итога, используемому в языке запросов.
При установке источника данных объекту ОписаниеИсточникаДанных, описания колонок создаются и заполняются автоматически.
Объект ОписаниеИсточникаДанных имеет конструктор, в качестве параметра которого может быть передан источник данных, для которого создается описание, при этом свойство ИсточникДанных будет заполнено переданным источником данных, описания колонок будут заполнены информацией о колонках из источника данных.
Пример установки источника данных построителю отчета:
|
1 |
ПостроительОтчета.ИсточникДанных = Новый ОписаниеИсточникаДанных(ТаблицаЗначенийРезультат); |
Дальнейшая работа с построителем отчета не отличается от работы с построителем отчета в режиме работы с запросом:
- построитель отчета предоставляет свою полную функциональность, за исключением вывода иерархических итогов;
- при работе с произвольным источником данных, у построителя отчета нельзя получить запрос, который будет использован для получения данных из информационной базы.
Работа построителя запроса с произвольным источником данных идентична работе с произвольным источником построителя отчета.
Создание отчета с помощью конструктора выходной формы
Конструктор выходной формы — встроенный в платформу механизм, который облегчает разработку отчета.
ВАЖНО! Конструктор доступен только для обычных форм.
Конструктору указывается запрос и все необходимые параметры будущего отчета, а он, в свою очередь, генерирует модули и формы отчета.
Механизм основан на объекте встроенного языка 1С — ПостроительОтчета.
Подробнее...
Использование построителя отчета с помощью программных средств
Настройка построителя отчета
Построитель отчетов может использоваться в тех случаях, когда СКД недоступна или существует вероятность, что она отработает неправильно.
Настройки построителя отчетов включают:
- ВыбранныеПоля, ДоступныеПоля;
- ИзмеренияКолонки, ИзмеренияСтроки;
- Отбор;
- Порядок;
- УсловноеОформление.
Алгоритм использования построителя отчета:
- объявить создание нового объекта типа ПостроительОтчета;
- для создания текста выборки использовать ПостроительЗапроса либо, используя объект ОписаниеИсточникаДанных, воспользоваться существующей выборкой;
- задать настройки построителя отчета, используя метод объекта построителя ЗаполнитьНастройки();
- отказаться от использования стандартного макета оформления (при желании), определив свойство объекта Макет у построителя;
- выполнить запрос, используя метод Выполнить() (если не используется ОписаниеИсточникаДанных);
- запустить метод Вывести() (в табличный документ, или в соответствующий элемент формы).
ВАЖНО! Расширения языка запросов, предназначенные для построителя отчета, выделяются фигурными скобками {}.
Особенности построителя отчетов 1С:
- Конструктор запросов входит в состав конструктора выходных форм, а конструктор выходных форм может использовать построитель отчетов.
- Для использования построителю отчета могут передаваться запрос и макет (среди свойств построителя отчета есть Макет и Текст - для запроса).
- Пользователь может изменить состав отображаемых полей отчета, используя настройки построителя отчета и выбирая их из числа доступных полей.
- Для формирования табличного документа построитель отчета использует:
- макет, созданный разработчиком, либо
- макет, генерируемый автоматически.
- Настройки построителя отчета:
- формируются автоматически на основе исходного текста запроса;
- могут быть указаны явно в тексте запроса с использованием расширения языка запросов.