Отчёты

Отчёт – это специальный проектный элемент, описывающий правила отбора, сортировки, группировки данных и выдачи их на экран, принтер, в файл. Часто отчётом называют результат выполнения перечисленных действий.

В проекте имеются отчёты двух видов. Первый – обычные отчёты. Отчёты этого вида были изначально включены в Домино и обозначаются иконкой. С появлением языка скриптов появилась возможность разрабатывать отчёты на этом языке. Отчёты второго вида оформляются в виде процедур на языке скриптов и находятся в разделе ‘Процедуры’. Подробнее об отчётах на языке скриптов можно прочитать в книгах ‘Язык скриптов’ и ‘Язык скриптов. Отчёты’.

Дальнейшее описание касается только обычных отчётов.

Отчёты можно описывать в разделе ‘Отчёты’ верхнего уровня любой библиотеки, либо внутри объектных разделов в разделе ‘Отчёты’. Раздел ‘Отчёты’ верхнего уровня библиотеки  содержит такие отчёты, которые рассчитываются по нескольким объектам. В объектные разделы помещают отчёты, обрабатывающие один конкретный объект.

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

• Группа отчетов – для создания папки, в которой могут быть сгруппированы несколько отчетов, объединенных по какому-либо признаку. Для группы задается только наименование.
• Базовый отчет – для создания нового базового отчета.
• Отчет – для создания нового отчета на базе существующего.
• Подстановка отчета – для изменения свойств существующего отчета.

Для базового отчета можно указать следующие атрибуты:

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

• HFile definition – используется программистами.
• Точка входа – место реализации базового отчета.
• Выборка – определяет основное правило отбора данных для отчета. Не указывается в базовых отчетах по проводкам и оборотам.
• Форма отчета – для описания формы, запускаемой перед выполнением отчета. В форме задаются параметры отчета.
• Параметры отчета – данный раздел применяется для описания всех используемых в отчете итоговых переменных, функций, выражений, мультиколонок.
• Структура (Состав, Содержание) – для описания блоков отчета. Структура отчета определяет порядок и уровень группировки данных. С каждым блоком сопоставляется определенный параметр отбираемого объекта.
• Элемент – применяется для указания специальных атрибутов базового отчета.
• Указатель на элемент – применяется для указания специальных атрибутов базового отчета.
• Допускает наследование атрибутов – при установленном признаке в описании наследника можно будет переопределить атрибуты.
• Использование – условие доступа проектировщиков к базовому отчету.
• Путь – для указания директории, в которой создается файл с результатом отчета.
• Сценарий – определяет список кнопок, которые будут представлены на панели инструментов при просмотре результатов отчета.
• Исходящий контекст – при разработке отчета будут доступны параметры перечисленных объектов.
• ЦФО – для задания центра финансовой ответственности. Значение ЦФО необходимо для любых  расчетов, в которых применяются проводки и обороты.
• Ограничение на класс/тип объектов – для наложения ограничений на класс или тип объектов, которые будут отобраны для отчета.
• Параметр сортировки объекта – определяет правило сортировки отбираемых объектов. Не указывается в базовых отчетах по проводкам и оборотам.
• Список ограничений на выборку – для наложения дополнительных ограничений на параметры отбираемых объектов.
• Группа счетов – для задания списка возможных значений атрибута ‘Счет’. Применяется в базовых отчетах по проводкам и оборотам.
• Счет – для задания счета. Применяется в базовых отчетах по проводкам и оборотам.
• Корр.счет – для задания корреспондирующего счета. Применяется в базовых отчетах по проводкам и оборотам.
• Размерность – для задания размерности расчета оборотов. Применяется в базовых отчетах по проводкам и оборотам.
• Параметр сортировки счета –для указания правила сортировки списка счетов. Применяется в базовых отчетах по проводкам и оборотам.
• Не рассчитывать обороты – при установленном признаке для отчетов по проводкам отключается дополнительный расчет оборотов по счету. Применяется в базовых отчетах по проводкам и оборотам.
• Не рассчитывать сальдо – при установленном признаке для отчетов по проводкам отключается дополнительный расчет сальдо. Применяется в базовых отчетах по проводкам и оборотам.
• Статистика выполнения отчета – определяет имя файла, в котором будет накапливаться информация о запусках данного отчета.
• Формальные параметры – список формальных параметров для вызова базового отчета.
• Список возможных группировок товарного отчета – Применяется в базовых отчетах по продуктам, оборотам, каталогам, партнерам и строкам документов.
•  Список возможных группировок отчета по оборотам – Применяется только в базовых отчетах по оборотам.
• Действие, выполняемое перед выполнением отчета – для указания процедуры, запускаемой перед выполнением отчета.
• Действие, выполняемое после выполнения отчета – для указания процедуры, запускаемой после выполнения отчета.
• Счет (атрибут) – при наличии данного атрибута в отчете – наследнике станет доступен атрибут ‘Счет’.

Список атрибутов обычного отчета несколько иной.

На картинке отображены не все атрибуты.

