Построение отчета

Построение отчета#

Отчеты системы GlobalFramework хранятся в базе данных — это позволяет легко адаптировать их под проекты. Для управления отчетами перейдите в приложение Global - Настройка системы.

Существует четыре типа отчетов:

  • произвольный;

  • динамический;

  • отчет с селекционным экраном;

  • экранная форма.

Варианты построения отчета#

Операция «Построить отчет»#

Стандартное построение отчета выбранного типа с заполнением параметров.

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

Операция «Построить отчет c текущими параметрами»#

Построение отчета с уже настроенными ранее параметрами.

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

Поведение идентично операции «Построить отчет».

Операция «Построить отчет в фоновом режиме»#

Для работы отчета в фоновом режиме необходимо:

  • Включить параметры:

    • «Вести журнал построения отчета» (закладка «Объектные характеристики»).

    • «Доступен фоновый режим» (закладка «Печатные формы отчета»).

  • Убедиться, что планировщик Btk_Job запущен и корректно настроен в системе. Через него работает фоновая печать.

  • Отчет не должен быть интерактивным. Печать интерактивного отчета в фоновом режиме невозможна.

  1. Работает аналогично операции «Построить отчет», но в фоновом режиме. Запускается той же кнопкой.

  2. При запуске (после окна с указанием параметров) открывается модальное окно с выбором:

    • режима выполнения;

    • даты и времени старта.

  3. После завершения система показывает уведомление с перечнем построенных отчетов.

  4. Результаты сохраняются:

    • в журнале построения отчета;

    • как прикрепленные файлы (если выбрано сохранение документа).

  5. Если отчет запланирован, то в журнале можно удалить запись в состоянии «Запланирован к фоновой печати».

  6. Подробности выполнения смотрите:

    • на вкладке Журнал построения отчета;

    • в меню Сервис → Фоновые задания (отображает все фоновые процессы).

Механизм построения отчета#

Для произвольных отчетов#

  1. Механизм поиска отчета: система ищет печатную форму, указанную на закладке «Объектные характеристики».

  2. Открытие выборки с параметрами:

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

    • Открывает выборку в режиме lookup, в которой заполняется карта параметров Rpt_Pkg().docReportParamsMap (системное имя параметра → параметр).

  3. Печать отчета: отчет формируется через метод printReport.

Для остальных типов#

  1. Механизм поиска отчета: система ищет печатную форму, установленную «По умолчанию», указанную на закладке «Печатные формы отчета».

  2. Открытие выборки с параметрами:

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

    • Форма с параметрами указывается напрямую названием выборки и отображения.

  3. Печать отчета: отчет формируется через метод printReport.

Механизм поиска отчета#

  • Динамический отчет: поиск по sSelectionName и sRepresentationName.

  • Отчет с селекционным экраном: поиск по sSelectionName и sRepresentationName.

  • Экранная форма: поиск по sSelectionName и sRepresentationName.

  • Произвольный отчет: механизм отличается (см. описание операций) .

Название выборки sSelectionName и отображения sRepresentationName указываются в карточке в объектных характеристиках отчетной формы Rpt_Entity.

Пример:

  • sSelectionName (имя выборки): Asf_InvNumbInSelScreenAvi.

  • sRepresentationName (имя отображения): SelectionScreenCardDeprTax.

Проверка дубликатов отчетов по параметрам#

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

Условия работы:

  • Параметр «Тип проверки отчета» выбран: «При построении» или «При построении и сохранении» (закладка «Объектные характеристики»).

  • Включен параметр «Вести журнал построения отчета» (закладка «Объектные характеристики»).

Если условия не выполнены — система всегда создает новый отчет.

Сохранение отчетов#

Вариант сохранения определяется параметрами на закладке «Объектные характеристики»:

  1. «Сохранять отчет в документ».

    • Создается документ формата Wf_Doc с прикрепленным PDF-отчетом.

    • В журнале появляется запись о построении отчета с указанием версии документа.

  2. «Сохранять отчет в журнал как прикрепленный файл».

    • Создается документ Wf_Doc с PDF.

    • В журнале появляется запись о построении отчета + документ прикрепляется к этой записи.

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

Закладки справочника#

Параметры отчета#

  • Содержит параметры, настроенные на отчете.

  • Создание и удаление параметров по умолчанию выполняется в классе Печатные формы на соответствующей закладке.

  • Получить параметры можно с помощью операции Получить параметры отчета.

Объектные характеристики#

