From OpenSCADAWiki
Jump to: navigation, search
This page is a translated version of the page Libs/Main graphical elements and the translation is 100% complete.

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

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

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

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

  • такой что поставляется с готовым и соответствующим пакетом дистрибутива Linux вроде "openscada-libdb-vca", "openscada-LibDB.VCA";
  • наиболее актуальный и непосредственно полученный из репозиторию subversion, преобразованный в файл БД SQLite путём:
$ 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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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.0 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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.0 GPLv2 * en, uk, ru Роман Савоченко

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

  • Спонсирование: Винницкая Птицефабрика
Рис.1.4. Элемент "Метка изображением" в режиме разработки и выполнения (слева направо)
.

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

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

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

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

  • atm — время возникновения нарушения;
  • qttm — время подтверждения (квитации) нарушения, для подтверждённых нарушений;
  • lev — уровень нарушения;
  • cat — категория нарушения;
  • mess — полный и неразобранный текст сообщения нарушения;
  • prm — адрес DAQ-параметра источника нарушения;
  • dscr — описание нарушения из DAQ-параметра источника;
  • dscrCust{N} — описание пользовательского поля N;
  • alrm — текст нарушения;
  • cmnt — комментарий к нарушению.

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

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

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

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

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

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

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

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

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

Идентификатор Имя Тип Описание
active Активный Логический Выключить если выключено подтверждение, расширение по получению фокуса и редактирование вообще — исключительно отображение.
hHdrVis Показывать заголовок: горизонтальный Логический
vHdrVis Показывать заголовок: вертикальный Логический
formDtTm Формат даты и времени (%Y-%m-%d %H.%M.%S[.%MS,%US]) Строка Формат отображения времени нарушения и подтверждения.
expOnItems Расширять при фокусе: элементов (<=0-отключено) Целый Граничное количество сообщений для срабатывания функции расширения элемента, увеличения высоты, при получении фокуса.
expOnFocus Расширять при фокусе: пикселей (0-отключено,>-вниз,<-вверх) Целый Установить в нужное значение расширения элемента, увеличения высоты, при получении фокуса.
colms Колонки, по ',' (atm,qttm,lev,cat,mess,prm,dscr,dscrCust{N},alrm,cmnt) Строка Определить в нужную последовательность и наполнение полей.
highLght Правила подсветки, {lev}{quitt}:{color}:{font}:{fontColor} Текст Правила подсветки, где:
  • lev — уровень сообщения [0...7];
  • quitt — признак подтверждения (квитации) сообщения [0|1];
  • color — цвет фона строки с сообщением;
  • font — шрифт текста строки с сообщением;
  • fontColor — цвет текста строки с сообщением.

Например:

5:gray
4:red
1:yellow
colDscrCustNames Перечень наименований пользовательских полей, поделённых ';' Строка При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.


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

1.1 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-эпохи.


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

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

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

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

  • область кнопок-индикаторов объектов сигнализации (вверху);
  • область навигации по видами отображения (справа-вверху);
  • контейнер основных кадров пользовательского интерфейса (в центре);
  • контейнер панелей управления (справа-внизу).

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

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

Кнопки сейчас генерируются динамически, путём копирования первой и единственной, согласно присутствующим в дереве проекта виртуальным страницам объектов сигнализации с последовательной цифровой идентификацией от 1. Ограничение на количество кнопок, или объектов сигнализации, состоит лишь в суммарной длине названий объектов сигнализации, которые можно поместить в два ряда этих кнопок. Т.е., для коротких названий можно получить до около 100 объектов сигнализации. Если объект сигнализации один то даже эта единственная-базовая кнопка прячется.

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

