Для чего предназначен построитель отчета

Рисунок 1. Пример автоматически сгенерированного макета.

Для каждого измерения, участвующего в отчете, построитель создаст в макете область с именем, соответствующим имени измерения. Для иерархических измерений построитель также создаст области для вывода иерархии измерения с именем, состоящим из имени измерения плюс слово «Иерархия» («Hierarchy»). Например, для вывода иерархических строк измерения «Номенклатура» будет создана область с именем «НоменклатураИерархия». Для вывода детальных записей построитель сгенерирует область с именем «Детали» («Details»). Для вывода заголовка отчета будет создана область с именем «Заголовок» («Header»). Для вывода подвала отчета будет создана область с именем «Подвал» («Footer»). Для вывода шапки таблицы будет создана область с именем «ШапкаТаблицы» («TableHeader»). Для вывода подвала таблицы будет создана область с именем «ПодвалТаблицы» («TableFooter»).

В областях для вывода данных построитель разместит параметры, которые будут соответствовать именам полей в запросе.

До тех пор, пока свойству построителя отчета «Макет» не установлено какое-либо значение, построитель автоматически генерирует макет при выводе отчета или чтении этого свойства. После установки свойству «Макет» любого макета построитель перестает автоматически создавать макеты. Для возобновления автоматического создания макета необходимо присвоить свойству «Макет» значение Неопределено.

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

Для установки макета целиком необходимо установить значение свойству «Макет».

Пример установки макета целиком:

В случае если имена областей соответствуют именам, принятым в построителе, никаких дополнительных настроек не требуется. В случае если имена отличаются, необходимо сообщить построителю о новых именах областей. Например, если область заголовка отчета в устанавливаемом макете имеет имя «ЗаголовокОтчетаОПродажах», то нам необходимо установить это имя в свойстве построителя «МакетЗаголовкаОтчета» («ReportHeaderTemplate»).

При установке отдельных частей макета следует заполнить соответствующие свойства требуемыми макетами.

Пример установки внешнего макета показан во внешней обработке rbempl.epf.

Все внешние обработки, описанные в данном разделе, находятся в каталоге \1CITS\EXE\RBSample

ВЫ МОЖЕТЕ ПРЯМО СЕЙЧАС СКОПИРОВАТЬ ОБРАБОТКИ С ПРИМЕРАМИ
НА ЖЕСТКИЙ ДИСК ВАШЕГО КОМПЬЮТЕРА

1С:Предприятие 8. Построитель отчета

Построитель отчета является объектом встроенного языка, который предоставляет возможность динамического создания отчета как программными, так и интерактивными средствами.

В основе работы построителя отчета лежит запрос. Исходя из текста этого запроса построитель отчета предоставляет пользователю возможность интерактивной настройки всех основных параметров, содержащихся в тексте запроса. Например, пользователь может выбрать все, или только некоторые исходные поля, может включать в состав полей поля «через точку» от данного поля, может наложить ограничения на значения некоторых полей, и т.д. Разработчик, используя команды построителя отчета, может изменить состав параметров, доступных пользователю для настройки.

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

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

Для формирования табличного документа построитель отчета использует макет, генерируемый автоматически. Средствами встроенного языка этот макет может быть изменен и оформлен, одним из доступных вариантов оформления. Также разработчик может использовать собственный макет, на основании которого будет формироваться итоговый документ.

Также при формировании табличного документа возможно использование условного оформления. Этот механизм позволяет оформлять отчет динамически, в зависимости от значений, выводимых в отчет. Для настройки доступны цвет текста, цвет фона, шрифт, формат значения, выделение отрицательных чисел и другие оформительские свойства:

Разработчик может настроить механизм расшифровки итогового табличного документа таким образом, что для получения детальных сведений по какому-либо результату отчета будет вызываться этот же, или другой построитель отчета, с нужными параметрами запроса.

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

Построение отчета пользователем

Применение построителя отчета дает пользователю возможность настроить состав выводимых полей, измерений по строкам и колонкам, указать условия отбора и сортировки. Все эти действия пользователь может выполнить с помощью мыши, просто указывая нужные поля в форме настройки параметров отчета:

Динамическое формирование макета

Построитель отчета позволяет выводить отчеты, размещая многоуровневые группировки в одной или нескольких колонках, выводить реквизиты как вместе с группировкой, так и в отдельных колонках, применять различные варианты оформления как для обычных отчетов, так и для кросс-отчетов.

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

Оформленный кросс-отчет может иметь следующий вид:

Разработчик может заменить автоматически формируемыймакет на специально разработанный макет, что позволяет использовать возможности построителя отчета для формирования специализированных отчетов:

Макет, используемый для формирования итогового табличного документа, может создаваться как с нуля, так и путем редактирования автоматически генерируемого макета:

Механизм оформления

Механизм оформления позволяет описывать и запоминать оформления отчетов (цвета, шрифты, рамки) и использовать запомненные оформления для любых отчетов, формируемых построителем отчетов и сводной таблицей.

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

