OpenSCADA

Библиотеки/Основные графические элементы

This page is a translated version of the page Libs/Main graphical elements and the translation is 85% complete.

English • ‎mRussian • ‎Українська
Название Версия Лицензия Источник Языки Автор Иконка
Библиотека основных элементов интерфейса пользователя 2.2 GPLv2 vcaBase.db (SQL, GZip) > VCA.wlb_Main en, uk, ru Роман Савоченко LibMainGraphElements.png
Описание
Предоставляет библиотеку основных элементов пользовательского интерфейса общей и промышленной автоматизации.
-

Библиотека создаётся для предоставления основных элементов пользовательского интерфейса и содержит графические элементы, которые часто востребованы при формировании пользовательского интерфейса автоматизации технологических и общих процессом. Строится библиотека на основе примитивов виджетов и языка внутреннего программирования JavaLikeCalc.

Названия элементов и их параметров доступны на языках: Английский, Украинский и mRussian. Их исходный код написан в языко(человеческий)-независимом режиме с вызовом функции перевода tr() и перевод этих сообщений также доступен Английским, Украинским и mRussian.

Для подключения библиотеки к проекту станции OpenSCADA Вы можете получить файл БД как:

wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql
sqlite3 -init vcaBase.sql vcaBase.db .exit

Этот полученный файл Вы далее можете разместить в каталоге проекта станции и создать объект базы данных модуля БД "SQLite", зарегистрировав файл базы данных в конфигурации.

Contents

1 Виджеты — графические элементы

Содержит элементы-виджеты общего применения, которые предназначены для размещения на основных кадрах. Этими основными кадрами могут быть и кадры за этой концепцией объектов сигнализации корневой страницы "RootPgSo", но нужно учитывать, что они часто ссылаются и вызывают те или иные панели управления!


1.1 Отображение аналогового (anShow)

1.3 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 1.1 служит для отображения текущего значения аналогового параметра и режима регулятора, если параметр является таковым. Также этот элемент генерирует уведомления про нарушения по соответствующим уставкам параметра. Элемент в целом использует и представляет представительскую структуру DAQ-шаблона "Аналоговый сигнал".

Рис.1.1. Элемент "Отображение аналогового" в режиме разработки и исполнения (слева направо).

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением значений аналоговых параметров и ПИД-регуляторов. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и связать с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается название параметра, режим регулятора (только для регулятора) и текущее значение-переменная этого параметра; которые, в зависимости от наличия нарушения, отображаются цветом стиля: labColorGood, labColorWarning, labColorAlarm; и которым изображение несквитированного параметра может мигать. При аппаратных ошибках и недостоверности данных, последнее значение отображается серым цветом и перечёркивается. В подсказке пользователь может получить описание связанного параметра и его ошибки.

В активном режиме элемента можно получить паспорт путём нажатия правой клавиши мыши на поле виджета. В паспорте будут представлены все свойства параметра. При нажатии левой клавишей мыши в области панелей появится панель управления параметром, а выбор данного виджета будет отображаться мигающей рамкой.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
pErr Параметр: ошибка Строка Входная связь Parameter|err Код и текст ошибки по параметру. Используется для формирования сигнализации о нарушении. Коды обрабатываемых ошибок:
  • 1,2 — отказ, параметр не достоверен, отображается серым и перечёркнутым кроме случая с redEVAL;
  • 3,4 — выше и ниже аварийной границы, отображается цветом стиля labColorAlarm;
  • 5,6 — выше и ниже предупредительной границы, отображается цветом стиля labColorWarning;
  • 10,11 — коды пользовательских нарушений статуса предупреждение и авария, соответственно отображаются цветом стиля labColorWarning и labColorAlarm.
pModeA Параметр: режим регулятора: автомат Логический Входная связь Parameter|auto Отображается большая буква "А" слева от значения, при установке.
pModeC Параметр: режим регулятора: каскад Логический Входная связь Parameter|casc Отображается большая буква "К" слева от значения, при установке.
pName Параметр: имя Строка Входная связь Parameter|NAME Короткое наименование параметра, которое отображается над значением и вставляється в сообщение про нарушение.
pPrec Параметр: точность Целый Входная связь Parameter|prec Количество знаков после точки, для положительный значений, и точность (знаков вообще), для негативных, для отображения конечного реального значения на экране.
pVal Параметр: значение Вещественный Входная связь Parameter|var Инженерное реальное значение параметра.
redEVAL Красное имя параметра в случае отказа Логический Постоянная По умолчанию, цвет имени при "отказе" (значение EVAL) параметра серый. Для некоторых критичных для технологического процесса параметров состояние отказ должно быть ярко выражено на мнемосхеме красным цветом.
spName Имя для синтеза Строка Постоянная Имя параметра для синтеза речи при формировании аварийных сообщений с учетом ударений слов, пауз и т.д. Пустое значение выключает уведомление речью!

1.2 Отображение аналогового 1 (anShow1); Отображение аналогового 1, короткий (anShow1s)

1.4 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 1.2 служит для отображения текущего значения аналогового параметра и краткого префиксу измеренного значения. Также этот элемент генерирует уведомления про нарушения по соответствующим уставкам параметра. Элемент в целом использует и представляет представительскую структуру DAQ-шаблона "Аналоговый сигнал".

Эти два элемента отличаются один от одного только начальным горизонтальным размером, т.е. второй "Отображение аналогового 1, короткий" является коротким вариантом для очень коротких случаев и он прямо наследуется от первого.

Рис.1.2. Элемент "Отображение аналогового 1" в режиме разработки и исполнения (слева направо).

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением значений аналоговых параметров с префиксом и/или как элемент статической экранной таблицы. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и связать с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается короткий префикс и текущее значение-переменная этого параметра; которые, в зависимости от наличия нарушения, отображаются цветом стиля: labColorGood, labColorWarning, labColorAlarm; и которым изображение несквитированного параметра может мигать. При аппаратных ошибках и недостоверности данных, последнее значение отображается серым цветом и перечёркивается. В подсказке пользователь может получить описание связанного параметра и его ошибки.

В активном режиме элемента можно получить паспорт путём нажатия правой клавиши мыши на поле виджета. В паспорте будут представлены все свойства параметра. При нажатии левой клавишей мыши в области панелей появится панель управления параметром, а выбор данного виджета будет отображаться мигающей рамкой.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
pErr Параметр: ошибка Строка Входная связь Parameter|err Код и текст ошибки по параметру. Используется для формирования сигнализации о нарушении. Коды обрабатываемых ошибок:
  • 1,2 — отказ, параметр не достоверен, отображается серым и перечёркнутым;
  • 3,4 — выше и ниже аварийной границы, отображается цветом стиля labColorAlarm;
  • 5,6 — выше и ниже предупредительной границы, отображается цветом стиля labColorWarning;
  • 10,11 — коды пользовательских нарушений статуса предупреждение и авария, соответственно отображаются цветом стиля labColorWarning и labColorAlarm.
pNAME Параметр: имя Строка Входная связь Parameter|NAME Короткое наименование параметра, которое вставляється в сообщение про нарушение.
prec Параметр: точность Целый Входная связь Parameter|prec Количество знаков после точки, для положительный значений, и точность (знаков вообще), для негативных, для отображения конечного реального значения на экране.
pVal Параметр: значение Вещественный Входная связь Parameter|var Инженерное реальное значение параметра.
spName Имя для синтеза Строка Постоянная Имя параметра для синтеза речи при формировании аварийных сообщений с учетом ударений слов, пауз и т.д. Пустое значение выключает уведомление речью!
pName Короткое название Строка Постоянная Значение короткого названия-префикса.
pNameSz Размер короткого названия Целое Постоянная Размер короткого названия-префикса, используйте 0 для отключения поля.


1.3 Текстовая метка (TextLab)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 1.3 служит для отображения динамических текстовых меток, которые формируется на основе дискретных сигналов. Также этот элемент генерирует уведомление про нарушения по локально определённому условию, атрибут ntf. Элемент в целом использует и представляет представительскую структуру DAQ-шаблонов дискретного блока и состояния по коду.

Рис.1.3. Элемент "Текстовая метка" в режиме разработки и выполнения (слева направо)
.

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением текстовых меток и/или как элемент статической экранной таблицы. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер и связать с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается текстовая метка и на фоне, которые соответствуют значениям дискретных сигналов параметра и конфигурации состояний в атрибуте digStts; где фон, зависимо от наличия нарушения соответствующего условию атрибута ntf, устанавливается в цвет нарушения; и которым изображение несквитированного параметра может мигать. При аппаратных ошибках и недостоверности данных, фон отображается серым цветом.

В активном режиме элемента можно получить паспорт дважды нажав левую клавиши мыши на поле виджета. В паспорте будут представлены все свойства параметра. При нажатии левой клавишей мыши в области панелей появится панель управления параметром, а выбор данного виджета будет отображаться мигающей рамкой. Команды дублируются в контекстном меню, которое появляется при нажатии правой клавиши мыши в области виджета.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
NAME Параметр: имя Строка Входная связь Parameter|NAME Краткое наименование параметра, которое вставляется в уведомление про нарушение и действия оператора-пользователя.
DESCR Параметр: описание Строка Входная связь Parameter|DESCR Описание или развёрнутое название параметра, которое вставляется в уведомление про нарушение и действия оператора-пользователя.
st_open Параметр: статус-открыто Логический Входная связь Parameter|st_open Статус параметра "Открыто" или общий статус переключателя при отсутствии сигнала статуса "Закрыто".
st_close Параметр: статус-закрыт Логический Входная связь Parameter|st_close Статус параметра "Закрыто".
st_text Параметр: статус (текст) Строка Входная связь Parameter|st_text Текст состояния параметра, в режиме "Статус по коду".
digStts Параметр: статусы Строка Входная связь Parameter|digStts Конфигурация статусов параметра со структурой {openedLabel}-{color};{closedLabel}-{color}, для дискретного блока.
com Параметр: команда Логический Полная связь Parameter|com Команда параметра "Открыть" или общая команда переключателя при отсутствии сигнала команды "Закрыть".
close Параметр: закрыть Логический Полная связь Parameter|close Команда параметра "Закрыть".
stop Параметр: останов Логический Полная связь Parameter|stop Команда параметра "Остановить".
com_text Параметр: текст команды (из digComs) Строка Полная связь Parameter|com_text Текст команды параметра, в режиме "Статус по коду".
digComs Параметр: команды Строка Входная связь Parameter|digComs Конфигурация команд параметра со структурой {openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}, для дискретного блока, и {com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}, для статуса по коду.
ntf Уведомление "{st}:{modes}:{Текст речи}" Строка Постоянная Конфигурация формирования сообщения по статусу (st) [0|1] и режимам-методам уведомления (modes), как строка чисел методов, и речью, если указано такой метод.


