Alpha.Community

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

Запись в файл-срез по индексам сигналов

При формировании файлов-срезов с большим объемом данных нагрузка на модуль увеличивается и скорость генерации файла-среза снижается. Для ускорения поиска сигналов в Alpha.Server и эффективной генерации файлов-срезов модуль Snapshot предоставляет возможность сохранять текущие значения сигналов в файл-срез не по тегам, а по индексам.

Использование индексов позволяет:

  • записывать и исключать сигналы из файла-среза группами;
  • создавать файл-срез, в котором будут присутствовать значения только тех сигналов, которые соответствуют требуемым критериям, например, относятся к одному технологическому узлу или принадлежат одному виду измеряемых величин.

Индексация сигналов

Индексацию дерева сигналов выполняет Alpha.DevStudio по заданному списку индексов. Для каждого индекса в списке необходимо указать:

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

Список индексов

Сформируйте список индексов в Alpha.DevStudio на основе пользовательских типов атрибутов.

Подробно о создании пользовательского типа атрибута описано в документации на Alpha.DevStudio (раздел Создание пользовательских атрибутов руководства пользователя).

Чтобы сформировать список индексов:

  1. Создайте пользовательский тип атрибута с типом значения string.

  2. Задайте имя пользовательского типа атрибута. Имя пользовательского типа атрибута одновременно будет являться названием индекса.
  3. Для созданного типа добавьте атрибуты:

    • Индекс для модуля SnapShot из пространства имен Om.Server.SnapShot. Этот атрибут используется для хранения значения индекса. Поле Значение не заполняется.
    • Свойство конфигурации из пространства имен Om.Server.Attributes. Этот атрибут используется для хранения номера пользовательского свойства. Номер выберите произвольный, но отличный от тех, которые уже используются в Alpha.Server.

  4. Назначьте индекс сигналу. Чтобы у сигнала Alpha.Server появился индекс:

    1. Выберите сигнал и во вкладке Атрибуты вызовите контекстное меню. Выберите пункт Добавить новые атрибуты.

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

    3. В качестве значения атрибута задайте значение индекса. Значением индекса может быть любая строка, в том числе пустая.

Уникальность и неуникальность индекса

Индексы могут быть:

  • Уникальными: одному значению индекса соответствует один сигнал.
  • Неуникальными: одному значению индекса соответствует несколько сигналов.

Alpha.DevStudio определяет уникальность индекса по количеству одинаковых значений пользовательского свойства: если значение пользовательского свойства уникально, то индекс является уникальным.

Для сигналов LU1.SW1.Signal1 и LU1.SW2.Signal2 определен индекс с названием Index_1 (пользовательский тип атрибута с именем Index_1) и номером пользовательского свойства конфигурации – 1500.

Если значение индекса Index_1 для этих сигналов имеет разное значение, то индекс уникален:

Если значение индекса Index_1 для обоих сигналов имеет одинаковое значение, то индекс неуникален:

Если индекс уникален, то для формирования файла-среза модуль Snapshot выбирает первый найденный в Alpha.Server сигнал с указанным индексом.

Если индекс неуникален, то в файл-срез попадают значения всех сигналов, соответствующих указанному значению индекса.

Шаблон файла-среза исходного формата с использованием индексов

Чтобы сформировать файл-срез по индексам сигналов, укажите названия индексов в шаблоне файла-среза вместо имен тегов. Если в шаблоне указаны индексы, то поиск сигналов выполняется по индексам с учётом их значений.

Шаблон, в котором теги сигналов для объектов LU1.SW1 и LU1.SW2 заменены на индексы.

<?xml version="1.0" encoding="UTF-8" ?>
<SnapShotTemplate Name="MyTemplate">
  <Data>
    <Signal Index_1="id369" />
    <Signal Index_1="id4752" />
    <Signal Tag="LU1.SW3.*" />
  </Data>
  <Exceptions>
    <Signal Index_2="4DEC7"/>
  </Exceptions>
</SnapShotTemplate>

 

Полученный файл-срез

Файл-срез, полученный по шаблону, в котором теги сигналов для объектов LU1.SW1 и LU1.SW2 заменены на индексы.

<?xml version="1.0" encoding="UTF-8" ?>
<SnapShot TimeStamp="29.10.2024 10:44:46" Description="" TemplateName="MyTemplate">
<Server Name="Alpha.Server" ConfigVersion="7346" ServerCompName="IVANOV"/>
<Data>
<!--Index_1: 'id369' Count: 5-->
<Signal Quality="28" Tag="LU1.SW3.Signal1" TimeStamp="29.10.2024 10:44:24" Value="2"/>
<Signal Quality="216" Tag="LU1.SW1.Signal3" TimeStamp="29.10.2024 10:44:24" Value="2.81"/>
<Signal Quality="216" Tag="LU1.SW1.Signal2" TimeStamp="29.10.2024 10:44:24" Value="2"/>
<Signal Quality="28" Tag="LU1.SW3.Signal2" TimeStamp="29.10.2024 10:44:24" Value="1"/>
<Signal Quality="216" Tag="LU1.SW1.Signal1" TimeStamp="29.10.2024 10:44:24" Value="3"/>
<!--Index_1: 'id4752' Count: 3-->
<Signal Quality="216" Tag="LU1.SW2.Signal3" TimeStamp="29.10.2024 10:44:24" Value="2.24"/>
<Signal Quality="216" Tag="LU1.SW2.Signal2" TimeStamp="29.10.2024 10:44:24" Value="1.15"/>
<Signal Quality="216" Tag="LU1.SW2.Signal1" TimeStamp="29.10.2024 10:44:24" Value="4.1"/>
</Data>
</SnapShot>