Alpha.Community

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

Наполнение визуальной таблицы сообщениями об оперативных событиях (Демо-проект)

В данном примере (скачать его можно здесь) показано, как настроить получение оперативных событий с источника данных и отобразить их в визуальной таблице на форме. В примере показано, как:

  • Подготовить визуальную таблицу с двумя столбцами — время генерации события и текст сообщения.
  • Настроить получение оперативных событий с Alpha.Server по протоколу TCP.
  • Заполнить таблицу данными сразу после запуска проекта в рантайм.

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

Подготовка визуальной таблицы

  1. Добавьте на экранную форму объект типа Таблица и назовите его, например — Events. Объект Events будет использоваться как контейнер для остальных объектов, необходимых для построения таблицы: модели данных и столбцов.

  2. Чтобы у визуальной таблицы появилось два столбца, добавьте компоненту Events два дочерних объекта типа Таблица: столбец:

    • первый столбец назовите Time — в нём будет отображаться время генерации события;

    • второй столбец назовите Message — в нём будет отображаться текст сообщения о событии.

  3. Для каждого столбца задайте отображаемый пользователю заголовок — свойство Заголовок:

    • для столбца Time укажите заголовок Время генерации;

    • для столбца Message укажите заголовок Сообщение.

Название объекта (Time, Message) используется только внутри проекта для обращения к столбцу в структуре объекта и в скриптах, а заголовок (Время генерации, Сообщение) — это текст, который увидит пользователь в шапке таблицы на форме. Эти значения не обязаны совпадать.

Привязка визуальной таблицы и столбцов к модели данных

  1. Добавьте компоненту Events дочерний объект типа Таблица: модель данных и назовите его TableModelEvents. Модель данных — это источник данных для визуальной таблицы внутри проекта.

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

  3. Укажите каждому столбцу какое именно поле события в него подгружать. Данные о событии, которые возвращает сервер, состоят из набора именованных полей (например, time — время генерации, message — текст сообщения). Чтобы столбец Time отображал время генерации события, откройте свойства этого столбца и укажите в свойстве Идентификатор значение time. Аналогично, чтобы столбец Message отображал текст сообщения, укажите в его свойстве Идентификатор значение message.

Настройка источника данных

Добавьте в проект объект типа Источник AP. В свойствах объекта Источник AP укажите параметры связи с Alpha.Server: адрес сервера, порт и остальные параметры подключения по протоколу TCP.

Сам по себе компонент Источник AP только устанавливает соединение с сервером — он не запрашивает и не передаёт события в таблицу. Чтобы связать его с моделью данных, потребуется ещё один компонент — Запрос алармов, который настраивается в следующем шаге.

Настройка запроса оперативных событий

  1. Добавьте компоненту TableModelEvents дочерний объект типа Запрос алармов и назовите его QuerySource.
  2. Настройте компонент QuerySource:
    • В свойстве Источник компонента QuerySource укажите ссылку на объект ApSource_1. Для этого щелкните правой кнопкой мыши по свойству Источник → Сослаться → ApSource_1.

    • В свойстве Режим работы выберите значение 2 (Журнал оперативных событий).

    • Установите значение true в свойстве Активность.

Заполнение таблицы при запуске проекта

Чтобы таблица на форме заполнялась сообщениями о событиях сразу после запуска проекта в рантайм, пропишите следующий код в обработчике формы AboutToOpened, который выполняется перед открытием формы:

Events.TableModelEvents.Clear(); // Очищаем таблицу перед запросом
Events.TableModelEvents.QuerySource.Reload(); // Запрашиваем оперативные события с источника
Events.TableModelEvents.BeginReadAsync(); // Заполняем таблицу полученными данными

После выполнения Reload() компонент QuerySource не завершает работу, а остаётся активным и продолжает получать новые события от сервера по мере их возникновения. Поэтому при появлении нового события строка в таблице добавляется автоматически, без повторного вызова скрипта.