Alpha.Community

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

События

StatusChanged

Изменение состояния процесса получения событий (оперативных или исторических) от источника.

Параметры

statusCode

UInt1

Код текущего состояния процесса запроса.

Значение Состояние Описание
0 Не определено Начальное состояние до инициализации запроса.
1 Ожидание Запрос поставлен в очередь, но выполнение еще не начато.
2 Подключение Установка соединения с источником данных.
3 Выполнение Процесс получения данных (чтение активных условий или загрузка истории).
4 Завершено Данные успешно получены и загружены в модель.
5 Ошибка В процессе запроса возникла ошибка.
message String Текстовое описание состояния или ошибка в текстовом виде.
data String

Дополнительные данные о прогрессе или результате в формате JSON.

Содержимое data зависит от значения statusCode.

  1. При выполнении (statusCode = 3)

    Используется для индикации процесса загрузки большого объема исторических событий.

    {
      "progress": 50
    }
  2. При завершении или ошибке (statusCode = 4 или 5)

    Содержит итоговые метрики или детальное описание проблемы

    {
      "result_code": 0,
      "metrics": {
        "row_count": 150,
        "exec_elapsed_ms": 450
      },
      "error_details": ""
    }
    Идентификатор Тип Описание
    result_code
    • 0 — Успешно;
    • 1 — Ошибка связи;
    • 2 — Ошибка фильтра.
    UInt1
    row_count Количество полученных событий (строк). UInt4
    exec_elapsed_ms Время, затраченное на запрос (мс). UInt4

OperativeBufferSizeExceeded

Количество строк (событий), накопленных в буфере компонента, превысило значение, установленное в свойстве Размер буфера оперативных событий.

Параметры

rowsCount UInt4 Текущее фактическое количество рядов в буфере на момент срабатывания события.

ClearFinished

Завершение работы функции Clear().

Параметры

result bool

Результат выполнения условия очистки.

  • true: в буфере осталось столько строк, сколько было указано в условии (condition), либо меньше.
  • false: фильтры очистки были применены, но в буфере всё еще больше строк, чем требовалось по условию.
rowsRemoved UInt4 Количество удаленных строк.
rowsCount UInt4 Текущее количество строк.

Примеры

Оставить в буфере не более 500 событий, удаляя для этого только квитированные (подтвержденные) алармы.

// Подготовка параметров
let clearParams = JSON.stringify({
    "filters": [{ "kind": "manual", "column": "ack", "value": true }],
    "condition": { "row_count": 500 }
});

// Запуск очистки
ApAlarmQuery_1.Clear(clearParams); 
  • Если в буфере было 800 строк и 400 из них квитированы: компонент удалит 300 строк. Останется 500. Событие ClearFinished вернет result: true.
  • Если в буфере было 800 строк и всего 50 квитированы: компонент удалит все 50 строк. Останется 750. Событие ClearFinished вернет result: false (так как 750 > 500).