Пространство кнопок видов отображения является динамическим, в смысле занимания пространства отсутствующих, и значение самих видов отображения настраивается на другое от типичного значение, т.е. предусмотрено два основных вида отображения (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 Идентификаторы страниц видов отображения, указанные как [view1|mn], должны указываться в дереве или по новой схеме "view1", или по старой "mn". Их смешивание не поддерживается!

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

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

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

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

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

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

В случае отсутствия Демо-режима, можно выключить кнопку запуска демонстрации и расширить панель управления.

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

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

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

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

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

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

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

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

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


3.1 Группа графиков (grpGraph), Группа графиков 10 (grpGraph10)

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

Элемент-кадр, представленный на рисунке 3.1, служит для одновременного наблюдения трендов и управления параметрами в объекте сигнализации, включает в себя как экземпляры виджета "Элемент группы графиков" каждого параметра (до 8 или 10), так и виджет "Диаграмма" для наблюдения за графиками параметров и просмотра истории, а также горизонтальную полосу прокрутки для быстрой навигации по доступной истории выбранных для отображения параметров.

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

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

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

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

Рис.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 Элемент группы графиков (ElViewGraph)

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

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

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

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

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

Кроме непосредственно доступных визуальных данных, предоставляется ряд элементов контроля:

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

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

Рис.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.4 GPLv2 * en, uk, ru Роман Савоченко

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

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

  • {DAQ_Arh_addr}[:Name[:min:max[:dim]], где:
    • "DAQ_Arh_addr" — адрес параметра, при групповом связывании, или атрибута с данными из подсистемы "Сбор данных (DAQ)", а также адрес архива значений, например:
      • /LogicLev/gen/prm_F3 — адрес параметра "F3";
      • /DAQ/System/AutoDA/prm_CPULoad/load — адрес атрибута "load", параметра "CPULoad";
      • /Archive/va_LC21_1_var — адрес архива "LC21_1_var".
    • "Name" — имя источника, для отображения. При групповом связывании имя будет браться из атрибута "NAME".
    • "min", "max" — шкала отображения. При групповом связывании шкала будет браться из атрибута "min" и "max", соответственно. В случае отсутствия шкалы (min >= max) включится автоматический выбор шкалы.
    • "dim" — единица измерения параметра, для отображения. При групповом связывании будет браться из атрибута "ed".
  • <varhs> — шаблон группового выбора, при указании которого в список выбора попадут все доступные в системе архивы.

Примеры содержимого атрибута "Выбор: параметры доступные для выбора (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.2 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

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

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


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

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

Элемент-кадр, представленный на рисунке 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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

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


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

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

Элемент-кадр, представленный на рисунке 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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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.1 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

  • имя параметра регулятора;
  • поле со свойствами регулятора в составе: идентификатор, имя, описание, единица измерения, задание, переменная, выход, шкала и режим;
  • коэффициенты настройки регулятора: Кп, Ки, Ти, Кд, Тд, Тзд, Зн, Н1, Н2, К1, К2, К3, К4, ТпИ, ТмИ и Rфкт;
  • область графика с отображением графиков: переменной (зелёный, стиль "labColorGrph4"), задания (синий, стиль "labColorGrph3"), выход аналоговый (голубой, стиль "labColorGrph5"), режим регулятора "Автомат" (магента, стиль "labColorGrph7") и дискретные выходы импульсного регулятора (оранжевый, стиль "labColorGrph2").

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

Рис.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.2 GPLv2 * en, uk, ru Роман Савоченко

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

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

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

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

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

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

  • atm — время возникновения нарушения;
  • qttm — время подтверждения (квитации) нарушения, для подтверждённых нарушений;
  • nrmtm — время перехода-возврата нарушения в состояние "НОРМА";
  • lev — уровень нарушения;
  • cat — категория нарушения;
  • mess — полный и неразобранный текст сообщения нарушения;
  • prm — адрес DAQ-параметра источника нарушения;
  • dscr — описание нарушения из DAQ-параметра источника;
  • dscrCust{N} — описание пользовательского поля N;
  • alrm — текст нарушения;
  • cmnt — комментарий к нарушению.

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

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

  • Спонсирование: Устьянцев Михаил
Рис.3.6a. Кадр "Нарушение — состояние" в режиме разработки.

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

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

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

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

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

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

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

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

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

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

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

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

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

Идентификатор Имя Тип Описание
messCat Категория сообщения Строка Категория обрабатываемых сообщений, типично "al*:*".
messLim Ограничение сообщений, количество Целый Максимальное количество сообщений в таблице, типично 1000.
alArch Архиватор сигналов, "{ArhMod}.{Arh}" Строка Архиватор из которого брать сообщения, пусто для всех.
alarms.active Активный Логический Выключить если выключено подтверждение, расширение по получению фокуса и редактирование вообще — исключительно отображение.
hHdrVis Показывать заголовок: горизонтальный Логический
vHdrVis Показывать заголовок: вертикальный Логический
formDtTm Формат даты и времени (%Y-%m-%d %H.%M.%S[.%MS,%US]) Строка Формат отображения времени нарушения и подтверждения.
colms Колонки, по ',' (atm,qttm,nrmtm,lev,cat,mess,prm,dscr,dscrCust{N},alrm,cmnt) Строка Определить в нужную последовательность и наполнение полей.
highLght Правила подсветки, {lev}{quiet}{act}:{color}:{font}:{fontColor} Текст Правила подсветки, где:
  • lev — уровень сообщения [0...7];
  • quiet — признак подтверждения (квитации) сообщения [0|1];
  • act — признак активности сообщения [0|1];
  • color — цвет фона строки с сообщением;
  • font — шрифт текста строки с сообщением;
  • fontColor — цвет текста строки с сообщением.

Например:

501:gray
401:red
101:yellow
511:gray:Arial 11 0 1
411:red:Arial 11 0 1
111:yellow:Arial 11 0 1
colDscrCustNames Перечень наименований пользовательских полей, поделённых ';' Строка При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.


3.6.1 Нарушения — отчёт (alarmsStReport)

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

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

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

  • Спонсирование: Устьянцев Михаил
Рис.3.6.1. Кадр "Нарушения — отчёт".

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

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


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

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

Элемент-кадр, представленный на рисунке 3.7, служит для предоставления возможности контроля пользователей из интерфейса самого пользователя. Т.е., типично эта функция предоставляется программисту SCADA на уровне конфигурации подсистемы "Безопасность", но иногда возникает необходимость предоставления такой возможности из интерфейса пользователя и с рядом ограничений на контролируемых пользователей и их группы, что этот кадр осуществляет и в целом предоставляет функции:

  • формирования перечня подконтрольных пользователей;
  • возможность ознакомления и смены информации пользователей, на предмет: имя, полное имя, описание, пароль и группы;
  • добавления новых и удаления существующих пользователей.
  • Спонсирование: Винницкая Птицефабрика
Рис.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 БД хранения новых пользователей Строка БД хранения новосозданных пользователей, типично — рабочая.

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

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

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


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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

Рис.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 Роман Савоченко

Элемент, представленный на рисунке 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 Роман Савоченко

Элемент, представленный на рисунке 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 Роман Савоченко

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

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

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

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

Использование — исполнение
С помощью панели пользователь имеет возможность:

  • выбрать режим отображения графиков диаграммы: "График", "Спектр частот", "XY";
  • выбрать время формирования диаграммы;
  • осуществить навигацию по диаграмме на один или пять размеров области графика;
  • установить время генерации диаграммы в текущее время и время курсора;
  • получить информацию о времени или частоте в текущем положении курсора;
  • выбрать размер (глубину) формирования графика или установить время начала;
  • выбрать архив, используемый для построения графиков, c правами доступа "root:ITW";
  • управлять вертикальной и горизонтальной шкалой отображения: увеличение и уменьшения масштаба, смещения шкалы вверх и вниз, возврат масштаба к исходному значению;
  • переключать режим масштабирования путём обрамления окном, мышью.

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

Идентификатор Имя Тип Конфигурация Конфигурационный шаблон Описание
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 Роман Савоченко

Элемент, представленный на рисунке 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 Роман Савоченко

Элемент на рисунке 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 Роман Савоченко

Элемент на рисунке 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 Источник выбранного элемента в диалоге.