Настройки печати отчетов:

  • Тип проверки отчета при построении.

  • Ведение журнала построения отчета.

  • Сохранение отчета в журнал как прикрепленного файла.

  • Сохранение отчета в документ (прикрепление отчета к документу класса Wf_Doc).

Журнал построения#

  • Содержит ранее сформированные отчеты.

  • Хранит параметры и метаданные отчетов.

  • Запись создается, только если включен соответствующий флаг на закладке Объектные характеристики.

Дополнительные настройки#

  • Тип документа: определяет тип документа, создаваемого при построении отчета.

  • JEXL для даты версии: содержит Jexl-выражение, которое вычисляет дату версии отчета.

  • Роли доступа отчета: определяет, какие пользователи могут создавать, просматривать и запускать отчет. Отчеты классифицируются по ролям доступа, которые соответствуют полномочиям пользователей, группам пользователей или отдельным пользователям. Если отчет предназначен для группы пользователей, соответствующая роль назначается всем участникам этой группы. Если отчет предназначен для конкретного пользователя, доступ ограничивается ролью, назначенной только этому пользователю. Если роли не указаны, применяются общие правила доступности отчета.

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

  • JEXL расширения сеттеров отчета: позволяет задать кастомную логику сеттера для интерактивного отчета.

Печатные формы отчета#

Для произвольных отчетов

  • Допустима только одна печатная форма.

  • Из этой формы берутся все параметры отчета.

Для остальных типов

  • Отображается список всех печатных форм.

  • Можно установить флаг печатной формы по умолчанию.

Лист рассылки отчетной формы#

Закладка Лист рассылки отчетной формы используется для настройки автоматической рассылки результатов печати выбранной отчетной формы. Закладка доступна для отчетов типов Произвольный отчет и Отчет с селекционным экраном.

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

Список листов рассылки#

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

Поле

Описание

Наименование

Название листа рассылки. Используется для идентификации настройки в списке.

Менеджер заданий

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

Печатная форма

Печатная форма, по которой формируется результат рассылки. Если у отчетной формы настроено несколько печатных форм, в листе рассылки указывается нужная печатная форма.

Версия печатной формы

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

Формат отчета

Формат результата печати.

Дата последней печати

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

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

Параметры формирования отчета#

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

Для работы с параметрами используются операции группы Действия с параметрами:

  • Заполнить параметры — открывает форму заполнения параметров отчетной формы. Заполненные значения сохраняются в листе рассылки и используются при выполнении связанного задания.

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

Для отдельного параметра можно задать переопределение через JEXL-скрипт. Для этого у нужного параметра устанавливается признак Определяется из JEXL, а сам скрипт указывается в поле Мнемокод. При выполнении рассылки значение такого параметра вычисляется по заданному скрипту.

Параметры отчета также доступны в JEXL-сценариях определения получателей через JSON под алиасом JPARAMS. Это позволяет формировать список получателей с учетом сохраненных параметров отчета, например подразделения, организации или периода.

Получатели рассылки отчетной формы#

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

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

Доступны следующие типы получателей:

  • Сотрудники OFS;

  • Физическое лицо;

  • Профиль администрирования;

  • Объектная привилегия;

  • Процедура получения пользователя.

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

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

Пример настройки#

Нужно настроить ежемесячную рассылку отчета Ведомость движения объектов ОС руководителю подразделения Цех № 12.

На закладке Лист рассылки отчетной формы создается лист рассылки Ведомость движения ОС по цеху № 12. В листе указываются:

  • Печатная форма — ПФ Ведомость движения объектов ОС;

  • Версия печатной формы — VedomostOS_v1;

  • Формат отчета — pdf;

  • Менеджер заданий — задание Рассылка ведомости движения ОС по цеху № 12.

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

  • Организация — АО "Пример";

  • Период с — 01.04.2026;

  • Период по — 30.04.2026;

  • Подразделение — Цех № 12.

Если период должен определяться автоматически, например всегда за предыдущий месяц, для параметров периода устанавливается признак Определяется из JEXL, а скрипт расчета даты указывается в поле Мнемокод нужного параметра.

В списке Получатели рассылки отчетной формы добавляется строка:

  • Тип получателя — Физическое лицо;

  • Получатель — Иванов И.И..

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

При запуске связанного задания система сформирует отчет Ведомость движения объектов ОС за апрель 2026 года по подразделению Цех № 12 в формате pdf и отправит результат указанным получателям.

Содержание