1.4 Метка изображением (ImgLab)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 1.4 служит для отображения динамических меток изображений, которые формируются на основе дискретных сигналов. Также этот элемент генерирует уведомления про нарушения по локально определённому условию, атрибут ntf. Элемент в целом использует и представляет представительскую структуру DAQ-шаблонов дискретного блока и состояния по коду.

Рис.1.4. Элемент "Метка изображением" в режиме разработки и выполнения (слева направо)
.

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением меток изображением и/или как элемент статической экранной таблицы. Для использования нужно добавить данный виджет на мнемосхему, подстроить горизонтальный, вертикальный размер и связать с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается изображение метки на фоне, которые соответствуют значениям дискретных сигналов параметра и конфигурации состояний в атрибуте imgs; где фон, зависимо от наличия нарушения соответствующего условию атрибута ntf, устанавливается в цвет нарушения; и которым изображение несквитированного параметра может мигать. При аппаратных ошибках и недостоверности данных, фон отображается серым цветом.

В активном режиме элемента можно получить паспорт, двойным кликом левой клавиши мыши на поле виджета. В паспорте будут представлены все свойства параметра. При нажатии левой клавиши мыши в области виджета появится панель управления параметром, и выбор данного виджета будет отображаться мигающей рамкой. Команды дублируются в контекстном меню, которое появляется при нажатии правой клавиши мыши в области виджета.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
NAME Параметр: имя Строка Входная связь Parameter|NAME Краткое наименование параметра, которое вставляется в уведомление про нарушения и действия оператора-пользователя.
DESCR Параметр: описание Строка Входная связь Parameter|DESCR Описание или развёрнутое название параметра, которое вставляется в уведомление про нарушения и действия оператора-пользователя.
st_open Параметр: статус-открыто Логический Входная связь Parameter|st_open Статус параметра "Открыто" или общий статус переключателя при отсутствии сигнала статуса "Закрыто".
st_close Параметр: статус-закрыт Логический Входная связь Parameter|st_close Статус параметра "Закрыто".
st_img Параметр: статус "{img}:{bCol}:{blink}" Строка Входная связь Parameter|st_text Изображение состояния параметра, в режиме "Статус по коду", где:
imgs Изображение, для "{openedImage}-{bCol}:{closedImage}-{bCol}:{EVAL}-{bCol}" Строка Постоянная Конфигурация статусов параметра со структурой {openedLabel}-{color};{closedLabel}-{color};{EVALLabel}-{color}, для дискретного блока.
digStts Параметр: статусы Строка Входная связь Parameter|digStts Стандартная конфигурация статусов параметра со структурой {openedLabel}-{color};{closedLabel}-{color}', для дискретного блока и отсутствия атрибута imgs.
com Параметр: команда Логический Полная связь Parameter|com Команда параметра "Открыть" или общая команда переключателя при отсутствии сигнала команды "Закрыть".
close Параметр: закрыть Логический Полная связь Parameter|close Команда параметра "Закрыть".
stop Параметр: останов Логический Полная связь Parameter|stop Команда параметра "Остановить".
com_text Параметр: текст команды (из digComs) Строка Полная связь Parameter|com_text Текст команды параметра, в режиме "Статус по коду".
digComs Параметр: команды Строка Входная связь Parameter|digComs Конфигурация команд параметра со структурой {openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}, для дискретного блока, и {com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}, для статуса по коду.
ntf Уведомление "{st}:{modes}:{Текст речи}" Строка Постоянная Конфигурация формирования сообщения по статусу (st) [0|1] и режимам-методам уведомления (modes), как строка чисел методов, и речью, если указано такой метод.


1.5 Нарушения — активное (alarmsAct)

1.4 GPLv2 * en, uk, ru Роман Савоченко

Элемент на рисунке 1.5 служит для динамического отображения активных нарушений в табличном виде и с выделением их цветом и текстом. Нарушения получаются из буфера текущих-активных нарушений OpenSCADA. Фактически элемент реализует функции примитива "Протокол" для нарушений и с расширением возможностей.

Сортирование сообщений зафиксировано по правилу "активные + наибольший уровень + последние" для сообщений вверху, что можно изменить только редактированием исходного текста елемента.

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

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

Основным пользовательским расширением является возможность определения видимых полей таблицы из перечня вариантов:

At.png Этот элемент и его поля в целом представляют структуру сообщения нарушения, которая детально описана в руководстве пользователя.

Как можно видеть из перечня возможных полей таблицы, этот элемент поддерживает механизм подтверждения (квитации), комментирования и пользовательские поля.

Рис.1.5. Элемент "Нарушения — активное" в режиме разработки и исполнения (сверху вниз).

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с постоянным отображением активных нарушений или для общего их отображения на корневой странице. Для использования необходимо добавить этот виджет на мнемосхему или корневую страницу, подстроить горизонтальный, вертикальный размер, настроить вертикальное расширение и откорректировать другие свойства вроде перечня и последовательности отображаемых полей таблицы.

Если нужно выключить функцию подтверждения то вы должны исключить время подтверждения "qttm" из перечня полей и установить элемент неактивным.

Использование — исполнение
В режиме использования строится таблица из перечня активных нарушений, для определённых полей, правила сортирования и выделения; содержимое которой периодически и динамически обновляется. При выборе таблицы, получение фокуса, её высота может расширяться, отобразив больше сообщений, если эта функцию включена и есть соответствие условию из определённого количества нарушений.

Пользователю предоставляется возможность подтвердить нарушение, изменив значение поля времени подтверждения или с помощью панели управления, которая выплывет при выборе элемента и строки нарушения.

Ещё пользователь может оставить комментарий к нарушению, откорректировав соответствующее поле таблицы.

Linking and configuring the attributes

Identifier Name Type Description
active Active Boolean Turn off if there disabled confirmation, focus gaining and editing in general — purely displaying.
hHdrVis Show header: horizontal Boolean
vHdrVis Show header: vertical Boolean
formDtTm Data and time format (%Y-%m-%d %H.%M.%S[.%MS,%US]) String Format of displaying the time of violation and confirmation.
expOnItems Expand on focus: items (<=0-disabled) Integer Maximum number of messages to trigger the element expansion, height increasing, at focus gaining.
expOnFocus Expand on focus: pixels (0-disabled,>-down,<-up) Integer Set to the desired value of the element extension, height increasing, at focus gaining.
colms Columns

List separated by ',' from the variants: atm, qttm, lev, type, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.

String Determine in the desired sequence and the fields filling.
highLght Highlight rules

Rows in the form "{lev}[{slev}]{quitt}:{color}:{font}:{fontColor}".

Text Highlight rules, where:
  • lev — main level of the message [0...7];
  • slev — sub-level of the message [0...9], optional;
  • quitt — sign of the message confirmation (quietation) [0|1];
  • color — background color of the message row;
  • font — text font of the message row;
  • fontColor — text color of the message row.

Te example:

#<SnthHgl font="monospace">
# <rule expr="^#[^\n]*" color="gray" font_italic="1"/>
# <rule expr="^[0-9]*" color="blue">
#  <rule expr="[01]$" color="red"/>
# </rule>
# <rule expr="(?<=:).*" font_weight="1"/>
#</SnthHgl>
50:gray
40:red
150:yellow
colDscrCustNames Перечень наименований пользовательских полей, поделённых ';' Строка (перевод) При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.
types Перечень типов по уровню от 0, разделены ';' Строка (перевод) Типы-названия нарушений за их уровнем, типично "Отладка;Информ.;Отметка;Предупр.;Ошибка;Критически;Тревога;Авария".
messCat Категория сообщений Строка Категория обрабатываемых сообщений нарушений, типично пусто для всей нарушений.


1.6 Свойства объекта (objProps)

1.2 GPLv2 * en, uk, ru Роман Савоченко

Элемент на рисунке 1.6 служит для отображения свойств источника данных в табличном виде и с выделением их цветом, как объект, и предоставления возможности изменения значения свойств с правом записи. Также этот элемент генерирует сообщения про нарушения согласно особенностям объекта. Элемент в целом использует и предоставляет представительскую структуру DAQ-шаблонов "Комплексный объект".

Рис.1.6. Элемент "Свойства объекта" в режиме разработки и выполнения (слева направо).

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с консолидированным отображением объекта как целое и сущности со свойствами. Для использования необходимо добавить этот виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и связать с параметром источника данных от DAQ-шаблона "Комплексный объект".

Использование — исполнение
В режиме исполнения отображается таблица со свойствами в строках, где первая колонка это название свойства, а вторая её значение. Строка может подсвечиваться фоном аварийного цвета, в случае нарушения по этому свойству. Особенное значение имеет и заголовок виджета где отображается название объекта, фон цвета которого может приобретать аварийные цвета, при наличии нарушений у объекта.

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

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
objName Объект: имя Строка Входная связь Object|NAME Имя объекта для заголовка.
objDescr Объект: описание Текст Входная связь Object|DESCR Описание объекта для подсказки к заголовку.
objErr Объект: ошибка Строка Входная связь Object|err Ошибка объекта для формирования сообщения и подсвечивания заголовка, обрабатываются коды концепции.
objItems Объект: элементы Объект Входная связь Object|items Описательный объект свойств физического объекта, согласно концепции.


1.7 Календарь (calendar)

1.0 GPLv2 * en, uk, ru Роман Савоченко

Элемент на рисунке 1.7 служит для отображения месяца календаря по неделям, который предусматривает возможность выбора года, месяца и отдельного дня, а также переход к текущему дню.

Рис.1.7. Элемент "Календарь" в режиме разработки и выполнения (слева направо).

Использование — разработка
Этот виджет может быть использован разработчиком при создании мнемосхем с отображением календаря. Для использования необходимо добавить этот виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и использовать атрибут "selTime" этого виджета для получения и установки даты.

Использование — исполнение
В режиме исполнения отображается соответствующий выбранному год, месяц и подсвечен день, согласно значению атрибута "selTime".

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

Свойства связывания и конфигурации

Идентификатор Имя Тип Описание
selTime Выбранное время Целое Время календаря в секундах от UNIX-эпохи.


1.8 Weather (weather)

1.0 GPLv2 * en, uk Roman Savochenko

The element on Figure 1.8 is used to display weather data from parameters on the DAQ-template "Weather".

Fig.1.8. The element "Weather" in the development and runtime modes (left to right).

Using — development
This widget can be used the developer to create mnemonic schemes with displaying the weather. To use it you need to add this widget to a mnemonic scheme, adjust for the horizontal, vertical size, by scaling, and link to the data source parameter at the DAQ-template "Weather".

Using — runtime
In the runtime mode, the current weather is displayed in the top and forecast displayed in the bottom with details on the images' tooltip.

At.png Images for some weather conditions can be missed yet due to the images are still appended!

Linking and configuring the attributes

