Генерация файлов документов

  Вызов шаблона документа

  Файл index.html

  Предобработка данных с помощью программ

Мониторы поддерживают функцию генерации файлов документов (отчетов) формата HTML (см. Генерация документов (отчетов) ). Сгенерированный файл имеет имя <имя канала вызова>.html.

Для разработки шаблонов документов в ИС встроен соответствующий редактор (см. Редактор шаблонов документов (отчетов) ).

Для входа в редактор аргументов шаблона документа используется команда Аргументы (меню Вид).

Вызов шаблона документа

Для вызова шаблона документа (генерации файла) используется канал CALL с типом вызова (3) Document(Report) (см. Канал класса CALL и Атрибуты канала класса CALL ). Файл отчета генерируется при присвоении такому каналу ненулевого значения, при этом биты этого значения, установленные в 1, задают следующие опции:

   бит 0 (0x1) – вывод на принтер;

   бит 1 (0x2) – публикация на web-сервере (см. TRACE MODE Data Center );

   бит 4 (0x10) – отображение жирных кривых (3 px) на трендах.

После отработки значение канала автоматически сбрасывается в 0.

Биты атрибута Параметр канала CALL.Document задают параметры генерации:

   Бит0=0 и Бит1=0 – при многократной генерации новое содержимое добавляется в существующий файл в виде секции. Файл не добавляется в содержание (файл index.html). Заголовок секции содержит дату и время генерации, если одновременно бит 3 реального значения и бит 3 атрибута Параметр равны 0;

   Бит0=1 – разрешение добавления файла в содержание;

   Бит1=1 – разрешение перезаписи файла;

   Бит4=1 – задание сохранения файла в папке, путь к которой задан атрибутом 80, COMMNT; если Бит4=0, файл сохраняется в папке узла;

   Бит5=1 – задание вывода документа на принтер;

Сгенерированный документ передается по заданному направлению только в том случае, если предварительно запущен соответствующий модуль ( сервер печати TRACE MODE 6 или TRACE MODE Data Center ), и использование этого модуля разрешено.

   Бит6=1 – разрешение использования сервера печати (см. Сервер печати TRACE MODE 6 );

   Бит7=1 – разрешение использования Data Center.

В атрибут 87, CC канала CALL.Document записывается время (в миллисекундах), затраченное на генерацию отчета (см. Атрибуты каналов, отображаемые профайлером ). Пока документ генерируется, в атрибуте 87 хранится время начала генерации. В атрибут 92, I2 записывается код ошибки (см. Коды диагностируемых ошибок ).

Значение байта 1 (0xFF00) атрибута 2, In или значение атрибута 1, A канала задает категорию документа (этот параметр может использоваться для конфигурирования дерева публикатора).

Файл index.html

Файл index.html создается при генерации документа, для которого добавление в содержание разрешено. Файл сохраняется в той же папке, что и документ, и содержит гиперссылки на аналогичные документы.

В заголовок файла содержания выводится строка <имя файла prj>_<ordinal> (см. Файлы узла, создаваемые при экспорте ).

Текст гиперссылки на документ в файле содержания соответствует титулу документа (см. Задание свойств документа ).

Предобработка данных с помощью программ

Если к каналу CALL.Document привязан атрибут 0, R канала CALL.Program, программа отрабатывается перед генерацией документа.

Если к каналу CALL.Document привязан атрибут 39, EXEC канала CALL.Program, и документ содержит архивную таблицу (см. Конфигурирование таблицы архивных значений ), программа отрабатывается после извлечения каждого архивного среза. Для отображения результатов обработки срезов в столбец архивной таблицы нужно поместить выражение <arg>.R, где arg – имя аргумента документа, в который передается результат программы. Передача данных между документом и программой конфигурируется с помощью привязок соответствующих аргументов каналов CALL.Document и CALL.Program.

Если документ содержит несколько архивных таблиц, то их данные могут быть обработаны с помощью разных программ – для этого к каналу CALL.Document нужно привязать атрибут 39, EXEC канала CALL.AsyncCollection, к аргументам которого привязаны каналы CALL.Program. В этом случае для обработки таблицы используется программа, привязанная к аргументу с тем же порядковым номером.