Table of Contents

Оглавление

3.4.4 Описание модели EventLists.xls — назначение базовых типов узлам дерева IOS

3.4.4.1 Назначение модели EventLists.xls

Файл EventLists.xls является конфигурационной моделью, используемой для назначения базовых типов и установки значений атрибутов узлам в дереве IOS (Information Object Server) проекта alpha.DevStudio.

Этот файл обрабатывается внешним модулем системы AutomiqAutomation, который запускается после завершения генерации объектов ПЛК и создания представлений на уровне IOS. Его задача — автоматизировать ручную настройку, обеспечивая единообразие оформления и корректное отображение данных в журналах событий.

🔗 Расположение:
JSC\USR\PRJ\Conf\EventLists\EventLists.xls

⚡ Быстрый доступ:
Файл можно быстро открыть через утилиту Selector (см. рис. 1).

Рис. 1. Быстрый доступ к EventLists.xls через Selector
Рис. 1. Быстрый доступ к EventLists.xls через Selector

> > *Рис. 1. Быстрый доступ к EventLists.xls через Selector*

⚠️ Важно: Модуль должен запускаться после генерации объектов ПЛК и создания представлений в DevStudio.

3.4.4.2 Структура файла

Файл содержит один или несколько листов, каждый из которых соответствует имени конкретного ПЛК.

  • Имя листа: Совпадает с opt.plcName из листа PlcOptions модели ПЛК.
  • Содержимое листа: Список узлов дерева IOS, для которых необходимо:
    • назначить базовый тип (VS:dsType),
    • установить значения атрибутов (arr:attr).

3.4.4.3 Ключевые столбцы

Столбец Описание
path Полный путь к узлу в дереве IOS (например, root.P0_72_140.JF_CA_1001.Zone_1.Room_101).
VS:dsType Путь к базовому типу в библиотеке DevStudio, который должен быть назначен узлу.
arr:attr Имя атрибута узла, которому должно быть присвоено значение. Если ячейка пустая — атрибут не обрабатывается.
@ Комментарии, игнорируемые системой.

3.4.4.4 Базовые типы для узлов дерева IOS

Для организации структуры дерева IOS и обеспечения корректного логирования используются специальные базовые типы:

Базовый тип Назначение
BaseAttr_RootBrunch Используется для корневой ветви дерева IOS, которую необходимо логировать, и которая не имеет ветвей в качестве родителя.
BaseAttr_Brunch Используется для дочерних ветвей дерева IOS, которые необходимо логировать.

💡 Пример:

  • root → BaseAttr_RootBrunch
  • root.P0_72_140 → BaseAttr_Brunch
  • root.P0_72_140.JF_CA_1001 → BaseAttr_Brunch

3.4.4.5 Принцип работы модуля

Модуль выполняет следующие действия:

  1. Обход строк: Для каждой строки с d:

    • Находит узел в дереве IOS по пути path.
    • Назначает ему базовый тип из столбца VS:dsType.
    • Устанавливает значения атрибутов из столбцов arr:attr.

  2. Рекурсивная сборка строки описания:

    • При логировании сработки сигналов, система рекурсивно собирает строку из атрибутов unit.System.Attributes.Description, начиная с корня дерева и двигаясь к целевому узлу.
    • Эта строка отображается в журнале событий.
    • Пример строки: АСПСиПТ.P0-72-140.JF-CA-1001.ЗКПС 1.Помещение 101.

  3. Формирование полного описания события:

    • К собранной строке добавляется атрибут Description объекта внутри узла, рассчитываемый по формуле:

      @(object:unit.Attributes.DevParams.SystemTag). @(object:unit.System.Attributes.Title)

    • Затем добавляется атрибут Description логируемого канала (параметра).

    • Итоговая строка в журнале событий:

      АСПСиПТ.P0-72-140.JF-CA-1001.ЗКПС 1.Помещение 101.P0-72-120-FA-BTH-016.Извещатель дымовой.Неисправность

  4. Пример использования:

    path VS:dsType arr:attr @
    root BaseAttr_RootBrunch АСПСиПТ
    root.P0_72_140 BaseAttr_Brunch P0-72-140
    root.P0_72_140.JF_CA_1001 BaseAttr_Brunch JF-CA-1001
    root.P0_72_140.JF_CA_1001.Zone_1 BaseAttr_Brunch ЗКПС 1
    root.P0_72_140.JF_CA_1001.Zone_1.Room_101 BaseAttr_Brunch Помещение 101

3.4.4.6 Ключевая задача: оперативное изменение описаний

Одной из ключевых задач модуля является возможность быстрого изменения описаний узлов в кратчайшие сроки.

Это особенно важно в условиях:

  • неопределенности с требованиями к виду логируемого сообщения,
  • частых изменений в структуре объектов или их номенклатуре,
  • необходимости согласования формата сообщений с заказчиком на поздних стадиях проекта.

✅ Преимущество: Вместо ручного редактирования сотен узлов в DevStudio, достаточно внести изменения в EventLists.xls и перезапустить модуль. Это позволяет:

  • За несколько минут обновить всю структуру описаний,
  • Быстро протестировать и согласовать формат сообщений,
  • Минимизировать риски ошибок при ручной настройке.

3.4.4.7 Преимущества использования

Задача Решение
Единообразие названий Все узлы имеют согласованные имена.
Автоматизация настройки Исключает ручное редактирование сотен узлов.
Удобство чтения журналов Собранная строка позволяет быстро определить местоположение события.
Интеграция с документацией Описания можно взять из КД или S6.
Гибкость и адаптивность Быстрое изменение описаний при изменении требований.

3.4.4.8 Вывод

Модель EventLists.xls — это ключевой компонент для подготовки проекта DevStudio к эксплуатации. Она позволяет:

  • Автоматизировать назначение базовых типов и атрибутов,
  • Обеспечить единообразие и читаемость дерева IOS,
  • Создать понятные и информативные записи в журналах событий.

Использование этого модуля является обязательным этапом при разработке проектов АСПСиПТ.