Identifier Name Type Configuration Configuration template Description
current Weather: Current Object Input link Parameter|current The object with current data.
forecast Weather: Forecast Object Input link Parameter|forecast The object with forecast data.


2 Корневая страница (СО) (RootPgSo)

2.7 GPLv2 * en, uk, ru Роман Савоченко 1000 мс

Элемент-кадр, представленный на рисунке 2, служит базой для создания пользовательских интерфейсов, начально для управления технологическими процессами, основанными на объектах сигнализации (СО).

Корневая страница содержит четыре области:

Область кнопок-индикаторов объектов сигнализации служит для предоставления информации о наличии нарушений в объекте сигнализации, а также для переключения между ними.

Для отображения выбранного объекта сигнализации используется цвет фона, согласно стилям: backColorButton и backColorButtonSel. А нарушения отображаются цветом текста, согласно стилям: labColorGood, labColorWarning, labColorAlarm; и которыми текст несквитированного объекта сигнализации может мигать.

Buttons are currently generated dynamically by copying the first and only, according to the virtual pages of the signal objects in the project tree, with the serial digital identification from 1 (one). The limitation on the number of buttons or signal objects is only the total length of the names of the signal objects that can be placed in two rows of these buttons. That is, for short names we can get up to near 100 signal objects. If the signal object is one, even this single base button is hidden.

Область навигации по видами отображения — индикация выбора и выбор вида отображения как, например: "Мнемосхемы", "Группы графиков", "Группы контуров", "Документы" и другое; и кнопки перелистывания или комбобокс прямого выбора кадров в объекте сигнализации.

Пространство кнопок видов отображения является динамическим, в смысле занимания пространства отсутствующих, и значение самих видов отображения настраивается на другое от типичного значение, т.е. предусмотрено два основных вида отображения (view1 и view2), три дополнительных (view3, view4 и view5), а также один общий на весь интерфейс (view6).

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

Контейнер основных кадров пользовательского интерфейса — область контейнера для включения в неё основных кадров при выборе их кнопками режимов отображения или смене объекта сигнализации.

Общая таблица активных нарушений — содержит цветные строки актуальных нарушений, которые упорядочены по их важности с наиболее важными наверху. Изначально виджет выключен.

Контейнер панелей управления — область контейнера для включения в неё панелей управления различными объектами в области контейнера основных кадров, например — панель параметра, документа, графика и т.д.

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

Рис.2a. Кадр "Корневая страница (СО)" в режиме разработки.

Использование — разработка
Данный виджет может использоваться только в режиме корневой страницы, которая должна помещаться в дерево проекта как элемент "so". Кроме этого, вокруг главной страницы должна быть развёрнута следующая древовидная иерархия:

