Alpha.Community

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

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

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

На текущий момент компонент Запрос значений множества сигналов AP работает только с историческими значениями.

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

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

Подробнее о свойствах и методах компонента Запрос значений множества сигналов AP.

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

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

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

  • Создать идентификаторы для сигналов Deviation.s_deviation4 и Level.s_level4 и подготовить таблицу для вывода исторических данных.

  • Указать перечень сигналов (Deviation.s_deviation4 и Level.s_level4), с которых требуется запросить данные.

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

  • Добавить кнопку запроса данных с источника, поставляющего исторические значения.

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

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

Создать идентификаторы для сигналов и подготовить таблицу для вывода исторических данных

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

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

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

  4. Добавьте компонент Запрос значений множества сигналов AP дочерним компоненту Таблица: модель данных. В свойстве Источник укажите ссылку на добавленный ранее объект типа Источник AР. Для этого правой кнопкой мыши нажмите по свойству Источник → Сослаться → ApSource_1.

  5. Добавьте компоненту Таблица дочерние компоненты Таблица: столбец для данных первого сигнала Deviation.s_deviation4 с идентификаторами:

    • value_1

    • quality_1

    • timestamp_1

      Аналогично, для данных второго сигнала Level.s_level4 добавьте столбцы с идентификаторами:

    • value_2

    • quality_2

    • timestamp_2

    Идентификаторы могут быть введены в свободной форме. На следующем шаге при заполнении свойства Список сигналов используйте выбранные идентификаторы при передаче JSON-структуры.

Указать список сигналов, с которых будут запрошены данные

Чтобы указать перечень сигналов (например, Deviation.s_deviation4 и Level.s_level4), с которых будут запрошены данные , настройте свойство Список сигналов для компонента Запрос значений множества сигналов AP. В свойстве введите JSON-структуру с указанием тегов сигналов на сервере, а также соответствующие идентификаторы (те идентификаторы, которые были введены на предыдущем этапе) столбцов, в которые будут записываться значения, качество и метки времени сигналов:

{
"items": [
{
ㅤㅤ"tag": "Deviation.s_deviation4",
ㅤㅤ"value": "value_1",
ㅤㅤ"quality":"quality_1",
ㅤㅤ"timestamp":"timestamp_1"
},
{
ㅤㅤ"tag": "Level.s_level4",
ㅤㅤ"value": "value_2",
ㅤㅤ"quality":"quality_2",
ㅤㅤ"timestamp":"timestamp_2"
}
ㅤㅤㅤㅤㅤㅤ]
}

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

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

Для указания начального значения 12.09.2023 введите формулу:

DateTime.Parse("12.09.2023")

Для указания конечного значения 15.09.2023 введите формулу:

DateTime.Parse("15.09.2023")

Добавить кнопку запроса данных с источника, поставляющего исторические значения.

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

Table_1.TableModel_1.ApMultiItemValueQuery_1.Reload(); //запрашиваем данные с источника
Table_1.TableModel_1.BeginReadAsync( ); //заполняем таблицу полученными данными