Alpha.Community

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

Запрос событий

Чтобы запросить события с источника данных (например, с Alpha.Server), используйте компонент Запрос алармов. Компонент выполняет обращение к серверу через настроенный источник данных и возвращает события одного из трех типов.

Тип возвращаемых данных определяется значением свойства Режим работы:

  • Режим работы = 1 — список активных условий;
  • Режим работы = 2 — журнал оперативных событий;
  • Режим работы = 3 — журнал исторических событий.

Полученные данные могут быть выведены в таблицу в проекте Alpha.HMI. Пример настройки компонента во всех режимах работы см. в разделе Как настроить получение и отображение событий.

КомпонентЗапрос алармов расположен в юните AP Библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

Подробнее о свойствах и методах компонента см. в справочном руководстве.

Какие данные возвращает компонент

По каждому событию компонент Запрос алармов возвращает следующий набор полей.

Идентификатор Описание Название столбца по умолчанию (если не заполнять свойство Заголовок для компонента Таблица: столбец)
source Источник события (полный тег сигнала, изменение которого привело к генерации события). Источник
relative_tag Относительный тег источника события. Состоит из имени объекта (object_name) и той части полного тега источника события, которая находится после имени объекта. Относительный тег
object_id Идентификатор объекта на сервере, по которому было сгенерировано событие. ID объекта
object_name Имя объекта на сервере, по которому было сгенерировано событие. Имя объекта
area_path Тег родительского узла источника события. Зона
time Время генерации уведомления о событии. Время генерации
active_time Время перехода состояния события в активное. Время срабатывания
deactive_time Время, когда событие перешло из активного состояния в неактивное. Время деактивации
condition_deactive_time Время, когда условие было деактивировано (сгенерировано событие деактивации) Время деактивации условия
message Сообщение. Сообщение
severity Уровень важности события. Важность
condition_name Имя условия генерации события. Условие
subcondition_name Имя подусловия генерации события. Подусловие
quality Текущее качество сигнала, изменение которого привело к генерации события. Качество
value Значение сигнала, изменение которого привело к генерации события. Значение
ack Признак квитирования события. Квитировано
ack_required Требование квитирования. Квитировать
ack_time Время квитирования. Время квитирования
actor_id Идентификатор (логин) пользователя, выполнившего квитирование Пользователь
active Признак активности подусловия, по которому было сгенерировано событие. Активность
cookie Специальный идентификатор события, который имеет служебное назначение. Куки
sound Звуковой файл или группа звуковых файлов, воспроизводимых при выполнении подусловия генерации сообщения о событии. Звук

Используя указанные выше идентификаторы, вы можете обращаться к этим данным в проекте. Например, вывести их значения в визуальную таблицу на форме, используя компоненты Таблица: модель данных и Таблица из юнита Таблицы.

Чтобы юнит Таблицы появился в библиотеке компонентов, установите Alpha.HMI.Tables.

Как настроить получение и отображение событий(Демо-проект)

В данном примере (скачать его можно здесь) показано, как настроить и использовать компонент Запрос алармов во всех режимах работы:

  • Журнал оперативных событий (Свойство Режим работы = 2):
    • получение и отображение журнала оперативных событий в таблице;
    • настройка запроса активных событий при подключении к источнику;
    • автоматическое скрытие квитированных и деактивированных событий;
    • применение JSON-фильтра к оперативным событиям.
  • Журнал исторических событий (Свойство Режим работы = 3 ):
    • выполнение запроса исторических событий за заданный временной интервал;
    • применение JSON-фильтра к историческим данным;
    • настройка хронологии (типа временной сортировки) при загрузке.
  • Список активных условий (Свойство Режим работы = 1 ):
    • отображение в таблице только текущих активных условий

В результате будет подготовлена форма, на которой при нажатии на кнопку будут отображены данные того типа, который соответствует установленному режиму.

Убедитесь, что у вас уже настроено подключение к источнику данных, с которым вы планируете взаимодействовать. Для получения подробной информации о настройке и подключении источника данных обратитесь к разделу Подключение к источнику.

Запрос оперативных событий

Создание общей таблицы для вывода данных

Сначала создаётся таблица, которая будет использоваться для вывода данных во всех режимах работы компонента.

  1. Добавьте на экранную форму компонент Таблица.
  2. Добавьте компонент Таблица: модель данных дочерним элементом к компоненту Таблица.

  3. В редакторе свойств у объекта Таблица укажите ссылку на добавленный объект Таблица: модель данных. Для этого нажмите правой кнопкой мыши по свойству Модель данных → Сослаться → TableModel_1.

  4. Добавьте компонент Запрос алармов дочерним элементом к компоненту Таблица: модель данных.

Настройка столбцов таблицы

Добавьте компоненту Таблица дочерние компоненты Таблица: столбец с идентификаторами нужных столбцов. Например:

  • source — источник события;
  • time — время генерации;
  • message — сообщение о событии;
  • severity — уровень важности;
  • active — признак активности;
  • ack — признак квитирования.

Полный список доступных идентификаторов см. в разделе Какие данные возвращает компонент.

Настройка компонента для подключения к источнику

  1. В свойстве Источник компонента Запрос алармов укажите ссылку на компонент Источник AP. Для этого щелкните правой кнопкой мыши по свойству Источник → Сослаться → выберите ваш источник (например, ApSource_1).

  2. В свойстве Режим работы выберите режим 2 (Журнал оперативных событий).

  3. Установите true в свойстве Активность.

