4.1.1.2.8.2.2. Запись данных в файл-срез
Для записи текущих значений сигналов из Astra.Server в файл-срез выполнить:
1. Подготовить шаблон файла-среза.
Шаблон файла-среза создается пользователем в формате .xml. Шаблон содержит теги сигналов (свойств сигналов), значения которых необходимо записать в файл-срез. Шаблон файла-среза сохраняется в папку, указанную пользователем в параметре модуля Каталог с шаблонами файлов-срезов.
2. Указать шаблон файла-среза.
Шаблон выбирается из папки, указанной в параметре модуля Каталог с шаблонами файлов-срезов. Имя выбранного для генерации шаблона файла-среза записывается в сигнал TemplateName ветки сигналов Generator.
3. Указать имя для генерируемого файла-среза.
Файл-срез именуется согласно записанному пользователем значению в сигнале OutFileName ветки сигналов Generator. Если заданное пользователем имя файла-среза совпадает с именем существующего файла-среза, то последний перезаписывается вновь сгенерированным файлом-срезом. Если имя файла-среза не указано пользователем, то при генерации файл-срез именуется в формате <имя шаблона без расширения> <дата генерации DD-MM-YYYY-HH-MM-SS>.xml.
4. Указать описание генерируемого файла-среза.
Описание к генерируемому файлу-срезу указывается в сигнале SnapShotDescription ветки Generator. При генерации файла-среза значение сигнала SnapShotDescription ветки Generator присваивается атрибуту Description элемента SnapShot.
5. Сгенерировать файл-срез.
Генерация файла-среза выполняется подачей команды Generate. При получении команды на генерацию файла-среза модуль SnapShot выполняет следующие действия:
загрузку указанного шаблона файла-среза;
проверку корректности формата шаблона файла-среза;
поиск сигналов в сервере ввода/вывода, указанных в шаблоне файла-среза.
При обнаружении несоответствия формата шаблона файла-среза формату XML выдается сообщение о несоответствии в журнал работы модуля и записывается в сигнал GenLastError ветки сигналов Generator.
При отсутствии сигналов, указанных в шаблоне файла-среза, в конфигурации сервера ввода/вывода формируется пустой файл-срез (значение сигнала GenSignalCount ветки Generator равно 0).
При наличии сигналов, указанных в шаблоне файла-среза, в файл-срез записываются текущие значения сигналов, выбранных согласно шаблону файла-среза. Сгенерированный файл-срез сохраняется в папку, указанную пользователем в настройках модуля SnapShot.
При генерации файла-среза атрибуту TemplateName элемента SnapShot присваивается имя шаблона, на основании которого был сгенерирован файл-срез.