• Формальные параметры - список формальных параметров для вызова отчета.
• Значения формальных параметров при вызове – список значений формальных параметров. Раздел заполняется при вызове отчета.
• Локальные переменные – список локальных переменных отчета.
• Группа параметров – для разделения параметров отчета на группы.
• Параметры отчета – данный раздел применяется для описания всех используемых в отчете итоговых переменных, функций, выражений, мультиколонок.
• Путь – для указания директории, в которой создается файл с результатом отчета.
• Имя файла отчета – определяет имя файла с результатом отчета. Если данный атрибут не указан, то создается файл с произвольным уникальным именем. Расширение имени файла зависит от типа шаблона.
• Инверсия сортировки – при установленном признаке записи перебираются в обратном порядке.
• Форма отчета – для описания формы, запускаемой перед выполнением отчета.
• Параметр сортировки объекта – определяет правило сортировки отбираемых объектов
• Список ограничений на выборку – для наложения дополнительных ограничений на параметры отбираемых объектов.
• Структура (Состав, Содержание) – для описания блоков отчета. Структура отчета определяет порядок и уровень группировки данных. С каждым блоком сопоставляется определенный параметр отбираемого объекта.
• Шаблон – для описания шаблонов отчета.
• Допускает наследование атрибутов – при установленном признаке в описании наследника можно будет переопределить атрибуты.
• Не наследовать форму отчета – при установленном признаке перед запуском отчета не будет запущена форма отчета. Данный атрибут отключает наследование формы от родителей отчета. Если для данного отчета указан атрибут ‘Форма’, то значение атрибута ‘Не наследовать форму отчета’ игнорируется.
• Использование – условие доступа проектировщиков к отчету.
• Использование (в режиме выполнения) – условие доступа пользователей к отчету.
• Сохранить изменения перед вызовом – наличие этого атрибута означает, что перед выполнением отчета вся введенная в форму информация будет записана в БД.  Применяется при вызове отчета из формы.
• Сценарий – определяет список кнопок, которые будут представлены на панели инструментов.
• Запретить прерывание – при установленном признаке будет удалена возможность прерывать процесс формирования отчета.
• Запрашивать подтверждение, если файл существует – для задания условия, при выполнении которого будет высвечено сообщение с запросом. Пользователю будет предложено либо перезаписать уже существующий файл с результатом отчета, либо создать новый файл с другим именем.
• ЦФО – для задания центра финансовой ответственности. Значение ЦФО необходимо для любых  расчетов, в которых применяются проводки и обороты.
• Рассчитывать обороты, если нет проводок – при установленном признаке в список отобранных данных попадут все счета с ненулевым сальдо, даже если по этим счетам не было проводок. Применяется только в отчетах по проводкам.
• Только один из элементов – для ограничения выбора данных. Может иметь одно из двух значений: ‘счет в дебетовой части’ или ‘счет в кредитовой части’. Применяется только в отчетах по проводкам и оборотам.
• Только с ненулевыми оборотами – при установленном признаке в список отобранных данных попадут те счета, по которым за указанный период проводились проводки. Применяется только в отчетах по проводкам и оборотам.
• Не рассчитывать обороты – при установленном признаке для отчетов по проводкам отключается дополнительный расчет оборотов по счету. Применяется в отчетах по проводкам и оборотам.
• Не рассчитывать сальдо – при установленном признаке для отчетов по проводкам отключается дополнительный расчет сальдо. Применяется в отчетах по проводкам и оборотам.
• Ограничение на класс/тип объектов – для наложения ограничений на класс или тип объектов, которые будут отобраны для отчета.
• Группа счетов – для задания списка возможных значений атрибута ‘Счет’. Применяется в отчетах по проводкам и оборотам.
• Счет – для задания счета. Применяется в отчетах по проводкам и оборотам.
• Корр.счет – для задания корреспондирующего счета. Применяется в отчетах по проводкам и оборотам.
• Размерность – для задания размерности расчета оборотов. Применяется в отчетах по проводкам и оборотам.
• Параметр сортировки счета – для указания правила сортировки списка счетов. Применяется в отчетах по проводкам и оборотам.
• Не наследовать размерность  - при установленном признаке будет отключено правило наследования атрибута ‘Размерность’. Применяется в отчетах по проводкам и оборотам.
• Рассчитывать обороты для счетов родителей - при установленном признаке обороты рассчитываются также для всех родителей указанного счета. Применяется в отчетах по оборотам.
• Не выводить на экран – при установленном признаке результат отчета на экране не отображается и файл не удаляется.
• Не удалять файл отчета – при установленном признаке файл, содержащий результат отчета, не будет автоматически удален по окончании его просмотра.
• Строк на странице – для задания максимального количества строк на странице. Применяется только для отчетов по страницам.
• Число строк на последней странице (с итогом) – для задания количества строк на последней странице. Применяется только для отчетов по страницам.
• Тестировать время выполнения – при установленном признаке в специальный файл  записывается информация о времени выполнения отчета. Данный атрибут применяется для отладки отчетов.
• Статистика выполнения отчета – определяет имя файла, в котором будет накапливаться информация о запусках данного отчета. Данный атрибут применяется для отладки отчетов.
• Иконка – для назначения иконки пункту сценария, вызывающему данный отчет.
• Заголовок кнопки – для указания наименования кнопки, если вызов отчета расположен в разделе ‘Сценарий’.
• Действие, выполняемое перед выполнением отчета – для указания процедуры, запускаемой перед выполнением отчета.
• Действие, выполняемое после выполнения отчета – для указания процедуры, запускаемой после выполнения отчета.

Подробное описание и примеры использования перечисленных атрибутов приведены в книге ‘Отчеты’.