Формирование файла маппинга

Модуль «Обвязка для тренажера» формирует файл соответствий (mapping) между объектами проекта АСУ и каналами тренажера.

Что нужно подготовить

Библиотека (Templates/)

Папка с Excel-файлами. Каждый файл описывает типовые каналы тренажера для одного набора типов объектов.

AssignmentMap.xlsx

Таблица назначений: для каких типов объектов и шаблонов тренажера какой файл библиотеки использовать.

LinkTemplate.xlsx

Шаблон строки результата: ячейки с переменными [Tag], [SimChannel] и др.

После прогона Uniplant Atomix в указанной папке появляется итоговый файл (например mapping.xlsx) — по одной строке на каждую связь «объект проекта — канал тренажера».

Шаг 1. Подготовить библиотеку шаблонов

Библиотека — папка с Excel-файлами (.xls / .xlsx). Каждый файл описывает типовые каналы тренажера для одного набора объектов.

Что сделать:

1. Создайте папку (или выберите существующую).
2. Создайте в ней Excel-файлы. Имя файла без расширения будет использоваться в AssignmentMap (колонка AssignSim).
3. В каждом файле создайте таблицу с колонками. Колонки библиотеки — это и есть переменные, доступные в LinkTemplate, поэтому все файлы библиотеки должны иметь одинаковый набор колонок. Типичный набор:

Колонка	Описание
ObjectType	Тип объекта АСУ (как в проекте)
FieldTag	Тег поля
ModuleTag	Тег модуля
ModuleId	Идентификатор модуля
SimChannel	Канал симулятора
SimTemplate	Шаблон симулятора
UnimodChannel	Канал Unimod

Добавляйте любые другие нужные колонки — они тоже станут переменными в LinkTemplate.

Note

Временные файлы Excel (имена начинаются с ~$) модуль игнорирует.

Шаг 2. Подготовить файл AssignmentMap

AssignmentMap — один Excel-файл с одним листом. Он указывает модулю: для какого типа объекта и каких шаблонов брать какой файл из библиотеки.

Что сделать:

1. Создайте Excel-файл с одним листом.
2. Первая строка — заголовки:

Колонка	Описание
ObjectType	Тип объекта АСУ
AssignSim	Имя файла из библиотеки без расширения
Template, Template1, Template2, …	Шаблоны тренажера (все колонки, начинающиеся с Template)

3. Заполните строки. Пример:

ObjectType	AssignSim	Template	Template1
Насос	UnimodChannels	OutAnalog	OutDiscrete
Задвижка	Сигналы	OutDiscrete

Строка «Насос» означает: использовать файл UnimodChannels.xlsx для экземпляров типа «Насос» с шаблоном OutAnalog или OutDiscrete.

Caution

В файле должен быть ровно один лист. Если листов несколько — модуль выдаст ошибку.

Шаг 3. Подготовить шаблон результата (LinkTemplate)

LinkTemplate — Excel-файл, задающий вид одной строки итогового отчёта.

Что сделать:

1. Создайте Excel-файл. Используется только первый лист.
2. Первая строка — заголовки (без переменных): скопируется в результат один раз.
3. Следующие строки — с переменными в ячейках. Форматы переменных:
   • [ИмяПеременной] — например [Tag], [SimChannel]
   • %ИмяПеременной% — например %ObjectType%

Каждая строка с переменными повторится в результате столько раз, сколько связей найдено.

Доступные переменные:

Переменная	Что подставляется
Tag	Мнемоника экземпляра
ObjectType	Тип объекта
SimChannel	Канал симулятора
SimTemplate	Шаблон симулятора
UnimodChannel	Канал Unimod

Дополнительно доступны любые другие колонки из файлов библиотеки (FieldTag, ModuleTag, ModuleId и др.).

Шаг 4. Настроить модуль и запустить

После подготовки файлов:

1. В проекте Uniplant Atomix добавьте внешний модуль «Обвязка для тренажера».
2. Укажите пути к папке библиотеки, файлам AssignmentMap и LinkTemplate, а также папку и имя файла результата.
3. Запустите прогон Uniplant Atomix.

Подробнее о настройке и запуске — в разделе Настройка модуля Uniplant Atomix.

← К тренажёру

Связанные разделы

• Хаб Альфа + ТРЕЙ
• АСПСиПТ
• АСУТП/АСУЭ