Вызов шаблона документа Предобработка данных с помощью программ
Мониторы поддерживают функцию генерации файлов документов (отчетов) формата 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 создается при генерации документа, для которого добавление в содержание разрешено. Файл сохраняется в той же папке, что и документ, и содержит гиперссылки на аналогичные документы.
В заголовок файла содержания выводится строка <имя файла 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. В этом случае для обработки таблицы используется программа, привязанная к аргументу с тем же порядковым номером.