Добавление кнопки для запроса данных

  1. Добавьте на форму компонент Кнопка.
  2. В обработчике события ButtonPressed пропишите следующий код:

    Table_1.TableModel_1.Clear(); // Очищаем таблицу от предыдущих данных
    Table_1.TableModel_1.ApAlarmQuery_1.Reload(); // Запрашиваем данные с сервера
    Table_1.TableModel_1.BeginReadAsync(); // Заполняем таблицу полученными данными

В результате при нажатии на кнопку компонент запросит оперативные события с источника и отобразит их в таблице.

После выполнения Reload() в режиме Журнал оперативных событий компонент автоматически получает новые события от сервера по мере их возникновения. Таблица обновляется в реальном времени без необходимости повторного нажатия кнопки.

Настройка режима получения активных событий

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

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

Если установить значение false, таблица будет заполняться только новыми событиями, возникающими после подключения компонента к серверу.

Автоматическое удаление квитированных и деактивированных событий

Чтобы автоматически удалять события, которые одновременно деактивированы и квитированы, используйте автоматическую очистку. Для этого установите значение true в свойстве Удалять квитированные и деактивированные события.

В результате после выполнения запроса события, которые были одновременно квитированы И деактивированы, будут автоматически удалены из таблицы. В таблице будут отображаться:

  • Активные неквитированные события;
  • Активные квитированные события;
  • Неактивные неквитированные события.

Применение фильтров для оперативных событий

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

Столбцы, доступные для фильтрации:

  • severity — уровень важности;
  • message — текст сообщения;
  • source — источник события;
  • area_path — зона (тег родительского узла);
  • ack — признак квитирования;
  • ack_required — требование квитирования.

Для настройки фильтра:

  1. В редакторе свойств найдите свойство Фильтр в JSON-формате.
  2. Введите условие фильтрации в формате JSON. Например, для фильтрации событий с важностью больше 500:

    {
      ">": {
        "severity": 500
      }
    }

    При выполнении запроса в таблицу будут загружены только события с уровнем важности больше 500.

Запрос исторических событий

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

Для переключения в исторический режим в свойстве Режим работы компонента Запрос алармов выберите значение 3 (Журнал исторических событий).

Задание интервала времени

При работе в режиме Журнал исторических событий компонент может выполнять запрос за указанный временной диапазон. Диапазон задаётся свойствами:

  • Начало исторического интервала
  • Конец исторического интервала

В обработчике ButtonPressed кнопки Button_1 замените код на следующий:

Table_1.TableModel_1.Clear(); // Очищаем таблицу от предыдущих данных
// Задаём временной диапазон
DateStart: var = DateTime.Parse("10.02.2026 20:00:25");
DateEnd: var = DateTime.Parse("14.02.2026 21:17:25");
// Переводим время в UTC
Table_1.TableModel_1.ApAlarmQuery_1.HistoricalRangeStart = DateTime.ToUtc(DateStart);
Table_1.TableModel_1.ApAlarmQuery_1.HistoricalRangeEnd = DateTime.ToUtc(DateEnd);
// Выполняем запрос
Table_1.TableModel_1.ApAlarmQuery_1.Reload();
// Заполняем таблицу
Table_1.TableModel_1.BeginReadAsync();

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

Применение фильтров для исторических событий

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

Для настройки фильтра:

  1. В редакторе свойств найдите свойство Фильтр исторических данных в JSON-формате.
  2. Введите условие фильтрации в формате JSON. Например, для фильтрации событий с важностью меньше 500 и источником, содержащим строку Discrete:

    {
      "AND": [
        {
          "<": {
            "severity": 500
          }
        },
        {
          "source": "*Discrete*"
        }
      ]
    }

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

Выбор хронологии событий

Историческое событие содержит две временные метки:

  • время генерации уведомления сервером;
  • время фактического срабатывания условия.

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

Чтобы настроить хронологию:

  1. В компоненте Запрос алармов найдите свойство Хронология исторических событий.
  2. Установите одно из значений:
    • 0 — сортировка по времени генерации уведомления;
    • 1 — сортировка по времени срабатывания условия.

В результате после выполнения запроса исторические события в таблице будут отсортированы по выбранному типу времени с учётом заданного временного интервала и фильтра.

Отображение списка активных условий

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

Для переключения в режим списка активных условий в свойстве Режим работы компонента Запрос алармов выберите значение 1.

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

Очередь активных событий

События, получаемые с помощью компонента Запрос алармов в оперативном режиме, можно помещать в очередь с помощью компонента Очередь активных алармов.

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

Чтобы работать с элементами очереди событий, используйте API компонента Очередь активных алармов (описание свойств, функций и событий компонента см. в справочном руководстве).

Как создать очередь активных событий

Чтобы организовать очередь из всех активных событий, сгенерированных сервером:

  1. Добавьте компонент Очередь алармов на форму.
  2. Укажите источник событий для очереди - объект типа Запрос алармов в свойстве Запрос алармов.

    В проект уже должен быть добавлен объект типа Запрос алармов.

  3. Чтобы обновлять данные от источника, используйте функцию Reload.