Export translations

Settings

Group
Language
Format	Export for off-line translation Export in native format

{{DISPLAYTITLE:Библиотеки/Основные графические элементы}}<languages/>
{| class="wikitable"
|-
! Название !! Версия !! Лицензия !! Источник !! Языки !! Автор !! Иконка
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main_graphical_elements|Библиотека основных элементов интерфейса пользователя]]
| 2.2 || GPLv2
| vcaBase.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql SQL], [[:File:vcaBase.db.gz|GZip]]) > VCA.wlb_Main
| en, uk, ru
<section end=info />
| [[User:RomanSavochenko|Роман Савоченко]] || [[File:LibMainGraphElements.png]]
|-
! colspan="9" | Описание
|-
| colspan="9" | Предоставляет библиотеку основных элементов пользовательского интерфейса общей и промышленной автоматизации.
* '''Основано:''' Сентябрь 2007
* '''Изначально создано:''' в [http://wiki.oscada.org/Using/GraphicElementsLibraries/MainElements старой Wiki]
* '''Использовано:''' [[Special:MyLanguage/Using|большинство проектов на OpenSCADA]]
* '''[[Special:MyLanguage/Works/To_do|Задачи (To Do)]]:'''
<section begin=ToDo />
: -
<section end=ToDo />
|}

