В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 26)
-
Лицензирование Альфа платформы
-
Ключи Guardant
-
Ключи Sentinel
-
-
Правила брандмауэра
-
Настройка DCOM
-
Работа в ОС Linux
-
Alpha.Server 6.5 (ред. 2. Предварительная)
-
Alpha.Server
-
Основные механизмы
-
Приложения
-
Модули
-
Коммуникационные модули
-
Link
-
TCP Сервер
-
-
Modbus
-
Modbus RTU Опросчик
-
Настройка обмена данными со станцией
-
Modbus RTU Станция
-
Modbus TCP Опросчик
-
Modbus TCP Станция
-
-
OPC
-
OPC AE Сервер
-
Функциональные возможности
-
OPC DA
-
OPC DA Клиент
-
OPC DA Сервер
-
-
OPC HDA
-
OPC HDA Клиент
-
OPC HDA Сервер
-
-
OPC UA
-
OPC UA Клиент
-
Настройка обмена данными с OPC UA сервером
-
Установка безопасного соединения
-
Приложения
-
OPC UA Сервер
-
Сертификаты
-
Приложения
-
-
-
МЭК 60870-5
-
МЭК 60870-5-101 Опросчик
-
Приложения
-
МЭК 60870-5-101 Станция
-
МЭК 60870-5-104 Опросчик
-
МЭК 60870-5-104 Станция
-
-
Универсальный модуль Опросчик (Меркурий, DCON)
-
МЭК 61850 Клиент
-
Обмен данными с устройствами
-
Набор данных устройства и сигналы сервера
-
ПОРТАЛ Клиент
-
Настройка обмена данными с ППД
-
ТЭМ-104
-
Приложения
-
BACnet Клиент
-
Настройка обмена данными с устройством
-
Приложения
-
EtherNet/IP Сканер
-
Приложения
-
FINS Клиент
-
Настройка обмена данными с ПЛК
-
MDLC Клиент
-
Настройка обмена данными с устройством MDLC
-
MQTT Клиент
-
Настройка обмена данными
-
Siemens S7 Клиент
-
Настройка обмена данными с ПЛК
-
Приложения
-
SNMP Менеджер
-
SQL Клиент
-
Настройка обмена данными с источником
-
Приложения
-
UNET Клиент
-
-
Служебные модули
-
Клиент безопасности
-
Получение значений из Alpha.Security
-
Модуль вычислений
-
Модуль истории
-
Приложения
-
Подсистема резервирования
-
Data Buffer
-
NetDiag, NetDiag2
-
Приложения
-
ProcessMonitor
-
SMTP
-
Snapshot
-
Запись данных в файл-срез
-
Модули Syslog
-
Syslog Клиент
-
Syslog Сервер
-
Приложения
-
Приложения
-
-
Write VQT
-
FS Generator
-
-
-
Сервисные приложения
-
Конфигуратор
-
Статистика
-
Просмотрщик лога кадров
-
-
Alpha.AccessPoint 6.5 (ред. 2. Предварительная)
-
Alpha.Imitator 6.5 (ред. 2. Предварительная)
-
Приложения
-
Alpha.Historian 4.0 (ред. 3. Предварительная)
-
Устройство и принципы работы
-
Управление базами данных
-
Общие
-
4x
-
3x
-
-
Устаревшие разделы
-
Справочник
-
Настройки базы данных
-
Alpha.Domain 1.5 (ред. 1)
-
Принципы настройки подсистемы
-
Приложения
-
Alpha.DevStudio 4.2 (ред. 4. Предварительная)
-
Руководство пользователя
-
Знакомство с Alpha.DevStudio
-
Разработка проекта
-
Описание домена
-
Добавление компонентов домена
-
-
Добавление объектов
-
Описание объектов
-
Добавление атрибутов
-
-
Пользовательский интерфейс
-
Инструменты
-
Редакторы
-
-
Интерфейс командной строки
-
Справочник
-
Элементы
-
Автоматизация
-
ВНИИАЭС
-
Карты адресов
-
Коммуникационные модули
-
-
Гидроуклон
-
Служебные модули
-
-
Инконтрол
-
Инконтрол
-
-
Контроллеры Modicon
-
Modbus
-
Контроллеры
-
-
Контроллеры OMRON
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры REGUL
-
Modbus
-
OPC
-
Контроллеры
-
МЭК 60870-5
-
-
Контроллеры SIMATIC
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Контроллеры ТРЭИ
-
Modbus
-
Карты адресов
-
Коммуникационные модули
-
Контроллеры
-
-
Обобщенные устройства
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Общие элементы
-
Последовательная шина
-
Устройства
-
-
Программируемые логические контроллеры
-
Modbus
-
OPC
-
Контроллеры
-
-
Развёртывание
-
Компьютеры
-
Устройства
-
-
Связи
-
Ссылки
-
-
Сервер истории
-
Сети BACnet
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети CANopen
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети EtherNet/IP
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети Ethernet
-
Сети KNX
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
Устройства
-
-
Сети Link
-
Link
-
Карты адресов
-
-
Сети MDLC
-
Карты адресов
-
Коммуникационные модули
-
Настройки по умолчанию
-
-
Сети MQTT
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Modbus
-
Modbus
-
Карты адресов
-
-
Сети NFL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети OPC
-
OPC
-
Карты адресов
-
-
Сети SMTP
-
Карты адресов
-
Служебные модули
-
-
Сети SNMP
-
Карты адресов
-
-
Сети SQL
-
Карты адресов
-
Коммуникационные модули
-
-
Сети Syslog
-
Карты адресов
-
Служебные модули
-
-
Сети МЭК 60870-5
-
Карты адресов
-
МЭК 60870-5
-
-
Сети МЭК 61850
-
Карты адресов
-
Устройства
-
-
ТПТС-НТ
-
Инконтрол
-
Контроллеры
-
-
Теплосчетчики ТЭМ
-
Карты адресов
-
Коммуникационные модули
-
Устройства
-
-
Уровень управления
-
Вычисления
-
-
Файловый обмен
-
Физический уровень
-
Элементы HMI
-
Элементы сервера
-
Карты адресов
-
Коммуникационные модули
-
Коммуникационные модули\Link
-
Коммуникационные модули\Modbus
-
Коммуникационные модули\OPC
-
Коммуникационные модули\МЭК 60870-5
-
Настройки по умолчанию
-
Служебные модули
-
-
-
Атрибуты
-
Om.BACnet
-
Om.CANopen
-
Om.EtherNetIP
-
Om.GenericDevices
-
Om.HMI
-
Om.Hydroslope
-
Om.IEC60870
-
Om.KNX
-
Om.MDLC
-
Om.MQTT
-
Om.OPC
-
Om.PLC
-
Om.Server
-
Om.System
-
-
-
Alpha.Security 1.7 (ред. 18)
-
LDAP-сервер и его настройка
-
Редактирование конфигурации на LDAP-сервере с помощью SecurityConfigurator
-
Приложения
-
Alpha.Om 1.4 (ред. 6. Предварительная)
-
Функции
-
Математические функции
-
Строковые функции
-
Функции обработки времени
-
Функции типа variant
-
-
Приложения
-
Alpha.HMI 2.0 (ред. 31. Предварительная)
-
Руководство пользователя
-
О продукте
-
Основные этапы работы с проектом
-
Запуск дизайнера
-
Запуск на исполнение
-
-
Разработка мнемосхем
-
Экранные формы
-
Компоненты
-
Графические примитивы
-
Готовые компоненты
-
-
Действия с объектами и экранными формами
-
Просмотр характеристик
-
Свойства объектов
-
Свойства в рантайме
-
Обработчики событий
-
Функции объектов
-
-
Заливка градиентом
-
Демонстрационный проект Резервуарный парк
-
-
Источники данных
-
OPC DA
-
TCP
-
Получение событий
-
-
Взаимодействие с окружением проекта
-
Приложения
-
Справочное руководство
-
Компоненты для работы с данными
-
Источник OPC
-
Элемент OPC
-
Источник AP
-
Элемент AP
-
Учетные данные АР
-
Браузер источника АР
-
Запрос алармов
-
Менеджер алармов
-
Запрос значений элемента AP
-
Запрос значений множества сигналов АР
-
Запрос значений сигналов АР
-
Очередь активных алармов
-
-
Компоненты окружения
-
Окружение: архиватор
-
Окружение: группа окон
-
Окружение: окно
-
Окружение: сеть
-
Окружение: файлы
-
Окружение: ошибка работы с файлами
-
Окружение: система
-
Окружение: запрос системного журнала
-
Окружение: браузер файлов
-
Окружение: процесс
-
Окружение: этот процесс
-
Окружение: переменные среды процесса
-
Текстовый файл
-
Оборудование: клавиатура
-
Оборудование: монитор
-
Снимок экрана
-
-
Компоненты для предоставления сервисных функций
-
Статистика: браузер
-
Статистика: JSON-браузер
-
Статистика: узел
-
Статистика: источник данных
-
-
Данные: агрегатор
-
Компоненты печати
-
Печать
-
Принтер
-
Системные принтеры
-
Размеры страницы
-
-
Компоненты для выполнения SQL-запросов
-
Источник SQL
-
Запрос источника SQL
-
Запрос SQL
-
-
Компоненты разметки
-
Линейная разметка
-
Плоская разметка
-
Вес элемента разметки
-
Ограничение размеров элемента разметки
-
Сворачивание элемента разметки
-
Выравнивание элемента разметки
-
Отступы элемента разметки
-
-
Графические компоненты
-
Линейный градиент
-
Радиальный градиент
-
Соединительная линия
-
Место соединения
-
Линия
-
Кривая линия
-
Прямоугольник
-
Эллипс
-
Изображение
-
Точка трансформации
-
-
Компоненты для построения пользовательского интерфейса
-
Индикатор гистограммы
-
Всплывающая подсказка
-
Уведомление
-
Перемещение
-
Кнопка
-
Курсор
-
Глобальный курсор
-
Полоса прокрутки
-
Панель вкладок
-
Системная кнопка
-
Флажок
-
Текст
-
Расширенный текст
-
Поле ввода
-
Редактор текста
-
Индикатор прогресса
-
Ползунок
-
Выпадающий список
-
Фрейм
-
-
Встраиваемые компоненты
-
Alpha.Alarms
-
Свойства
-
Функции
-
События
-
-
Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
-
Компоненты для проверки ввода и преобразования форматов
-
Входной формат
-
Выходной формат
-
Формат булевского значения
-
Формат даты/времени
-
Формат числа с плавающей запятой
-
Проверка ввода
-
Проверка ввода целого числа
-
Проверка ввода беззнакового целого числа
-
Проверка ввода числа с плавающей запятой
-
Проверка ввода регулярного выражения
-
-
Компоненты периодичного выполнения
-
Таймер
-
Мигание
-
Команда
-
Звук
-
Инициализатор
-
Сессия
-
-
Буфер обмена
-
Веб содержимое
-
Компоненты для работы с графиками
-
График: данные
-
График: декоратор линии
-
График: линия
-
График: ось
-
График: поле графика
-
График: реперная линия
-
График: точка пересечения
-
График: экспорт
-
-
Компоненты для формирования древовидной структуры
-
Дерево
-
Источник данных дерева
-
Колонка дерева
-
-
Экранные формы
-
Средство отладки
-
Менеджер проекта
-
Среда исполнения
-
-
Alpha.HMI.WebViewer 2.0 (ред. 31. Предварительная)
-
О продукте
-
-
Alpha.HMI - дополнительные модули
-
Alpha.HMI.Security 2.0 (ред. 15)
-
Руководство пользователя
-
Справочное руководство
-
Контекст безопасности (SecurityContext)
-
Список пользователей (UserList)
-
Настройка безопасности: Контроль целостности (SecurityIntegrityControl)
-
Числовой элемент безопасности (NumericTokenProxy)
-
Строковый элемент безопасности (StringTokenProxy)
-
Булевский элемент безопасности (BoolTokenProxy)
-
Настройка безопасности: Менеджер (SecurityManager)
-
Настройка безопасности: Приложение (SecurityManagerApplication)
-
Настройка безопасности: Пользователь (SecurityManagerUser)
-
Настройка безопасности: Группа (SecurityManagerGroup)
-
Мастер конфигурирования Security (Configurator)
-
Информация лицензирования: Получение (LicenseInfo)
-
-
-
Alpha.HMI.Tables 2.1 (ред. 1)
-
Построение таблицы модели данных
-
Справочник API
-
Таблицы
-
Таблица
-
Свойства
-
Функции
-
События
-
-
Таблица: декоратор
-
Свойства
-
-
Таблица: итератор
-
Свойства
-
Функции
-
-
Таблица: модель данных
-
Свойства
-
Функции
-
События
-
-
Таблица: столбец
-
Свойства
-
Функции
-
События
-
-
Таблица: устойчивый итератор
-
Функции
-
-
-
-
-
Alpha.HMI - библиотеки
-
Alpha.HMI.CommonLib 3.0 (ред. 2)
-
Руководство пользователя
-
Примеры использования компонентов расширения
-
Справочное руководство
-
Типы
-
Тема оформления
-
Конвертер значений
-
Утилиты для работы со строками
-
Утилиты для работы с окном
-
Утилиты для работы с файлами
-
Информация о продукте
-
Буфер аргументов события
-
Обработчик события
-
Пользовательская команда
-
Текстовые шаблоны
-
Редакторы
-
Редактор целого числа
-
Редактор даты
-
Редактор времени
-
Редактор интервала времени
-
Горизонтальный сплиттер
-
Вертикальный сплиттер
-
Рамка с ошибкой
-
Редактор даты и времени
-
-
Меню
-
Элемент меню
-
Результат выбора меню
-
-
Панель инструментов
-
Кнопка панели инструментов
-
Кнопка выпадающего списка
-
Разделитель панели инструментов
-
Панель поиска
-
Тема оформления панели инструментов
-
-
Строка статуса
-
Кнопка авторизации
-
Кнопка-индикатор журнала сообщений
-
Индикатор подключения к серверу
-
Кнопка вызова экранной клавиатуры
-
Параметры вызова экранной клавиатуры
-
-
Диалоги
-
Результат выбора папки
-
Результат выбора цвета
-
Результат выбора параметров подключения
-
Результат выбора даты и времени
-
Результат ввода значения
-
Результат редактирования колонтитула
-
Результат выбора файла
-
Результат диалога авторизации
-
Список файлов
-
Дерево сигналов
-
Журнал сообщений
-
Редактируемая таблица
-
Редактор ячейки таблицы
-
-
Экранные формы
-
Меню
-
Календарь
-
Сообщение
-
Диалог ввода значения
-
Диалог выбора цвета
-
Диалог подключения к серверу
-
Редактор колонтитула
-
Файлы
-
Диалог открытия файла
-
Диалог сохранения файла
-
Диалог выбора папки
-
-
Безопасность
-
Диалог авторизации пользователя
-
Диалог смены пароля
-
Диалог ввода учетных данных
-
-
Общие свойства компонентов библиотеки
-
-
-
-
Alpha.HMI - приложения
-
Alpha.HMI.AdminConsole 1.0 (ред. 3)
-
Руководство пользователя
-
Справочное руководство
-
Консоль администрирования
-
Инструментальная панель
-
Разрешения
-
AdminConsole_Page
-
-
-
Alpha.HMI.Alarms 3.3 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Привлечение внимания к важным событиям
-
Квитирование событий
-
Экспорт сообщений в файл
-
Справочное руководство
-
Alarms
-
Свойства
-
Функции
-
-
Alarms_Table
-
Свойства
-
Функции
-
-
Alarms_Sounds
-
Свойства
-
Функции
-
-
EventStatistics
-
Свойства
-
-
Разрешения пользователя
-
Свойства
-
Функции
-
-
-
-
Alpha.HMI.ComtradeViewer 1.1 (ред. 1)
-
Встраивание в проект
-
API
-
ComtradeViewer
-
Свойства
-
Функции
-
-
Разрешения (ComtradeViewer_Permissions)
-
Свойства
-
-
-
Alpha.HMI.Explorer 4.0 (ред. 2)
-
Руководство пользователя
-
Справочное руководство
-
Explorer_Form
-
-
Alpha.HMI.IntegrityControl 2.8 (ред. 1)
-
Руководство пользователя
-
Контроль целостности
-
Справочное руководство
-
IntegrityControl
-
IntegrityConfiguration
-
Разрешения
-
Настройки
-
IntegrityControl_KTN
-
IntegrityControl_Form
-
IntegrityConfiguration_Form
-
-
-
Alpha.HMI.SecurityConfigurator 4.0 (ред. 1)
-
Руководство пользователя
-
Редактирование конфигурации
-
Приложения
-
Справочное руководство
-
SecurityConfigurator
-
Настройки
-
Разрешения
-
SecurityConfigurator_Page
-
SecurityConfigurator_Form
-
-
-
Alpha.HMI.SetPoints 2.5 (ред. 2)
-
Руководство пользователя
-
Приложения
-
Справочное руководство
-
SetPoints
-
SetPoints_Settings
-
Разрешения
-
Тема оформления Уставок
-
SetPoints_Page
-
SetPoints_Form
-
-
-
Alpha.HMI.Statistics 1.2 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
Statistics
-
Разрешения
-
Настройки
-
Statistics_Form
-
-
-
Alpha.HMI.SystemLogViewer 2.0 (ред. 1)
-
Руководство пользователя
-
Справочное руководство
-
SystemLogViewer
-
Разрешения
-
Тема оформления Журнала событий
-
SystemLogViewer_Form
-
-
-
Alpha.HMI.Trends 2.4 (ред. 1. Предварительная)
-
Руководство пользователя
-
Встраивание в проект
-
Сохранение и загрузка данных
-
Справочное руководство
-
Свойства
-
Функции
-
-
-
-
Alpha.Alarms 3.30 (ред. 1)
-
Варианты запуска
-
Начало работы
-
Аспекты безопасности
-
Просмотр оперативных событий
-
Подавление и блокирование событий источника/объекта
-
Аналитика событий
-
Фильтрация сообщений о событиях
-
Дополнительные возможности
-
Работа со встраиваемым компонентом
-
Alarms-API
-
Свойства
-
Функции
-
События
-
-
-
Alpha.Trends 3.33 (ред. 3. Предварительная)
-
Начало работы
-
Просмотр значений сигналов
-
Аналитика графиков
-
Использование реперных линий
-
Вертикальные реперы
-
-
Вспомогательные функции
-
Работа со встраиваемым компонентом Alpha.Trends
-
Свойства
-
Функции
-
События
-
-
Alpha.Tools 1.6 (ред. 8)
-
EventLogViewer
-
Приложения
-
OpcExplorer
-
Настройка и подключение к источнику данных
-
Просмотр адресного пространства
-
Приложения
-
-
Alpha.RMap 1.7 (ред. 2)
-
Приложения
-
Установка и настройка
-
-
Alpha.Diagnostics 2.2
-
Alpha.AuditReport
-
Настройка Alpha.AuditReport
-
Alpha.SystemMonitor
-
Интерфейс
-
Настройка
-
Alpha.Hashcheck
-
Настройка конфигурации
-
Alpha.NTPClient
-
Alpha.Utilities
-
Приложения
-
Alpha.Reports 1.1 (ред. 18)
-
Руководство администратора
-
Приложения
-
Конфигуратор
-
Конструктор отчётов
-
Описание интерфейса и функций программы
-
Приложения
-
Поддерживаемые функции
-
Текстовые
-
Числовые
-
Математические
-
Информационные
-
Логические
-
Поиск и ссылки
-
Дата и время
-
База данных
-
Финансовые
-
-
-
Библиотека
-
Функции библиотеки
-
Приложения
-
Просмотр отчётов
-
-
Alpha.SmartControl 9.3 (ред. 1)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Свойства
Отображаемое имя
Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.
Кардинальное число
Преобразует объект в массив и задает размер массива (количество элементов в массиве).
Значение
| 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";
Источник
Сервер, поставляющий оперативные и исторические события. Указывается в виде ссылки на объект типа Источник AP, существующий в проекте.
Режим работы
uint1 Mode
Устанавливает режим работы компонента в зависимости от вида запрашиваемых событий.
Значение
| 1 | Список активных условий. |
| 2 | Журнал оперативных событий. |
| 3 | Журнал исторических событий. |
Начало исторического интервала, Конец исторического интервала
Свойство используется только при запросе исторических данных (когда в свойстве Режим работы указано значение 3).
timestamp HistoricalRangeStart
timestamp HistoricalRangeEnd
Начальное и конечное значение интервала запроса исторических данных от источника. Перед указанием значения переведите ваше строковое значение даты в метку времени формата uint8, а затем полученное значение переведите в формат UTC. Для перевода вы можете использовать функции Parse и ToUtc языка Alpha.Om.
Начальной или конечной точкой интервала запроса может быть 0. Это значит, что данные будут запрошены за бесконечный интервал в прошлом.
Пример
Запросить исторические события с 22.07.2022 20:00:25 по 25.07.2022 21:17:25.
DateStart: uint8 = DateTime.Pars ("22.07.2022 20:00:25");
DateEnd: uint8 = DateTime.Parse ("25.07.2022 21:17:25");
Events.TableModelEvents.QuerySource1.HistoricalRangeStart = DateTime.ToUtc(DateStart);
Events.TableModelEvents.QuerySource1.HistoricalRangeEnd = DateTime.ToUtc(DateEnd);
Events.TableModelEvents.QuerySource1.Reload();
Events.TableModelEvents.BeginReadAsync();
Фильтр в JSON-формате
string Filter
Условия фильтрации запрашиваемых от источника (сервера, генерирующего события) оперативных данных. Задаются в виде строки - объекта JSON.
Фильтрация возможна только для столбцов c идентификаторами (переменными): severity, message, source, area, acked.
Условие фильтрации представляет собой одиночный ({"ключ": "значение"}) или составной (состоящий из нескольких объектов) объект JSON.
Составной объект формируется с помощью:
- логических операций:
- конъюнкция - "and" или "&"
- дизъюнкция - "or" или "|"
- инверсия - "not" или "!"
- операций сравнения:
- больше - ">"
- больше либо равно - ">="
- меньше - "<"
- меньше либо равно - "<="
- соответствует - "=="
- не соответствует - "!="
В зависимости от используемой операции составной объект JSON может иметь вид:
- {"and": [ARRAY]}
- {"or": [ARRAY]}
- { "not": { OBJECT } }
- { "операция сравнения": { VARIABLE } }(операцию сравнения "==" можно не указывать, т.е. вид объекта - { VARIABLE })
где:
- VARIABLE - переменная. Обозначается структурой <имя переменной>: <значение переменной>
- OBJECT - переменная или составной объект JSON любого из указанных выше форматов
- ARRAY - массив. Может состоять из переменных и составных объектов JSON (любого формата) в различных комбинациях
Примеры
Запросить события с:
- важностью (столбец severity) больше 10;
- сообщением (столбец message), содержащим текст поставлен или с именем источника (столбец source), не соответствующим TU_212.
{
"AND": [
{ ">": { "severity": 10 } },
{
"OR": [
{ "message": "*поставлен*" },
{ "NOT": { "source": "TU_212" } }
]
}
]
}
Запросить события с важностью 667.
{"==":{"severity":667}}
Фильтр исторических данных в JSON-формате
string HistoricalFilter
Условия фильтрации запрашиваемых от источника исторических данных. Задаются в виде строки - объекта JSON. Правила формирования условий фильтрации аналогичны правилам при запросе оперативных данных.
Фильтр можно установить для всех данных, загружаемых в историческом режиме (когда в свойстве Режим работы указано значение 3), а также для исторических данных, загружаемых в оперативном режиме (когда в свойстве Режим работы указано значение 2или 1, а в свойстве Интервал предзагрузки истории задан интервал предзагрузки данных).
Размер буфера оперативных событий
uint4 OperativeBufferSize
Максимальное количество строк (событий), которое может одновременно храниться в буфере компонента. Если установлено значение 0, буфер считается неограниченным.
Активность
bool Active
Включает/выключает активность компонента.
Неактивный компонент не запрашивает события.
Значения
| true | Компонент активен и может запрашивать события. |
| false | Компонент неактивен. |
Удалять квитированные и деактивированные события
bool RemoveAckedInactive
Разрешает/запрещает удаление из списка событий, получаемых от источника (сервера, поставляющего оперативные события) квитированные и при этом деактивированные события.
Свойство работает только в режиме журнала оперативных событий.
Значения
| true | Квитированные и деактивированные события удаляются из списка. |
| false | Квитированные и деактивированные события остаются в списке. |
Запрашивать список активных событий при подключении к источнику
bool RefreshAtStart
Включает запрос активных и неквитированных событий с источника данных при каждом подключении.
Значения
| true | Запрос активных и неквитированных событий при подключении к серверу включен. |
| false | Запрос активных и неквитированных событий при подключении к серверу выключен. |
Интервал предзагрузки истории
uint4 HistoryPreloadInterval
Интервал (в секундах) подгрузки исторических данных в таблицу оперативных данных. Интервал начинается указанное количество секунд назад и заканчивается текущим моментом.
Расширяющий интервал
Свойство используется только при запросе исторических данных (когда в свойстве Режим работы указано значение 3).
uint4 HistoryExpandInterval
Отрезок времени (в часах), на который сдвигается время, указанное в свойстве Конец исторического интервала. За счет такого сдвига можно расширить исходный запрашиваемый интервал (указанный в свойствах Начало исторического интервала и Конец исторического интервала).
Если такое расширение установлено, с сервера запрашиваются также события, у которых время генерации больше времени, указанного в свойстве Конец исторического интервала. Из полученных событий отбрасываются события, время срабатывания которых не входит в исходный запрашиваемый интервал.
Хронология исторических событий
Свойство используется только при запросе исторических данных (когда в свойстве Режим работы указано значение 3).
uint4 HistoricalEventsChronology
Устанавливает хронологию, в которой будут запрашиваться исторические события за интервал, указанный в свойствах Начало исторического интервала и Конец исторического интервала.
Значение
| 0 | По времени генерации. Хронология выстраивается с учетом времени генерации уведомлений о событиях на сервере. |
| 1 | По времени срабатывания. Хронология выстраивается с учетом времени активации условий на технологическом объекте. |
Режим фильтрации источника событий
uint1 SourceFilterMode
Определяет, к каким типам событий (оперативным или историческим) будут применяться условия фильтрации, заданные в JSON-строках свойств Фильтр в JSON-формате и Фильтр исторических данных в JSON-формате.
Значение
| 0 | Без фильтрации. Компонент принимает и отображает все события, передаваемые источником, игнорируя заданные JSON-условия. |
| 1 | Фильтрация оперативных. Условия фильтрации из свойства Фильтр в JSON-формате применяются только к оперативным событиям. Исторические события (если они запрашиваются) поступают в компонент в полном объеме, без наложения фильтров. |
| 2 | Фильтрация исторических событий. Условия фильтрации из свойства Фильтр исторических данных в JSON-формате применяются только к историческим событиям, попадающим в интервал, заданный свойствами Начало исторического интервала и Конец исторического интервала. Оперативные события поступают в компонент в полном объеме, без применения фильтров. |
| 3 | Фильтрация оперативных и исторических событий. Условия фильтрации применяются ко всем типам событий: к оперативным применяется фильтр из свойства Фильтр в JSON-формате, к историческим (за заданный интервал) из свойства Фильтр исторических данных в JSON-формате. |
Параметры обработки данных
string DataProcessing
JSON-строка, задающая правила обработки и очистки событий в буфере компонента. Позволяет настраивать автоматические и ручные фильтры очистки и условия прекращения очистки.
Структура JSON:
{
"clear": {
"conditions": [ /* условия прекращения очистки */ ],
"filters": [ /* фильтры для очистки событий */ ]
}
}
Описание полей:
-
clear — очистка буфера.
Поле
Тип Описание conditions array Массив условий прекращения очистки. Определяют, когда процесс очистки должен остановиться. filters array Массив фильтров для очистки событий. Каждый фильтр определяет правила отбора событий для удаления. -
conditions — условия прекращения очистки.
Каждый объект условия содержит:
Поле
Тип Описание row_count uint4 Максимальное количество событий в буфере, при достижении которого очистка прекращается. Используется с операторами сравнения (<=, <, >=, >, ==). -
filters — фильтры для очистки событий
Каждый объект фильтра содержит:
Поле Тип Описание kind string Тип запуска фильтра:
- manual — запуск вручную через функцию Clear().
- auto — автоматический запуск при обновлении буфера.
period uint4 Интервал автоматического запуска в миллисекундах. condition object Условие отбора событий для удаления. JSON-объект с логическими операторами и полями событий.
Доступные операторы в condition:
Оператор Описание <, <=, >, >=, ==, != Операторы сравнения для числовых значений. AND, OR, NOT Логические операторы для комбинирования условий. Доступные поля событий:
Поле Тип Описание severity uint4 Важность события. acked bool Признак квитирования события. active bool Признак активности события. active_time timestamp Время активации события. Поддерживает относительные значения.
Примеры
Настроить ручную очистку событий с важностью меньше 667 до достижения 500 записей в буфере
{
"clear": {
"conditions": [
{
"rowCount_condition": {
"<=": { "row_count": 500 }
}
}
],
"filters": [
{
"low_priority_filter": {
"kind": "manual",
"condition": { "<": { "severity": 667 } }
}
}
]
}
}
При ручном запуске через функцию Clear() удаляются события с важностью меньше 667. Очистка продолжается, пока в буфере больше 500 событий.
Настроить автоматическое удаление квитированных неактивных событий и событий старше 12 часов каждую секунду
{
"clear": {
"filters": [
{
"acked_inactive_filter": {
"kind": "auto",
"period": 1000,
"condition": {
"OR": [
{ "acked": true, "active": false },
{ "<=": { "active_time": "now - 12h" } }
]
}
}
}
]
}
}
Автоматически каждую секунду (1000 мс) удаляются события, которые квитированы И деактивированы, ИЛИ активны более 12 часов назад.
Порядок сортировки событий
uint1 SortOrder
Порядок сортировки очереди событий внутри провайдера. От этого порядка зависит, какие события будут считаться старыми и первыми пойдут под удаление при переполнении буфера или работе функции Clear.
Значение
| 0 | По времени срабатывания | Сортировка выполняется по времени активации условия на технологическом объекте. |
| 1 | По времени генерации | Сортировка выполняется по времени генерации уведомления о событии на сервере. |
Максимальное количество событий
uint4 MaxEventCount
Предельное количество событий, которое будет передано потребителю по результатам выполнения запроса.
Если фактическое количество найденных событий превышает заданное значение, применяется режим ограничения, установленный в свойстве Режим обработки превышения максимального количества событий.
Значение
| 0 | Ограничение не применяется. |
| >0 | Применяется ограничение количества возвращаемых событий. |
Режим обработки превышения максимального количества событий
uint1 MaxEventCountOverflowMode
Способ формирования результирующего набора данных при превышении значения Максимальное количество событий.
Свойство учитывается только если в свойстве Максимальное количество событий задано значение больше 0.
Значение
| 0 | Не ограничивать (возвращается полный набор найденных событий). |
| 1 | Предоставить первые события (с учетом установленной сортировки). |
| 2 | Предоставить последние события (с учетом установленной сортировки). |
Режим сведения в историческом журнале
uint1 MergeMode
Определяет, сколько строк в таблице занимает одно событие.
Одно событие проходит несколько этапов:
- Активация (условие сработало);
- Квитирование (оператор подтвердил получение);
- Деактивация (условие перестало выполняться).
По каждому событию сервер передаёт один набор данных, в котором есть поля всех этапов.
Свойство Режим сведения в историческом журнале определяет, как этот набор данных отображается в таблице — одной строкой или несколькими строками по числу этапов.
Свойство применяется в двух случаях:
- при работе в режиме журнала исторических событий (когда свойство Режим работы имеет значение 3).
-
при предзагрузке исторических данных в оперативном режиме — когда задан Интервал предзагрузки истории и свойство Режим работы имеет значение 1 или 2.
Значение
| 0 | Полное сведение |
Событие отображается одной строкой. Строка создаётся при активации и обновляется при квитировании и деактивации. Отдельные строки для квитирования и деактивации не создаются.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1 | Частичное сведение |
Создаются три строки: активации, квитирования и деактивации.
Строка активации
Строка квитирования Создаётся в момент квитирования, после создания не изменяется.
Строка деактивации Создаётся в момент деактивации, после создания не изменяется.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 2 | Отключенное сведение |
Создаются независимые строки для активации, квитирования и деактивации. Каждая строка содержит только данные своего этапа. Строка активации
Строка квитирования
Строка деактивации
|
Режим сведения в оперативном журнале
uint1 OperativeMergeMode
Определяет, как в таблице отображаются записи, относящиеся к одному и тому же событию, при работе с оперативными данными.
Работает так же, как свойство Режим сведения в историческом журнале, но применяется к оперативным событиям.
Свойство применяется при работе в режиме журнала оперативных событий (свойство Режим работы =2).
Значение
| 0 | Полное сведение |
Событие отображается одной строкой. Строка создаётся при активации и обновляется при квитировании и деактивации. Отдельные строки для квитирования и деактивации не создаются.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 1 | Частичное сведение |
Создаются три строки: активации, квитирования и деактивации.
Строка активации
Строка квитирования Создаётся в момент квитирования, после создания не изменяется.
Строка деактивации Создаётся в момент деактивации, после создания не изменяется.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 2 | Отключенное сведение |
Создаются независимые строки для активации, квитирования и деактивации. Каждая строка содержит только данные своего этапа. Строка активации
Строка квитирования
Строка деактивации
|
Спецификация пользовательских атрибутов
string CustomAttributes
JSON-строка, задающая соответствие между пользовательскими атрибутами событий и столбцами результирующего набора данных.
По умолчанию компонент получает от источника только стандартные поля событий, пользовательские атрибуты игнорируются. Если необходимо отображать значения пользовательских атрибутов в таблице событий, заполните данное свойство: для каждого нужного атрибута укажите его идентификатор в событии и параметры столбца, в который будут помещены его значения. Компонент разберёт JSON-строку, добавит в результирующий набор данных соответствующие столбцы и при получении каждого события заполнит их значениями из атрибутов.
Структура JSON — массив объектов, каждый из которых описывает один атрибут:
[
{
"id": "attribute_id",
"column": "column_name_in_rowset",
"description": "Описание столбца",
"type": "string"
}
]
Поля объекта:
| Поле | Тип | Описание |
| id | string | Идентификатор пользовательского атрибута в событии источника. |
| column | string | Идентификатор столбца результирующего набора данных, в который будут помещены значения атрибута. |
| description | string | Описание столбца результирующего набора данных. |
| type | string | Ожидаемый тип значения атрибута: bool, int1, int2, int4, int8, uint1, uint2, uint4, uint8, float, double, string, timestamp, variant |
Правила преобразования значений при заполнении строки результирующего набора данных:
- Если атрибут получен в событии от источника, но не описан ни в одном объекте JSON-массива, он пропускается.
- Если в поле type указан тип, отличный от variant, ожидается значение строго этого типа; при несоответствии поле будет содержать нулевое значение.
- Если в поле type указан тип variant, принимается значение любого поддерживаемого типа.
Примеры
Получать из событий два пользовательских атрибута: единицы измерения (строка) и код зоны (целое число):
[
{
"id": "unit_of_measure",
"column": "unit",
"description": "Единица измерения",
"type": "string"
},
{
"id": "zone_code",
"column": "zone",
"description": "Код зоны",
"type": "uint4"
}
]
Параметры сведения событий
string MergeParameters
JSON-строка, задающая правила обновления или сохранения значений пользовательских атрибутов события при изменении его состояния.
Пользовательские атрибуты — произвольные поля, которые сервер передаёт вместе с уведомлением о событии. При каждом изменении состояния (активации, квитировании, деактивации и других переходах) сервер может передавать новые значения этих атрибутов или не передавать их вовсе. Свойство определяет, что делать в каждом из этих случаев: записать новое значение или сохранить прежнее.
Если свойство не задано (пустая строка), поведение при сведении определяется внутренней логикой компонента.
Структура JSON:
{
"rules": [
{
"id": "<идентификатор_правила>",
"rule": {
"<тип_перехода>": {
"new_value_empty": "<действие_если_новое_значение_пусто>",
"new_value_nonempty": "<действие_если_новое_значение_не_пусто>"
}
}
}
],
"column_rules": [
{
"columns": ["<идентификатор_колонки_1>", "<идентификатор_колонки_2>"],
"rule_id": "<идентификатор_правила>"
}
]
}
Описание полей:
-
rules — массив объектов, описывающих правила сведения.
Поле
Тип Описание id string Уникальный идентификатор правила. Используется для привязки правила к колонкам в column_rules. rule object Правила обновления атрибутов по типам переходов. Каждый ключ — тип перехода, значение — объект с двумя действиями: new_value_empty (что делать, если новое значение не пришло) и new_value_nonempty (что делать, если новое значение получено). Если переход не указан, применяются внутренние правила компонента.
-
column_rules — массив объектов, сопоставляющих правила с конкретными колонками (пользовательскими атрибутами).
Поле
Тип Описание columns array Массив идентификаторов пользовательских колонок (Custom Attributes), к которым применяется правило, указанное в rule_id. Если поле отсутствует, правило считается правилом по умолчанию и действует для всех атрибутов, для которых не задано отдельное правило. rule_id string Идентификатор правила из массива rules.
Возможные значения <тип_перехода> (ключи внутри rule):
|
Значение |
Описание перехода |
| activation | Новая активация подусловия. |
| acknowledgement | Квитирование события. |
| pseudo_activation | Псевдоактивация. |
| deactivation | Деактивация подусловия. |
| acknowledgement_reset | Сброс квитирования. |
| reactivation | Новая активация события, которое уже является активным, без изменения подусловия (переактивация). |
| attribute_change | Уведомление об изменении атрибутов. |
Возможные значения для действий (new_value_empty и new_value_nonempty):
|
Значение |
Описание действия |
| update | Обновить значение атрибута. Если используется для new_value_nonempty — атрибут принимает новое значение. Если используется для new_value_empty — значение атрибута очищается. |
| keep | Сохранить текущее (старое) значение атрибута. Поступившее значение игнорируется. |
Примеры
Сохранять значение атрибута при отсутствии нового; при псевдоактивации — обновлять всегда.
{
"rules": [
{
"id": "defaultRule",
"rule": {
"activation": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"acknowledgement": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"pseudo_activation": { "new_value_empty": "update", "new_value_nonempty": "update" },
"deactivation": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"acknowledgement_reset": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"reactivation": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"attribute_change": { "new_value_empty": "keep", "new_value_nonempty": "update" }
}
}
],
"column_rules": [
{
"rule_id": "defaultRule"
}
]
}
Для колонки AckSourceFromPlc всегда обновлять значение при активации и переактивации; для остальных атрибутов — сохранять значение при его отсутствии.
{
"rules": [
{
"id": "defaultRule",
"rule": {
"activation": { "new_value_empty": "keep", "new_value_nonempty": "update" },
"acknowledgement": { "new_value_empty": "keep", "new_value_nonempty": "update" }
}
},
{
"id": "forceUpdateRule",
"rule": {
"activation": { "new_value_empty": "update", "new_value_nonempty": "update" },
"reactivation": { "new_value_empty": "update", "new_value_nonempty": "update" }
}
}
],
"column_rules": [
{
"rule_id": "defaultRule"
},
{
"columns": [ "AckSourceFromPlc" ],
"rule_id": "forceUpdateRule"
}
]
}