Редактор отчетов

Главное окно

Режим "Редактор отчетов" среды разработки активируется нажатием соответствующей кнопки в левом боковом меню.

Важно

Переключение в режим работы с отчетами возможно только при выборе лицензии Standard или Enterprise в проекте.

Важно

Для корректной работы генератора отчетов необходимо установить компонент Microsoft Edge WebView2 ( загрузить файл Evergreen Standalone Installer x64). Проверить наличие данного компонента в системе можно с помощью команды в PowerShell Get-Item "C:\Program Files (x86)\Microsoft\EdgeWebView\Application\*\msedgewebview2.exe"

Окно редактора включает в себя следующие функциональные области:

1. Список отчетов — перечень всех отчетов проекта. В данном окне доступна панель инструментов с кнопками:

➕ — создать новый отчет.
📁 — создать новый каталог.
❌ — удалить выбранный отчет или каталог.
🔳 — переименовать выбранный отчет или каталог.
⚙️ — открывает диалоговое окно "Свойство отчета". В выпадающем списке окна можно выбрать формат файла отчета: PDF, Excel 2007, Word 2007, HTML5, SVG, PowerPoint, XML или CSV.

2. Источники данных — перечень источников данных.

Источник данных (Data Source) - это структурное описание данных, используемых для построения отчета. Источник данных представляет собой программный компонент, который обеспечивает получение данных из базы данных, их преобразование и передачу в генератор отчетов. В сущности, "Источник данных" определяет способы, параметры и методы доступа к данным.

➕ — создать новый источник данных.
🔗 — открыть редактор ссылок.
❌ — удалить выбранный источник данных.
✏️ — редактировать выбранный источник данных.

3. Дерево проекта — перечень тегов проекта.

4. Рабочая зона отчета — рабочая область для редактирования визуальных элементов отчета.

5. Вкладки:

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

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

7. Панель форматирования — в зависимости от выбранного пункта меню предоставляет доступ к определенному набору инструментов.

Переменные в отчете

Создание переменной

Для добавления тега в отчет необходимо в окне "Дерево проекта" нажать правую кнопку мыши на теге и в контекстном меню выбрать пункт "Добавить переменную".

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

После этого переменная станет доступна в разделе "Переменные" словаря отчета.

Также запись о создании переменной появится в "Редакторе ссылок". Данная запись указывает на то, что в отчете есть переменная "Температура_1", которая связана с активным тегом проекта "Температура 1".

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

Для создания переменной отчета необходимо в меню "Словарь" нажать правой кнопкой мыши на пункт "Переменные" и в контекстном меню выбрать "Новая переменная".

В диалоговом окне "Новая переменная" указать имя и псевдоним.

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

Из списка выбрать созданную на предыдущем этапе переменную отчета "Температура_2" и нажать кнопку "Ок".

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

Редактирование и удаление

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

Для удаления переменной из отчета нужно удалить сначала ссылку на эту переменную.

Затем удалить саму переменную из словаря отчета.

Источники данных

Источник данных — это хранилище, из которого "Редактор отчетов" получает информацию для формирования отчета. Источником данных может быть сервер системы, база данных, текстовый файл, таблица Excel и другие. Источники данных можно разделить на две категории:

Источники, генерируемые сервером:
- Периодический
- По изменению
Другие источники данных, такие как текстовый файл, таблица Excel, база данных и т. д.

Периодический

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

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

Для создания источника необходимо нажать кнопку ➕ окна "Источники данных". В меню "Тип источника" выбрать пункт "Периодический".

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

В источник данных попадут все архивные данные за период, указанный в переменной начала и переменной конца. Переменная интервала определяет, на какие интервалы (в секундах) будут разбиты данные. Если значение переменной интервала равно 0, то будет использован весь период отчета, указанный в переменной начала и переменной конца. Если значение переменной интервала равно -1, то данные будут разбиты по месяцам.

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

Чтобы добавить тег к источнику необходимо нажать правой кнопкой мыши на требуемый тег в "Дереве проекта" и выбрать пункт "Добавить в источник".

Важно

Источник данных "Периодический" работает с архивными данными тега. Перед добавлением тега в источник необходимо убедиться, что для него актвирована архивация.

В диалоговом окне "Добавить колонку" указать имя, источник и тип обработки переменной:

Имя — имя, с которым переменная будет добавлена в источник.
Источник — позволяет выбрать источник данных, в который будет добавлена переменная.
Тип обработки:
- Первое значение — первое зафиксированное значение в отчетном интервале.
- Последнее значение — последнее зафиксированное значение в отчетном интервале.
- Потребление — интегральное (накопленное) значение за отчетный интервал.
- Минимум — минимальное значение в отчетном интервале.
- Максимум — максимальное значение в отчетном интервале.
- Среднее — средневзвешенное по времени значение за отчетный интервал.
- Количество включений — число переходов значения переменной из состояния "0" в состояние "≠0" в отчетном интервале.
- Количество выключений — число переходов значения переменной из состояния "≠0" в состояние "0" в отчетном интервале.
- Разность — алгебраическая разница между последним и первым значением в отчетном интервале.

После добавления переменной, в источнике данных появится новая колонка.

Также в меню "Ссылки" будет добавлена новая ссылка.

По изменению

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

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

Для создания источника необходимо нажать кнопку ➕ окна "Источники данных. В меню "Тип источника" выбрать пункт "По изменению".

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

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

Чтобы добавить тег к источнику необходимо нажать правой кнопкой мыши на требуемый тег в "Дереве проекта" и выбрать пункт "Добавить в источник".

Важно

Источник данных "По изменению" работает с архивными данными тега. Перед добавлением тега в источник необходимо убедиться, что для него актвирована архивация.

В диалоговом окне "Добавить колонку" указать имя и источник переменной.

После добавления переменной, в источнике данных появится новая колонка.

Также в меню "Ссылки" будет добавлена новая ссылка.

Редактирование и удаление источника

Изменить параметры ранее созданных источников данных можно с помощью кнопки ✏️ или двойного нажатия левой кнопки мыши на источнике.

Для удаления требуется выбрать источник в списке и нажать кнопку ❌. После удаления источника в словаре отчета останутся переменные начала, конца и интервала, с которыми он был связан. Если эти переменные больше не требуются, их можно выделить и удалить.