Перейти к основному содержимому

Отчёты

Отчёты создаются на основе шаблонов отчётов. На форме «Отчёты» пользователь видит доступные для работы отчёты, сгруппированные по разделам. Настройка прав доступа к отчётам выполняется на форме «Настройки» → «Безопасность» → «Роли».

Отчёт может быть создан:

  • Пользователем вручную нажатием кнопки «Сформировать».
  • Автоматически по событию или по расписанию в соответствии с настройками шаблона отчёта — в том числе с последующим пересчётом, рассылкой по почте и другими действиями, см. Правила отчётов.

Создание отчёта​

Для создания отчёта:

  • Перейдите на форму «Отчёты» из главного меню приложения.
  • Выберите дату начала отчёта и другие входные параметры, которые были определены в шаблоне отчёта.
  • Нажмите кнопку «Сформировать».
    • Если включена опция «Предпросмотр», то отчёт будет сформирован без сохранения в БД ТехноДок.
    • Если опция «Предпросмотр» отключена, то отчёт будет сформирован и сохранён в БД ТехноДок. Сохранённые отчёты будут в дальнейшем доступны для просмотра и редактирования на вкладке «Просмотр».

Создание отчёта

Создание отчёта

Экспорт без создания​

На форме формирования отчёта рядом с кнопкой «Сформировать» доступно вспомогательное меню (кнопка «…»), позволяющее выполнить действие с отчётом без его создания и сохранения в БД ТехноДок:

  • «Экспортировать в Excel/CSV/PDF/HTML/JSON» — отчёт формируется и сразу выгружается в файл выбранного формата.
  • «Печать» — отчёт формируется и сразу отправляется на печать.
  • «Отправить» — отчёт формируется и сразу отправляется по почте.

Это наиболее быстрый способ выгрузки данных, так как отчёт не создаётся и не отображается на экране. Например, выгрузка данных за сутки в Excel/CSV без создания выполняется значительно быстрее, чем формирование и последующий экспорт отчёта.

Примечание

В первую очередь экспорт без создания предназначен для очень больших отчётов (миллионы значений). Он позволяет в одно действие выгрузить такой отчёт в CSV или Excel без разметки наиболее оптимальным образом: данные сразу сохраняются в файл, минуя создание, отображение на экране и хранение отчёта в БД. Это снижает потребление оперативной памяти и время выгрузки, а ограничение «Максимальное количество шагов при экспорте» к этим форматам не применяется — выгружаются все строки.

Примечание

Состав доступных действий зависит от прав пользователя («Экспорт отчёта», «Печать отчёта», «Отправка отчёта по почте») и от того, настроен ли почтовый клиент.

Переформирование отчёта​

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

Для переформирования отчёта доступны следующие настройки:

  • «Сохранять ручные правки» — при выборе этой настройки будут сохранены все ручные правки отчёта с момента его формирования.
  • «Учитывать изменения шаблона» — активируйте эту настройку, чтобы применить самую новую версию шаблона отчётов.
  • «Перезагрузить значения из внешних источников» — активируйте эту настройку, чтобы заново загрузить данные из внешних источников.
  • «Переформировать за период» — активируйте эту настройку, чтобы переформировать сразу несколько отчётов за выбранный промежуток времени.
Примечание

ТехноДок хранит версии шаблонов сохранённых отчётов. Если в шаблон внесли изменения и переформировали отчёт без включённой настройки «Учитывать изменения шаблона», то отчёт будет переформирован на основании той версии шаблона, на которой он был сформирован, и последние изменения в переформированном отчёте не будут применены.

Возможные ошибки при создании отчёта​

Ошибки расчёта параметров​

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

Ошибка расчёта параметров отчёта

Ошибка расчёта параметров отчёта

В списке шаблонов на форме «Отчёты» шаблоны, последний расчёт которых завершился с ошибкой, отображаются с иконкой с восклицательным знаком.

Ошибка расчёта параметров отчёта

Ошибка расчёта параметров отчёта

Системные ошибки​

При формировании отчёта могут возникнуть системные ошибки. Эти ошибки могут быть связаны с ошибкой при формировании шаблона отчёта. В приведённом ниже случае при попытке формирования отчёта на экране отобразится сообщение об ошибке, отчёт не будет сформирован. Нажмите на кнопку сообщения «Подробнее», чтобы получить детальную информацию.

Ошибка создания отчёта

Ошибка создания отчёта

Просмотр отчёта​

Для просмотра содержимого сохранённых отчётов перейдите на вкладку «Просмотр».

  • При просмотре отчёта в панели инструментов сверху доступны кнопки, при помощи которых можно отправить отчёт на печать, экспортировать отчёт в Excel/PDF, переформировать отчёт и выполнить другие действия с отчётом.
  • В верхнем правом углу отображаются иконки пользователей, которые сейчас работают с отчётом.
  • Если в шаблоне для таблицы включено постраничное отображение, под таблицей отображается элемент навигации по страницам.