Библиотека создаётся для предоставления основных элементов пользовательского интерфейса и содержит графические элементы, которые часто востребованы при формировании пользовательского интерфейса автоматизации технологических и общих процессом. Строится библиотека на основе [[Special:MyLanguage/Modules/VCAEngine#WidgetPrimitives|примитивов виджетов]] и языка внутреннего программирования [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc]].

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

Для подключения библиотеки к проекту станции OpenSCADA Вы можете получить файл БД как:
* такой что поставляется с готовым и соответствующим пакетом дистрибутива Linux вроде "openscada-libdb-vca", "openscada-LibDB.VCA";
* наиболее актуальный и непосредственно полученный из [http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql репозиторию subversion], преобразованный в файл БД SQLite путём:
<syntaxhighlight lang="BASH" style="margin-left: 15px">
wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql
sqlite3 -init vcaBase.sql vcaBase.db .exit
</syntaxhighlight>
* загрузка [[:File:vcaBase.db.gz|прикреплённого тут]].

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

== {{Anch|Widgets|Виджеты — графические элементы}} ==
Содержит элементы-виджеты общего применения, которые предназначены для размещения на [[#MainFrames|основных кадрах]]. Этими основными кадрами могут быть и кадры за этой [[#RootPgSo|концепцией объектов сигнализации корневой страницы "RootPgSo"]], но нужно учитывать, что они часто ссылаются и вызывают те или иные [[#Panels|панели управления]]!

{| class="wikitable"
<section begin=anShow />
| {{Anch|anShow|<h3>Отображение аналогового ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow|anShow]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=anShow />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 1.1 служит для отображения текущего значения аналогового параметра и режима регулятора, если параметр является таковым. Также этот элемент генерирует уведомления про нарушения по соответствующим уставкам параметра. Элемент в целом использует и представляет представительскую структуру [[Special:MyLanguage/Libs/Main#anUnif|DAQ-шаблона "Аналоговый сигнал"]].

[[file:LibMainEls_AnShow_ru.png|center|frame|Рис.1.1. Элемент "Отображение аналогового" в режиме разработки и исполнения (слева направо).]]

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

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

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

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

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

{| class="wikitable"
<section begin=anShow1 />
| {{Anch|anShow1|<h3>Отображение аналогового 1 ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|anShow1]]); Отображение аналогового 1, короткий ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|anShow1s]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru
<section end=anShow1 />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 1.2 служит для отображения текущего значения аналогового параметра и краткого префиксу измеренного значения. Также этот элемент генерирует уведомления про нарушения по соответствующим уставкам параметра. Элемент в целом использует и представляет представительскую структуру [[Special:MyLanguage/Libs/Main#anUnif|DAQ-шаблона "Аналоговый сигнал"]].

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

[[file:LibMainEls_anShow1.png|center|frame|Рис.1.2. Элемент "Отображение аналогового 1" в режиме разработки и исполнения (слева направо).]]

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

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

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

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

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

{| class="wikitable"
<section begin=TextLab />
| {{Anch|TextLab|<h3>Текстовая метка ([[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|TextLab]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=TextLab />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 1.3 служит для отображения динамических текстовых меток, которые формируется на основе дискретных сигналов. Также этот элемент генерирует уведомление про нарушения по локально определённому условию, атрибут '''ntf'''. Элемент в целом использует и представляет представительскую структуру DAQ-шаблонов [[Special:MyLanguage/Libs/Main#digitBlockUnif|дискретного блока]] и [[Special:MyLanguage/Libs/Main#codeState|состояния по коду]].

* '''Спонсирование:''' Василий Григорьев, [http://e-beam.ru Лаборатория Вакуумных Технологий]

[[file:LibMainEls_TextLab.png|center|frame|Рис.1.3. Элемент "Текстовая метка" в режиме разработки и выполнения (слева направо)]].

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

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

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

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

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

{| class="wikitable"
<section begin=ImgLab />
| {{Anch|ImgLab|<h3>Метка изображением ([[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|ImgLab]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=ImgLab />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 1.4 служит для отображения динамических меток изображений, которые формируются на основе дискретных сигналов. Также этот элемент генерирует уведомления про нарушения по локально определённому условию, атрибут '''ntf'''. Элемент в целом использует и представляет представительскую структуру DAQ-шаблонов [[Special:MyLanguage/Libs/Main#digitBlockUnif|дискретного блока]] и [[Special:MyLanguage/Libs/Main#codeState|состояния по коду]].

* '''Спонсирование:''' Винницкая Птицефабрика

[[file:LibMainEls_ImgLab.png|center|frame|Рис.1.4. Элемент "Метка изображением" в режиме разработки и выполнения (слева направо)]].

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

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

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

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

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

{| class="wikitable"
<section begin=alarmsAct />
| {{Anch|alarmsAct|<h3>Нарушения — активное ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsAct|alarmsAct]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru
<section end=alarmsAct />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент на рисунке 1.5 служит для динамического отображения активных нарушений в табличном виде и с выделением их цветом и текстом. Нарушения получаются из [[Special:MyLanguage/Documents/Program_manual#ArchMess|буфера текущих-активных нарушений OpenSCADA]]. Фактически элемент реализует функции примитива "[[Special:MyLanguage/Sub-projects/VCA#ImplProtocol|Протокол]]" для нарушений и с расширением возможностей.

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

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

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

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

[[file:at.png]] Этот элемент и его поля в целом представляют структуру сообщения нарушения, которая детально описана в [[Special:MyLanguage/Documents/Program_manual#ArchMess|руководстве пользователя]].

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

* '''Спонсирование:''' Устьянцев Михаил
* '''Спонсировано, добавление нового пользовательского поля "Тип" на 0.2 {{CtxDetails|ЧД|человеко-дней, 1ЧД — 10 часов}}:''' INSERTEC LTDA

[[file:LibMainEls_alarmsAct_ru.png|center|frame|Рис.1.5. Элемент "Нарушения — активное" в режиме разработки и исполнения (сверху вниз).]]

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

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

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

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

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

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| active || Active || Boolean || Turn off if there disabled confirmation, focus gaining and editing in general — purely displaying.
|-
| hHdrVis || Show header: horizontal || Boolean ||
|-
| vHdrVis || Show header: vertical || Boolean ||
|-
| formDtTm || Data and time format (%Y-%m-%d %H.%M.%S[.%MS,%US]) || String || Format of displaying the time of violation and confirmation.
|-
| expOnItems || Expand on focus: items (<=0-disabled) || Integer || Maximum number of messages to trigger the element expansion, height increasing, at focus gaining.
|-
| expOnFocus || Expand on focus: pixels (0-disabled,>-down,<-up) || Integer || Set to the desired value of the element extension, height increasing, at focus gaining.
|-
| colms || Columns
List separated by ',' from the variants: atm, qttm, lev, type, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.
| String || Determine in the desired sequence and the fields filling.
|-
| highLght || Highlight rules
Rows in the form "{lev}[{slev}]{quitt}:{color}:{font}:{fontColor}".
| Text || Highlight rules, where:
* ''lev'' — main level of the message [0...7];
* ''slev'' — sub-level of the message [0...9], optional;
* ''quitt'' — sign of the message confirmation (quietation) [0|1];
* ''color'' — background color of the message row;
* ''font'' — text font of the message row;
* ''fontColor'' — text color of the message row.
Te example:
<syntaxhighlight lang="BASH">
#<SnthHgl font="monospace">
# <rule expr="^#[^\n]*" color="gray" font_italic="1"/>
# <rule expr="^[0-9]*" color="blue">
#  <rule expr="[01]$" color="red"/>
# </rule>
# <rule expr="(?<=:).*" font_weight="1"/>
#</SnthHgl>
50:gray
40:red
150:yellow
</syntaxhighlight>
|-
| colDscrCustNames || Перечень наименований пользовательских полей, поделённых ';' || Строка (перевод) || При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.
|-
| types || Перечень типов по уровню от 0, разделены ';' || Строка (перевод) || Типы-названия нарушений за их уровнем, типично "Отладка;Информ.;Отметка;Предупр.;Ошибка;Критически;Тревога;Авария".
|-
| messCat || Категория сообщений || Строка || Категория обрабатываемых сообщений нарушений, типично пусто для всей нарушений.
|}

{| class="wikitable"
<section begin=objProps />
| {{Anch|objProps|<h3>Свойства объекта ([[Special:MyLanguage/Libs/Main_graphical_elements#objProps|objProps]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
 <section end=objProps />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент на рисунке 1.6 служит для отображения свойств источника данных в табличном виде и с выделением их цветом, как объект, и предоставления возможности изменения значения свойств с правом записи. Также этот элемент генерирует сообщения про нарушения согласно особенностям объекта. Элемент в целом использует и предоставляет представительскую структуру DAQ-шаблонов "[[Special:MyLanguage/Libs/Main#ComplexObject|Комплексный объект]]".

* '''Спонсировано:''' ПАТ ХАРТРОН

[[file:LibMainEls_objProps_ru.png|center|frame|Рис.1.6. Элемент "Свойства объекта" в режиме разработки и выполнения (слева направо).]]

{{CntHdr|Использование — разработка}}
Этот виджет может быть использован разработчиком при создании мнемосхем с консолидированным отображением объекта как целое и сущности со свойствами. Для использования необходимо добавить этот виджет на мнемосхему, подстроить горизонтальный, вертикальный размер масштабом и связать с параметром источника данных от DAQ-шаблона "[[Special:MyLanguage/Libs/Main#ComplexObject|Комплексный объект]]".

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| objName || Объект: имя || Строка || Входная связь || Object&#124;NAME || Имя объекта для заголовка.
|-
| objDescr || Объект: описание || Текст || Входная связь || Object&#124;DESCR || Описание объекта для подсказки к заголовку.
|-
| objErr || Объект: ошибка || Строка || Входная связь || Object&#124;err || Ошибка объекта для формирования сообщения и подсвечивания заголовка, обрабатываются коды концепции.
|-
| objItems || Объект: элементы || Объект || Входная связь || Object&#124;items || Описательный объект свойств физического объекта, согласно концепции.
|}

{| class="wikitable"
<section begin=calendar />
| {{Anch|calendar|<h3>Календарь ([[Special:MyLanguage/Libs/Main_graphical_elements#calendar|calendar]])</h3>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=calendar />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент на рисунке 1.7 служит для отображения месяца календаря по неделям, который предусматривает возможность выбора года, месяца и отдельного дня, а также переход к текущему дню.

* '''Спонсировано:''' ООО "СВІТоВИР"

[[file:LibMainEls_calendar_ru.png|center|frame|Рис.1.7. Элемент "Календарь" в режиме разработки и выполнения (слева направо).]]

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

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Описание
|-
| selTime || Выбранное время || Целое || Время календаря в секундах от UNIX-эпохи.
|}

{| class="wikitable"
<section begin=weather />
| {{Anch|weather|<h3>Weather ([[Special:MyLanguage/Libs/Main_graphical_elements#weather|weather]])</h3>}} || 1.0 || GPLv2 || * || en, uk <section end=weather />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element on Figure 1.8 is used to display weather data from parameters on the DAQ-template "[[Special:MyLanguage/Libs/Main#weather|Weather]]".

[[file:LibMainEls_weather.png|center|frame|Fig.1.8. The element "Weather" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used the developer to create mnemonic schemes with displaying the weather. To use it you need to add this widget to a mnemonic scheme, adjust for the horizontal, vertical size, by scaling, and link to the data source parameter at the DAQ-template "[[Special:MyLanguage/Libs/Main#weather|Weather]]".

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

[[File:at.png]] Images for some weather conditions can be missed yet due to the images are still appended!

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| current || Weather: Current || Object || Input link || Parameter&#124;current || The object with current data.
|-
| forecast || Weather: Forecast || Object || Input link || Parameter&#124;forecast || The object with forecast data.
|}

{| class="wikitable"
<section begin=RootPgSo />
| {{Anch|RootPgSo|<h2>Корневая страница (СО) ([[Special:MyLanguage/Libs/Main_graphical_elements#RootPgSo|RootPgSo]])</h2>}}
| 2.7 || GPLv2 || * || en, uk, ru
<section end=RootPgSo />
| [[User:RomanSavochenko|Роман Савоченко]] || 1000 мс
|}
Элемент-кадр, представленный на рисунке 2, служит базой для создания пользовательских интерфейсов, начально для управления технологическими процессами, основанными на объектах сигнализации (СО).

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

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

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

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

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

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

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

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

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

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

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

* '''Спонсирование динамизации:''' Винницкая Птицефабрика

[[file:LibMainEls_RootPgSoD_ru.png|center|frame|Рис.2a. Кадр "Корневая страница (СО)" в режиме разработки.]]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[[file:LibMainEls_RootPgSoR_ru.png|center|frame|Рис.2b. Кадр "Корневая страница (СО)" в режиме исполнения.]]

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Описание
|-
| alarms > en (конфигурация) || Сигналы > Включено || Логический || Включение [[#alarmsAct|общей таблицы активных нарушений]]
|-
| defUser (конфигурация) || Типичное для возврата, {минут)-{пользователь} || Строка || Включение и конфигурация возврата к некоторому непривилегированному пользователю после некоторого времени неактивности, строкой '''{минуты)-{пользователь}'''.
|-
| demoPlayProc || Проц. проигрывания демо || Текст || Процедура на [[Special:MyLanguage/Modules/JavaLikeCalc|языке JavaLikeCalc]] для проигрывания некоторой демонстрации. Включает кнопку Демо-режима в режиме исполнения. Для примера такой процедуры смотрите демонстрационные-проекты [[Special:MyLanguage/Using/Model_AGLKS|АГЛКС]] и [[Special:MyLanguage/Using/Model_Boiler|Котел]]!
|-
| colspan=4 | ''Специфические для визуализатора атрибуты для [[Special:MyLanguage/Modules/Vision|UI.Vision]] ([[Special:MyLanguage/Modules/Vision#SpecAttrs|больше]]) и [[Special:MyLanguage/Modules/WebVision|UI.WebVision]] ([[Special:MyLanguage/Modules/WebVision#SpecAttrs|больше]])''
|-
| keepAspectRatio || Сохранять пропорцию при масштабировании || Логический || Сохранять пропорцию страниц при масштабировании.
|-
| stBarNoShow || Не показывать строку статуса || Логический || Скрыть строку статуса главного окна.
|-
| colspan=4 | ''Специфические для визуализатора атрибуты для [[Special:MyLanguage/Modules/Vision|UI.Vision]] ([[Special:MyLanguage/Modules/Vision#SpecAttrs|больше]])''
|-
| runWin || Окно исполнения || Выбор целых чисел || Установка режима исполнения главного окна:
* "Оригинальный размер (0)".
* "Максимизировать (1)".
* "На весь экран (2)".
|-
| statLine || Элементы строки статуса || Текст || Текстовое поле с описанием элементов строки статуса пользователя.
|-
| winPosCntrSave || Управление и сохранение положений окон || Логический || Включение управления и сохранения положения окон исполнения.
|-
| colspan=4 | ''Основные процедуры [[Special:MyLanguage/Modules/VCAEngine#Alarms|механизма уведомлений]]''
|-
| notify0 || Уведомление: тип 0 (Свет) || Текст ||
|-
| notify1 || Уведомление: тип 1 (Гудок) || Текст ||
|-
| notify2 || Уведомление: тип 2 (СинтезРечи) || Текст || 
|}

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

{| class="wikitable"
<section begin=grpGraph />
| {{Anch|grpGraph|<h3>Graphics group ([[Special:MyLanguage/Libs/Main_graphical_elements#grpGraph|grpGraph]]); Graphics group 10 ([[Special:MyLanguage/Libs/Main_graphical_elements#grpGraph|grpGraph10]])</h3>}}
| 1.6 || GPLv2 || * || en, uk, ru
<section end=grpGraph />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame shown in Figure 3.1 is provided for simultaneous observation of trends and control the parameters in the signal object, includes both instances of the widget "[[#ElViewGraph|Graphics group element]]" of each parameter (up to 8 or 10) and [[Special:MyLanguage/Sub-projects/VCA#Diagram|the primitive "Diagram"]] to monitor the parameters' trends and browsing history, and also the scroll bar for fast navigation on allowed history of selected parameters for show. The variant in 10 trends is inherited from the base variant in 8 trends and you can create your own variants by inherit the base and append more graphics group elements.

[[file:LibMainEls_grpGraphD_ru.png|center|frame|Рис.3.1a. Кадр "Группа графиков" в режиме разработки.]]

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

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

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

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

[[file:LibMainEls_grpGraphR_ru.png|center|frame|Рис.3.1b. Кадр "Группа графиков" в режиме исполнения.]]

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| name || Имя || Строка || Постоянная ||  || Имя группы 
|-
| allowSelLst || Выбор: параметры доступные для выбора || Текст || Нет || || Поместите сюда параметры для выбора пользователем, списком DAQ-путей к ним (детальнее смотрите в диалоге "[[#graphSelPrm|Выбор параметра графика]]"):
<pre style="white-space:">
/LogicLev/proc/prm_CPU/prm_load
/LogicLev/proc/prm_MEM/prm_use
/LogicLev/proc/prm_CPU/prm_T </pre>
|-
| perUserSel || Выбор: сохранять выбор по пользователям || Логический || Нет || || Установить для сохранения пользовательского выбора отдельно
|-
| colspan="6" | ''Элемент {n} от 1 до 8(10)'' 
|-
| el{n} || colspan="5" | ''Перечень связываемых атрибутов соответствует перечню виджета "Элемент группы графиков (ElViewGraph)"''
|}

{| class="wikitable"
<section begin=ElViewGraph />
| {{Anch|ElViewGraph|<h4>Graphics group element ([[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|ElViewGraph]])</h4>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=ElViewGraph />
| [[User:RomanSavochenko|Roman Savochenko]] || 2000 ms
|}
The element-widget shown in Figure 3.1.1 is provided to create [[#grpGraph|graphics groups]]. The widget contains information about parameter, the regulator mode, if the parameter is such, the units of analog parameter, as well as the color corresponding to the parameter's trend. The widget commonly uses and represents the representative structure of the DAQ-templates "[[Special:MyLanguage/Libs/Main#anUnif|Analog signal]]" and "[[Special:MyLanguage/Libs/Main#digitBlockUnif|Discrete block]]".

[[file:LibMainEls_ElViewGraphD_ru.png|center|frame|Рис.3.1.1a. Виджет "Элемент группы графиков" в режиме разработки.]]

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

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

Except the available visual data, a number of control elements are provided:
* "Selection" — at pressing the left mouse button in the widget area, in the right side will appear [[#ElCadr|the control panel]], and the widget selection will be displayed by the border flashing.
* "Hide/Show" — double-clicking in the widget area toggles the show-hiding of the item's graph.
* "Context menu functions" — a number of functions are provided through the context menu:
** "Passport" — getting [[#Passport|the passport]] of the parameter, which will present all it properties.
** "Hide/Show" — toggling the display or hiding of a graph of this element, similar to a double click.
** "Show one" — single graph display of the selected parameter in its native scale by hiding the rest of the items in the group.
** "Show all" — display all parameter graphs in the group.
** "Calculating" — calling the [[#graphCalc|calculating dialog]] above the visible data of the selected parameter.
** "Select" — calling the [[#graphSelPrm|selection dialog]] of the parameter from the list of ones available for selection — the attribute "Select: parameters accessible to select" of the owner cadre. This item is only available if a selection list is available. From the dialog the user can clear the parameter also and what for statically preset parameters means of return to the static parameter.

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

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

[[file:LibMainEls_ElViewGraphR_ru.png|center|frame|Рис.3.1.1b. Виджет "Элемент группы графиков" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=graphSelPrm />
| {{Anch|graphSelPrm|<h4>Выбор параметра графика ([[Special:MyLanguage/Libs/Main_graphical_elements#graphSelPrm|graphSelPrm]])</h4>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=graphSelPrm />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунке 3.1.2, реализует диалог пользовательского выбора источников данных, часто архивных, для формирования графика в кадре "[[#grpGraph|Группа графиков]]". Выбор предоставляется из перечня указанного в атрибуте "Выбор: параметры доступные для выбора (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)":

<pre style="white-space: pre-wrap;">
/System/AutoDA/prm_CPULoad/load:CPU Load:0:100:%
/LogicLev/gen/prm_F3
<varhs>
</pre>

[[file:LibMainEls_graphSelPrm_ru.png|center|frame|Рис.3.1.2. Кадр "Выбор параметра графика" в режиме разработки и исполнения.]]

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

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

{| class="wikitable"
<section begin=graphCalc />
| {{Anch|graphCalc|<h4>Вычисление параметра графика ([[Special:MyLanguage/Libs/Main_graphical_elements#graphCalc|graphCalc]])</h4>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=graphCalc />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент, представленный на рисунке 3.1.3, реализует диалог пользовательского вычисления параметра выбранного графика для видимых на графике данных. Пользователю предоставляется возможность выбрать вычисление из встроенной библиотеки, привилегированный пользователь ("root" или в группе "ITW") имеет возможность отредактировать или написать собственную процедуру вычисления.

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

[[file:LibMainEls_graphCalc_ru.png|center|frame|Рис.3.1.3. Кадр "Вычисление параметра графика" в режиме разработки и исполнения.]]

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

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

{| class="wikitable"
<section begin=grpCadr />
| {{Anch|grpCadr|<h3>Группа контуров ([[Special:MyLanguage/Libs/Main_graphical_elements#grpCadr|grpCadr]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=grpCadr />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент-кадр, представленный на рисунке 3.2, служит для одновременного наблюдения и управления контурами нескольких параметров, до восьми, включает в себя как экземпляры виджета "[[#ElCadr|Элемент кадр]]" для каждого контура, так и [[Special:MyLanguage/Sub-projects/VCA#Diagram|примитив "Диаграмма"]] для наблюдения за трендами контуров и просмотра истории.

[[file:LibMainEls_grpCadrD_ru.png|center|frame|Рис.3.2a. Кадр "Группа контуров" в режиме разработки.]]

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

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

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

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

[[file:LibMainEls_grpCadrR_ru.png|center|frame|Рис.3.2b. Кадр "Группа контуров" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=ViewCadr />
| {{Anch|ViewCadr|<h3>Группа обзорных кадров ([[Special:MyLanguage/Libs/Main_graphical_elements#ViewCadr|ViewCadr]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=ViewCadr />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент-кадр, представленный на рисунке 3.3, служит для отображения текущих трендов параметров в отдельных кадрах-виджетах количеством до 24 единиц (6x4), относительно которых поддерживается масштабирование в зависимости от их конфигурируемого количества. Кадры-виджеты трендов параметров реализуются сопутствующим виджетом "[[#ElViewCadr|Кадр обзорной группы]]".

[[file:LibMainEls_ViewCadrD_ru.png|center|frame|Рис.3.3a. Кадр "Группа обзорных кадров" в режиме разработки.]]

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

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

[[file:LibMainEls_ViewCadrR_ru.png|center|frame|Рис.3.3b. Кадр "Группа обзорных кадров" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=ElViewCadr />
| {{Anch|ElViewCadr|<h4>Кадр группы обзора ([[Special:MyLanguage/Libs/Main_graphical_elements#ElViewCadr|ElViewCadr]])</h4>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=ElViewCadr />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент-виджет, представленный на рисунке 3.3.1, служит основой [[#ViewCadr|группы обзорных кадров]] и обычно не используется самостоятельно. Виджет отображает текстовую информацию о параметре в виде наименования и значения, а также тренд параметра за небольшой промежуток времени (2 минуты) для наблюдения за текущей тенденцией поведения параметра с авто-масштабированием по шкале значения. Виджет в целом использует и представляет представительскую структуру DAQ-шаблона "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговый сигнал]]".

[[file:LibMainEls_ElViewCadr_ru.png|center|frame|Рис.3.3.1. Виджет "Кадр группы обзора" в режиме разработки и исполнения (слева направо).]]

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

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

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| name || Имя || Строка || Входная связь || Parameter&#124;NAME || Имя параметра (шифр) для отображения в поле имени.
|-
| addr || Адрес || Адрес || Входная связь || Parameter&#124;var || Адрес к атрибуту значения параметра для построения тренда.
|-
| var || Переменная || Вещественный || Входная связь || Parameter&#124;var || Непосредственно значение параметра для отображения в поле значения.
|}

{| class="wikitable"
<section begin=ResultGraph />
| {{Anch|ResultGraph|<h3>Сводные графики ([[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraph|ResultGraph]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=ResultGraph />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент-кадр, представленный на рисунке 3.4, служит для отображения группы текущих трендов параметров (до 5) в отдельных кадрах-виджетах количеством до 16 единиц (4x4), относительно которых поддерживается масштабирование в зависимости от их конфигурируемого количества. Кадры-виджеты трендов параметров реализуются сопутствующим виджетом "[[#ResultGraphEl|Кадр сводных графиков]]".

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

[[file:at.png]] Кадр не поддерживает никакого управления.

[[file:LibMainEls_ResultGraphD_ru.png|center|frame|Рис.3.4a. Кадр "Сводные графики" в режиме разработки.]]

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

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

[[file:LibMainEls_ResultGraphR_ru.png|center|frame|frame|Рис.3.4b. Кадр "Сводные графики" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=ResultGraphEl />
| {{Anch|ResultGraphEl|<h4>Кадр сводных графиков ([[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraphEl|ResultGraphEl]])</h4>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=ResultGraphEl />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент-виджет, представленный на рисунке 3.4.1, служит основой [[#ResultGraph|сводных графиков]] и обычно не используется самостоятельно. Виджет отображает название группы и до пяти трендов, с их текстовыми метками, за фиксированный промежуток времени (10 минут) для наблюдения за текущей тенденцией поведения параметров. Виджет в целом использует и представляет представительскую структуру DAQ-шаблона "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговый сигнал]]".

[[file:LibMainEls_ResultGraphEl_ru.png|center|frame|Рис.3.4.1. Виджет "Кадр сводных графиков" в режиме разработки и исполнения (слева направо).]]

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

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

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

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

{| class="wikitable"
<section begin=cntrRegul />
| {{Anch|cntrRegul|<h3>Панель настройки регулятора ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrRegul|cntrRegul]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=cntrRegul />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент-кадр, представленный на рисунке 3.5, служит для настройки ПИД-регулятора, включает в себя информацию о параметре-регуляторе, поля настроек регулятора и [[Special:MyLanguage/Sub-projects/VCA#Diagram|примитив "Диаграмма"]], для наблюдения за трендами регулятора и просмотра истории. Кадр в целом использует и представляет представительскую структуру DAQ-шаблона [[Special:MyLanguage/Libs/Main#pidUnif|аналогового]] и [[Special:MyLanguage/Libs/Main#pidUnifImp|импульсного]] ПИД-регуляторов.

* '''Спонсировано:''' [http://diyaorg.dp.ua ООО "ДІЯ"]

[[file:LibMainEls_cntrRegulD_ru.png|center|frame|Рис.3.5a. Кадр "Панель настройки регулятора" в режиме разработки.]]

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

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

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

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

[[file:LibMainEls_cntrRegulR_ru.png|center|frame|Рис.3.5b. Кадр "Панель настройки регулятора" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=alarmsSt />
| {{Anch|alarmsSt|<h3>Нарушение — состояние ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsSt|alarmsSt]])</h3>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=alarmsSt />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент-кадр на рисунке 3.6 служит для отображения истории нарушений и динамического их обновление для текущего времени в полноформатном табличном виде, с выделением их цветом и текстом и возможностью многоуровневого фильтрования. Нарушения получаются из [[Special:MyLanguage/Documents/Program_manual#ArchMess|буфера текущих-активных сообщений OpenSCADA]] и архива(ов), определённого конфигурационным полем "'''alArch'''". Фактически элемент реализует функции примитива "[[Special:MyLanguage/Sub-projects/VCA#ImplProtocol|Протокол]]" для нарушений и с расширением возможностей.

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

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

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

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

[[file:at.png]] Этот кадр и его поля в целом представляют структуру сообщения нарушения, которая детально описана в [[Special:MyLanguage/Documents/Program_manual#ArchMess|руководстве пользователя]].

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

* '''Спонсирование:''' Устьянцев Михаил
* '''Спонсировано, добавление нового пользовательского поля "Тип" на 0.2 {{CtxDetails|ЧД|человеко-дней, 1ЧД — 10 часов}}:''' INSERTEC LTDA

[[file:LibMainEls_alarmsStD_ru.png|center|frame|Рис.3.6a. Кадр "Нарушение — состояние" в режиме разработки.]]

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

[[file:at.png]] Поскольку кадр предусматривает отображение состояния и истории нарушений, то создание и использование [[Special:MyLanguage/Documents/Program_manual#ArchMess|архиватора сообщений]] является обязательным. Поэтому создайте или используйте шаблонный архиватор стартового проекта "Нарушения (alarms)" с опциями исключения дублирования, и укажите его (FSArch.alarms) в свойстве кадра "'''alArch'''".

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

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

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

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

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

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

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

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

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

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

[[file:LibMainEls_alarmsStR_ru.png|center|frame|Рис.3.6b. Кадр "Нарушение — состояние" в режиме исполнения.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| messCat || Message category || String || Category of the processing messages, typically it is "al*:*".
|-
| messLim || Messages limit, quantity || Integer || Maximum quantity of the messages in the table, typically it is 1000.
|-
| alArch || Alarms archiver, "{ArhMod}.{Arh}" || String || An archiver from which the violations will be taken, empty for all ones.
|-
| alarms.active || Active || Boolean || Turn off if there disabled confirmation, focus gaining and editing in general — purely displaying.
|-
| hHdrVis || Show header: horizontal || Boolean ||
|-
| vHdrVis || Show header: vertical || Boolean ||
|-
| formDtTm || Data and time format (%Y-%m-%d %H.%M.%S[.%MS,%US]) || String || Format of displaying the time of violation and confirmation.
|-
| colms || Columns
List separated by ',' from the variants: atm, qttm, nrmtm, lev, type, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.
| String || Determine in the desired sequence and the fields filling.
|-
| highLght || Highlight rules
Rows in the form "{lev}[{slev}]{quitt}{act}:{color}:{font}:{fontColor}".
| Text || Highlight rules, where:
* ''lev'' — main level of the message [0...7];
* ''slev'' — sub-level of the message [0...9], optional;
* ''quitt'' — sign of the message confirmation [0|1];
* ''act'' — sign of the message activity [0|1];
* ''color'' — background color of the message row;
* ''font'' — text font of the message row;
* ''fontColor'' — text color of the message row.
Te example:
<syntaxhighlight lang="BASH">
#<SnthHgl font="monospace">
# <rule expr="^#[^\n]*" color="gray" font_italic="1"/>
# <rule expr="^[0-9]*" color="blue">
#  <rule expr="[01]{2}$" color="red">
#   <rule expr="[01]$" color="darkorange"/>
#  </rule>
# </rule>
# <rule expr="(?<=:).*">
#  <rule expr="[^:]*" font_weight="1"/>
#  <rule expr="(?<=:).*" font_italic="1"/>
# </rule>
#</SnthHgl>
501:gray
401:red
1501:yellow
511:gray:Arial 11 0 1
411:red:Arial 11 0 1
1511:yellow:Arial 11 0 1
</syntaxhighlight>
|-
| colDscrCustNames || Перечень наименований пользовательских полей, поделённых ';' || Строка (перевод) || При поддержке пользовательских полей, и их видимости, тут приводятся их наименования.
|-
| types || Перечень типов по уровню от 0, разделены ';' || Строка (перевод) || Типы-названия нарушений за их уровнем, типично "Отладка;Информ.;Отметка;Предупр.;Ошибка;Критически;Тревога;Авария".
|}

{| class="wikitable"
<section begin=alarmsStReport />
| {{Anch|alarmsStReport|<h4>Report ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsStReport|alarmsStReport]])</h4>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=alarmsStReport />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element-frame, shown in Figure 3.6.1, implements a dialog to display a report document based on a list of violations received from [[#alarmsSt|the full-format frame of presenting the violations history]].

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

* '''Спонсирование:''' Устьянцев Михаил

[[file:LibMainEls_alarmsStReport_ru.png|center|frame|Рис.3.6.1. Кадр "Нарушения — отчёт".]]

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

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

{| class="wikitable"
<section begin=userManager />
| {{Anch|userManager|<h3>Менеджер пользователей ([[Special:MyLanguage/Libs/Main_graphical_elements#userManager|userManager]])</h3>}}
| 1.6 || GPLv2 || * || en, uk, ru
<section end=userManager />
| [[User:RomanSavochenko|Roman Savochenko]] || -2 ms (disabled)
|}
The element-frame, shown in Figure 3.7, serves to control users from the user interface itself. That is, typically this feature is provided to the SCADA programmer at [[Special:MyLanguage/Documents/Program_manual#CfgSecurity|the Security subsystem configuration]], but sometimes there is a need to provide this capability from the user interface and with a few restrictions on controlled users and their groups that this frame performs and generally provides:
* forming a list of controlled users;
* the ability to view and change user information for: name, full name, description, password and groups;
* adding new and deleting existing users;
* the possibility to edit the unprivileged user own information and password.

* '''Спонсирование:''' Винницкая Птицефабрика

[[file:LibMainEls_userManagerD_ru.png|center|frame|Рис.3.7a. Кадр "Менеджер пользователей" в режиме разработки.]]

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

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

[[file:LibMainEls_userManagerR_ru.png|center|frame|Рис.3.7b. Кадр "Менеджер пользователей" в режиме исполнения.]]

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Описание
|-
| 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 || БД хранения новых пользователей || Строка || БД хранения новосозданных пользователей, типично — рабочая.
|}

{| class="wikitable"
<section begin=storeHouse />
| {{Anch|storeHouse|<h3>Storehouse ([[Special:MyLanguage/Libs/Main_graphical_elements#storeHouse|storeHouse]])</h3>}}
| 1.4 || GPLv2 || * || en, uk
<section end=storeHouse />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.8, serves to manage of storehouses on different classes-categories of the storing-managing things. Initially that was developed and tested on the class "Library". The frame means of the direct accessing the DB by SQL and currently supports only MySQL/MariaDB.

During the frame implementing, the view "Table" of [[Special:MyLanguage/Modules/VCAEngine|the primitive "FormEl"]] significantly expanded on both visualizers for:
{{#lst:Documents/Release_0.9/Update4/en|FormElTable}}

The frame provides currently and in future for next features:
* '''Class edition mode''': observing, creation and edition the storehouse classes with a function of storing data at the field type change.
* '''Main data observing and edition mode''':
** observing main data of the selected or fixed storehouse classes in a big table with possibility of sorting and filtering by up to five columns;
** editing of content of the table cells in the edition mode;
** adding, copying and removing of records-rows of the table in the edition mode;
** generation of the report document of the selected item, which is ready to print and convenient in complete observing;
** generation of the report document of the main table with accounting the filter settings and natural show the specific fields;
** detailed control panel-form of the selected item with the specific fields.

The storehouse classes are stored in the table "classes" with the fixed table structure "<u>'''CLASS'''</u>, <u>'''ID'''</u>, '''NAME''', '''TP''' , '''TBL''', '''FILTER''', '''PROC'''", where:
* ''CLASS'' [varchar(20)] — class ID;
* ''ID'' [varchar(20)] — specific field ID of the class;
* ''NAME'' [text] — specific field localised name of the class, where the first line for the default value and the next lines form in the view '''{2SymbolLang}:{LocalizedText}''';
* ''TP'' [varchar(100)] — specific field type of the class, which correspond directly to the MySQL data types and some specific ones:
:* "'''file[:{max}[:{storage}[:{MIME}[:{OverViewSz}]]]]'''" — attaching files with the parameters:
::* ''max'' — maximum files allowed to attach;
::* ''storage'' — storage of the files on the File System with the specified path, and empty to store directly in the DB field of the type LONGTEXT;
::* ''MIME'' — files type, allowed to attach-load, where empty for any and like to "image/*" for only images;
::* ''OverViewSz'' — enable a field of the image files overview on the item form with the specified size in pixels.
* ''TBL'' [varchar(100)] — specific field properties of representing data in the table, has the format '''{align}:{width}:{pos}''', where:
:* ''align'' — column alignment, supports the values: "left", "center", "right"; where the "left" value is default one for strings and "center" for other;
:* ''width'' — forced width for the column, in percents at symbol "%" in the end or in pixels;
:* ''pos'' — the column position in the string view, so you can write that like to "005" for true sort.
* ''FILTER'' [text] — specific field properties of filtering and indexing lists preparing for the filter selection, for the variants: '''index''' and '''list{SepSymb}''', where:
:* ''index'' — the column value means as whole one for indexing;
:* ''list{SepSymb}'' — the column value means as a list of items for indexing, separated by symbol ''SepSymb''.
: From the second line you can specify rules of the highlighting in the form "'''{ID}:{FLGS}:{color}:{font}'''", where:
:* ''ID'' — indexed or listed value in the cell;
:* ''FLGS'' — flags list in values [0|1], currently that is only "Highlight [Cell|Row]";
:* ''color'' — the background color;
:* ''font'' — the text font.
* ''PROC'' [text] — a procedure of calculation the cell value on the internal language [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc.JavaScript]] of OpenSCADA, the column is become the logical one; cells of the logical columns aren't accessible for the manual edition; all cells of the record-row are accessed in the procedure as them IDs, including the calculated one which you have to assign in some value; you can use that feature also as a temporary one, that is install a procedure for calculation and next clean up that;
: [[file:at.png]] Setting here a procedure will clean up (set to NULL) all the column cells!

Data of storehouse of the corresponded class stores in different table with name "sh_{CLASS}" and the structure "<u>'''ID'''</u>, '''NAME''', '''DSCR''', '''SP_{ID}1''', ..., '''SP_{ID}N'''", where:
* ''ID'' [INT] — automatic index of the table, allowed for change the visibility;
* ''NAME'' [varchar(200)] — name of the item, allowed for change the type;
* ''DSCR'' [text] — description of the item;
* ''SP_{ID}X'' — specific field of the class corresponding to ''ID'' in the class table.

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

[[file:LibMainEls_storeHouseD.png|center|frame|Fig.3.8a. The "Storehouse" frame in the development mode.]]

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

To enable the reporting, you have to place [[#alarmsStReport|the frame of alarms reporting]] in the logical container of panels of the project tree.

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

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

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

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

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

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

[[file:at.png]] The frame supports now of working with very big "Periodic processing" value and that value is set now to from parent (the value -1). That is possible by a mechanism of the events early processing and the possibility of control the processing periodicity from the procedure.

[[file:LibMainEls_storeHouseClassR.png|center|frame|Fig.3.8b. The "Storehouse" frame in the runtime mode at the class representing.]]

[[file:LibMainEls_storeHouseDataR.png|center|frame|Fig.3.8c. The "Storehouse" frame in the runtime mode at the data representing.]]

[[file:LibMainEls_storeHouseDataRf.png|center|frame|Fig.3.8d. The "Storehouse" frame in the runtime mode at the item edition form.]]

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

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

Эти элементы в основном открываются динамически, при вызове из элемента-виджета первичного представления, осуществляя при этом [[Special:MyLanguage/Sub-projects/VCA#LinkingDyn|динамическое связывание связей панели в группе "<page>"]] с виджетом (часто страницей), который вызывает эту панель. Дальнейшая работа, до закрытия, осуществляется с данными виджета, который вызывал.

{| class="wikitable"
<section begin=terminator />
| {{Anch|terminator|<h3>Терминальная панель ([[Special:MyLanguage/Libs/Main_graphical_elements#terminator|terminator]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=terminator />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Элемент панели, представленный на рисунке 4.1, служит для заполнения пространства контейнера панели, когда не выбран активный визуальный элемент для управления на основном кадре, поскольку закрытия или очистки кадров в области контейнера не предусматривается, только замена.

[[file:LibMainEls_terminatorD_ru.png|center|frame|Рис.4.1. Элемент панели "Терминальная панель".]]

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

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

{| class="wikitable"
<section begin=ElCadr />
| {{Anch|ElCadr|<h3>Элемент кадр ([[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|ElCadr]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru <section end=ElCadr />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунках 4.2, фактически является универсальной панелью управления и расширенного контроля различными устройствами по всем известным и определённым представительским структурам базовых данных систем управления по DAQ-шаблонам:
* аналоговые: [[Special:MyLanguage/Libs/Main#anUnif|аналоговый сигнал]], [[Special:MyLanguage/Libs/Main#manInUnif|ручной ввод аналогового сигнала]], ПИД-регулятор ([[Special:MyLanguage/Libs/Main#pidUnif|аналоговый]] и [[Special:MyLanguage/Libs/Main#pidUnifImp|импульсный]]);
* [[Special:MyLanguage/Libs/Main#digitBlockUnif|дискретные сборки]]: клапаны, отсекатели, задвижки, двигатели, вентиляторы и различные переключатели;
* [[Special:MyLanguage/Libs/Main#codeState|произвольные дискретные состояния]].

В первичной функции панели — расширенное и общее управление, этот элемент вызывается из:
* [[#Widgets|виджетов первичного представления данных]] этой библиотеки: "[[#anShow|Отображение аналогового]]", "[[#anShow|Отображение аналогового 1]]", "[[#TextLab|Текстовая метка]]", "[[#ImgLab|Метка изображением]]";
* [[#MainFrames|основных кадров]]: "[[#grpGraph|Группа графиков]]", "[[#ViewCadr|Группа обзорных кадров]]", "[[#cntrRegul|Панель настройки регулятора]]".

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

[[file:LibMainEls_ElCadrD_ru.png|center|frame|Рис.4.2a. Виджет "Элемент кадр" в режиме разработки.]]

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

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

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

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

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

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

Каждое действие на этой панели управления (смена задания ПИД-регулятора, изменение состояния дискретного параметра, ...) регистрируется в журнале (протоколе) вмешательств, посредством генерации соответствующих сообщений согласно [[Special:MyLanguage/Documents/Program_manual#ArchMess|структуре сообщений действий оператора]].

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

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

[[file:LibMainEls_elcadr_ru.png|center|frame|Рис.4.2b. Виджет "Элемент кадр" в режиме исполнения.]]

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

{| class="wikitable"
<section begin=cntrPaspExt />
| {{Anch|cntrPaspExt|<h3>Паспорт, расширенный ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|cntrPaspExt]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=cntrPaspExt />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунке 4.3, является информационно-контрольным диалогом около параметра источника данных — расширенный паспорт параметра. В отличии от [[#cntrPasp|простого паспорта]], расширенный, кроме информации, предоставляет возможность контроля атрибутов параметра и отображения истории стандартных атрибутов как в виде тренда, так и таблицы данных.

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

''История'' предоставляется в следующих двух вкладках "Тренды" и "Данные", которые могут и отсутствовать при отсутствии истории-архивов по стандартным атрибутам. Вкладка "Тренды" содержит область графиков, [[Special:MyLanguage/Sub-projects/VCA#Diagram|примитив "Диаграмма"]], на большей части окна, и таблицу внизу с названиями, цветом и шкалами графиков. Графики периодически обновляются и строятся с периодом 1 секунда, и на фиксированную глубину в 1 час. Вкладка "Данные" содержит только поле [[Special:MyLanguage/Sub-projects/VCA#Document|примитива "Документ"]] с таблицей со значениями атрибута в столбцах, которая обновляется с периодом 1 секунда для периода данных истории и на глубину в 100 записей. Стандартными атрибутами с историей считаются следующие элементы [[Special:MyLanguage/Libs/Main|представительских структур параметра]]:
* [[Special:MyLanguage/Libs/Main#anUnif|Аналоговый сигнал]]:
** '''var''' — переменная.
* [[Special:MyLanguage/Libs/Main#pidUnif|ПИД-регулятор]]:
** '''sp''' — задание;
** '''out''' — выход;
** '''auto''' — режим: автомат.
* [[Special:MyLanguage/Libs/Main#codeState|Дискретные сборки]]:
** '''com''' — команда "Открыть";
** '''close''' — команда "Закрыть";
** '''stop''' — команда "Остановить";
** '''st_open''' — состояние "Открыто";
** '''st_close''' — состояние "Закрыто".

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

[[file:at.png]] На данный момент этот диалог является основным и он заменил [[#cntrPasp|простой диалог паспорта]].

* '''Спонсировано:''' ПАТ ХАРТРОН

[[file:LibMainEls_cntrPaspExt_ru.png|center|frame|Рис.4.3. Диалог "Паспорт, расширенный" в режиме исполнения.]]

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

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

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| pName || Имя параметра || Адрес || Входная связь || Parameter&#124;NAME || Адрес к имени параметра для обращения к параметру целиком и изъятия всех его свойств.
|}

{| class="wikitable"
<section begin=cntrPasp />
| {{Anch|cntrPasp|<h3>Паспорт ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrPasp|cntrPasp]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=cntrPasp />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунке 4.4, является информационным диалогом около параметра источника данных — паспорт параметра, соответственно он позволяет получить такого рода информацию как: шифр, имя, описание, единица измерения, аварийные границы и другое, согласно [[Special:MyLanguage/Libs/Main|представительской структуре параметра]] — атрибуты параметра. Диалог построен на основе [[Special:MyLanguage/Sub-projects/VCA#Document|примитива "Документ"]], содержимое которого формируется динамически и периодически обновляется.

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

[[file:at.png]] На данный момент этот диалог фактически заменён [[#cntrPaspExt|более функциональным и расширенным диалогом паспорта]] и он в основном отключен во всех шаблонных и демонстрационных проектах, хотя никто не препятствует его использованию, если необходима только информацию.

[[file:LibMainEls_cntrPasp_ru.png|center|frame|Рис.4.4. Диалог "Паспорт" в режиме исполнения.]]

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

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| pName || Имя параметра || Адрес || Входная связь || Parameter&#124;NAME || Адрес к имени параметра для обращения к параметру целиком и изъятия всех его свойств.
|}

{| class="wikitable"
<section begin=grph_panel />
| {{Anch|grph_panel|<h3>Панель графиков ([[Special:MyLanguage/Libs/Main_graphical_elements#grph_panel|grph_panel]])</h3>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=grph_panel />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунке 4.5, является специализированной панелью динамического управления основными пользовательскими свойствами [[Special:MyLanguage/Sub-projects/VCA#Diagram|примитива "Диаграмма"]]. Так, панель позволяет просмотреть графики истории за необходимый период времени и в нужном разрешении, поддерживается: масштабирование шкалы, выбор архиваторов для отображения, а также представление графиков в виде спектра присутствующих частот или XY.

[[file:LibMainEls_grph_panel.png|center|frame|Рис.4.5. Панель графиков в режиме разработки и исполнения (слева направо).]]

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

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

{{CntHdr|Using — runtime}}
The panel allows the user to:
* select the diagram graphics mode: "Graph", "Spectrum of frequencies", "XY";
* select of the diagram formation time;
* perform of navigation through the diagram for the half or five sizes of the graph area and setting of the diagram generation time to the current time or in the cursor time;
* get information about the time or frequency in the current cursor's position;
* select of the trend's formation size (depth) or set the begin time, also to the cursor time;
* select of the archive, used for the trend building, at the access rule "root:ITW";
* control the vertical and horizontal scale of the presentation: zoom in and out the scale, shift the scale up and down, the scale returns to its original value;
* switch of the scale mode by the window drawn by the mouse.

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

{| class="wikitable"
<section begin=doc_panel />
| {{Anch|doc_panel|<h3>Панель документов ([[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|doc_panel]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=doc_panel />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент, представленный на рисунке 4.6, является специализированной панелью динамического управления основными пользовательскими свойствами [[Special:MyLanguage/Sub-projects/VCA#Document|примитива "Документ"]]. Так, панель позволяет управлять документами и осуществлять навигацию по их истории; поддерживаются динамические и архивные документы.

[[file:LibMainEls_doc_panel_ru.png|center|frame|Рис.4.6. Панель документов в режиме разработки и исполнения (динамический и архивный), слева направа.]]

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

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

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

''Динамическим документом'' предусматривается:
* выбор времени формирования документа;
* выбор размера (глубины) формирования документа или времени начала;
* навигация по документу на один или пять размеров-глубины документа;
* установка времени генерации документа в текущее время.

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| colspan="6" | ''Динамические документы''
|-
| time || Время документа || ДатаВремя || Полная связь || <page>&#124;time ||
|-
| bTime || Начало документа || ДатаВремя || Полная связь || <page>&#124;bTime ||
|-
| doc || Документ || Строка || Полная связь || <page>&#124;doc ||
|-
| colspan="6" | ''Архивные документы''
|-
| n || Размер архива || Целый || Входная связь || <page>&#124;n ||
|-
| vCur || Курсор отображения || Целый || Полная связь || <page>&#124;vCur ||
|-
| aCur || Курсор архива || Целый || Входная связь || <page>&#124;aCur ||
|-
| aSize || Размер архива || Целый || Входная связь || <page>&#124;aSize ||
|}

{| class="wikitable"
<section begin=accept />
| {{Anch|accept|<h3>Подтверждение ([[Special:MyLanguage/Libs/Main_graphical_elements#accept|accept]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=accept />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 4.7 реализует простейший диалог подтверждения операций. Диалог содержит сообщение с вопросом и две кнопки "Принять" и "Отмена". Данный диалог, например, использован в кадре [[#userManager|Менеджер пользователей]] для подтверждения операции удаления.

* '''Спонсирование:''' Василий Григорьев, [http://e-beam.ru Лаборатория Вакуумных Технологий]

[[file:LibMainEls_accept_ru.png|center|frame|Рис.4.7. Диалог "Подтверждение" в режиме разработки и исполнения.]]

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

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

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

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

{| class="wikitable"
<section begin=treeSelect />
| {{Anch|treeSelect|<h3>Выбор элемента в дереве ([[Special:MyLanguage/Libs/Main_graphical_elements#treeSelect|treeSelect]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=treeSelect />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Элемент на рисунке 4.8 реализует простой диалог операции выбора пункта в дереве. Диалог содержит само дерево и две кнопки "Принять" и "Отменить". Этот диалог, например, использован, и первично для него разрабатывался, в кадре "[[Special:MyLanguage/Libs/Prescriptions#prescrRunSimple|Рецепт: исполнение (простой)]]" для иерархического выбора элемента в дереве.

* '''Спонсирование:''' Василий Григорьев, [http://e-beam.ru Лаборатория Вакуумных Технологий]

[[file:LibMainEls_treeSelect_ru.png|center|frame|Рис.4.8. Диалог "Выбор элемента в дереве" в режиме разработки и исполнения.]]

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

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

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

{{CntHdr|Свойства связывания и конфигурации}}
{| class="wikitable"
|-
! Идентификатор !! Имя !! Тип !! Конфигурация !! Конфигурационный шаблон !! Описание
|-
| elEvent || Элемент: событие || Строка || Полная связь || <page>&#124;event || Используется для отправки события "dlg_Apply" в случае подтверждения.
|-
| elItems || Элемент: список элементов || Текст || Входная связь || <page>&#124;items || Источник перечня элементов в диалоге.
|-
| selValue || Элемент: выбранное значение || Строка || Полная связь || <page>&#124;selValue || Источник выбранного элемента в диалоге.
|}

Export translations

Views

Navigation menu

OpenSCADA

OpenSCADA Wiki

Search

Tools

MediaWiki

Personal tools