В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.
-
Альфа платформа (ред. 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)
-
Администрирование
-
Отчеты
-
Бланки переключений
-
Специальные возможности
Настройка в Alpha.DevStudio
Настройка обмена данными между модулем SQL Клиент и источником выполняется в среде разработки Alpha.DevStudio.
Чтобы настроить обмен данными с источником:
- добавьте в проект и настройте источник, с которым будет выполняться обмен данными;
- в Alpha.Server добавьте и настройте модуль SQL Клиент;
- настройте обмен данными между источником и модулем SQL Клиент;
- примените конфигурацию Alpha.Server.
Порядок создания проекта и добавление Alpha.Server в проект описаны в документации на Alpha.DevStudio (раздел Знакомство с Alpha.DevStudio руководства пользователя).
Далее приведено описание настройки обмена данными Alpha.Server с источником данных с помощью запросов языка SQL.
Настройка источника данных
-
Перейдите в Alpha.Domain → Узел Alpha.Domain, и добавьте Исполняющий компонент.
-
Перейдите в Исполняющий компонент и добавьте элементы Приложение и База данных SQL.
-
Перейдите в Приложение и добавьте элемент Карта адресов SQL.
В дальнейшем в Приложение будут добавлены экземпляры логических типов.
-
На элементе Карта адресов SQL:
- Нажмите кнопку
. - Укажите место хранения карты адресов на диске.
- Задайте имя карты адресов.
- Нажмите кнопку Открыть.
Карта адресов будет создана. Если требуется открыть существующую карту адресов, то выберите файл карты адресов на диске и нажмите кнопку Открыть.
- Нажмите кнопку
-
Вернитесь в Исполняющий компонент и настройте Базу данных SQL: в свойстве Карта адресов укажите ранее добавленную Карту адресов SQL.
Свойства Базы данных SQL:
| Свойство | Описание |
|---|---|
|
Имя |
Название базы данных SQL в проекте. |
| Карта адресов | Расположение карты адресов, которую будет использовать база данных SQL. |
Настройка нескольких источников данных
В случае, если требуется настроить обмен данными с несколькими источниками, то в Alpha.Domain добавьте необходимое количество Исполняющих компонентов и выполните настройку каждого из них.
Настройка SQL Клиент
-
Перейдите в Alpha.Domain → Узел Alpha.Domain → Alpha.Server и добавьте Приложение.
В дальнейшем в это приложение будут добавлены экземпляры логических типов.
-
В Alpha.Server из папки Коммуникационные модули добавьте SQL Клиент.
Для свойств SQL Клиент можно оставить значения по умолчанию.
Настройка связи с БД
-
На элементе SQL Клиент нажмите кнопку
и укажите ранее настроенную Базу данных SQL.
-
Выделите добавленную БД и настройте параметры взаимодействия SQL Клиент с Базой данных SQL.
В примере для настройки обмена данными:
- Поставщик данных - ODBC;
- строка подключения разделена на две части:
Открытая часть строки подключения имеет вид:
Driver={PostgreSQL Unicode(x64)};Server=127.0.0.1;Port=5432;Database=postgres;Секретная часть строки подключения имеет вид:
UID=postgres;PWD=qwerty@123;
Свойство Описание База данных SQL
Расположение в проекте базы данных, к которой подключается модуль. Поставщик данных Интерфейс доступа к данным.
Значение по умолчанию - OLE DB.
Открытая часть строки подключения Параметры подключения к базе данных, хранящиеся в конфигурации в открытом виде.
Период попытки подключения к источнику, мс Свойство будет доступно для использования в последующих релизах Alpha.Server.
Секретная часть строки подключения Параметры подключения к базе данных, хранящиеся в конфигурации в зашифрованном виде, например, пароль, имя пользователя или любые другие параметры, которые требуется зашифровать.
Настройка обмена данными
Для настройки обмена данными между модулем SQL Клиент и источником:
- настройте список SQL запросов;
- настройте логические типы источника и Alpha.Server;
- добавьте экземпляры логических типов в приложения источника и Alpha.Server;
- настройте получение и отправку значений сигналов.
Настройка списка SQL-запросов
Чтобы настроить список SQL-запросов, которые модуль SQL Клиент будет отправлять источникам:
- Перейдите в Alpha.Domain → Узел Alpha.Domain → Исполняющий компонент → Приложение.
-
По умолчанию Карта адресов SQL содержит одну группу SQL-запросов. Если требуется настроить несколько групп, то добавьте нужное количество групп SQL-запросов кнопкой
.
-
На элементе Карта адресов SQL нажмите кнопку
для перехода к настройкам группы SQL-запросов.
-
В группу SQL-запросов для каждого запроса, который требуется выполнять, добавьте элемент SQL запрос.
-
Для каждого запроса укажите значения параметров:
Параметр Описание Имя Имя SQL-запроса. Период исполнения запроса, мс Период в миллисекундах, через который модуль будет отправлять SQL-запрос источнику.
Значение по умолчанию - 10000.
Чтобы модуль отправлял запрос источнику по команде, укажите значение 0.
Текст запроса
Текст SQL-запроса, который модуль SQL Клиент будет отправлять источнику. Значения остальных параметров можно оставить по умолчанию.
Параметр Описание Возможность результата запроса быть пустым При получении пустого результата запроса:
- True - качество сигналов не изменяется;
- False - сигналам будет установлено плохое качество.
Значение по умолчанию - False.
Имя ключевого поля Имя столбца таблицы, по которому будет выполняться дополнительная фильтрация данных. Если дополнительная фильтрация не требуется, то оставьте поле пустым. Качество при неполном значении Если в результате запроса значение, качество или метка времени имеют пустое значение (NULL), то сигналу устанавливать заданное качество.
Значение по умолчанию - 64 (Uncertain) (данные не получены).
Часовой пояс Часовой пояс (UTC), в котором хранятся метки времени в источнике.
К указанному часовому поясу будут приведены метки времени значений:
- полученных от источника запросами SELECT;
- отправляемых в источник запросами UPDATE, INSERT.
-
Если требуется выполнять некоторые запросы при инициализации (перед первым запросом), то в настройках группы SQL-запросов укажите список таких запросов в параметре Запросы инициализации. Имена запросов можно задавать через запятую. Если запросы инициализации не требуются, то оставьте параметр пустым.
В примере для настройки обмена данными требуется настроить 5 запросов со следующими параметрами:
| Имя запроса | Текст запроса | Период исполнения запроса, мс |
|---|---|---|
| Id | SELECT param_name,value,quality,timestamp FROM tank_db WHERE id=? | 1000 |
| String | SELECT param_name,value,quality FROM tank_db WHERE param_name LIKE ? | 5000 |
| NewName | UPDATE tank_db SET param_name=? WHERE id=? | 0 |
| NewData | INSERT INTO tank_db(id,param_name,value,quality,timestamp) VALUES (?,?,?,?,?) | 0 |
| Delete | DELETE FROM tank_db WHERE id=? AND param_name=? | 0 |
Для всех запросов:
- значение параметра Имя ключевого поля оставьте пустым;
- в параметре Часовой пояс укажите часовой пояс, в котором работает Alpha.Server;
- значения остальных параметром оставьте по умолчанию.
Значения по умолчанию
Для каждого запроса можно указать значения по умолчанию, которые следует устанавливать столбцам, если результат запроса имеет пустое значение (NULL). Чтобы добавить в запрос значения по умолчанию:
-
Добавьте нужное количество значений кнопкой
.
-
Укажите Имя столбца и его Значение по умолчанию.
Если значения столбцов по умолчанию не заданы, а в результате запроса получено пустое значение (NULL), то следующие значения столбца запрашиваться не будут, а в журнал приложений будет записано сообщение об ошибке.
Настройка логических типов
-
Добавьте в проект два элемента Пространство имен для логических типов источника и Alpha.Server. Каждому элементу задайте Имя, например, DB_Types и Server_Types.
-
В каждое Пространство имен добавьте Аспект.
Задайте Имя каждому добавленному аспекту:
- в пространстве имён DB_Types - аспект DB;
- в пространстве имён Server_Types - аспект Server.
Логические типы источника
Чтобы настроить логический тип источника:
-
Перейдите в Пространство имен DB_Types и добавьте Логический тип. В свойствах логического типа укажите:
Параметр Описание Имя Имя логического типа. Аспект Добавленный ранее аспект источника - DB.
-
Перейдите в Логический тип и опишите его структуру: добавьте сигналы требуемых типов, укажите им Имя и Направление.
Для получения и изменения значений таблицы из примера для настройки обмена данными добавьте следующие логические типы с сигналами:
| Сигнал | Тип | Направление | Описание |
|---|---|---|---|
| Логический тип Read_ID (для запроса 1) | |||
| Id | Int8 | вход | Идентификатор параметра, данные которого требуется получить из БД (столбец id). |
| Name |
String |
выход | Название параметра (столбец param_name). |
| Value |
Uint8 |
выход | Значение параметра (столбец value). |
| Логический тип Read_Name (для запроса 2) | |||
| String | String | вход | Строка в названии параметра, данные которого требуется получить из БД (столбец param_name). |
| Name |
String |
выход | Название параметра (столбец param_name). |
| Value | Uint8 | выход | Значение параметра (столбец value). |
| Логический тип Update (для запроса 3) | |||
| Id | Int8 | вход | Идентификатор параметра, название которого требуется обновить (столбец id). |
| Name | String | вход | Обновленное название параметра, которое требуется записать в БД (столбец param_name). |
| Логический тип Insert (для запроса 4) | |||
| Id | Int8 | вход | Идентификатор нового параметра, который требуется добавить в БД (столбец id). |
| Name | String | вход | Название нового параметра, который требуется добавить в БД (столбец param_name). |
| Value | Uint8 | вход | Значение нового параметра, который требуется добавить в БД (столбец value). |
| Quality | Uint8 | вход | Качество нового параметра, который требуется добавить в БД (столбец quality). |
| Time | String | вход | Метка времени нового параметра, который требуется добавить в БД (столбец timestamp). |
| Логический тип Delete (для запроса 5) | |||
| Id | Int8 | вход | Идентификатор параметра, который требуется удалить из БД (столбец id). |
| Name | String | вход | Название параметра, который требуется удалить из БД (столбец param_name). |
Добавленные логические типы источника:
Логические типы Alpha.Server
Чтобы настроить логический тип Alpha.Server:
-
Перейдите в Пространство имен Server_Types и добавьте Логический тип. В свойствах логического типа укажите:
Параметр Описание Имя Имя логического типа. Аспект Добавленный ранее аспект - Server. Представляемый тип Описанный ранее логический тип источника.
Добавленный Логический тип будет представлять описанный ранее логический тип источника, только со стороны Alpha.Server.
-
Перейдите в Логический тип и добавьте Ссылку. В свойствах добавленной ссылки укажите:
Параметр Описание Имя Имя ссылки. Тип Описанный ранее логический тип источника.
После указания Типа в элементе Ссылка отобразится структура соответствующего логического типа источника. Добавленная ссылка будет связывать логический тип Alpha.Server с логическим типом источника.
-
В контекстном меню ссылки выполните команду Экспонировать входы и выходы, в результате чего в логическом типе будут созданы сигналы с теми же именами и типами, что и в логическом типе источника, а также прорисованы связи.
Логические типы Alpha.Server из примера для настройки обмена данными:
Добавление типов в приложения источника и Alpha.Server
-
Перейдите в приложение источника. Ранее в него уже была добавлена Карта адресов SQL. Теперь добавьте в приложение экземпляры логических типов источника.
- Перейдите в приложение Alpha.Server:
-
В качестве аспекта новых представлений укажите аспект Server и нажмите кнопку Готово.
Представления выбранных объектов будут созданы в приложении Alpha.Server.
Получение и запись значений параметров БД
Чтобы получать от источника и отправлять в источник значения параметров БД, перейдите в Карту адресов SQL и настройте параметры адреса для каждого сигнала:
| Поле | Значение |
|---|---|
| Привязка | непосредственно. |
| Имя группы | Имя группы, к которой относится запрос. |
| Имя запроса | Имя запроса, который будет отправлен в источник для получения или записи значения данного сигнала в БД. |
| Тип |
Тип привязки сигнала:
|
Для сигналов с типом привязки QRead настройте параметры адреса:
| Поле | Значение |
|---|---|
| Value | Имя столбца таблицы, значение которого будет записано в значение сигнала (свойство сигнала 2 (Value)). |
| Quality | Имя столбца таблицы, значение которого будет записано в качество сигнала (свойство сигнала 3 (Quality)). Если не указано, то сигналу будет установлено качество GOOD. |
| Timestamp |
Имя столбца таблицы, значение которого будет записано в метку времени сигнала (свойство сигнала 4 (Timestamp)). Если не указано, то сигналу будет установлено текущее время Alpha.Server. |
| KeyFieldValue | Значение столбца таблицы, указанного в параметре запроса Имя ключевого поля. Если указано, то к результату запроса будет применён дополнительный фильтр: результат запроса будет содержать только те строки, где ключевое поле принимает указанное значение. |
Для сигналов с типом привязки QParam настройте параметры адреса:
| Поле | Значение |
|---|---|
| ParamID |
Порядковый номер параметра запроса, обозначенного символом ?, вместо которого будет подставлено значение сигнала для динамического формирования SQL-запроса. |
| ParamValuePropID | Номер свойства сигнала, значение которого будет подставлено в текст запроса вместо параметра ?. Если не указано, то будет подставлено свойство 2 (Value). |
Ниже приведены настройки SQL-запросов и соответствующие настройки адресов сигналов для получения и записи значений параметров БД из примера для настройки обмена данными:
-
Запрос Id и адреса сигналов логического типа Read_ID:
- Значение сигнала Read_ID.Id будет подставлено в текст запроса Id в параметр запроса ? с порядковым номером 1.
- В результате выполнения запроса Id в свойства сигналов будут записаны значения столбцов таблицы tank_db, соответствующие параметру с идентификатором, равным значению сигнала Read_ID.Id:
- В значение сигнала Read_ID.Name будет записано значение столбца param_name.
- Для сигнала Read_ID.Value:
- в значение будет записано значение столбца value;
- качество будет установлено из столбца quality;
- метка времени будет установлена из столбца timestamp.
-
Запрос String и адреса сигналов логического типа Read_Name:
-
Значение сигнала Read_Name.String будет подставлено в текст запроса String в параметр запроса ? с порядковым номером 1.
Для выполнения запроса с оператором LIKE значение сигнала, которое будет подставлено в параметр запроса ?, должно быть задано в формате %строка%. Пример:
%Уровень%
- В результате выполнения запроса String в свойства сигналов будут записаны значения столбцов таблицы tank_db, соответствующие параметру со строкой из значения сигнала Read_Name.String:
- В значение сигнала Read_Name.Name будет записано значение столбца param_name.
- Для сигнала Read_Name.Value:
- в значение будет записано значение столбца value;
- качество будет установлено из столбца quality.
-
-
Запрос NewName и адреса сигналов логического типа Update:
- Значение сигнала Update.Id будет подставлено в текст запроса NewName в параметр запроса ? с порядковым номером 1.
- Значение сигнала Update.Name будет подставлено в текст запроса NewName в параметр запроса ? с порядковым номером 2.
- В результате выполнения запроса NewName в таблицу tank_db в строку с идентификатором, равным значению сигнала Update.Id, в столбец param_name будет записано значение сигнала Update.Name.
-
Запрос NewData и адреса сигналов логического типа Insert:
- Значения сигналов будут подставлены в текст запроса NewData в параметры запроса ? с порядковыми номерами:
- 1 - значение сигнала Insert.Quality;
- 2 - значение сигнала Insert.Name;
- 3 - значение сигнала Insert.Value;
- 4 - значение сигнала Insert.Id;
- 5 - значение сигнала Insert.Time.
Для сигнала Insert.Time задано значение параметра ParamValuePropID, равное 4. Это значит, что в параметр запроса ? с порядковым номером 5 будет подставлено значение свойства 4 (Timestamp) сигнала Insert.Time.
Если требуется вводить метку времени вручную и в параметр запроса ? подставлять введённое значение, то поле ParamValuePropID нужно оставить пустым.
В БД тип данных столбца timestamp (timestamp without time zone) не совпадает с размерностью типа сигнала Alpha.Server Insert.Time (string), поэтому в настройках модуля параметру Неявное приведение ODBC типов большей размерности к типам меньшей размерности установите значение Да.
-
В результате выполнения запроса NewData в таблицу tank_db будет добавлена новая строка, в которой значения столбцов:
- id равно значению сигнала Insert.Id;
- param_name равно значению сигнала Insert.Name;
- value равно значению сигнала Insert.Value;
- quality равно значению сигнала Insert.Quality;
- timestamp равно значению свойства 4 (Timestamp) сигнала Insert.Time.
- Значения сигналов будут подставлены в текст запроса NewData в параметры запроса ? с порядковыми номерами:
-
Запрос Delete и адреса сигналов логического типа Delete:
- Значение сигнала Delete.Id будет подставлено в текст запроса Delete в параметр запроса ? с порядковым номером 1.
- Значение сигнала Delete.Name будет подставлено в текст запроса Delete в параметр запроса ? с порядковым номером 2.
- В результате выполнения запроса Delete из таблицы tank_db будет удалена строка, в которой значение столбца id равно значению сигнала Delete.Id, а имя параметра в столбеце param_name соответствует значению сигнала Delete.Name.
Выполнение запроса по команде
Чтобы модуль SQL Клиент отправлял запрос в источник по команде, в настойках запроса параметру Период исполнения запроса, мс установите значение 0.
Для такого запроса модуль создаёт служебные сигналы выполнения запроса по команде, полный тег которых:
Service.Modules.<Имя модуля>.<Имя источника>.<Имя запроса>.<Имя сигнала>
| Сигнал | Тип | Описание сигнала |
|---|---|---|
| MakeQuery_Command |
bool |
Команда выполнения запроса:
|
|
QueryInExecutionStatus |
bool |
Статус выполнения запроса:
|
Применение конфигурации Alpha.Server
-
Постройте решение. Конфигурация Alpha.Server будет построена.
-
Перейдите в Мастер развёртывания.
Для успешного применения построенных конфигураций должен быть настроен Alpha.Domain. Описание настройки приведено в документации на Alpha.Domain (см. раздел Конфигурирование руководства администратора).
-
Примените конфигурацию к Alpha.Server.