В дополнение к готовым вариантам оформления, разработчик может самостоятельно добавлять новые варианты оформления, а также предоставлять пользователю возможность создавать собственные варианты оформления.

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

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

Условное оформление

Механизм условного оформления позволяет оформлять отчет динамически, в зависимости от значений, выводимых в отчет. Для настройки доступны цвет текста, цвет фона, шрифт, формат значения, выделение отрицательных чисел и другие оформительские свойства.

Использование этого механизма позволяет, например, зеленым фоном выделить суммы, значения которых превысили 10 000, желтым фоном выделить строки номенклатуры, объем продаж которой превысил 30 000, а красным текстом выделить в отчете строки, содержащие услуги:

Настройка условного оформления построителя отчета возможна как из встроенного языка, так и интерактивными средствами:

Построитель отчета в 1С

При разработке отчетов иногда возникает необходимость вывести отчет, данные для которого не могут быть получены с помощью языка запросов. Такая ситуация может возникнуть, например, если для расчета данных используется некий сложный алгоритм, или же данные, для вывода отчет получаются не из информационной базы, а, например из внешнего файла.

Построитель отчета предоставляет возможность вывода отчета из произвольного источника данных.

Основными областями применения построителя отчетов являются:

1. стандартные и аналитические отчеты;
2. произвольные выборки для обработки информации;
3. создание отчетов пользователями без доработки в конфигурации.

В качестве источника данных для построителя отчета могут выступать:

1. ТаблицаЗначений;
2. РезультатЗапроса;
3. ОбластьЯчеекТабличногоДокумента;
4. Табличная часть;
5. РегистрНакопленияНаборЗаписей;
6. РегистрСведенийНаборЗаписей;
7. РегистрБухгалтерииНаборЗаписей;
8. РегистрРасчетаНаборЗаписей.

Для того чтобы построитель отчета выводил отчет для произвольного источника данных, достаточно установить описание источника данных в свойство построителя ИсточникДанных . Свойство построителя отчета ИсточникДанных может содержать значение типа ОписаниеИсточникаДанных .

Объект ОписаниеИсточникаДанных содержит сам источник данных, а также содержит описание колонок источника данных.

Каждое описание колонки источника данных содержит:

• Имя — имя колонки в источнике данных;
• ПутьКДанным — описание зависимости колонок друг от друга. Колонка, чей путь к данным получен через точку от пути к данным другого поля, считается реквизитом другой колонки. Если поле содержит через точку слово Представление , то данное поле считается представлением для колонки, от пути к данным которого получается представление. Примеры: Если колонка «Номенклатура» имеет путь к данным «Номенклатура», а колонка «Код» имеет путь к данным «Номенклатура.Код», то данная колонка будет считаться реквизитом колонки «Номенклатура». Колонка с путем к данным «Номенклатура.Представление» будет считаться представлением для колонки «Номенклатура»;
• Поле — признак того, что данная колонка может быть использована в качестве поля отчета;
• Порядок — признак того, что по данной колонке возможно упорядочивание;
• Отбор — признак того, что на данную колонку возможно накладывать отбор;
• Измерение — признак того, что данная колонка может быть использовано как группировка отчета;
• Итог — строка, содержащая выражение для расчета итога. Для построителя отчета выражение данной строки соответствует выражению для вычисления итога, используемому в языке запросов.

При установке источника данных объекту ОписаниеИсточникаДанных , описания колонок создаются и заполняются автоматически.

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

Создание отчета в несколько «кликов»с использованием построителя

Пользователю необходимо видеть остатки товаров на складах. Остаток достаточно видеть в количественной оценке. Вот пример вывода отчета.

Подобный отчет может сделать даже начинающий программист без единой строчки кода.

Шаг за шагом

Рассмотрим все шаги по созданию этого отчета с использованием объекта «Построитель отчета». Для начала создадим внешний отчет. Назовем его «Остатки номенклатуры».

Далее запускаем конструктор выходной формы.

Указываем имя выходной формы.

Теперь самый важный этап. Нужно в конструкторе создать запрос, который будет получать данные для отчета. Для получения остатков будем использовать регистр накопления «СвободныеОстатки».

Чтобы результат отчета группировался по полю «Склад», в запросе на вкладке «Итоги» нужно добавить поле «Склад».

А на вкладке «Отчет» установим режм размещения реквизитов в позицию «С группировками».

По нажатию на кнопку «ОК» отчет будет готов к использованию.

Так просто?

Создать такой отчет не составит труда, однако если нужен более сложный отчет, то без программирования тут не обойтись. Например, если для номенклатуры нужно выводить основное изображение. Тогда придется программно обрабатывать получение изображения и помещение его в табличный документ.

Все действия, проделанные конструктором, можно сделать вручную. Посмотреть работу конструктора «за кулисами» Вы можете, открыв модуль объекта созданного отчета.