Alpha.Community

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

Получение значений множества сигналов (оперативные и исторические значения)

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

Подписка на новые значения означает, что при появлении новых данных для указанных сигналов (например, LU1.SW1.Signal1 и LU1.SW2.Signal2) они автоматически добавляются в таблицу без необходимости повторного запроса. Подписка активируется при использовании режима "operative" в JSON-структуре параметров, передаваемой в метод Execute компонента Запрос значений сигналов AP. Параметр "operative_interval" в этой структуре определяет частоту обновления данных (в секундах).

Предзагрузка исторических данных включается с помощью параметра "preload_historical_data": true в той же JSON-структуре, передаваемой в метод Execute. При активации этого параметра компонент автоматически запрашивает исторические данные за заданный оперативный интервал времени и отображает их в таблице вместе с оперативными данными.

После вызова метода Execute компонент подготавливает данные для последующего чтения. Чтобы отобразить их в таблице, используйте метод BeginReadAsync, который запускает процесс чтения.

С помощью компонента Запрос значений сигналов AP можно получить значение, качество сигнала, метку времени и другие атрибуты, указанные в запросе. Полученные данные можно отобразить в визуальной таблице на форме с использованием компонентов Таблица: модель данных и Таблица из юнита Таблицы.

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

Как настроить запрос оперативных и исторических значений сигналов (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) использования компонента Запрос значений сигналов AP в проекте Alpha.HMI (проект сделан на языке JavaScript).

В примере показано, как:

  • Подготовить таблицу для отображения значений сигналов LU1.SW1.Signal1 и LU1.SW2.Signal2.

  • Настроить взаимодействие компонента Запрос значений сигналов AP с источником данных.
  • Получить оперативные данные с помощью кнопки Load Operative.
  • Получить исторические данные за 15 мая 2025 года с помощью кнопки Load Historical.

В результате будет подготовлена форма, на которой:

  • При нажатии кнопки Load Operative запрашиваются оперативные данные по сигналам LU1.SW1.Signal1 и LU1.SW2.Signal2. Значения, качество и метки времени этих сигналов загружаются и отображаются в таблице. Также активируется подписка на новые значения с интервалом обновления 69 секунд и включается предзагрузка исторических данных.
  • При нажатии кнопки Load Historical запрашиваются исторические данные за 15 мая 2025 года по сигналам LU1.SW1.Signal1 и LU1.SW2.Signal2. Значения, качество и метки времени этих сигналов загружаются и отображаются в таблице.

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

Подготовить таблицу для вывода данных

  1. Добавьте на экранную форму объект типа Таблица, чтобы иметь возможность помещать данные, полученные из источника, в таблицу.

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

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

  4. Добавьте компоненту Таблица дочерние компоненты Таблица: столбец для данных первого сигнала LU1.SW1.Signal1 с идентификаторами:
    • value_1
    • quality_1
    • timestamp_1

  5. Аналогично, для данных второго сигнала LU1.SW2.Signal2 добавьте столбцы с идентификаторами:
    • value_2
    • quality_2
    • timestamp_2

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

Настроить взаимодействие компонента Запрос значений сигналов AP с источником данных

  1. Добавьте компонент Запрос значений сигналов AP дочерним компоненту Таблица: модель данных.

  2. В свойстве Источник укажите ссылку на добавленный ранее объект типа Источник AP. Для этого нажмите правой кнопкой мыши по свойству Источник → Сослаться → ApSource_1.

Запросить оперативные данные

  1. Добавьте на форму компонент Кнопка и в свойстве Текст укажите Load Operative.
  2. В обработчике ButtonPressed для этой кнопки пропишите код, который вызывает метод Execute с JSON-структурой параметров для оперативного режима и заполняет таблицу полученными данными:

    Table_1.TableModel_1.Clear(); // Очистка таблицы перед новым запросом
    // JSON-структура для оперативного режима
    var params = {
      "mode": "operative", // Режим запроса: оперативные данные
      "operative_interval": 69, // Интервал обновления (в секундах)
      "preload_historical_data": true, // Предзагрузка исторических данных
      "columns": [
        {
          "id": "value_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "value"
          }
        },
        {
          "id": "quality_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "quality"
          }
        },
        {
          "id": "timestamp_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "timestamp"
          }
        },
        {
          "id": "value_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "value"
          }
        },
        {
          "id": "quality_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "quality"
          }
        },
        {
          "id": "timestamp_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "timestamp"
          }
        }
      ]
    };
    
    // Преобразование объекта запроса в строку JSON
    var requestJson = JSON.stringify(params);
    
    Table_1.TableModel_1.ApSourceValueQuery_1.Execute(requestJson); // Выполняем запрос оперативных данных
    Table_1.TableModel_1.BeginReadAsync(); // Заполняем таблицу полученными данными

Запросить исторические данные за 15 мая 2025 года

  1. Добавьте на форму компонент Кнопка и в свойстве Текст укажите Load Historical.
  2. В обработчике ButtonPressed для этой кнопки пропишите код, который вызывает метод Execute с JSON-структурой параметров для исторического режима и заполняет таблицу полученными данными:

    Table_1.TableModel_1.Clear(); // Очистка таблицы перед новым запросом
    // JSON-структура для исторического режима
    var params = {
      "mode": "historical", // Режим запроса: исторические данные
      "historical_range_start": {
        "timestamp": 133917408000000000 // Начало 15 мая 2025, 00:00:00
    
      },
      "historical_range_end": {
        "timestamp": 133918272000000000 // Конец 15 мая 2025, 23:59:59
       
      },
      "columns": [
        {
          "id": "value_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "value"
          }
        },
        {
          "id": "quality_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "quality"
          }
        },
        {
          "id": "timestamp_1",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW1.Signal1",
            "id": "timestamp"
          }
        },
        {
          "id": "value_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "value"
          }
        },
        {
          "id": "quality_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "quality"
          }
        },
        {
          "id": "timestamp_2",
          "type": "attribute",
          "parameters": {
            "tag": "LU1.SW2.Signal2",
            "id": "timestamp"
          }
        }
      ]
    };
    
    // Преобразование объекта запроса в строку JSON
    var requestJson = JSON.stringify(params);
    
    Table_1.TableModel_1.ApSourceValueQuery_1.Execute(requestJson); // Выполняем запрос исторических данных
    Table_1.TableModel_1.BeginReadAsync(); // Заполняем таблицу полученными данными