Просмотр отчётов

Просмотр отчётов

Журнал расчётов​

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

Открыть журнал можно двумя способами:

  • В режиме просмотра отчёта в выпадающем меню по кнопке «…» выберите пункт «Журнал расчётов».
  • Если при расчёте возникли ошибки, перейдите по ссылке «журнале расчётов отчёта» в панели с информацией об ошибках над отчётом — журнал откроется сразу с отбором по ошибкам расчёта.

Состав записей журнала определяется настройкой шаблона «Журнал расчётов»: в режиме «Только ошибки» сохраняются записи о значениях, рассчитанных с ошибкой, в режиме «Все значения» — записи обо всех рассчитанных значениях отчёта.

Группировка записей​

Записи журнала группируются одним из трёх способов, который выбирается в левом верхнем углу окна:

  • «По параметрам» — строка на каждый параметр отчёта: количество записей, количество ошибок, суммарная и максимальная длительность расчёта. Позволяет найти параметры, расчёт которых занимает больше всего времени.
  • «По меткам времени» — строка на каждую метку времени отчёта с теми же показателями. Позволяет увидеть, на каком шаге отчёта расчёт замедлился или возникли ошибки.
  • «Хронология расчёта» — параметры выстроены по времени расчёта в виде диаграммы: полоса каждого параметра начинается там, где закончилась полоса предыдущего. Наглядно показывает порядок расчёта параметров и вклад каждого из них в общее время формирования отчёта.

При выборе строки группы справа открывается таблица её записей: метка времени (или параметр), дата расчёта, длительность и статус значения. Ошибки расчёта вынесены под таблицу и пронумерованы — одна и та же ошибка обычно повторяется на нескольких записях, поэтому номер связывает запись с описанием ошибки. Для ошибки показываются тип исключения, текст и примерный номер строки в формуле параметра.

Отбор записей​

Записи журнала отбираются по условиям в верхней панели окна, все условия действуют совместно:

  • Название параметра — часть идентификатора параметра.
  • Интервал меток времени — включается кнопкой с изображением календаря.
  • Статус значения — например, «Ошибка расчёта» или «Изменено вручную».
  • Минимальная длительность расчёта в миллисекундах — оставляет только долгие расчёты.

Показатели в нижней части окна (количество значений, параметров, меток времени, ошибок и общее время расчёта) считаются по тем же условиям отбора, что и таблицы.

Экспорт журнала​

Записи журнала выгружаются в CSV или Excel по кнопке экспорта в верхней панели окна. Выгружаются записи, отобранные заданными условиями, со всеми полями: параметр, метка времени, дата расчёта, длительность, статус, тип исключения, текст ошибки и строка в формуле. Экспорт доступен пользователям с правом «Экспорт отчёта».

Примечание

Журнал несохранённого отчёта (созданного с включённой опцией «Предпросмотр») хранится во временном файле на сервере приложений и удаляется вместе с кэшем значений отчёта. Журнал сохранённого отчёта хранится в БД ТехноДок и удаляется вместе с отчётом.

Кроме того, записи журнала удаляются по истечении срока хранения — периодическая задача «Удаление журнала расчётов отчётов» раз в час удаляет записи, рассчитанные раньше этого срока. По умолчанию срок хранения равен 14 суткам и задаётся параметром CalculationsLogLiveTime секции Reports файла конфигурации. Сам отчёт, его значения и история изменений при этом не затрагиваются: у отчёта, рассчитанного раньше срока хранения, окно журнала расчётов покажет «Нет данных».

Экспорт отчёта​

Отчёт можно экспортировать в файл из панели инструментов в режиме просмотра отчёта. Доступны следующие форматы:

  • Excel — выгрузка отчёта в XLSX с сохранением разметки (внешнего вида) отчёта.
  • Excel (без разметки) — быстрая выгрузка табличных данных отчёта в XLSX без учёта разметки. Используется для быстрого экспорта больших объёмов данных.
  • PDF — выгрузка отчёта в PDF с сохранением разметки.
  • HTML — выгрузка отчёта в HTML.
  • CSV — выгрузка табличных данных отчёта в CSV.
  • JSON — выгрузка данных отчёта в JSON.

Особенности экспорта:

  • При экспорте в Excel числовые значения сохраняются с типом «число», что позволяет использовать их в формулах Excel.
  • Разделитель целой и дробной части числа берётся из региональных настроек операционной системы сервера приложений (например, запятая для локали ru-RU).
  • Количество выгружаемых строк при экспорте в PDF, HTML и XLSX (с разметкой) ограничено настройкой шаблона «Максимальное количество шагов при экспорте» (см. раздел Ограничения). На экспорт в CSV и в Excel без разметки это ограничение не распространяется — они всегда выгружают все строки отчёта, поэтому именно их следует использовать для выгрузки больших объёмов данных целиком.