Alpha.Community

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

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

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

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

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

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

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

if (SW_1.Mode.Index == 0)
ㅤ TextEdit_1.Text = "Включен режим 1";
else
ㅤ TextEdit_1.Text = "Включен режим 2";

Поставщик входных данных

InputRowsetProvider

Ссылка на поставщика данных, предоставляющего записи для выполнения агрегации.

Текст запроса

string Query

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

Формат JSON-запроса:

{
  "aggregate": [
    {
      "unacked_priority_1": {
        "count": {
          "condition": {
            "AND": [
              { "NOT": "acked" },
              { "==": { "severity": 1 } }
            ]
          }
        }
      }
    },
    {
      "unacked_priority_2": {
        "count": {
          "condition": {}
        }
      }
    }
  ],
  "condition": {
    ">=": { "active_time": "now - 12h" }
  }
}
  • aggregate — начало блока описания агрегаций.
  • unacked_priority_1, unacked_priority_2 — идентификаторы (имена) условий для выполнения агрегации.
  • count — агрегирующая функция для подсчёта записей.
  • condition — блок условий для фильтрации данных.

Вложенные условия могут использовать логические операторы, такие как AND, NOT, OR, а также операторы сравнения: ==, !=, >, <, >=, <=.

Примеры

Выполнить JSON-запрос для подсчёта необработанных событий с приоритетом 1 за последние 12 часов.

{
  "aggregate": [
    {
      "unacked_priority_1": {
        "count": {
          "condition": {
            "AND": [
              { "NOT": "acked" },
              { "==": { "severity": 1 } }
            ]
          }
        }
      }
    }
  ],
  "condition": {
    ">=": { "active_time": "now - 12h" }
  }
}

В этом случае запрос подсчитает количество событий с приоритетом 1, которые не были подтверждены, за последние 12 часов.

Интервал уведомлений

uint4 NotificationInterval

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

Примеры

Установить интервал уведомлений равным 1000.

DataAggregator_1.NotificationInterval = 1000;

В этом случае событие OnDataChanged будет срабатывать не чаще одного раза в секунду (1000 миллисекунд).

Интервал уведомлений фильтра

uint4 FilterUpdateInterval

Интервал обновления фильтра (в миллисекундах) для условий, которые изменяются со временем (динамические условия). Примеры динамических условий:

  • ">=": {"active_time": "now - 12h"}
  • "<=": {"time": "d - 12h"}
  • ">=": {"ack_time": "mo – 12d"}
  • ">=": {"deactive_time": "y – 2mo"}

Примеры

Установить интервал обновления фильтра равным 5000

DataAggregator_1.FilterUpdateInterval = 5000;

В этом случае фильтр с динамическим условием будет обновляться каждые 5 секунд (5000 миллисекунд).