Alpha.Community

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

Получение значений одного сигнала

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

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

Подробнее о свойствах и методах компонента Запрос значений элемента АР.

Какие данные получает компонент

Компонент Запрос значений элемента АР получает значения свойств сигнала:

Идентификатор Описание Название столбца по умолчанию (если не заполнять свойство Заголовок для компонента Таблица: столбец)
value Значение сигнала Значение
quality Текущее качество сигнала Качество
timestamp Метка времени значения сигнала Метка времени
server_timestamp

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

Работает только в историческом режиме.

Метка времени сервера

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

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

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

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

  • Настроить взаимодействие компонента Запрос значений элемента АР с источником данных для получения оперативных и исторических значений сигнала.
  • Настроить вывод в таблицу значения сигнала, метки времени и качества сигнала.
  • Добавить кнопку запроса данных с источника, поставляющего оперативные или исторические значения.

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

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

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

  1. Добавьте на форму компонент Элемент AP, с которого компонент Запрос значений элемента АР будет запрашивать оперативные значения сигнала.

    Компонент Запрос значений элемента АР работает только с типом данных variant (т.е нетипизированным).

  2. В свойстве Источник укажите ссылку на компонент Источник AP, к дереву которого относится данный Элемент AP. Укажите путь до сигнала относительно корня Источника с помощью свойства Путь.

Настроить вывод в таблицу значения сигнала, метки времени и качества сигнала

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

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

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

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

    1. Активируйте компонент в свойстве Активность указав значение True.
    2. В свойстве Режим работы выберите 2 для получения оперативных значений:

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

    • value
    • quality
    • timestamp

Добавить кнопку запроса данных с источника

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

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