Copyright: © 2003 НКТ Индастриз
Citation: Настоящий документ не может передаваться третьей стороне без предварительного письменного разрешения компании НКТ


Введение

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


Структура шаблонов
Структура шаблонов отчетов

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


Внутренние переменные
Внутренние переменные отчетов

 Внутренние переменные отчетов используются для вывода фиксированных и изменяющихся данных. Названия всех переменных начинается с префикса "#". На настоящий момент в отчетах доступны следующие общие переменные для вывода фиксированных данных:

#DT1	дата начала периода формирования отчета
#DT2	дата окончания периода формирования отчета
#Title	заголовок отчета
#DTReport	текущая дата(дата формирования отчета)
#DateCaption	строка вида 'за период с DT1 по DT2'
#Emitent	номер и название эмитента системы
#UserName	имя текущего пользователя в системе
#SummaryDataInfo1..12	дополнительная итоговая информация по отчету(комментарии, примечание)

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

  Названия переменных для вывода изменяющихся данных образуются из названия набора данных, используемого  для формирования отчета, и, далее через точку, названия поля в наборе данных, например - #DS.EmitentName". Переменные для вывода изменяющихся данных могут использоваться совместно со стандартными функциями отчетов и функциями MS Excel.


Стандартные функции
Стандартные функции отчетов

  Стандартные функции предназначены для обработки данных при группировке и подведении итогов. Названия функций, также как и переменных, начинается с префикса "#". Доступны следующие пять агрегатных функций, которые аналогичны соответствующим функциям MS Excel.Результат функций вычисляется на основе значений поля, указанного в качестве аргумента.

#SUM(FieldName)	сумма значений
#AVERAGE(FieldName)	среднее арифметическое
#MAX(FieldName)	максимальное значение
#MIN(FieldName)	минимальное значение
#COUNT(FieldName)	общее количество значений

      где FieldName - имя поля из набора данных без префикса.

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


Возможности редактирования
Возможности редактирования шаблонов

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

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

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