Шаблон отчетов Excel#
Для создания отчетов в формате Excel используются специальные файлы шаблонов.
Шаблон – это файл программы Excel в формате xls содержащий специальную разметку для размещения данных программы IngortechSCADA.
Для создания отчетов можно использовать готовые шаблоны, поставляемые с ПО, либо редактировать или создавать собственные, необходимые для выполнения текущих задач.
Исходное формирование и основные настройки шаблонов едины для всех видов отчетов выгружаемых из программ ПО IngortechSCADA.
Предупреждение
Шаблон может быть создан в любой версии Excel, но итоговый файл должен быть сохранен в формате xls.
В комплект поставки ПО включены шаблоны для всех отчетов, создаваемых всеми программами комплекса.
Настройка ленты Excel#
Для задания областей в шаблоне используется функция Excel указания имени для области таблицы. Что использовать эту функцию необходимо убедиться, что на ленте Excel в закладке Формулы есть кнопка Диспетчер имен.
Если кнопки Диспетчер имен на панели настроек нет, нужно произвести настройку, для чего выбрать и в появившемся диалоге выбрать на обеих панелях Основные вкладки.
В левом окне выбрать раздел Формулы, выделить вкладку Определенные имена, добавить в правое окно и нажать ОК.
После этой настройки на ленте появиться кнопка Диспетчер имен.
Заполнение шаблона#
Данные в ячейках шаблона имеют различное назначение в зависимости от формата текста, используемого в ячейке.
Текстовая область
Оформление отчета созданное пользователем и не изменяемое программой, создающей отчет.
Область загрузки данных
В ячейках с этим форматом будут размещены значения из баз данных программы, создающей отчет.
Область специальных значений
В ячейках с этим форматом будут размещены специальные данные отчета.
Области отчета
Для работы отчета необходимо создать области, которые будут обрабатываться программой, создающей отчет.
Ячейки в специальных форматах будут обрабатываться только в этих областях.
- Область всего шаблона:
Эта область должна включать в себя все ячейки, содержащие текст в формате «загрузки данных» и «специальных значений».
- Область загрузки данных:
Для каждой базы данных, которую имеет программа создающая отчет и данные которой должны быть выгружены, необходимо создать отдельную область.
Информация
На каждой странице шаблона может быть только одна область шаблона, но количество областей для загрузки данных не ограничено.
Предупреждение
Ячейки, содержащие текст специального формата, но не включенные ни в одну область шаблона обработаны не будут.
Содержимое ячеек шаблона за пределами выделенных областей не обрабатывается и будет выведено в результирующий отчет в том виде, в котором оно описано в шаблоне.
Каждая область загрузки данных должны быть полностью включена в область шаблона.
Если на одном листе выделено несколько областей для загрузки данных, то эти области не должны пересекаться. В противном случае данные отчета могут не соответствовать формату шаблона.
Текстовая область#
Часть шаблона, где содержимое ячеек Excel заполнено обычным текстом или цифрами без использования специального формата, принятого в ПО IngortechSCADA для создания шаблонов.
Данные ячеек этой области не будут обрабатываться программой и при формировании отчета или печати останутся неизменными.
Текстовая область используется для создания оформления отчета:
наименование таблиц,
названия колонок и прочей информации.
Область «Загрузка данных» – заполнение#
Часть шаблона, которая при выгрузке отчетов будет заполнена значениями из базы данных.
Область загрузки будет повторяться в итоговом файле столько раз, сколько записей в базе данных для которой она описана.
В этой области можно использовать специальный формат записи для подстановки значений в базы данных.
##<база>##<поле>
- <база>:
Номер базы данных, который задается в именованном диапазоне при настройке таблицы шаблона.
- <поле>:
Номер поля (столбца) базы данных, значение которого будут подставлены в текущую ячейку. Номер поля должен начинаться с единицы.
Предупреждение
Каждому <полю> записи в области загрузки данных присвоен свой определенный номер, который приведен в описании каждого вида шаблонов.
Вместо номера поля можно использовать специальные имена:
- <Index>:
Порядковый номер записи базы данных, начинающийся с единицы. Максимальное значение порядкового номера соответствует общему количеству записей в базе данных.
Шаблон может содержать как все данные отражаемые в программе, так и только те, которые значимы для конкретного отчета.
Если необходимо использовать в отчете только часть данных, то при заполнении ячеек области загрузки данных им присваивается определенный номер, который приведен в документации каждого отчета отдельно.
Область «Специальных значений» – заполнение#
Шаблон может содержать специальные значения, которых не относятся к какой-либо базе данных, но их можно использовать в шаблоне для заполнения ячейки специальным значением в момент создания отчета.
Для использования специальных значений нужно использовать следующий формат:
#.<Имя>
Существует набор стандартных имен, которые можно использовать в любом отчете.
Имя |
Описание |
Формат в отчете |
Формат ячейки в Excel |
|---|---|---|---|
|
текущая дата создания отчета |
dd-mm-yyy |
Дата |
|
текущее время создания отчета |
hh:nn:ss |
Время |
|
текущие дата и время создания отчета |
dd-mm-yyy hh:nn:ss |
Дата и время |
|
количество записей в соответствующей базе |
число |
общий |
Кроме стандартных, каждый отчет может использовать собственные специальные значения, которые описаны в документации ПО, создающего отчет.
Задание имен областей шаблона#
После создания формы заполнения областей шаблона необходимо провести настройку – задать именованные области, данные которых будут обрабатываться при формировании отчета.
При формировании шаблона в файле состоящем из одной таблицы находящейся на одном листе необходимо задать имена:
Создание именной области диапазона всего шаблона, включая текстовую область и область загрузки данных.
Создания отдельной именной области загрузки данных.
Для задания именной области шаблона используется функция Диспетчер имен.
Предупреждение
При задании имени для «Области загрузки данных» в окне настройки Excel «Область» необходимо указывать тот Лист, на котором описаны поля базы данных.
Область всего шаблона#
Действие |
Скриншот |
|---|---|
Выделить область всего шаблона, включая текстовую область и область загрузки данных. Допустимо выделение дополнительных пустых строк и столбцов – это не повлияет на итоговый вид отчета. |
|
Нажать кнопку Если кнопки нет, её нужно настроить. |
|
Выбрать закладку |
|
Задать имя __MAIN__, который определяет общий диапазон таблицы и будет обрабатываться из шаблона. Нажать |
|
В окне отобразится запись созданной именной области для всего диапазона шаблона. Нажать |
|
Далее необходимо создать область загрузки данных.
Область загрузки данных#
Действие |
Скриншот |
|---|---|
Выделить область, которая при выгрузке отчетов будет заполнена значениями из базы данных. Допустимо выделение дополнительных пустых строк и столбцов – это не повлияет на итоговый вид отчета. |
|
Нажать кнопку Если кнопки нет, её нужно настроить. |
|
Выбрать закладку При этом в окне отображается ранее созданная область всей формы шаблона. |
|
Задать имя __1__ для первой базы данных. Нажать |
|
В окне отобразились записи созданные для именной области всего диапазона шаблона и первой базы данных.
|
|
На последнем этапе работы с шаблоном, необходимо сохранить файл в папку, из которой в дальнейшем будет извлекаться шаблон для экспорта отчетов.
При использовании вышеописанного шаблона, при выгрузке в Excel получается следующий отчет:
Красной рамкой выделена именная область всего шаблона (все текстовые записи остались неизменными, в ячейку с именем специального значения DateTime выгрузились время и дата создания отчета).
Синей рамкой выделена именная область базы данных, которая, при формировании отчета заполнилась значениями переменных из базы данных.
Предупреждение
Для создания некоторых видов отчетов, например отчетов ОБОРУДОВАНИЯ, нельзя создать отдельные шаблоны, их можно только редактировать, так как шаблоны поставляются в комплекте ПО и автоматически загружаются при выборе команды на создание отчета.