/control/* — логический контейнер, содержит различные панели управления;
/so/ — этот кадр как контейнер, содержит логические контейнеры объектов сигнализации:
{n}/ — логический контейнер объекта сигнализации n (1...), содержит логические контейнера и шаблоны видов отображения:
[view1|mn]/* — вид отображения 1 (обычно и ранее это мнемосхемы), содержит множество страниц конечных кадров;
[view2|ggraph]/* — вид отображения 2 (обычно и ранее это шаблон группы графиков), содержит множество страниц конечных кадров;
[view3|gcadr]/* — вид отображения 3 (обычно и ранее это шаблон группы контуров), содержит множество страниц конечных кадров;
[view4|gview]/* — вид отображения 4 (обычно и ранее это шаблон группы обзорных кадров), содержит множество страниц конечных кадров;
[view5|doc]/* — вид отображения 5 (обычно и ранее это логический контейнер документов), содержит множество страниц конечных кадров;
greg/* — специфический шаблон страницы настройки ПИД-регулятора, содержит множество страниц конечной конфигурации ПИД-регуляторов, подключенных статически и которые вызываются только кнопкой "ПИД" элемента кадра.
[view6|rg]/ — логический контейнер глобального вида отображения 6 (обычно и ранее это сводные графики — общие графики для всего интерфейса):
[view6|rg]/* — вид отображения 6 (обычно и ранее это шаблон сводных графиков), содержит множество страниц конечных кадров.

At.png Identifiers of the pages of the types of view, specified as [view1|mn], must be specified in the tree either in the new scheme "view1" or in the old scheme "mn". Mixing is not supported and the view items must not be empty, that is contain at least one active page!

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

Все дальнейшие настройки и редактирования около этого кадра нужно осуществлять для его копии-ссылки в дереве проекта, и настойчиво не рекомендуется редактировать его в библиотеке, иначе Вы потеряете возможность обновления библиотеки или эти изменения, при её обновлении!

Текст и подсказка кнопок видов отображения изменяется непосредственно в соответствующих свойствах этих виджетов. Быстрые клавиши вида отображения берутся из скобок всплывающей подсказки, вроде "Графики (CtrlAlt+G)", и соответственно обрабатываются. Для изменения изображения вида отображения достаточно переопределить иконку соответствующего вида, вроде "view1", путём загрузки изображения с соответствующим именем в Mime-данные проекта.

Для включения общей таблицы активных нарушений просто установить 1 (один) в конфигурации связей кадра для "alarms > en".

Для включения и конфигурации возврата к некоторому непривилегированному пользователю после некоторого времени неактивности, просто установить {минуты)-{пользователь} в конфигурации связей кадра для "defUser".

Изображение логотипа можно изменить также само, как и изображение вида отображения, т.е. загрузить в Mime-данные проекта новое изображение с названием "logo", после чего можно откорректировать геометрию виджета логотипа под нужные пропорции. Виджет изображения можно перенести влево, подвинув предварительно кнопку объекта сигнализации вправо на размер логотипа. Если логотип вообще не нужен то обнулить ширину его виджета, но не удаляйте его!

Панель навигации и контейнер панелей управления потенциально также можно перенести влево, подвинув контейнер основных кадров, а может и кнопку объекта сигнализации вправо.

При необходимости, корневую страницу можно дополнить дополнительными элементами, которые не нуждаются в особенной обработке, т.е. — изменение исходной процедуры кадра, что уже является не использованием, а редактированием. At.png Тут нужно отметить, что уменьшение размеров этого контейнера, как и любого другого, приведёт к появлению полос прокрутки и-или будет требовать корректировки кадров размещения в контейнер, но этого может быть не нужно совершать, учитывая расширение контейнера на неиспользованные строки кнопок объектов сигнализации.

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

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

At.png The frame supports now of working with very big "Periodic processing" value or disabling the periodic processing in whole (the value -2) and that value also propagated to the child pages and widgets if they want such behaviour (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Смена кадра в контейнере панелей управления не отслеживается и они в целом вызываются из интерфейса основных кадров, разве-что он очищается со сменой основного кадру путём открытия панели-заглушки.

Из основных действий, кадром предоставляется возможность пользователю выбрать объект сигнализации, вид отображения и соответствующий кадр. Нажав кнопку объекта сигнализации, вида отображения, прямо выбрав в комбобоксе или полистав; результатом чего является вызов соответствующего кадра в контейнере основных кадров. Из дополнительных действий, пользователь может сквитировать нарушение-уведомление и запустить Демо-режим, если он предусмотрен. Типовая настройка кадра предусматривает обслуживание ряда горячих клавиш, таких как CtrlAlt+[1...0] для вызова объектов сигнализации от 1 до 10, и CtrlAlt+[MGCVDR] для вызова соответствующих видов отображения.

Рис.2b. Кадр "Корневая страница (СО)" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Описание
alarms > en (конфигурация) Сигналы > Включено Логический Включение общей таблицы активных нарушений
defUser (конфигурация) Типичное для возврата, {минут)-{пользователь} Строка Включение и конфигурация возврата к некоторому непривилегированному пользователю после некоторого времени неактивности, строкой {минуты)-{пользователь}.
demoPlayProc Проц. проигрывания демо Текст Процедура на языке JavaLikeCalc для проигрывания некоторой демонстрации. Включает кнопку Демо-режима в режиме исполнения. Для примера такой процедуры смотрите демонстрационные-проекты АГЛКС и Котел!
Специфические для визуализатора атрибуты для UI.Vision (больше) и UI.WebVision (больше)
keepAspectRatio Сохранять пропорцию при масштабировании Логический Сохранять пропорцию страниц при масштабировании.
stBarNoShow Не показывать строку статуса Логический Скрыть строку статуса главного окна.
Специфические для визуализатора атрибуты для UI.Vision (больше)
runWin Окно исполнения Выбор целых чисел Установка режима исполнения главного окна:
  • "Оригинальный размер (0)".
  • "Максимизировать (1)".
  • "На весь экран (2)".
statLine Элементы строки статуса Текст Текстовое поле с описанием элементов строки статуса пользователя.
winPosCntrSave Управление и сохранение положений окон Логический Включение управления и сохранения положения окон исполнения.
Основные процедуры механизма уведомлений
notify0 Уведомление: тип 0 (Свет) Текст
notify1 Уведомление: тип 1 (Гудок) Текст
notify2 Уведомление: тип 2 (СинтезРечи) Текст

3 Основные кадры

Содержит элементы-кадры шаблонного и конечного типов, а также элементы-виджеты и панели из которых они строятся и которые имеют отношение к их использованию. Эти кадры предназначены для размещения в дереве страниц проекта, построенного по концепции объектов сигнализации корневой страницы "RootPgSo". Однако они могут быть размещены как отдельные сущности или в составе собственной концепции управления страницами, но тут нужно учитывать, что кадры часто ссылаются и вызывают те или иные панели управления общего применения и связанные элементы!


3.1 Graphics group (grpGraph); Graphics group 10 (grpGraph10)

1.6 GPLv2 * en, uk, ru Roman Savochenko -1 ms (parent)

The element-frame shown in Figure 3.1 is provided for simultaneous observation of trends and control the parameters in the signal object, includes both instances of the widget "Graphics group element" of each parameter (up to 8 or 10) and the primitive "Diagram" to monitor the parameters' trends and browsing history, and also the scroll bar for fast navigation on allowed history of selected parameters for show. The variant in 10 trends is inherited from the base variant in 8 trends and you can create your own variants by inherit the base and append more graphics group elements.

Рис.3.1a. Кадр "Группа графиков" в режиме разработки.

Использование — разработка
Кадр предназначен для выполнения роли страницы-шаблона, а, следовательно, он должен непосредственно помещаться в дерево проекта. В проекте-шаблоне "Группы сигнализаций", для каждого объекта сигнализации, этот кадр включен в роли шаблона, что позволяет создавать на его основе множество страниц групп графиков. К каждому кадру могут подключаться до восьми-десяти параметров, путём установки связей. Графики, для которых не будут установлены связи, будут скрыты при исполнении или доступны для пользовательского выбора в случае наличия списка выборных параметров в атрибуте "Выбор: параметры доступные для выбора" (формат списка описан в диалоге выбора параметров).

Типичная глубина трендов в прошлое установлена в 10 минут — для текущего оперативного контроля, что, при необходимости, можно изменить непосредственно отредактировав соответствующее поле виджета диаграммы, например, для шаблонной страницы проекта, чтобы оно распространилось на все конечные страницы.

Использование — исполнение
В режиме исполнения отображаются графики, для которых установлены связи. Управление параметрами с элементов группы графиков детально описано в разделе виджета "Элемент группы графиков (ElViewGraph)". Дополнительно можно управлять свойствами отображения графиков, для чего автоматически с этой страницей открывается панель управления графиком, или необходимо левой клавишей мыши нажать в области графика.

At.png The frame supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Рис.3.1b. Кадр "Группа графиков" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
name Имя Строка Постоянная Имя группы
allowSelLst Выбор: параметры доступные для выбора Текст Нет Поместите сюда параметры для выбора пользователем, списком DAQ-путей к ним (детальнее смотрите в диалоге "Выбор параметра графика"):
/LogicLev/proc/prm_CPU/prm_load
/LogicLev/proc/prm_MEM/prm_use
/LogicLev/proc/prm_CPU/prm_T 
perUserSel Выбор: сохранять выбор по пользователям Логический Нет Установить для сохранения пользовательского выбора отдельно
Элемент {n} от 1 до 8(10)
el{n} Перечень связываемых атрибутов соответствует перечню виджета "Элемент группы графиков (ElViewGraph)"


3.1.1 Graphics group element (ElViewGraph)

1.5 GPLv2 * en, uk, ru Roman Savochenko 2000 ms

The element-widget shown in Figure 3.1.1 is provided to create graphics groups. The widget contains information about parameter, the regulator mode, if the parameter is such, the units of analog parameter, as well as the color corresponding to the parameter's trend. The widget commonly uses and represents the representative structure of the DAQ-templates "Analog signal" and "Discrete block".

Рис.3.1.1a. Виджет "Элемент группы графиков" в режиме разработки.

Using — development
Though this widget is not intended for independent use in isolation from the graphics groups, it can be used, for example, placing it to the mnemonic scheme and linking with the data source parameter.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается название параметра, режим регулятора (только для регулятора), текущее значение-переменная и единица измерения этого параметра; которые, в зависимости от наличия нарушения, отображаются цветом стиля: labColorGood, labColorWarning, labColorAlarm. При аппаратных ошибках и недостоверности данных, последнее значение отображается серым цветом.

Except the available visual data, a number of control elements are provided:

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

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Рис.3.1.1b. Виджет "Элемент группы графиков" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
name Имя Строка Входная связь Parametr|NAME Имя-шифр параметра, для отображения в поле имени.
dscr Описание Текст Входная связь Parameter|DESCR Имя параметра, для помещения в tooltip и statusbar.
addr Адрес Адрес Входная связь Parameter|var Адрес к атрибуту значения параметра для построения графика.
color Цвет графика Строка Нет Рабочий цвет тренда
colorDef Типовой цвет из стиля Строка Нет Типовой цвет тренда на уровне кадра
Аналоговые параметры
ed Единица измерения Строка Входная связь Parameter|ed
prec Точность Целый Входная связь Parameter|prec Количество знаков после точки, для положительный значений, и точность (знаков вообще), для негативных, для отображения конечного реального значения на экране.
log Логарифмическая шкала Логический Входная связь Parameter|log
max Максимум Веществен. Входная связь Parameter|max Верхняя граница значения параметра.
min Минимум Веществен. Входная связь Parameter|min Нижняя граница значения параметра.
aMax Граница верхняя аварийная Веществен. Входная связь Parameter|aMax
aMin Граница нижняя аварийная Веществен. Входная связь Parameter|aMin
wMax Граница верхняя предупр. Веществен. Входная связь Parameter|wMax
wMin Граница нижняя предупр. Веществен. Входная связь Parameter|wMin
pModeA Режим регулятора: автомат Логический Входная связь Parameter|auto Режим регулятора "Автомат".
pModeC Режим регулятора: каскад Логический Входная связь Parameter|casc Режим регулятора "Каскад".
Дискретные параметры
digComs Дискретный: команды Строка Постоянная Наименования и цвет кнопок команд в формате {On}[-color]:{Off}[-color][:{Stop}[-color]]. Цвета по умолчанию: зеленый, красный и жёлтый.
digStts Дискретный: состояния Строка Постоянная Наименования и цвет надписей состояний в формате {On}[-color]:{Off}[-color]. Цвета по умолчанию: зеленый и красный.
digRevers Дискретный: реверс Логический Постоянная Реверс дискретного сигнала.


3.1.2 Выбор параметра графика (graphSelPrm)

1.5 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунке 3.1.2, реализует диалог пользовательского выбора источников данных, часто архивных, для формирования графика в кадре "Группа графиков". Выбор предоставляется из перечня указанного в атрибуте "Выбор: параметры доступные для выбора (allowSelLst)", кадра-инициатора. Для выбранного источника можно указать имя, шкалу, логарифмичность, единицу измерения и цвет графика.

В атрибуте "Выбор: параметры доступные для выбора (allowSelLst)" должны помещаться источники данных в виде:

Примеры содержимого атрибута "Выбор: параметры доступные для выбора (allowSelLst)":

/System/AutoDA/prm_CPULoad/load:CPU Load:0:100:%
/LogicLev/gen/prm_F3
<varhs>
Рис.3.1.2. Кадр "Выбор параметра графика" в режиме разработки и исполнения.

Использование — разработка
Данный кадр должен быть помещен в логический контейнер панелей дерева проекта. В "Группах графиков", которые должны предоставлять возможность пользовательского выбора источника, должен быть определён атрибут "Выбор: параметры доступные для выбора (allowSelLst)", перечнем источников согласно правилам указанным выше. Как результат, в контекстном меню элемента графика появится пункт "Выбор".

Использование — исполнение
Вызов диалога осуществляется посредством пункта "Выбор", контекстного меню элемента графика. Диалогом пользователю предоставляется выбор источника данных из списка, а так-же указание основных его параметров: имя, шкала, логарифмичность, единица измерения и цвет графика, который вы также можете выбрать типичным/стилевым через очистку. При подтверждении, выбранные параметры применяются к элементу графика, заменяя ссылки. Выбор и подтверждение пункта "<Очистить>" приведёт к очистке всех ссылок и элемента графика. В текстовом поле под списком можно быстро найти нужный параметр.


3.1.3 Вычисление параметра графика (graphCalc)

1.0 GPLv2 * en, uk, ru Роман Савоченко

Элемент, представленный на рисунке 3.1.3, реализует диалог пользовательского вычисления параметра выбранного графика для видимых на графике данных. Пользователю предоставляется возможность выбрать вычисление из встроенной библиотеки, привилегированный пользователь ("root" или в группе "ITW") имеет возможность отредактировать или написать собственную процедуру вычисления.

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

Рис.3.1.3. Кадр "Вычисление параметра графика" в режиме разработки и исполнения.

Использование — разработка
Этот кадр должен быть размещён в логическом контейнере панелей дерева проекта.

Использование — исполнение
Вызов диалога осуществляется посредством пункта "Вычисление", контекстного меню элемента графика. Диалогом пользователю предоставляется выбор функции вычисления видимых данных выбранного параметра и возможность отредактировать-написать собственную функцию, для привилегированного пользователя. Результат вычисления помещается в соответствующем текстовом поле.


3.2 Группа контуров (grpCadr)

1.3 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент-кадр, представленный на рисунке 3.2, служит для одновременного наблюдения и управления контурами нескольких параметров, до восьми, включает в себя как экземпляры виджета "Элемент кадр" для каждого контура, так и примитив "Диаграмма" для наблюдения за трендами контуров и просмотра истории.

Рис.3.2a. Кадр "Группа контуров" в режиме разработки.

Использование — разработка
Кадр предназначен для выполнения роли страницы-шаблона, а, следовательно, он должен непосредственно помещаться в дерево проекта. В проекте-шаблоне "Группы сигнализаций", для первого объекта сигнализации, этот кадр включен в роли шаблона, что позволяет создавать на его основе множество страниц групп контуров. К каждому кадру могут подключаться до восьми параметров, путём установки связей. Контура и графики, для которых не будут установлены связи, будут скрыты при исполнении.

Типичная глубина трендов в прошлое установлена в 10 минут — для текущего оперативного контроля, что, при необходимости, можно изменить непосредственно отредактировав соответствующее поле виджета диаграммы, например, для шаблонной страницы проекта, чтобы оно распространилось на все конечные страницы.

Использование — исполнение
В режиме исполнения отображаются контура и графики, для которых установлены связи. Управление параметрами с контуров детально описано в разделе панели "Элемент кадр". В дополнении к этому можно управлять свойствами отображения графиков, для чего необходимо левой клавишей мыши нажать в область графика и с помощью появившейся панели управления графиком осуществить необходимые действия.

At.png The frame supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Рис.3.2b. Кадр "Группа контуров" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
grpName Имя группы Строка Постоянная Имя группы
Элемент {n} от 1 до 8.
el{n} Перечень связываемых атрибутов соответствует перечню панели "Элемент кадр (ElCadr)"


3.3 Группа обзорных кадров (ViewCadr)

1.1 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент-кадр, представленный на рисунке 3.3, служит для отображения текущих трендов параметров в отдельных кадрах-виджетах количеством до 24 единиц (6x4), относительно которых поддерживается масштабирование в зависимости от их конфигурируемого количества. Кадры-виджеты трендов параметров реализуются сопутствующим виджетом "Кадр обзорной группы".

Рис.3.3a. Кадр "Группа обзорных кадров" в режиме разработки.

Использование — разработка
Кадр предназначен для выполнения роли страницы-шаблона, а, следовательно, он должен непосредственно помещаться в дерево проекта. В проекте-шаблоне "Группы сигнализаций", для первого объекта сигнализации, этот кадр включен в роли шаблона, что позволяет создавать на его основе множество страниц обзорных групп. К каждому кадру могут подключаться до 24 параметров, путём установки связей. Кадры-виджеты, для которых не будут установлены связи, будут скрыты при исполнении, и осуществлено пропорциональное масштабирование на отсутствующие полные строки и колонки с целью заполнения всего кадра.

Использование — исполнение
В режиме исполнения отображаются кадры-виджеты, для которых установлены связи. Управление параметрами с кадров-виджетов детально описано в разделе виджета "Кадр обзорной группы".

Рис.3.3b. Кадр "Группа обзорных кадров" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
name Имя Строка Постоянная Имя кадра
Кадр-виджет {r}_{c}, где строки {r} от 1 до 4 и колонки {c} от 1 до 6.
el{r}_{c} Перечень связываемых атрибутов соответствует перечню виджета "Кадр обзорной группы (ElViewCadr)"


3.3.1 Кадр группы обзора (ElViewCadr)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент-виджет, представленный на рисунке 3.3.1, служит основой группы обзорных кадров и обычно не используется самостоятельно. Виджет отображает текстовую информацию о параметре в виде наименования и значения, а также тренд параметра за небольшой промежуток времени (2 минуты) для наблюдения за текущей тенденцией поведения параметра с авто-масштабированием по шкале значения. Виджет в целом использует и представляет представительскую структуру DAQ-шаблона "Аналоговый сигнал".

Рис.3.3.1. Виджет "Кадр группы обзора" в режиме разработки и исполнения (слева направо).

Использование — разработка
Хотя данный виджет не предназначен для самостоятельного использования, в отрыве от группы обзора, использовать его всё-же можно, например, поместив на мнемосхему и установив связь с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле елемента, отображается название параметра, текущее значение-переменная и тренд параметра; которые всегда отображаются цветом стиля: labColorGood.

В активном режиме элемента можно получить паспорт путём нажатия правой клавиши мыши на поле виджета. В паспорте будут представлены все свойства параметра. При нажатии левой клавишей мыши в области панелей появится панель управления параметром, а выбор данного виджета будет отображаться мигающей рамкой.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
name Имя Строка Входная связь Parameter|NAME Имя параметра (шифр) для отображения в поле имени.
addr Адрес Адрес Входная связь Parameter|var Адрес к атрибуту значения параметра для построения тренда.
var Переменная Вещественный Входная связь Parameter|var Непосредственно значение параметра для отображения в поле значения.


3.4 Сводные графики (ResultGraph)

1.1 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент-кадр, представленный на рисунке 3.4, служит для отображения группы текущих трендов параметров (до 5) в отдельных кадрах-виджетах количеством до 16 единиц (4x4), относительно которых поддерживается масштабирование в зависимости от их конфигурируемого количества. Кадры-виджеты трендов параметров реализуются сопутствующим виджетом "Кадр сводных графиков".

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

At.png Кадр не поддерживает никакого управления.

Рис.3.4a. Кадр "Сводные графики" в режиме разработки.

Использование — разработка
Кадр предназначен для выполнения роли страницы-шаблона, а, следовательно, он должен непосредственно помещаться в дерево проекта. В проекте-шаблоне "Группы сигнализаций", на уровне корневой страницы для него предусмотрено специальную виртуальную страницу "Сводные графики" с шаблоном сводных графиков, что позволяет создавать на его основе множество страниц сводных графиков. К каждому кадру могут подключаться до 80 параметров, путём установки связей. Кадры-виджеты, для которых не будет установлено ни одной связи, будут скрыты при исполнении, и осуществлено пропорциональное масштабирование на отсутствующие полные строки и колонки с целью заполнения всего кадра.

Использование — исполнение
В режиме исполнения отображаются кадры-виджеты, для которых установлены связи.

Рис.3.4b. Кадр "Сводные графики" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
grpName Имя группы Строка Постоянная Имя группы
Кадр-виджет {n} от 1 до 16.
el{n} Перечень связываемых атрибутов соответствует виджету "Кадр сводных графиков (ResultGraphEl)".


3.4.1 Кадр сводных графиков (ResultGraphEl)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент-виджет, представленный на рисунке 3.4.1, служит основой сводных графиков и обычно не используется самостоятельно. Виджет отображает название группы и до пяти трендов, с их текстовыми метками, за фиксированный промежуток времени (10 минут) для наблюдения за текущей тенденцией поведения параметров. Виджет в целом использует и представляет представительскую структуру DAQ-шаблона "Аналоговый сигнал".

Рис.3.4.1. Виджет "Кадр сводных графиков" в режиме разработки и исполнения (слева направо).

Использование — разработка
Хотя данный виджет не предназначен для самостоятельного использования, в отрыве от сводных графиков, использовать его всё-же можно, например, поместив на мнемосхему и установив связь с параметром источника данных.

Использование — исполнение
В режиме исполнения, в основном поле элемента, отображается заголовок группы, заголовки и тренды параметров в определённых конфигурацией или стилем цветах.

At.png The widget supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent widget/page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
title Заголовок Строка Постоянная Отображается сверху графика, при отсутствии поле графика расширится вверх.
Параметр {n} от 1 до 5.
p1_addr Параметр{n}: адрес Адрес Входная связь Parameter {n}|var Адрес к атрибуту значения параметра для построения графика {n}.
p{n}_clr Параметр{n}: цвет Цвет Из стиля labColorGrph{n}
p{n}_max Параметр{n}: максимум Вещественный Входная связь Parameter {n}|max Максимальная граница графика.
p{n}_min Параметр{n}: минимум Вещественный Входная связь Parameter {n}|min Минимальная граница графика.
p{n}_name Параметр{n}: имя Строка Входная связь Parameter {n}|NAME Короткое имя параметра для отображения в поле слева.


3.5 Панель настройки регулятора (cntrRegul)

1.2 GPLv2 * en, uk, ru Роман Савоченко

Элемент-кадр, представленный на рисунке 3.5, служит для настройки ПИД-регулятора, включает в себя информацию о параметре-регуляторе, поля настроек регулятора и примитив "Диаграмма", для наблюдения за трендами регулятора и просмотра истории. Кадр в целом использует и представляет представительскую структуру DAQ-шаблона аналогового и импульсного ПИД-регуляторов.

Рис.3.5a. Кадр "Панель настройки регулятора" в режиме разработки.

Использование — разработка
Кадр может использоваться как в роли панели, вызываемой из панели управления параметрами, так и в роли страницы-шаблона. Кадр должен непосредственно помещаться в дерево проекта, а именно в контейнер панелей, где будет осуществляться динамическое связывание на параметр регулятора. Для создания статического перечня контуров настроек регуляторов, с возможностью последующего листания по ним, необходимо поместить их в контейнер контуров регуляторов "greg" каждого объекта сигнализации и статически связать с соответствующим параметром, а также обеспечить равенство идентификатора панели и связанного параметра.

Типичная глубина трендов в прошлое установлена в 20 минут — для текущего оперативного контроля, что, при необходимости, можно изменить непосредственно отредактировав соответствующее поле виджета диаграммы.

Использование — исполнение
В режиме исполнения отображается:

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

Рис.3.5b. Кадр "Панель настройки регулятора" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
SHIFR Параметр: шифр Строка Входная связь Parameter|SHIFR
NAME Параметр: шифр Строка Входная связь Parameter|NAME
DESCR Параметр: описание Строка Входная связь Parameter|DESCR
max Параметр: максимум шкалы Вещественный Входная связь Parameter|max
min Параметр: минимум шкалы Вещественный Входная связь Parameter|min
ed Параметр: единица измерения Строка Входная связь Parameter|ed
prec Параметр: точность Целый Входная связь Parameter|prec Количество знаков после запятой в значении и задании параметра ПИД.
var Параметр: переменная Вещественный Входная связь Parameter|var
var_addr Параметр: адрес переменной Адрес Входная связь Parameter|var Адрес для построения графика переменной.
ПИД-регулятор
auto_addr Параметр: автомат Адрес Входная связь Parameter|auto Адрес для построения графика режима "Автомат".
sp Параметр: задание Вещественный Входная связь Parameter|sp
sp_addr Параметр: адрес задания Адрес Входная связь Parameter|sp Адрес для построения графика задания.
out Параметр: выход Вещественный Входная связь Parameter|out
out_addr Параметр: адрес выхода Адрес Входная связь Parameter|out Адрес для построения графика аналогового выхода.
Hdwn Параметр: нижняя граница выхода Вещественный Полная связь Parameter|Hdwn Ограничение значения аналогового выхода по низу.
Hup Параметр: верхняя граница выхода Вещественный Полная связь Parameter|Hup Ограничение значения аналогового выхода по верху.
Kp Параметр: коэф. пропорциональности Вещественный Полная связь Parameter|Kp
Ki Параметр: коэф. пропорциональности интеграла Вещественный Полная связь Parameter|Ki
Ti Параметр: время интегрирования Вещественный Полная связь Parameter|Ti
Kd Параметр: коэф. пропорциональности производной Вещественный Полная связь Parameter|Kd
Td Параметр: время дифференцирования Вещественный Полная связь Parameter|Td
Tzd Параметр: время задержки дифференциальной части Вещественный Полная связь Parameter|Tzd
Zi Параметр: зона нечувствительности Вещественный Полная связь Parameter|Zi
K1 Параметр: коэф. входа 1 Вещественный Полная связь Parameter|K1
K2 Параметр: коэф. входа 2 Вещественный Полная связь Parameter|K2
K3 Параметр: коэф. входа 3 Вещественный Полная связь Parameter|K3
K4 Параметр: коэф. входа 4 Вещественный Полная связь Parameter|K4
Импульсный ПИД-регулятор
impQdwn_addr Параметр: адрес выхода импульса вниз Адрес Входная связь Parameter|impQdwn Адрес для построения графика импульсного выхода "Вниз".
impQup_addr Параметр: адрес выхода импульса вверх Адрес Входная связь Parameter|impQup Адрес для построения графика импульсного выхода "Вверх".
KImpRfact Параметр: рейтинг фактор Вещественный Полная связь Parameter|KImpRfact Асимметрия в генерации ширины импульса вверх и вниз.
TImpMin Параметр: минимальное время импульса Целый Полная связь Parameter|TImpMin Генерируются импульсы начиная с указанной ширины.
TImpPer Параметр: период повторения импульсов Целый Полная связь Parameter|TImpPer Периодичность повторения генерации импульса.


3.6 Нарушение — состояние (alarmsSt)

1.5 GPLv2 * en, uk, ru Роман Савоченко

Элемент-кадр на рисунке 3.6 служит для отображения истории нарушений и динамического их обновление для текущего времени в полноформатном табличном виде, с выделением их цветом и текстом и возможностью многоуровневого фильтрования. Нарушения получаются из буфера текущих-активных сообщений OpenSCADA и архива(ов), определённого конфигурационным полем "alArch". Фактически элемент реализует функции примитива "Протокол" для нарушений и с расширением возможностей.

В целом кадр содержит элементы:

Согласно объявленному перечню элементов контроля, сортировка сообщений может меняться пользователем, как путём встроенного механизма сортировки колонок отдельно взятого визуализатора, так и на уровне модели данных, если визуализатором такой функции не предусмотрено. Учитывая основное назначение кадра — состояние нарушений (т.е. история), типовым правилом сортировки является "последние" для сообщений сверху.

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

Основным пользовательским расширением является возможность определения видимых полей таблицы из перечня вариантов:

At.png Этот кадр и его поля в целом представляют структуру сообщения нарушения, которая детально описана в руководстве пользователя.

Как можно видеть из перечня возможных полей таблицы, этот элемент поддерживает механизм подтверждения, комментирования и пользовательские поля.

Рис.3.6a. Кадр "Нарушение — состояние" в режиме разработки.

Использование — разработка
Виджет предназначен для выполнения роли страницы, а, соответственно, он должен непосредственно располагаться в дереве проекта. После добавления, для кадра нужно отредактировать свойства вроде перечня и последовательности отображаемых полей таблицы.

At.png Поскольку кадр предусматривает отображение состояния и истории нарушений, то создание и использование архиватора сообщений является обязательным. Поэтому создайте или используйте шаблонный архиватор стартового проекта "Нарушения (alarms)" с опциями исключения дублирования, и укажите его (FSArch.alarms) в свойстве кадра "alArch".

Комбобокс выбора правила сортировки по умолчанию выключен из соображений использования встроенной функции сортирования по колонке таблицы соответствующего визуализатора. Если такая функция визуализатором не предоставляется то включите этот комбобокс.

Если нужно выключить функцию подтверждения то вы должны исключить время подтверждения "qttm" из перечня полей и установить элемент таблицы неактивным.

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

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

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

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

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

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

Ещё пользователь может оставить комментарий к нарушению, откорректировав соответствующее поле таблицы.

Для генерации отдельного отчёта пользователь может нажать характерную кнопку в правом верхнем углу, если такая функцию включена.

Рис.3.6b. Кадр "Нарушение — состояние" в режиме исполнения.

Linking and configuring the attributes

Identifier Name Type Description
messCat Message category String Category of the processing messages, typically it is "al*:*".
messLim Messages limit, quantity Integer Maximum quantity of the messages in the table, typically it is 1000.
alArch Alarms archiver, "{ArhMod}.{Arh}" String An archiver from which the violations will be taken, empty for all ones.
alarms.active Active Boolean Turn off if there disabled confirmation, focus gaining and editing in general — purely displaying.
hHdrVis Show header: horizontal Boolean
vHdrVis Show header: vertical Boolean
formDtTm Data and time format (%Y-%m-%d %H.%M.%S[.%MS,%US]) String Format of displaying the time of violation and confirmation.
colms Columns

List separated by ',' from the variants: atm, qttm, nrmtm, lev, type, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.

String Determine in the desired sequence and the fields filling.
highLght Highlight rules

Rows in the form "{lev}[{slev}]{quitt}{act}:{color}:{font}:{fontColor}".

Text Highlight rules, where:
  • lev — main level of the message [0...7];
  • slev — sub-level of the message [0...9], optional;
  • quitt — sign of the message confirmation [0|1];
  • act — sign of the message activity [0|1];
  • color — background color of the message row;
  • font — text font of the message row;
  • fontColor — text color of the message row.

Te example:

#<SnthHgl font="monospace">
# <rule expr="^#[^\n]*" color="gray" font_italic="1"/>
# <rule expr="^[0-9]*" color="blue">
#  <rule expr="[01]{2}$" color="red">
#   <rule expr="[01]$" color="darkorange"/>
#  </rule>
# </rule>
# <rule expr="(?<=:).*">
#  <rule expr="[^:]*" font_weight="1"/>
#  <rule expr="(?<=:).*" font_italic="1"/>
# </rule>
#</SnthHgl>
501:gray
401:red
1501:yellow
511:gray:Arial 11 0 1
411:red:Arial 11 0 1
1511:yellow:Arial 11 0 1
colDscrCustNames Перечень наименований пользовательских полей, поделённых ';' Строка (перевод) При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.
types Перечень типов по уровню от 0, разделены ';' Строка (перевод) Типы-названия нарушений за их уровнем, типично "Отладка;Информ.;Отметка;Предупр.;Ошибка;Критически;Тревога;Авария".


3.6.1 Report (alarmsStReport)

1.0 GPLv2 * en, uk, ru Roman Savochenko

The element-frame, shown in Figure 3.6.1, implements a dialog to display a report document based on a list of violations received from the full-format frame of presenting the violations history.

Основным назначением и функцией этого кадра является предоставление возможности распечатать таблицу истории нарушений и экспортировать из неё данные.

Рис.3.6.1. Кадр "Нарушения — отчёт".

Использование — разработка
Этот кадр должен быть размещён в логическом контейнере панелей дерева проекта.

Использование — исполнение
Вызов диалога осуществляется посредством характерной кнопки, вверху справа, кадра полноформатного представления истории нарушений. Диалогом предоставляется текст отчётного документа и кнопка, внизу справа, для его закрытия.


3.7 Менеджер пользователей (userManager)

1.6 GPLv2 * en, uk, ru Roman Savochenko -2 ms (disabled)

The element-frame, shown in Figure 3.7, serves to control users from the user interface itself. That is, typically this feature is provided to the SCADA programmer at the Security subsystem configuration, but sometimes there is a need to provide this capability from the user interface and with a few restrictions on controlled users and their groups that this frame performs and generally provides:

Рис.3.7a. Кадр "Менеджер пользователей" в режиме разработки.

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

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

Рис.3.7b. Кадр "Менеджер пользователей" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Описание
owner Владелец Строка Владелец и группа кадра, которые имеют к нему доступ, типично "root:Security" — для предоставления доступа к кадру нужно пользователя включить в группу "Security".
perm Доступ Выбор целых чисел Правила доступа к кадру, типично "RWRW__" — кадр видимый и контролируемый только для пользователя "root" и пользователей в группе "Security".
denyUsers Запрещённые для редактирования: пользователи, разделённые ';' Строка Перечень запрещённых для контроля пользователей, типично "root;".
denyGroups Запрещённые для редактирования: группы, разделённые ';' Строка Перечень запрещённых для контроля групп, типично "root;users;Archive;BD;DAQ;ModSched;Protocol;Security;Special;Transport;UI;".
newUseGrps Группы новосозданного пользователя Строка Группы в которые включать пользователя автоматически после создания, типично "UI;Guest".
storeDB БД хранения новых пользователей Строка БД хранения новосозданных пользователей, типично — рабочая.


3.8 Storehouse (storeHouse)

1.4 GPLv2 * en, uk Roman Savochenko -2 ms (disabled)

The element-frame, shown in Figure 3.8, serves to manage of storehouses on different classes-categories of the storing-managing things. Initially that was developed and tested on the class "Library". The frame means of the direct accessing the DB by SQL and currently supports only MySQL/MariaDB.

During the frame implementing, the view "Table" of the primitive "FormEl" significantly expanded on both visualizers for:

  • VCAEngine,QTStarter,Vision,WebVision: Appended by the new cell type 't'-text mostly for allowing the edition confirming the type 's'-string by pressing Enter.
  • VCAEngine,Vision,WebVision: Appended of the column, row and cell space option "prec" of the real value precision control; and by the column and cell attribute "align" implementation.
  • WebVision,Vision: Appended for switching the tables in preventing of double storing the source content at the content size more for 10000.
  • FIX:Vision: Using the common table delegate with the feature of multiline edition.
  • Improved in the columns, rows and cells show at the table updation and commonly:
  • in limiting the visual size of the cell content in 300 symbols and the rows height in 70% from the whole table size;
  • more precision columns width alignment;
  • in fitting at the development mode and also at the vertical header show;
  • in the table close filling by consideration the visible vertical scrollbar size;
  • in fitting after the table whole resizing only, so allow the columns resizing manually also and to provide that true fitting always.
  • Implemented for the light processing of the width changing and updating:
  • light edition without the columns refitting all updating time, only at: first row appearing, columns count change and the column title change, font change and resize;
  • apply the column force width and the row height calculation with limits independently from the common attribute "colsWdthFit" value;
  • setting the value, early resizing and the table fitting, moved to the space of the table content presence and after the sorting.
  • The export function in runtime append of export the view Table of the primitive "FormEl" in CSV.
  • WebVision:
  • Improved in the columns, rows and cells show at the table updating and commonly:
  • the not fitting mode (the attribute "colsWdthFit" missing) implementation, using the automatic table layout mode for calculation the fixed widths and next switching to the fixed table layout mode;
  • multiline text edition of the text cells in whole width and height of the cell, with the edition apply by Ctrl+Enter;
  • view limiting the string cells in 300 symbols;
  • display the boolean cells as an image at the TRUE state;
  • table cells in the editing mode allowed for the system-browser context menu.
  • Implemented for the light processing of the width changing and updating:
  • the table changes detection and updating switched to the mode of not storing double source content;
  • prevented from the complete updating at the attribute "value" modification.
  • Appended for the sorting support by columns. Set to the first visible column for sorting at the sorting enable.


The frame provides currently and in future for next features:

The storehouse classes store in the table "classes" with the fixed table structure "CLASS, ID, NAME, TP , TBL, FILTER, PROC", where:

  • align — column alignment, supports the values: "left", "center", "right"; where the "left" value is default one for strings and "center" for other;
  • width — forced width for the column, in percents at symbol "%" in the end or in pixels;
  • pos — the column position in the string view, so you can write that like to "005" for true sort.
  • index — the column value means as whole one for indexing;
  • list{SepSymb} — the column value means as a list of items for indexing, separated by symbol SepSymb.
From the second line you can specify rules of the highlighting in the form "{ID}:{FLGS}:{color}:{font}", where:
  • ID — indexed or listed value in the cell;
  • FLGS — flags list in values [0|1], currently that is only "Highlight [Cell|Row]";
  • color — the background color;
  • font — the text font.
At.png Setting here a procedure will clean up (set to NULL) all the column cells!

Data of storehouse of the corresponded class stores in different table with name "sh_{CLASS}" and the structure "ID, NAME, DSCR, SP_{ID}1, ..., SP_{ID}N", where:

For the special means there in the table "classes" reserved and forcibly created fields "*TITLE" for the whole storehouse localised name and "*NAME", "*DSCR" which control the corresponded fixed fields.

Fig.3.8a. The "Storehouse" frame in the development mode.

Using — development
The widget is designed to perform the role of a page, and should therefore be placed directly in the project's tree. Additionally, into the panels folder of the project, you need to place the accepting dialog frame and some attribute configuration is required, below, where no links are provided.

To enable the reporting, you have to place the frame of alarms reporting in the logical container of panels of the project tree.

Using — runtime
In the runtime mode you will see a single big table for class (Fig.3.8b) and data (Fig.3.8c) representing with edition right in the table or in the item edition form (Fig.3.8d).

In the main class data representing mode the users can observe the table, filter and sort the representing data at the specified fields.

In the main class data edition mode the users, allowed to edit, can add, copy, remove the rows/records and edit the fields.

In the class edition mode, the users, allowed to edit, can add new and remove present (after removing the last item) classes; and add, remove the specific class fields and edit properties of that fields.

For user access limitation there provided now only a mechanism of including the allowed for the class and data edition users to the group "ITW".

To generate a separate report, the user can click a characteristic button in the top right corner.

At.png The frame supports now of working with very big "Periodic processing" value and that value is set now to disabled (the value -2). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Fig.3.8b. The "Storehouse" frame in the runtime mode at the class representing.
Fig.3.8c. The "Storehouse" frame in the runtime mode at the data representing.
Fig.3.8d. The "Storehouse" frame in the runtime mode at the item edition form.

Linking and configuring the attributes

Identifier Name Type Description
class Class: initial String Forced/initial class for first opening.
classEditable (Constant) Class: editable Boolean Flag of allowing for the class edition.
classFix (Constant) Class: fixed String The fixed class for which the frame performed only, denying access for other classes.
dataEditable (Constant) Data: editable Boolean Flag of allowing for the main data edition.
db (Constant) DB: Data base String Database of the classes and data in the view {Type}.{DB}.

4 Панели управления и простые диалоги

Содержит элементы-кадры панелей управления и простых диалогов, которые сложно или не нужно реализовывать в виде панелей. Эти кадры предназначены для размещения в соответствующей директории панелей дерева проекта, построенного согласно концепции объектов сигнализации корневой страницы "RootPgSo". Кадры в основном не предназначены для использования отдельно, поскольку часто репрезентуют специфику данных к которым предоставляют элементы управления или расширенную информацию, а соответственно должны использоваться вместе с ними, кроме случаев унификации, обобщения и расширения контроля примитивами!

Эти элементы в основном открываются динамически, при вызове из элемента-виджета первичного представления, осуществляя при этом динамическое связывание связей панели в группе "<page>" с виджетом (часто страницей), который вызывает эту панель. Дальнейшая работа, до закрытия, осуществляется с данными виджета, который вызывал.


4.1 Терминальная панель (terminator)

1.1 GPLv2 * en, uk, ru Роман Савоченко

Элемент панели, представленный на рисунке 4.1, служит для заполнения пространства контейнера панели, когда не выбран активный визуальный элемент для управления на основном кадре, поскольку закрытия или очистки кадров в области контейнера не предусматривается, только замена.

Рис.4.1. Элемент панели "Терминальная панель".

Использование — разработка
Данный элемент должен быть размещён в логическом контейнере панелей дерева проекта.

Использование — исполнение
Вызов панели осуществляется из главной страницы "RootPgSo" при смене объекта сигнализации или вида отображения.


4.2 Элемент кадр (ElCadr)

1.4 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунках 4.2, фактически является универсальной панелью управления и расширенного контроля различными устройствами по всем известным и определённым представительским структурам базовых данных систем управления по DAQ-шаблонам:

В первичной функции панели — расширенное и общее управление, этот элемент вызывается из:

Если использование этого элемента в качестве панели управления не является обязательным, в первую очередь в виджетах первичного представления и через их специализацию на отдельных типах данных, для которых можно создать отдельную панель. То благодаря высокой универсальности, через поддержку всех известных репрезентативных структур DAQ-шаблонов, её обязательно использовать в основных кадрах, как это сделано в кадре "Группа контуров".

Рис.4.2a. Виджет "Элемент кадр" в режиме разработки.

Использование — разработка
Панель не предусматривает специальной конфигурации пользователем, она должна лишь быть размещена в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать её динамический вызов и открытие в контейнере панелей управлений корневой страницы.

Идентификатор панели, при размещении, должен сохраняться и строка её вызова, при получении фокуса, в атрибуте обработки событий "evProc" первичного виджета приобретёт вид "ws_FocusIn::open:/pg_control/pg_ElCadr".

Использование — исполнение
Показания аналогового параметра — в этом режиме нет никакого управления, а осуществляется только отображение единицы измерения, значения, гистограммы значения и наименования параметра.

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

Режим ПИД-регулятора — к значению переменной и её гистограмме добавляются значения и гистограммы задания и выхода ПИД-регулятора, кнопки для ввода нового значения, задания или выхода, а также кнопки установки режима регулятора и поле отображения текущего режима. Также, для пользователя с соответствующими правами ("root:ITW"), доступна кнопка перехода к кадру настройки коэффициентов ПИД-регулятора. В случае с импульсным ПИД-регулятором вместо гистограммы аналогового выхода отображаются треугольники состояния импульсного выхода "Вверх" и "Вниз", а ручной ввод выхода приводит к прямому формированию импульса, соответственно вниз или вверх.

Режим дискретного устройства — в этом режиме осуществляется отображение наименования и поле дискретной сборки параметра. Поле дискретной сборки содержит текущее состояние дискретного устройства, слева, и кнопки возможных команд устройству, справа. Предусмотрено два состояния устройства: "Открыт", "Закрыт" и три команды: "Открыть", "Закрыть", "Стоп". Наименования состояний и команд могут быть установлены при настройке. Смена состояния дискретного устройства определяется нажатием на кнопку соответствующей команды. В режиме прямых дискретных состояний формируется комбобокс из перечня элементов из digComs, текущим состоянием из st_text и отправкой команд в com_text.

Каждое действие на этой панели управления (смена задания ПИД-регулятора, изменение состояния дискретного параметра, ...) регистрируется в журнале (протоколе) вмешательств, посредством генерации соответствующих сообщений согласно структуре сообщений действий оператора.

Для каждого отображаемого или управляемого параметра можно получить паспорт, путём нажатия правой клавиши мыши на поле контура. В паспорте будут представлены все свойства параметра.

At.png The frame supports now of working with very big "Periodic processing" value and that value is set now to inherit from parent page/session (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

Рис.4.2b. Виджет "Элемент кадр" в режиме исполнения.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
prmId Параметр: идентификатор Строка Входная связь <page>|SHIFR Идентификатор параметра, используется только для определения соответствующей страницы контроля ПИД.
prmShifr Параметр: шифр Строка Входная связь <page>|NAME Краткое название параметра — шифр, для размещения под фреймом и в действия пользователя-оператора.
prmDescr Параметр: описание Строка Входная связь <page>|DESCR Описание параметра, для размещения в действия пользователя-оператора.
prmColor Параметр: цвет бордюра Строка Входная связь <page>|color Устанавливает цвет рамки контура.
Свойства аналоговых устройств
prmDemention Параметр: единица измерения Строка Входная связь <page>|ed
prmPrec Параметр: точность (знаков) Целый Входная связь <page>|prec Количество знаков после запятой значения параметра и шаг изменения ручного ввода значения, а также задания и выхода ПИД регулятора.
prmVar Параметр: переменная Вещественный Полная связь <page>|var Непосредственное значение аналогового параметра.
max Параметр: максимум Вещественный Входная связь <page>|max Максимальная граница значения параметра.
min Параметр: минимум Вещественный Входная связь <page>|min Минимальная граница значения параметра.
prmAMax Параметр: граница верхн. аварийная Вещественный Входная связь <page>|aMax
prmAMin Параметр: граница нижн. аварийная Вещественный Входная связь <page>|aMin
prmWMax Параметр: граница верхняя предупр. Вещественный Входная связь <page>|wMax
prmWMin Параметр: граница нижняя предупр. Вещественный Входная связь <page>|wMin
Ручной аналоговый ввод
prmVarIn Параметр: ввод переменной Вещественный Полная связь <page>|varIn Выход ручного ввода значения аналогового параметра. Наличие этого параметра является признаком того, что параметр определяется как "Ручной аналоговый ввод".
ПИД-регулятор
prmAnalog Параметр: аналоговый регулятор Логический Входная связь <page>|analog Признак аналогового регулятора, при отсутствии которого регулятор считается импульсным.
prmAuto Параметр: автомат Логический Полная связь <page>|auto Режим регулятора "Автомат".
prmCasc Параметр: каскад Логический Полная связь <page>|casc Режим регулятора "Каскад".
prmSp Параметр: задание Вещественный Полная связь <page>|sp Задание ПИД-регулятора, которое может быть установлено пользователем.
prmImpQdwnTm Параметр: выходной импульс вниз Логический Входная связь <page>|impQdwn Выход "Вниз" импульсного регулятора.
prmImpQupTm Параметр: выходной импульс вверх Логический Входная связь <page>|impQup Выход "Вверх" импульсного регулятора.
prmOut Параметр: выход Вещественный Полная связь <page>|out Выход аналогового ПИД-регулятора для отображения и ручного ввода значения выхода ПИД, в ручном режиме.
prmManIn Параметр: ручной ввод Вещественный Полная связь manIn Ручной ввод нового значения выхода ПИД-регулятора в ручном режиме.
Свойства дискретных устройств
prmCom Параметр: команда - "Открыть" Логический Полная связь <page>|com
prmClose Параметр: команда - "Закрыть" Логический Полная связь <page>|close
prmStop Параметр: команда - "Стоп" Логический Полная связь <page>|stop
prmComText Параметр: текст команды Строка Полная связь com_text Текст команды прямо, полученный из digComs при формировании комбобокса выбора.
digComs Параметр: дискр. команды Строка Входная связь <page>|digComs Конфигурация команд параметра со структурой {openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}, для дискретного блока, и {com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}, для статуса по коду. Цвета по умолчанию для дискретного блоку: "зелёный", "красный" и "жёлтый".
prmOpenSt Параметр: состояние - "Открыто" Логический Входная связь <page>|st_open
prmCloseSt Параметр: состояние - "Закрыто" Логический Входная связь <page>|st_close
prmStText Параметр: текст статуса Строка Входная связь <page>|st_text Текст статуса прямо.
digStts Параметр: дискр. состояния Строка Входная связь <page>|digStts Конфигурация статусов параметра со структурой {openedLabel}-{color};{closedLabel}-{color}, для дискретного блока. Цвета по умолчанию: "зелёный" и "красный".


4.3 Паспорт, расширенный (cntrPaspExt)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунке 4.3, является информационно-контрольным диалогом около параметра источника данных — расширенный паспорт параметра. В отличии от простого паспорта, расширенный, кроме информации, предоставляет возможность контроля атрибутов параметра и отображения истории стандартных атрибутов как в виде тренда, так и таблицы данных.

Информация и контроль атрибутов параметра остаётся основной функцией, которая предоставляется во вкладке "Обзор", где формируется таблица атрибутов как они есть, со столбцами "Имя" и "Значение". Таблица активная и при выборе доступных для записи атрибутов, и соответствующих прав (root:op), внизу предоставляется поле ввода новых значений.

История предоставляется в следующих двух вкладках "Тренды" и "Данные", которые могут и отсутствовать при отсутствии истории-архивов по стандартным атрибутам. Вкладка "Тренды" содержит область графиков, примитив "Диаграмма", на большей части окна, и таблицу внизу с названиями, цветом и шкалами графиков. Графики периодически обновляются и строятся с периодом 1 секунда, и на фиксированную глубину в 1 час. Вкладка "Данные" содержит только поле примитива "Документ" с таблицей со значениями атрибута в столбцах, которая обновляется с периодом 1 секунда для периода данных истории и на глубину в 100 записей. Стандартными атрибутами с историей считаются следующие элементы представительских структур параметра:

Для построения трендов аналоговых параметров отдельно обрабатываются атрибуты общей шкалы [min...max], а также аварийные [aMin...aMax] и предупредительные шкалы [wMin...wMax], которые, кроме всего, отображаются и на графике.

At.png На данный момент этот диалог является основным и он заменил простой диалог паспорта.

Рис.4.3. Диалог "Паспорт, расширенный" в режиме исполнения.

Использование — разработка
Диалог не предусматривает специальной конфигурации пользователем, он должен лишь быть размещён в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать его динамический вызов и открытие, как внешнее диалоговое окно.

Идентификатор диалога, при размещении, должен быть изменён в "cntrPasp" и строка его вызова, при нажатии правой клавиши мыши, в атрибуте обработки сообщений "evProc" первичного виджета приобретёт вид "key_mousePresRight::open:/pg_control/pg_cntrPasp".

Использование — исполнение
Диалог предоставляет пользователю, во вкладке "Обзор", информацию про параметр источника данных в виде перечня и значений всех свойств-атрибутов параметра в таблицы. Где атрибуты, доступные для записи, могут редактироваться согласно прав доступа "root:op" в поле редактирования, которое появляется внизу при выборе такого атрибута.

Что касается истории, пользователь может наблюдать тренды во вкладке "Тренды" и данные во вкладке "Данные". Для трендов, пользователь может также подсветить какой-то из них, выбрав его в таблице внизу, и отредактировать шкалу если она ошибочна.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
pName Имя параметра Адрес Входная связь Parameter|NAME Адрес к имени параметра для обращения к параметру целиком и изъятия всех его свойств.


4.4 Паспорт (cntrPasp)

1.0 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунке 4.4, является информационным диалогом около параметра источника данных — паспорт параметра, соответственно он позволяет получить такого рода информацию как: шифр, имя, описание, единица измерения, аварийные границы и другое, согласно представительской структуре параметра — атрибуты параметра. Диалог построен на основе примитива "Документ", содержимое которого формируется динамически и периодически обновляется.

При построении паспорта отдельно обрабатываются атрибуты аварийных [aMin...aMax] и предупредительных шкал [wMin...wMax], которые объединяются в одной записи и в целом могут скрываться при условии их отключения.

At.png На данный момент этот диалог фактически заменён более функциональным и расширенным диалогом паспорта и он в основном отключен во всех шаблонных и демонстрационных проектах, хотя никто не препятствует его использованию, если необходима только информацию.

Рис.4.4. Диалог "Паспорт" в режиме исполнения.

Использование — разработка
Диалог не предусматривает специальной конфигурации пользователем, он должен лишь быть размещён в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать его динамический вызов и открытие, как внешнее диалоговое окно.

Идентификатор диалога, при размещении, должен сохраняться и строка его вызова, при нажатии правой клавиши мыши, в атрибуте обработки сообщений "evProc" первичного виджета приобретёт вид "key_mousePresRight::open:/pg_control/pg_cntrPasp".

Использование — исполнение
Диалог только предоставляет пользователю информацию про параметр источника данных в виде перечня и значений всех свойств-атрибутов параметра в таблице.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
pName Имя параметра Адрес Входная связь Parameter|NAME Адрес к имени параметра для обращения к параметру целиком и изъятия всех его свойств.


4.5 Панель графиков (grph_panel)

1.5 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунке 4.5, является специализированной панелью динамического управления основными пользовательскими свойствами примитива "Диаграмма". Так, панель позволяет просмотреть графики истории за необходимый период времени и в нужном разрешении, поддерживается: масштабирование шкалы, выбор архиваторов для отображения, а также представление графиков в виде спектра присутствующих частот или XY.

Рис.4.5. Панель графиков в режиме разработки и исполнения (слева направо).

Использование — разработка
Панель не предусматривает специальной конфигурации пользователем, она должна лишь быть размещена в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать её динамический вызов и открытие в контейнере панелей управлений корневой страницы.

Идентификатор панели, при размещении, должен сохраняться и строка её вызова, при получении фокуса, в атрибуте обработки событий "evProc" первичного виджета приобретёт вид "ws_FocusIn::open:/pg_control/pg_grph_panel".

Using — runtime
The panel allows the user to:

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
tSek Время тренда ДатаВремя Полная связь <page>|tSek
tSize Размер тренда Вещественный Полная связь <page>|tSize Временной размер-интервал графика в историю от времени тренда.
trcPer Период слежения Целый Полная связь <page>|trcPer Период обновления-слежения графика.
type Тип Целый Полная связь <page>|type Тип графика: "Тренд", "Спектр частот", "XY".
valArch Архиватор Строка Полная связь <page>|valArch
curSek Курсор ДатаВремя Полная связь <page>|curSek Время установки курсора.
curUSek Курсор, микросекунды Целый Полная связь <page>|curUSek Время установки курсора, микросекунды.
sclVer Вертикальный масштаб Вещественный Полная связь <page>|sclVerScl Процент вертикального масштаба.
sclVerOff Смещение вертикального масштаба Вещественный Полная связь <page>|sclVerSclOff Процент смещения по вертикальной шкале.
sclHor Горизонтальная шкала Вещественный Полная связь <page>|sclHorScl Процент горизонтального масштаба.
sclHorOff Смещение горизонтальной шкалы Вещественный Полная связь <page>|sclHorSclOff Процент смещения по горизонтальной шкале.
sclWin Масштаб окном Логический Полная связь <page>|sclWin Переключение режима масштабирования окном.
sclWinCtx Масштаб: контекст окном Объект Входная связь <page>|sclWinCtx Контекст сохранения исходных параметров масштабирования окном, для возврата.


4.6 Панель документов (doc_panel)

1.2 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент, представленный на рисунке 4.6, является специализированной панелью динамического управления основными пользовательскими свойствами примитива "Документ". Так, панель позволяет управлять документами и осуществлять навигацию по их истории; поддерживаются динамические и архивные документы.

Рис.4.6. Панель документов в режиме разработки и исполнения (динамический и архивный), слева направа.

Использование — разработка
Панель не предусматривает специальной конфигурации пользователем, она должна лишь быть размещена в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать её динамический вызов и открытие в контейнере панелей управлений корневой страницы.

Идентификатор панели, при размещении, должен сохраняться и строка её вызова, при получении фокуса, в атрибуте обработки событий "evProc" первичного виджета приобретёт вид "ws_FocusIn::open:/pg_control/pg_doc_panel".

Использование — исполнение
Панелью предоставляются инструменты, которые несколько отличаются для динамического и архивного режимов.

Динамическим документом предусматривается:

Архивным документом предусматривается только навигация по документам в архиве путём их перелистывания, а также информация о текущем и общем количестве документов в архиве.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
Динамические документы
time Время документа ДатаВремя Полная связь <page>|time
bTime Начало документа ДатаВремя Полная связь <page>|bTime
doc Документ Строка Полная связь <page>|doc
Архивные документы
n Размер архива Целый Входная связь <page>|n
vCur Курсор отображения Целый Полная связь <page>|vCur
aCur Курсор архива Целый Входная связь <page>|aCur
aSize Размер архива Целый Входная связь <page>|aSize


4.7 Подтверждение (accept)

1.0 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 4.7 реализует простейший диалог подтверждения операций. Диалог содержит сообщение с вопросом и две кнопки "Принять" и "Отмена". Данный диалог, например, использован в кадре Менеджер пользователей для подтверждения операции удаления.

Рис.4.7. Диалог "Подтверждение" в режиме разработки и исполнения.

Использование — разработка
Диалог не предусматривает специальной конфигурации пользователем, он должен лишь быть размещён в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать его динамический вызов и открытие, как внешнее диалоговое окно.

Идентификатор диалога, при размещении, должен сохраняться и строка его вызова, при нажатии кнопки "progDel", в атрибуте обработки сообщений "evProc" первичного виджета приобретёт вид "ws_BtPress:/progDel:open:/pg_control/pg_accept". Из атрибута "mess" берётся сообщение вопроса, а в "event" передаётся сигнал "dlg_Apply", при подтверждении.

Использование — исполнение
Вызов диалога осуществляется из кадра-инициатора, а закрытие происходит по нажатию любой кнопки диалога. В случае нажатия кнопки "Применить" кадра-инициатора будет отправлен сигнал "dlg_Apply", по которому он может выполнить нужные действия.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
elEvent Элемент: событие Строка Полная связь <page>|event Используется для отправки события "dlg_Apply" в случае подтверждения.
elMess Элемент: сообщение Строка Входная связь <page>|mess Источник сообщения вопроса в диалоге.


4.8 Выбор элемента в дереве (treeSelect)

1.0 GPLv2 * en, uk, ru Роман Савоченко -1 мс (предок)

Элемент на рисунке 4.8 реализует простой диалог операции выбора пункта в дереве. Диалог содержит само дерево и две кнопки "Принять" и "Отменить". Этот диалог, например, использован, и первично для него разрабатывался, в кадре "Рецепт: исполнение (простой)" для иерархического выбора элемента в дереве.

Рис.4.8. Диалог "Выбор элемента в дереве" в режиме разработки и исполнения.

Использование — разработка
Диалог не предусматривает специальной конфигурации пользователем, он должен лишь быть размещён в каталоге панелей дерева проекта концепции объектов сигнализации корневой страницы "RootPgSo", что будет предусматривать его динамический вызов и открытие, как внешнее диалоговое окно.

Идентификатор диалога, при размещении, должен сохраняться и строка его вызова, при нажатии кнопки "lib", в атрибуте обработки сообщений "evProc" первичного виджета приобретёт вид "ws_BtPress:/lib:open:/pg_control/pg_treeSelect". Из атрибута "items" берётся перечень элементов, из "selValue" выбранное значение, а в "event" передаётся сигнал "dlg_Apply", при подтверждении.

Использование — исполнение
Вызов диалога осуществляется из кадра-инициатора, а закрытие происходит по нажатию любой кнопки диалога. В случае нажатия кнопки "Применить" кадра-инициатора будет отправлен сигнал "dlg_Apply", по которому он применит выбранный елемент.

Свойства связывания и конфигурации

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
elEvent Элемент: событие Строка Полная связь <page>|event Используется для отправки события "dlg_Apply" в случае подтверждения.
elItems Элемент: список элементов Текст Входная связь <page>|items Источник перечня элементов в диалоге.
selValue Элемент: выбранное значение Строка Полная связь <page>|selValue Источник выбранного элемента в диалоге.
Libs/Main_graphical_elements/ru - GFDLMay 2024OpenSCADA 0.9.7