Создание, сохранение и загрузка шаблонов

Для создания нового шаблона надо выполнить команду Создать из меню Файл или нажать ЛК на соответствующей иконке основной инструментальной панели. При этом рабочее поле редактора очищается и становится доступным для создания нового шаблона.

Создаваемому шаблону присваивается имя Безымянный. При его первом сохранении на экран выводится диалог выбора файла. В нем можно изменить имя шаблона и указать каталог сохранения.

Для сохранения шаблона надо выполнить команду Сохранить из меню Файл или нажать ЛК на соответствующей иконке инструментальной панели. Для сохранения шаблона под другим именем следует выполнить команду Сохранить как из меню Файл.

Чтобы загрузить шаблон в редактор, нужно выполнить команду Открыть из меню Файл или нажать ЛК на соответствующей иконке инструментальной панели. При этом на экран выводится диалог выбора файла. Указанный в нем шаблон загружается в редактор.

Подключение шаблона к проекту

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

Чтобы вставить в документ команды запроса этой информации, надо связать шаблон с проектом, для которого подготавливается данный документ.

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

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

Структура файла шаблона

Файл шаблона представляет собой HTML-документ. Однако, помимо стандартных функций, заложенных в HTML, шаблон может содержать команды форматирования и запроса данных у мониторов реального времени. Существует три типа таких команд:

• команды, задающие общие параметры шаблона (путь к проекту TRACE MODE, интервал обновления);

• команды, определяющие пользовательские функции (общие для всего документа);

• команды, управляющие форматированием отдельных HTML-элементов шаблона.

Команды первых двух типов размещаются в заголовке документа HTML внутри тега <HEAD>. Ниже приведен пример записи этих команд.

<HEAD>

<TITLE>Пример отчета</TITLE>

...

<!--$TM DOC PRJ="D:\\TM5\\TEST.CTM" REFRESH=5-->

<!--$TM VAR NAME=»Входной канал» VALUE=CHAN("input_chan",0,"NODE1")-->

<!--$TM VAR NAME=»Значение входа» VALUE=GETVAL(@»Входной канал»)-->

...

</HEAD>

Символы <!-- и --> обозначают начало и конец комментария языка HTML. Комментарии, содержащие команды для сервера документирования, начинаются с символов $TM. Далее следует слово, определяющее тип команды:

• DOC – информация о документе,

• VAR – определение пользовательской функции.

Далее следуют пары ИМЯ = ЗНАЧЕНИЕ, где значением может быть любое выражение в синтаксисе сервера документирования.

Чтобы исключить появление в тексте команд-символов -->, которые обозначают конец комментария, приняты следующие правила кодирования:

• Символ ‘<’ записывается как ‘<’

• Символ ‘>’ записывается как ‘>’

• Символ ‘&’ записывается как ‘&’

Команды управления форматированием отдельных HTML-элементов шаблона находятся в теле документа HTML (внутри тега <BODY>). Они располагаются внутри того элемента, к которому относятся. Обычно эти команды вставляются сразу за стартовым тегом элемента. Ниже приведен пример команды, вставляющей в текст документа значение канала.

<BODY>

...

<P>

ЗНАЧЕНИЕ КАНАЛА:

<SPAN>

<!--$TM ELT VALUE=@»Значение входа» STYLE.COLOR=»red»-->

</SPAN>

</P>

...

Команды этого типа имеют ту же структуру, что и у первых двух. После символов открытия комментария записывается идентификатор команды ТРЕЙС МОУД ($TM), затем – тип команды ELT (информация об отдельном элементе). Далее может следовать произвольное число пар ИМЯ=ЗНАЧЕНИЕ. Каждая из них задает ту или иную характеристику элемента. Например, VALUE= задает текст HTML, который будет подставлен вместо содержимого элемента, ATTR.XXX= позволяет задать значение произвольного атрибута, а STYLE.XXX= - стиля элемента.