OpenSCADAWiki - User contributions [en]

Modules/SSL/uk

2026-05-25T05:54:48Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Ім'я !! Версія !! Ліцензія !! Джерело !! Мови !! Платформи !! Тип !! Автор
|-
<section begin=info />
| [[Special:MyLanguage/Modules/SSL|SSL]] || SSL
| 5.2 || GPL2 || tr_SSL.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| Транспорт || Роман Савоченко
|-
! colspan="9" | Опис
|-
| colspan="9" | Надає транспорт, заснований на безпечному шарі сокетів. Використано [http://www.openssl.org OpenSSL] та підтримуються SSL-TLS залежно від версії бібліотеки.
* '''Спонсорування, зовнішнього файлу сертифікатів на 0.3 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' Вінницька Птахофабрика
|}

Модуль надає до програми підтримку транспортів, заснованих на Шарі Безпечних Сокетів (SSL). У основі модуля лежить бібліотека [http://www.openssl.org OpenSSL]. Підтримуються вхідні та вихідні транспортні протоколи SSL-TLS, загальний перелік яких залежить від їх доступності у бібліотеці OpenSSL та обирається найбільш актуальний і безпечний.

Додати нові вхідні та вихідні безпечні сокети можна за посередництвом конфігурації [[Special:MyLanguage/Documents/Program_manual#Transports|транспортної підсистеми]] у будь якому конфігураторі OpenSCADA.

__TOC__

На нових SSL-версіях вкладка "Транспорти" модуля доповнена інформацією щодо загальних-контекстних шифрів окремо для вхідної-серверної частини і вихідної-клієнтської, дивіться рисунок 1.

[[File:SSL_tr_uk.png|center|frame|Рис.1. Вкладка "Транспорти" із SSL шифрами.]]

== {{Anch|InTr|Вхідні транспорти}} ==
Сконфігурований та запущений вхідний транспорт відкриває серверний SSL-сокет для очікування підключень клієнтів, крім ініціативного підключення. SSL-сокет є багато-потоковим, тобто при підключенні клієнту створюється клієнтське SSL-з'єднання та новий потік, у якому здійснюється обслуговування клієнту. Серверний SSL-сокет на цей час переходить до очікування запитів від нового клієнту. Таким чином досягається паралельне обслуговування клієнтів.

Кожний вхідний транспорт пов'язується з одним або декількома з доступних транспортних протоколів, якому передаються вхідні повідомлення. Разом з транспортним протоколом підтримується механізм об'єднання шматків розрізнених при передачі запитів.

Прочитати про механізм пасивного збору та ініціативні підключення ви можете у відповідній частині документу "[[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Збір даних в OpenSCADA]]".

[[File:SSL_in_uk.png|center|frame|Рис.2. Загальні діалоги конфігурації вхідного SSL-транспорту.]]

За допомогою основного діалогу можна встановити:
* Стан транспорту, а саме: статус, "Підключення", ім'я сховища (яке містить конфігурацію), перелік з інформацією про поточні підключення і підтримувані шифри.
* Ідентифікатор, ім'я та опис транспорту.
* Адреса транспорту у форматі "'''{addr}[:{port}[,{port2}[,{portN}]][:{mode}[:{IDmess}]]]'''" де:
** ''addr'' — адреса для відкриття SSL, має бути однією з адрес хосту. Порожня або "*" адреса відкриває SSL на всіх інтерфейсах. Допускаються як символьне, так й IPv4 "'''127.0.0.1'''" або IPv6 "'''[::1]'''" представлення адреси.
** ''port'', ''port2'', ''portN'' — мережеві порти на яких послідовно відкривається SSL (при зайнятості перших), можливе вказання символьного ім'я порту відповідно до ''/etc/services''.
** ''mode'' – режим оперування:
*** '''0'''(типовий) — звичайне підключення.
*** '''2''' — ініціативне підключення. Вмикає режим ініціативи підключення цього вхідного транспорту до віддаленого хосту (адреса замість локального) та перехід у режим очікування запитів від цього хосту. Значення "Keep alive час очікування" використовується як таймаут перепідключення даного транспорту за відсутності активності, з метою відновлення можливо втраченого підключення.
** ''IDmess'' — ідентифікуюче повідомлення ініціативного підключення — режим 2.
* Обрання транспортних протоколів.
* Стан "Підключення", у який переводити транспорт при завантажені.

За допомогою додаткового діалогу можна встановити:
* Пріоритет задач транспорту.
* Розмір системного вхідного буферу сокетів в кілобайтах. Встановити в 0 для зняття користувацького розміру. Актуальний розмір можете бачити у статусі.
* Максимальний розмір сегмента (MSS) в байтах для обмеження розміру пакетів що відсилаються (сегментів TCP) на поганих каналах зв'язку. Встановити в 0 для зняття користувацького обмеження розміру. Актуальний розмір можете бачити у статусі.
* PEM-файл сертифікатів та приватного ключа; або сертифікати, приватний ключ SSL безпосередньо та пароль приватного ключа SSL.
:[[File:at.png]] Приховано у підключеному стані.
:[[File:at.png]] Відстежується у 60 секунд щодо оновлення, відтак перепідключення транспорту для актуалізації.
* [!INIT] Максимальна кількість клієнтів, Максимальна кількість клієнтів за хостами та Розмір вхідного буферу.
* [!INIT] Keep alive запитів. Закриття підключення після вказаної кількості запитів. Нульове значення для вимкнення — не закривається ніколи.
* Keep alive час очікування, секунд. Закриття підключення після відсутності запитів протягом вказаного часу. Нульове значення для вимкнення — не закривається ніколи.
:[[File:at.png]] Вимикати цю функцію не рекомендується оскільки властивість мережі TCP/IP не гарантує повідомлення серверу про відключення з'єднання, скажемо у випадку пропадання живлення на клієнті. У результаті чого можуть <span style="color: red">назавжди</span> залишатися відкриті клієнтські підключення, а за досягненням ліміту сервер припинить приймати нові!
* [INIT|ASSOC] Таймаути, спроби ініціативного підключення і асоційованих вихідних транспортів, порожнє для типового і поділене '||'. Формат таймаутів і спроб відповідає вихідному транспорту.
* Специфічні до протоколу користувацькі параметри.
* Скинути усі додаткові параметри до типових значень та очистити специфічні до протоколу користувацькі параметри.

== Вихідні транспорти ==
Сконфігурований та запущений вихідний транспорт відкриває з'єднання з вказаним сервером. При розриві з'єднання вихідний транспорт зупиняється. Для відновлення з'єднання транспорт треба знову запустити, що всі протоколи роблять автоматично.

Транспорт підтримує пряме визначення декількох адрес серверу та опрацювання всіх IP-адрес у які резолвиться символьна адреса, що дозволяє будувати [[Special:MyLanguage/Documents/DAQ#Redundancy|вертикальне резервування]] безпосередньо транспортом, який буде автоматично підключатися до першого доступного серверу.

[[file:SSL_out_uk.png|center|frame|Рис.3. Загальні діалоги конфігурації вихідного SSL-транспорту.]]

За допомогою основного діалогу можна встановити:
* Стан транспорту, а саме: статус, "Підключення" та ім'я сховища, яке містить конфігурацію, і підтримувані шифри.
* Ідентифікатор, ім'я та опис транспорту.
* Адреса транспорту у форматі "'''{addr}[,{addrN}]:{port}'''", де:
** ''addr'' — адреса до якої здійснюється підключення. Допускається як символьне так й IPv4 "'''127.0.0.1'''" або IPv6 "'''[::1]'''" представлення адреси.
** ''port'' — мережевий порт до якого здійснюється підключення. Можливе вказання символьного ім'я порту відповідно до ''/etc/services''.

За допомогою додаткового діалогу можна встановити:
* PEM-файл сертифікатів та приватного ключа; або сертифікати, приватний ключ SSL безпосередньо та пароль приватного ключа SSL.
:[[File:at.png]] Приховано у підключеному стані.
* Інтервали часу підключення у форматі "'''{conn}:{next}'''", де:
** ''conn'' — максимальний час очікування відповіді з'єднання, у секундах;
** ''next'' — максимальний час очікування продовження відповіді, у секундах.
: Може бути пріоритетно визначено другим глобальним аргументом поля адреси, на кшталт "'''localhost:123||5:1'''".
* Спроб запиту транспортом та протоколом, для повних запитів.
: Може бути пріоритетно визначено третім глобальним аргументом поля адреси, на кшталт "'''localhost:123||5:1||3'''".
* Максимальний розмір сегмента (MSS) в байтах для обмеження розміру пакетів що відсилаються (сегментів TCP) на поганих каналах зв'язку. Встановити в 0 для зняття користувацького обмеження розміру. Актуальний розмір можете бачити у статусі.
* Специфічні до протоколу користувацькі параметри.
* Скинути усі додаткові параметри до типових значень та очистити специфічні до протоколу користувацькі параметри.

== Сертифікати та ключі ==
Для повноцінного функціювання модуля необхідні сертифікати і приватні ключі. У випадку з вхідним SSL-транспортом (сервером) вони обов'язкові. У випадку з вихідним SSL-транспортом вони можуть і не встановлюватися, хоча їх використання бажане.

Простішою конфігурацією сертифікату є само-підписаний сертифікат та приватний ключ. Нижче описано процедуру їх створення за допомогою утиліти '''openssl''':
<syntaxhighlight lang="bash">
# Генерація секретного ключа
openssl genrsa -out ./key.pem -des3 -rand /var/log/messages 2048
# Генерація само-підписаного сертифікату
openssl req -x509 -new -key ./key.pem -out ./selfcert.pem -days 365
</syntaxhighlight>

Next, the contents of the files "key.pem" and "selfcert.pem" is copied into the text field of the certificate and key. Password of the private key is installed in the appropriate field. Or you can place the private key and the certificate into single PEM-File and specify its in the corresponded configuration field.

== Specific errors of the OpenSSL library ==
The OpenSSL library is coding errors in own way, which often is not obvious for problems understanding, so there we provide such errors with explanation:
* "BIO_do_accept: error:10000075:BIO routines:unable to bind socket" — this error from an input transport in case of busy the specified port.

Modules/SSL/ru

2026-05-25T05:54:48Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Имя !! Версия !! Лицензия !! Источник !! Языки !! Платформы !! Тип !! Автор
|-
<section begin=info />
| [[Special:MyLanguage/Modules/SSL|SSL]] || SSL
| 5.2 || GPL2 || tr_SSL.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| Transport || {{Author|Roman Savochenko|Maxim Lysenko (2009) — this page initial translation}}
|-
! colspan="9" | Description
|-
| colspan="9" | Provides transport based on the secure sockets' layer. [http://www.openssl.org OpenSSL] is used and supported SSL-TLS depending on the library version.
* '''Sponsored by, for an external certificates file on 0.3 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
|}

The module provides to the program support for the Secure Sockets Layer (SSL) based transports. The module is based on the library [http://www.openssl.org OpenSSL]. Input and output SSL-TLS transport protocols are supported, the general list of which is dependent on their availability in the OpenSSL library and the most relevant and safe is selected.

Добавить новые входные и выходные безопасные сокеты можно посредством конфигурации [[Special:MyLanguage/Documents/Program_manual#Transports|транспортной подсистемы]] в любом конфигураторе OpenSCADA.

__TOC__

On new SSL-versions the "Transports" tab of the module is appended by information of the common-context ciphers for input-server and output-client parts differently, see Figure 1.

[[File:SSL_tr.png|center|frame|Fig.1. The "Transports" tab with SSL ciphers.]]

== {{Anch|InTr|Входные транспорты}} ==
Сконфигурированный и запущенный входной транспорт открывает серверный SSL-сокет для ожидания подключения клиентов. SSL-сокет являются много-поточными, т.е. при подключении клиента создаётся клиентское SSL-соединение и новый поток в котором производиться обслуживание клиента. Серверный SSL-сокет в этот момент переходит к ожиданию запросов от нового клиента. Таким образом достигается параллельное обслуживание клиентов.

Each input transport is associated with one or several available transport protocols, to which input messages are transmitted. Together with the transport protocols, the mechanism of combining fragmented pieces when sending requests is supported.

Read about the passive acquisition mechanism and initiative connections you can in the corresponding part of the "[[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Data acquisition in OpenSCADA]]" document.

[[File:SSL_in.png|center|frame|Fig.2. The generic configuration dialogues of the input SSL-transport.]]

Using the main dialog you can set:
* State of the transport, that is: status, "Connect", name of the storage (containing the configuration), a list with information about the active connections and supported ciphers.
* Identifier, name and description of the transport.
* Address of the transport in the format "'''{addr}[:{port}[,{port2}[,{portN}]][:{mode}[:{IDmess}]]]'''", where:
** ''addr'' — address to open SSL, it must be one of the addresses of the host. Empty or "*" address opens SSL for all interfaces. There may be as the symbolic representation as well as IPv4 "'''127.0.0.1'''" or IPv6 "'''[::1]'''".
** ''port'', ''port2'', ''portN'' — network ports on which SSL is sequential opened (at busy the first ones), indication of the character name of the port, according to ''/etc/services'' is available.
** ''mode'' – mode of operation:
*** '''0'''(default) — ordinal connection;
*** '''2''' — initiative connection. Enables the mode of connecting this input transport to remote host (address instead of local) and switching to the listening state of this host. The "Keep alive timeout" value is used as the timeout of the re-connection of this transport in the absence of activity in order to restore the possibly lost connection.
** ''IDmess'' — identification message of the initiative connection — the mode 2.
* Selecting of the transport protocols.
* State "Connect", in which the transport must be switched at start up.

Using the additional dialog you can set:
* Priority of the transport tasks.
* System input buffer size in kilobytes of the socket. Set to 0 for disabling the user size. Actual size you can see in the status.
* Maximum segment size (MSS) in bytes, for limit the transmitted packages size (segments TCP) on bad link channels. Set to 0 for disabling the user limit for size. Actual size you can see in the status.
* PEM-file of the certificates and private key; or the certificates, private SSL key directly and password of the private SSL key.
:[[File:at.png]] Hidden in the connected state.
:[[File:at.png]] Is traced in 60 seconds for updating, then the transport reconnect for actualisation.
* [!INIT] Maximum number of clients, Maximum number of clients per host and Size of the input buffer.
* [!INIT] Keep alive requests. Closing the connection after the specified requests. Zero value to disable - not close ever.
* Keep alive timeout, seconds. Closing the connection after no requests at the specified timeout. Zero value to disable - not close ever.
:[[File:at.png]] We do not recommend disable the function by the TCP/IP network's properties does not guarantee notice the server about the connection disable, for example after power supply lost on the client. As result the opened client connections will left <span style="color: red">forever</span> and after their number achieve to the limit, server will drop new connections!
* [INIT|ASSOC] Timeouts, tries of the initiative connection and the associated output transports, empty for default and separated by '||'. Format of the timeouts and tries is corresponded to ones of the output transport.
* Protocols' specific custom parameters.
* Reset all the additional parameters to default values and cleanup the protocols' specific custom parameters.

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

The transport supports of direct definition of multiple server addresses and processing of all IP addresses in which the symbolic address is resolved, which allows you to build [[Special:MyLanguage/Documents/DAQ#Redundancy|vertical redundancy]] directly by the transport that will be automatically connected to the first available server.

[[file:SSL_out.png|center|frame|Fig.3. The generic configuration dialogues of the output SSL-transport.]]

Using the main dialog you can set:
* State of the transport, that is: status, "Connect", name of the storage, containing the configuration, and supported ciphers.
* Identifier, name and description of the transport.
* Address of the transport in the format "'''{addr}[,{addrN}]:{port}'''", where:
** ''addr'' — address with which the connection is made. There may be as the symbolic representation as well as IPv4 "'''127.0.0.1'''" or IPv6 "'''[::1]'''".
** ''port'' — network port with which the connection is made. Indication of the character name of the port according to ''/etc/services'' is available.

Using the additional dialog you can set:
* PEM-file of the certificates and private key; or the certificates, private SSL key directly and password of the private SSL key.
:[[File:at.png]] Hidden in the connected state.
* Connection timings in the format "'''{conn}:{next}'''", where:
** ''conn'' — maximum time of waiting the connection, in seconds;
** ''next'' — maximum time of waiting for continue the response, in seconds.
: Can be prioritatile specified into the address field as the second global argument, as such "'''localhost:123||5:1'''".
* Attempts of the requesting both for this transport and protocol, for full requests.
: Can be prioritatile specified into the address field as the third global argument, as such "'''localhost:123||5:1||3'''".
* Maximum segment size (MSS) in bytes, for limit the transmitted packages size (segments TCP) on bad link channels. Set to 0 for disabling the user limit for size. Actual size you can see in the status.
* Protocols' specific custom parameters.
* Reset all the additional parameters to default values and cleanup the protocols' specific custom parameters.

== Certificates and keys ==
For the full function of the module, you need certificates and private keys. In the case of input SSL-transport (server), they are mandatory. In the case of the output SSL-transport, they may not be installed, although their using is desirable.

The simplest configuration of the certificate is self-subscription certificate and private key. The following describes how to create them using the tool '''openssl''':
<syntaxhighlight lang="bash">
# Generation the secret key
openssl genrsa -out ./key.pem -des3 -rand /var/log/messages 2048
# Generation of self-subscription certificate
openssl req -x509 -new -key ./key.pem -out ./selfcert.pem -days 365
</syntaxhighlight>

Next, the contents of the files "key.pem" and "selfcert.pem" is copied into the text field of the certificate and key. Password of the private key is installed in the appropriate field. Or you can place the private key and the certificate into single PEM-File and specify its in the corresponded configuration field.

== Specific errors of the OpenSSL library ==
The OpenSSL library is coding errors in own way, which often is not obvious for problems understanding, so there we provide such errors with explanation:
* "BIO_do_accept: error:10000075:BIO routines:unable to bind socket" — this error from an input transport in case of busy the specified port.

Modules/SSL/en

2026-05-25T05:54:47Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Module !! Name !! Version !! License !! Source !! Languages !! Platforms !! Type !! Author
|-
<section begin=info />
| [[Special:MyLanguage/Modules/SSL|SSL]] || SSL
| 5.2 || GPL2 || tr_SSL.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| Transport || {{Author|Roman Savochenko|Maxim Lysenko (2009) — this page initial translation}}
|-
! colspan="9" | Description
|-
| colspan="9" | Provides transport based on the secure sockets' layer. [http://www.openssl.org OpenSSL] is used and supported SSL-TLS depending on the library version.
* '''Sponsored by, for an external certificates file on 0.3 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
|}

The module provides to the program support for the Secure Sockets Layer (SSL) based transports. The module is based on the library [http://www.openssl.org OpenSSL]. Input and output SSL-TLS transport protocols are supported, the general list of which is dependent on their availability in the OpenSSL library and the most relevant and safe is selected.

You can add new input and output safe sockets through the configuration of [[Special:MyLanguage/Documents/Program_manual#Transports|the transport subsystem]] in any OpenSCADA configurator.

__TOC__

On new SSL-versions the "Transports" tab of the module is appended by information of the common-context ciphers for input-server and output-client parts differently, see Figure 1.

[[File:SSL_tr.png|center|frame|Fig.1. The "Transports" tab with SSL ciphers.]]

== {{Anch|InTr|Input transports}} ==
Configured and running input transport opens server SSL-socket for the expectation of connection of the clients, besides the initiative connections. SSL-socket is multi-stream, i.e. when the client connects, the client socket and the new thread are created in which the client is served. Server socket in this moment switches to the waiting for the request from the new client. Thus the parallel service of the clients is achieved.

Each input transport is associated with one or several available transport protocols, to which input messages are transmitted. Together with the transport protocols, the mechanism of combining fragmented pieces when sending requests is supported.

Read about the passive acquisition mechanism and initiative connections you can in the corresponding part of the "[[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Data acquisition in OpenSCADA]]" document.

[[File:SSL_in.png|center|frame|Fig.2. The generic configuration dialogues of the input SSL-transport.]]

Using the main dialog you can set:
* State of the transport, that is: status, "Connect", name of the storage (containing the configuration), a list with information about the active connections and supported ciphers.
* Identifier, name and description of the transport.
* Address of the transport in the format "'''{addr}[:{port}[,{port2}[,{portN}]][:{mode}[:{IDmess}]]]'''", where:
** ''addr'' — address to open SSL, it must be one of the addresses of the host. Empty or "*" address opens SSL for all interfaces. There may be as the symbolic representation as well as IPv4 "'''127.0.0.1'''" or IPv6 "'''[::1]'''".
** ''port'', ''port2'', ''portN'' — network ports on which SSL is sequential opened (at busy the first ones), indication of the character name of the port, according to ''/etc/services'' is available.
** ''mode'' – mode of operation:
*** '''0'''(default) — ordinal connection;
*** '''2''' — initiative connection. Enables the mode of connecting this input transport to remote host (address instead of local) and switching to the listening state of this host. The "Keep alive timeout" value is used as the timeout of the re-connection of this transport in the absence of activity in order to restore the possibly lost connection.
** ''IDmess'' — identification message of the initiative connection — the mode 2.
* Selecting of the transport protocols.
* State "Connect", in which the transport must be switched at start up.

Using the additional dialog you can set:
* Priority of the transport tasks.
* System input buffer size in kilobytes of the socket. Set to 0 for disabling the user size. Actual size you can see in the status.
* Maximum segment size (MSS) in bytes, for limit the transmitted packages size (segments TCP) on bad link channels. Set to 0 for disabling the user limit for size. Actual size you can see in the status.
* PEM-file of the certificates and private key; or the certificates, private SSL key directly and password of the private SSL key.
:[[File:at.png]] Hidden in the connected state.
:[[File:at.png]] Is traced in 60 seconds for updating, then the transport reconnect for actualisation.
* [!INIT] Maximum number of clients, Maximum number of clients per host and Size of the input buffer.
* [!INIT] Keep alive requests. Closing the connection after the specified requests. Zero value to disable - not close ever.
* Keep alive timeout, seconds. Closing the connection after no requests at the specified timeout. Zero value to disable - not close ever.
:[[File:at.png]] We do not recommend disable the function by the TCP/IP network's properties does not guarantee notice the server about the connection disable, for example after power supply lost on the client. As result the opened client connections will left <span style="color: red">forever</span> and after their number achieve to the limit, server will drop new connections!
* [INIT|ASSOC] Timeouts, tries of the initiative connection and the associated output transports, empty for default and separated by '||'. Format of the timeouts and tries is corresponded to ones of the output transport.
* Protocols' specific custom parameters.
* Reset all the additional parameters to default values and cleanup the protocols' specific custom parameters.

== Output transports ==
Configured and running output transport opens a connection to the specified server. In the case of destroying the connection, output transport is stopped. In order to resume the connection transport must be re-run, that all protocols do automatically.

The transport supports of direct definition of multiple server addresses and processing of all IP addresses in which the symbolic address is resolved, which allows you to build [[Special:MyLanguage/Documents/DAQ#Redundancy|vertical redundancy]] directly by the transport that will be automatically connected to the first available server.

[[file:SSL_out.png|center|frame|Fig.3. The generic configuration dialogues of the output SSL-transport.]]

Using the main dialog you can set:
* State of the transport, that is: status, "Connect", name of the storage, containing the configuration, and supported ciphers.
* Identifier, name and description of the transport.
* Address of the transport in the format "'''{addr}[,{addrN}]:{port}'''", where:
** ''addr'' — address with which the connection is made. There may be as the symbolic representation as well as IPv4 "'''127.0.0.1'''" or IPv6 "'''[::1]'''".
** ''port'' — network port with which the connection is made. Indication of the character name of the port according to ''/etc/services'' is available.

Using the additional dialog you can set:
* PEM-file of the certificates and private key; or the certificates, private SSL key directly and password of the private SSL key.
:[[File:at.png]] Hidden in the connected state.
* Connection timings in the format "'''{conn}:{next}'''", where:
** ''conn'' — maximum time of waiting the connection, in seconds;
** ''next'' — maximum time of waiting for continue the response, in seconds.
: Can be prioritatile specified into the address field as the second global argument, as such "'''localhost:123||5:1'''".
* Attempts of the requesting both for this transport and protocol, for full requests.
: Can be prioritatile specified into the address field as the third global argument, as such "'''localhost:123||5:1||3'''".
* Maximum segment size (MSS) in bytes, for limit the transmitted packages size (segments TCP) on bad link channels. Set to 0 for disabling the user limit for size. Actual size you can see in the status.
* Protocols' specific custom parameters.
* Reset all the additional parameters to default values and cleanup the protocols' specific custom parameters.

== Certificates and keys ==
For the full function of the module, you need certificates and private keys. In the case of input SSL-transport (server), they are mandatory. In the case of the output SSL-transport, they may not be installed, although their using is desirable.

The simplest configuration of the certificate is self-subscription certificate and private key. The following describes how to create them using the tool '''openssl''':
<syntaxhighlight lang="bash">
# Generation the secret key
openssl genrsa -out ./key.pem -des3 -rand /var/log/messages 2048
# Generation of self-subscription certificate
openssl req -x509 -new -key ./key.pem -out ./selfcert.pem -days 365
</syntaxhighlight>

Next, the contents of the files "key.pem" and "selfcert.pem" is copied into the text field of the certificate and key. Password of the private key is installed in the appropriate field. Or you can place the private key and the certificate into single PEM-File and specify its in the corresponded configuration field.

== Specific errors of the OpenSSL library ==
The OpenSSL library is coding errors in own way, which often is not obvious for problems understanding, so there we provide such errors with explanation:
* "BIO_do_accept: error:10000075:BIO routines:unable to bind socket" — this error from an input transport in case of busy the specified port.

Translations:Modules/SSL/15/en

2026-05-25T05:54:43Z

FuzzyBot: Importing a new version from external source

Next, the contents of the files "key.pem" and "selfcert.pem" is copied into the text field of the certificate and key. Password of the private key is installed in the appropriate field. Or you can place the private key and the certificate into single PEM-File and specify its in the corresponded configuration field.

Translations:Modules/SSL/23/en

2026-05-25T05:54:43Z

FuzzyBot: Importing a new version from external source

== Specific errors of the OpenSSL library ==
The OpenSSL library is coding errors in own way, which often is not obvious for problems understanding, so there we provide such errors with explanation:
* "BIO_do_accept: error:10000075:BIO routines:unable to bind socket" — this error from an input transport in case of busy the specified port.

Documents/Release 0.9/Update 9/en

2026-05-12T16:16:15Z

FuzzyBot: Updating to match new version of source page

<noinclude><languages/></noinclude>


This update of the [[Special:MyLanguage/Documents/Release_0.9|0.9 LTS release]] fixes about 70 bugs and appends MANY improvements, which you can read wholly in [http://oscada.org/svn/tags/openscada_0.9/ChangeLog?p=3066 the update ChangeLog].

{{CntHdr|[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]}}
* adaptation of work the hosting server under constant DDoS in ~3 million unique IPs and with short time under power net by economy the batteries, and under OpenSCADA control;
* appending Debian 13 as the distributive base;
* moving back to the OpenSCADA server of building the Debian 9 base;
* moving of building the Debian 12,11,10 base to the Debian 13 environment with enabling back support SHA-1 here;
* switching the building conception to use '''sshfs''' in working remotely with the repositories;
* updating TDE to 14.1.4, 14.1.5 and next to 14.1.6;
* TDE > krusader-trinity > RAR: Loading the builtin TDEIO RAR library.
* TDE > tdebase-trinity > TDEIO > media: Translation the FS options in the "propsdlg" plugin.
* TDE > tde-i18n-trinity > uk: Adding messages translation in patched packages to the Ukrainian part.
* TDE > tdebase-trinity > KControl > Locale: Clearing the language settings to system ones.
* TDE > tdelibs-trinity > TDELocale: Adding of obtaining country from environment.
* TDE > tdelibs-trinity > TDEIO > SwitchLanguageDialog: Clearing all language setting.
* TDE > tdeutils-trinity > ARK: Adding "unrar-free" using.
* TDE > krusader-trinity > RAR: Adding "unrar-free" using.
* TDE > tdegraphics-trinity > kghostview: Represent PDF on Ghostscript 10.05.
* TDE > tdebase-trinity: KDesktop > Lock: Restoring the locking code to one in version 14.1.4 with extending for the lock dialog itself.
* TDE > tdepim-trinity > holiday_ua > HoliDays: Replacing by actual Holi Days and Memorial Days of Ukraine.
* TDE > kaffeine-trinity > xine-part: Adding translation the message "Impossible to obtain image!" to Ukrainian.
* TDE > tdebase-trinity: Preventing-oppressing double icons in the system tray from programs with equal window ID like to '''blueman''' and with an option of disabling that function, with fixing of using ''readBoolEntry()''.
* TDE > tqt3-trinity > Plugins > XIM: Calls ''XCloseIM()'' to prevent memory leaking.
* TDE > tdelibs-trinity > TDEIO > KFileView: Processes file extensions with patterns at saving and doesn't reset the dialog size.
* TDE > kaffeine-trinity > xine-part: Allows to screenshot in any supported image-file format.
* TDE > tdesvn-trinity: Fixing of conflicts resolving in KDiff3, preventing of crashes at conflicts resolving, updating parent of changed item with all expandings.
* TDE > tdebase-trinity > TDEIO > media: Restoring of using '''fuser'''.
* TDE > tdebase-trinity > ksysguard: Removing the processes loading limit in 100%.
* TDE > tdelibs-trinity > TDEIO > CopyJob: Don't rename directories and files overwrite for old, lesser and in different size.
* TDE > tdebase-trinity > TDEIO > SMB: Prevents double ''result()'' signal generation through errors.
* TDE > tdepim-trinity > knote: Adding the find only local per selected note.
* TDE > tdelibs-trinity: Complete disabling of processing for the unclassified devices due to it is very CPU intensive, especially on slow HW.

{{CntHdr|Main WWW-resources, documentation of the project and subprojects, and localisation}}
* appending the [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]] by description the new element-frame "Dynamic frame";
* updating information of the subproject [[Special:MyLanguage/Sub-projects/Automatic_Builder_of_OpenSCADA|Automatic Builder of OpenSCADA]];
* adding Portuguese translation from Diego Eckhard for parts: SYS, DAQ.ModBus, Transport.{Sockets,SSL,Serial}, UI.{QTStarter,QTCfg,VCAEngine,Vision}.

{{CntHdr|New and significantly updated parts}}
* OpenSCADA Core: 3:15:0 => '''3:16:0'''
: ([[#Upd9InitCon|Implementing initiative connections — fixes and expandings of the conceptual changes of the previous updates]], [[#Upd9MessTrFix|Messages Translation — fixes of the conceptual changes of the previous updates]])
* OpenSCADA "DAQ" subsystem: 15 => '''16'''
* OpenSCADA "Archives" subsystem: 14 => '''15'''
* DAQ.Siemens: 4.5 => <b style="color: red">4.8</b>
: ([[#Upd9SimStab|Common stabilization in the ISO_TCP connection]], [[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.System: 3.3 => <b style="color: red">3.5</b>
: ([[#Upd9SystemSMART|Reading the NVMe Log with moving on parsing by RE and reading string fields]])
* DAQ.LogicLev: 2.9 => <b style="color: red">2.11</b>
: ([[#Upd9LogicLevRefl|Improving the parameter reflection mode]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.OPC_UA: 2.8 => <b style="color: red">2.10</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.ModBus: 3.9 => <b style="color: red">3.11</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.DAQGate: 2.14 => '''2.15'''
* Protocol.HTTP: 3.9 => '''3.11'''
* UI.WebCfgD: 2.8 => <b style="color: red">3.0</b>
: ([[#Upd9WebCfgD|Syntax highlight in the textareas]])
* UI.VCAEngine: 7.17 => '''7.19'''
* UI.WebVision: 6.13 => '''6.16'''
* UI.QTStarter: 6.0 => '''6.1'''
* UI.QTCfg: 6.1 => '''6.2'''
* UI.WebCfgD: 3.0 => '''3.1'''
* LibsDB.OscadaLibs:
:* JavaLikeCalc.flb_Json: <b style="color: red">0.3</b>
:* base:
::* UPS: 1.3 => <b style="color: red">2.2</b>
::: ([[#Upd9UPSDirDevs|Implementing devices directly, attributes definition in "Elements definition (defs)"]])
::* DiskSMART: 1.0 => '''1.1'''
::: ([[#Upd9DSMARTInProc|Input processing procedure]])
::* initRemCntr: 1.1 => '''1.2'''
:* DevLib.mbBase: 1.3 => <b style="color: red">1.6</b>
:: ([[#Upd9MbBaseInProcAtrUpd|Input processing procedure, additional types and flexible attributes update]])
:* LowDevLib:
::* IEC62056: 1.1 => <b style="color: red">2.0</b>
::: ([[#Upd9IEC62056Part21|Support 21 part and many improvements]])
::* S1BP: 1.0 => '''1.1'''
* LibsDB.vcaBase.Main: 2.2 => '''2.3'''
:* dynFrame: <b style="color: red">1.2</b>
:* storeHouse: 2.1 => <b style="color: red">2.3</b>
:: ([[#Upd9StoreHouseExt|Significant extending and fixing]])
:* TextLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* ImgLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* cntrPaspExt: 1.2 => '''1.3'''

{{CntHdr|{{Anch|Upd9InitCon|CONCEPTUAL > [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Concentration the different OpenSCADA-hosts on the common server, both for IoT on OpenSCADA and other]] (fixes of the [[Special:MyLanguage/Documents/Release_0.9#Upd8InitCon|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase.wlb_Main.dynFrame: Advancing the frame implementation up to the possibility of items real placing, linking, generic control, saving and restoring.
* LibsDB.OscadaLibs:
** FIX:tmplib_base.initRemCntr: Fixing of saving the table of the remote OpenSCADA hosts after removing old ones.
*** Adding of direct freeing data of requests.
*** The key changed to force two symbols in HEX.
*** Allowed of updating the remote logical source objects for new sources.
*** The protection time of the execution increased to 60 seconds.
*** Checking and removing logical parameters with missing sources.
*** Setting the field "Allow the automatic removal of parameters and attributes" and "Synchronization time with the remote station, seconds" of the [[Special:MyLanguage/Modules/DAQGate|DAQGate module]].
** Security_user,Transport_in.{Sockets,SSL}::RemCntr: Appending detailed description of the objects target and using.
* data/{oscada_plc.xml,oscada_server.xml}: Simplifying the station name for short remote identifiers.

{{CntHdr|{{Anch|Upd9MessTrFix|CONCEPTUAL > Messages Translation (fixes of the [[Special:MyLanguage/Documents/Release_0.9#MessTrFix|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase:
** FIX:wlb_Main.ElViewGraph: The attribute "Dimension (ed)" set to the type "String (translate)" to restore the transitive translation of the DAQ-Source messages at the links in the DYNAMIC-MULTILANGUAGE mode.
* FIX:DAQ.TDAQS,Archive.TArchives: Fixing dynamic translation of names of the redundant objects.
* FIX:SYS,DAQ.{.,JavaLikeCalc}: TFunction::IO: Fixing-finishing of the default value translation in the constructor and for the DAQ-Templates with its implementations.
* SYS:
** The Translation Manager is appended by an information into the last line about achieving an limit time.
** FIX:TMess: Adding of processing prestored I18N messages in the long ''TMess::translGet()'' variant, which is called from ''objFuncCall()'', instead the translation loss here.
* FIX:DB: Preventing the warnings "Some messages completely cleaned for the base ..." for items with no translation fields.
* FIX:DAQ: Fixing dynamic translation the select items from the default field in ''addLinksAttrs()''.
* FIX:UI.VCAEngine: The configuration value fixed in translation on the tab "Links" and processing the field translation for values with the prefix "val:" and switching to its.

{{CntHdr|OpenSCADA libraries and projects}}
* LibsDB.OscadaLibs:
** Adding the new library "Json" of support JSON from Arkadii Kysil.
** FIX:{tmplib_base,tmplib_DevLib}.UPS: Fixing of writing to the writable attributes.
** tmplib_base:
*** digAlarm,anUnif,anUnifSt,codeState: The input processing procedure added by a parameter "args" as a link to arguments of the main procedure.
*** {{Anch|Upd9UPSDirDevs|UPS}}: Expanding by implementing devices directly in this template starting from Must EP2X. Appending of attributes transferring in parameters on the template base with their definition in the new attribute "Elements definition (defs)". Adding the ''alarm()'' function for true control of borders with hysteresis.
*** FIX:manInUnif: Preventing of setting stored value to PLC at start, so overwriting actual one, also at the signal out the scale.
*** FIX:{{Anch|Upd9DSMARTInProc|DiskSMART}}: Adding the input processing procedure for processing specific fields and adding new derivative fields. The "Item definitions" field added a default list of specific interpretation the SMART fields. Improving some original messages.
*** anUnif: The alarm message of signal exceeding hardware border added by this wrong value.
** tmplib_DevLib:
*** mbBase,ergomera625: Improving the syntax highlight rules for types like to "u4".
*** {{Anch|Upd9IEC62056Part21|IEC62056}}: Expanding by support part 21 (direct local data exchange) and improvements:
**** adding input procedure for processing read OBISes;
**** list of OBISes appeded by description and the syntax higflight;
**** adding an option of control bytes LE order of integers;
**** ID of the attribute of representing OBIS appended by "ClassId" and "a";
**** "ClassId" of OBIS expanded up to two bytes;
**** trimming the visible strings up to first zero byte;
**** adding preset devices with known main OBISes;
**** address field expanded for support single digit like to SN;
**** the "tr" and "ctx" attributes moved from IO.
*** {{Anch|Upd9MbBaseInProcAtrUpd|mbBase}}: Expanded by an input procedure for customizing without changing the template. Expanding in support by the types "Int8 (i8)" and "Double (d)", also as by recreation attributes with changed type and removing attributes are missing in the items list. Allowing to specify address of the register in HEX and OCTAL. Adding by applying entries of the register syntax of the module [[Special:MyLanguage/Modules/ModBus|DAQ.ModBus]].
* LibsDB.vcaBase:
** wlb_Main: The library appended by the frame "Dynamic frame (dynFrame)" with documenting.
*** The library appended by an extra icon 'weath13n' for the widget "Weather (weather)".
*** FIX:{{Anch|Upd9LabExtSt|TextLab,ImgLab}}: Expanding for processing conflict states "false && false" and "true && true" taking the parameters from item [2] and [3].
**** Adding alarms generation from the "Error (err)" attribute.
**** FIX: Renaming the states name "Enable" to "Enabled" and "Disable" to "Disabled".
**** FIX: Unifying the alarms blinking with just changing work color to alarm one in the second cycle.
*** alarmsAct,alarmsSt: Adaptation to human-readable names in messages.
*** FIX:{{Anch|Upd9StoreHouseExt|storeHouse}}: Moving the Control Panel formation and updating to the table updating code.
**** FIX: Separating data preparing part from formation the visual data for early preparing the lists and with limiting time of processed items.
**** Appending to processing the event ws_TableEdit of checking validity row and column.
**** The retry cycles and updating rewrote for specifying time in "toCalcCycles" in seconds and updating after its elapsing.
**** FIX: Preventing of show second filter field in the item form after change the user.
**** FIX: Fixing the images overview at selecting in the file combobox.
**** Specifying the transaction mode in all ''SQLReq()'' calls.
**** The control panel appended by the selection fields.
**** Rewrote in preparing the column list for filters with using redefined names of the standard fields "NAME", "DSCR", and with true sorting.
**** In file sizes used new function ''SYS.cpct2str()''.
*** FIX:ImgLab: Taking the background color even empty from images list at its presence.
**** FIX: Setting width of the border to 2 when it is zero at the selection blinking, that is for active elements.
**** Format of the attribute "Images (imgs)" moved to the help, that is to the second line.
*** FIX:objProps: Appending of tracing the user changing, appending for support real properties.
*** ElCadr: Adding the attribute "Parameter: Force disable PID (prmNotPID)" for disabling PID show at presence SP.
*** cntrPaspExt: Hide attributes in EVAL. Generating for user action messages at changing the editable properties.
*** TextLab: Adapted to use the default background at its missing in "st_text".
** wlb_doc:
*** FIX:docRepYear: Fixing of processing the last value in year for data from archives.
*** docUsersSet: Expanding by a possibility to specify-configure of used archivers.
* Model.AGLKS.Model.DAQ_BlockCalc.gen_cnt: Appending the description by the field "MessName: {Name}".

{{CntHdr|API}}
''!!!!:Changes'':
* SYS.ResString: ''getVal()'' set to constant.
* Archives,DAQ.*: Enumeration items of the source modes added by the "SRC_" prefix and "ActiveAttr" renamed to "DAQAttrAct"; items of the combination modes added by the "CMB_" prefix and an item "FromArchiver"; items of the data mode added by the "DM_" prefix instead "DM".
* DAQ.TFunction: Switching the method "mStor" to ResString.
''Appends'':
* SYS.CntrNode,Protocol.HTTP: Adding the service requests "select:/db/list" by an option "nostor" for the empty item.
* SYS,UI.VCAEngine: Appending the definition "starts_with" as link to the STL::String function "compare(0,strlen(str),str) == 0" to replace ''compare()'' and ''find()'' in this role.
* Archives,DAQ.DAQGate: The TMArchivator object appended by a reimplementation TMess::SRec with a container of storing double messages in one second.
* SYS: The file's User API functions appended by ''fileRotate()'' for files rotation mostly the logging type.
** TCntrNode: new function ''nodeMessSnthHgl()''.
** XMLNode: The function ''load()'' appended of parsing pure HTML with an option LD_HTML. The function ''save()'' appended by an option HoldEmptyAttr of holding empty attributes.
** XMLNodeObj: Added by the User API and API function ''childDel( AutoHD<XMLNodeObj> nd )''. The User API function ''setAttr()'' added by a synonym ''attrSet()''.
* DAQ:
** TController,TParamContr: Adding a function ''justCreated()'' of detection the just creation.
** TParamContr: Added by a virtual function ''loadVal()'' of reloading all or one stored values.
** TPrmTempl.Impl.''archAttrs()'': Appended by a timestamp argument for using common timestamp in archiving.
** {{Anch|Upd9DirValAccess|ModBus,OPC_UA,Siemens}}: The Controller Object added by a User API function ''value()'' of direct value getting and setting at the source-specific address and through the address registering for getting-setting in the generic pooling cycle of the source.
* Archives: The TVArchivator object is added by the functions ''combMode()'' and ''setCombMode()''.
* JavaLikeCalc: The User API functions to string appended by ''sep2path()''.

{{CntHdr|SYS}}
* Building:
** configure.ac: Core library version risen to 3:16:0 and the program version risen to 0.9.9. The module version of the subsystem "DAQ" risen to 16 and the subsystem "Archives" risen to 15.
** Appended for building to Debian 13 and Ubuntu 26.04 LTS.
** .,DAQ.Siemens: Generic adaptation for building on Debian 13, adaptation for support PCRE2 since missing old PCRE libraries on Debian 13 with moving the variable "vSz" to a definition TRegExp_vSz for old libraries.
** DB.MySQL: Adaption to build with headers without definition the "my_bool" type on Ubuntu 26.04 LTS.
* XMLNode: The function ''load()'' appended of parsing pure HTML with: tags without closing, attributes without a value, attribute values without quoting, closing tags switching.

{{CntHdr|DAQ}}
* Templates: Enabling the selectable fields in the "Template configuration" tab for constants.
* FIX:{ModBus,OPC_UA,Siemens}.LogicLev: Preventing of wrong writing to PLC at RO links, when the value changed in the procedure.
* LogicLev,ModBus,OPC_UA,Siemens: The User API functions ''attrAdd()'' and ''attrDel()'' of managing user attributes moved from LogicLev, ModBus, OPC_UA, Siemens to the core parameter object and for all dynamic parameters at ''dynElCntr()''. Adding of {{Anch|Upd9StoreDynVal|storing values}} of the user's dynamic attributes.
* FIX:{{Anch|Upd9SimStab|Siemens}}: Moving the SELF_ISO_TCP mode to the generic ''outAt()'' function. Debugging the connection errors for the modes SELF_ISO_TCP and ISO_TCP on the actual S7-1500 connection.
* System: Adding the data acquisition of the slow sources per some cycle by the new configuration field "In cycle call for slow sources".
** {{Anch|Upd9SystemSMART|DA_SMART}}: Adding for support reading the NVMe Log with moving on parsing by RE and reading string fields, like to temperature.
** DA_PROC: Appended by obtaining the field "User loading (%)" and "System loading (%)" from the file "/proc/{PID}/stat" also with the value concatenation for group selection.
* FIX:JavaLikeCalc: Fixing permission to the Function node after moving under ACL.
* FIX:{{Anch|Upd9LogicLevRefl|LogicLev}}: Improving the parameter reflection mode by a possibility to connect later the missing at the start sources, also as unlinking-unlocking disabled sources.
* FIX:DAQGate: Fixing ''messSet()'' by taking parameter whole ID from the first line of the argument "prm" and with its normalization by the prefix "prm_" removing. Set for writing to remote stations without checking the value at equality, due to the previous value can be not actual at situative reading.
* ModBus: Unified in registering values at the ModBus-specific address in other variant of the function ''regVal()''.

{{CntHdr|Archives-History}}
* FIX:Value: Prevented of crashing at zero period in ''TVArchEl::getVals()''.
** Added by a configuration field "Data combining mode (CombMode)", as in the archive object, for specifying the data combination in the archiver, and the field in archive added by an item "From Archiver" by default.
** The "Active DAQ Attribute (DEPRECATED)" item of the archive source renamed to "DAQ Attribute actively" and unmarked deprecated due to it is the single way of creation multiple archives to single source.

{{CntHdr|Transports}}
* FIX: The generic Control Interface requesting function ''cntrIfCmd()'' is prevented from any local-direct-custom authentication at reforwarding to intermediate OpenSCADA nodes, that is especially actual for remote connections of UI.Vision for different users.
* The traffic logging in the file appended by rotation the files.

{{CntHdr|User Interface}}
* FIX:Vision,WebVision: Fixing of compensation debries of the real numbers in position and size for true aligning the internal content of widgets with different size, when the scale greater of 1. Preventing of crashing in the ''VCADiagram::TrendObj::loadTrendsData()'' function at zero in "wantPer".
* QTCfg,Vision: The tab distance of the TextArea set dynamic and calculated from the font metric for standard eight symbols "00000000".
* {{Anch|Upd9WebCfgD|WebCfgD}}: Implemented for syntax highlight in the textareas.
* FIX:WebVision: Restoring a function of user changing after previous preventing the connection messages flooding with connection to the same session from other host or other agent. Adding the user of last request for preventing from new sessions opening after changing the user from original.
* FIX:VCAEngine: Moving setting the flag Attr::VizerSpec for attributes with the prefix "vs_" to the attributes inheritance and only for session widgets. Unification the Attribute's self flags by separation to storing and operative ones.
* FIX:QTStarter.lib_qtgen: The syntax highlight algorithm in ''SnthHgl::rule()'' cleaned from spare containers and unified.
* FIX:Vision: Preventing of crashing in the ShapeFormEl event handler at not finished initialisation, that is the "addrWdg" variable is missing. Preventing of the user changing for reforwarding connections.

Documents/Release 0.9/Update 9/ru

2026-05-12T16:16:14Z

FuzzyBot: Updating to match new version of source page

<noinclude><languages/></noinclude>


This update of the [[Special:MyLanguage/Documents/Release_0.9|0.9 LTS release]] fixes about 70 bugs and appends MANY improvements, which you can read wholly in [http://oscada.org/svn/tags/openscada_0.9/ChangeLog?p=3066 the update ChangeLog].

{{CntHdr|[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]}}
* adaptation of work the hosting server under constant DDoS in ~3 million unique IPs and with short time under power net by economy the batteries, and under OpenSCADA control;
* appending Debian 13 as the distributive base;
* moving back to the OpenSCADA server of building the Debian 9 base;
* moving of building the Debian 12,11,10 base to the Debian 13 environment with enabling back support SHA-1 here;
* switching the building conception to use '''sshfs''' in working remotely with the repositories;
* updating TDE to 14.1.4, 14.1.5 and next to 14.1.6;
* TDE > krusader-trinity > RAR: Loading the builtin TDEIO RAR library.
* TDE > tdebase-trinity > TDEIO > media: Translation the FS options in the "propsdlg" plugin.
* TDE > tde-i18n-trinity > uk: Adding messages translation in patched packages to the Ukrainian part.
* TDE > tdebase-trinity > KControl > Locale: Clearing the language settings to system ones.
* TDE > tdelibs-trinity > TDELocale: Adding of obtaining country from environment.
* TDE > tdelibs-trinity > TDEIO > SwitchLanguageDialog: Clearing all language setting.
* TDE > tdeutils-trinity > ARK: Adding "unrar-free" using.
* TDE > krusader-trinity > RAR: Adding "unrar-free" using.
* TDE > tdegraphics-trinity > kghostview: Represent PDF on Ghostscript 10.05.
* TDE > tdebase-trinity: KDesktop > Lock: Restoring the locking code to one in version 14.1.4 with extending for the lock dialog itself.
* TDE > tdepim-trinity > holiday_ua > HoliDays: Replacing by actual Holi Days and Memorial Days of Ukraine.
* TDE > kaffeine-trinity > xine-part: Adding translation the message "Impossible to obtain image!" to Ukrainian.
* TDE > tdebase-trinity: Preventing-oppressing double icons in the system tray from programs with equal window ID like to '''blueman''' and with an option of disabling that function, with fixing of using ''readBoolEntry()''.
* TDE > tqt3-trinity > Plugins > XIM: Calls ''XCloseIM()'' to prevent memory leaking.
* TDE > tdelibs-trinity > TDEIO > KFileView: Processes file extensions with patterns at saving and doesn't reset the dialog size.
* TDE > kaffeine-trinity > xine-part: Allows to screenshot in any supported image-file format.
* TDE > tdesvn-trinity: Fixing of conflicts resolving in KDiff3, preventing of crashes at conflicts resolving, updating parent of changed item with all expandings.
* TDE > tdebase-trinity > TDEIO > media: Restoring of using '''fuser'''.
* TDE > tdebase-trinity > ksysguard: Removing the processes loading limit in 100%.
* TDE > tdelibs-trinity > TDEIO > CopyJob: Don't rename directories and files overwrite for old, lesser and in different size.
* TDE > tdebase-trinity > TDEIO > SMB: Prevents double ''result()'' signal generation through errors.
* TDE > tdepim-trinity > knote: Adding the find only local per selected note.
* TDE > tdelibs-trinity: Complete disabling of processing for the unclassified devices due to it is very CPU intensive, especially on slow HW.

{{CntHdr|Main WWW-resources, documentation of the project and subprojects, and localisation}}
* appending the [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]] by description the new element-frame "Dynamic frame";
* updating information of the subproject [[Special:MyLanguage/Sub-projects/Automatic_Builder_of_OpenSCADA|Automatic Builder of OpenSCADA]];
* adding Portuguese translation from Diego Eckhard for parts: SYS, DAQ.ModBus, Transport.{Sockets,SSL,Serial}, UI.{QTStarter,QTCfg,VCAEngine,Vision}.

{{CntHdr|New and significantly updated parts}}
* OpenSCADA Core: 3:15:0 => '''3:16:0'''
: ([[#Upd9InitCon|Implementing initiative connections — fixes and expandings of the conceptual changes of the previous updates]], [[#Upd9MessTrFix|Messages Translation — fixes of the conceptual changes of the previous updates]])
* OpenSCADA "DAQ" subsystem: 15 => '''16'''
* OpenSCADA "Archives" subsystem: 14 => '''15'''
* DAQ.Siemens: 4.5 => <b style="color: red">4.8</b>
: ([[#Upd9SimStab|Common stabilization in the ISO_TCP connection]], [[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.System: 3.3 => <b style="color: red">3.5</b>
: ([[#Upd9SystemSMART|Reading the NVMe Log with moving on parsing by RE and reading string fields]])
* DAQ.LogicLev: 2.9 => <b style="color: red">2.11</b>
: ([[#Upd9LogicLevRefl|Improving the parameter reflection mode]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.OPC_UA: 2.8 => <b style="color: red">2.10</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.ModBus: 3.9 => <b style="color: red">3.11</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.DAQGate: 2.14 => '''2.15'''
* Protocol.HTTP: 3.9 => '''3.11'''
* UI.WebCfgD: 2.8 => <b style="color: red">3.0</b>
: ([[#Upd9WebCfgD|Syntax highlight in the textareas]])
* UI.VCAEngine: 7.17 => '''7.19'''
* UI.WebVision: 6.13 => '''6.16'''
* UI.QTStarter: 6.0 => '''6.1'''
* UI.QTCfg: 6.1 => '''6.2'''
* UI.WebCfgD: 3.0 => '''3.1'''
* LibsDB.OscadaLibs:
:* JavaLikeCalc.flb_Json: <b style="color: red">0.3</b>
:* base:
::* UPS: 1.3 => <b style="color: red">2.2</b>
::: ([[#Upd9UPSDirDevs|Implementing devices directly, attributes definition in "Elements definition (defs)"]])
::* DiskSMART: 1.0 => '''1.1'''
::: ([[#Upd9DSMARTInProc|Input processing procedure]])
::* initRemCntr: 1.1 => '''1.2'''
:* DevLib.mbBase: 1.3 => <b style="color: red">1.6</b>
:: ([[#Upd9MbBaseInProcAtrUpd|Input processing procedure, additional types and flexible attributes update]])
:* LowDevLib:
::* IEC62056: 1.1 => <b style="color: red">2.0</b>
::: ([[#Upd9IEC62056Part21|Support 21 part and many improvements]])
::* S1BP: 1.0 => '''1.1'''
* LibsDB.vcaBase.Main: 2.2 => '''2.3'''
:* dynFrame: <b style="color: red">1.2</b>
:* storeHouse: 2.1 => <b style="color: red">2.3</b>
:: ([[#Upd9StoreHouseExt|Significant extending and fixing]])
:* TextLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* ImgLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* cntrPaspExt: 1.2 => '''1.3'''

{{CntHdr|{{Anch|Upd9InitCon|CONCEPTUAL > [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Concentration the different OpenSCADA-hosts on the common server, both for IoT on OpenSCADA and other]] (fixes of the [[Special:MyLanguage/Documents/Release_0.9#Upd8InitCon|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase.wlb_Main.dynFrame: Advancing the frame implementation up to the possibility of items real placing, linking, generic control, saving and restoring.
* LibsDB.OscadaLibs:
** FIX:tmplib_base.initRemCntr: Fixing of saving the table of the remote OpenSCADA hosts after removing old ones.
*** Adding of direct freeing data of requests.
*** The key changed to force two symbols in HEX.
*** Allowed of updating the remote logical source objects for new sources.
*** The protection time of the execution increased to 60 seconds.
*** Checking and removing logical parameters with missing sources.
*** Setting the field "Allow the automatic removal of parameters and attributes" and "Synchronization time with the remote station, seconds" of the [[Special:MyLanguage/Modules/DAQGate|DAQGate module]].
** Security_user,Transport_in.{Sockets,SSL}::RemCntr: Appending detailed description of the objects target and using.
* data/{oscada_plc.xml,oscada_server.xml}: Simplifying the station name for short remote identifiers.

{{CntHdr|{{Anch|Upd9MessTrFix|CONCEPTUAL > Messages Translation (fixes of the [[Special:MyLanguage/Documents/Release_0.9#MessTrFix|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase:
** FIX:wlb_Main.ElViewGraph: The attribute "Dimension (ed)" set to the type "String (translate)" to restore the transitive translation of the DAQ-Source messages at the links in the DYNAMIC-MULTILANGUAGE mode.
* FIX:DAQ.TDAQS,Archive.TArchives: Fixing dynamic translation of names of the redundant objects.
* FIX:SYS,DAQ.{.,JavaLikeCalc}: TFunction::IO: Fixing-finishing of the default value translation in the constructor and for the DAQ-Templates with its implementations.
* SYS:
** The Translation Manager is appended by an information into the last line about achieving an limit time.
** FIX:TMess: Adding of processing prestored I18N messages in the long ''TMess::translGet()'' variant, which is called from ''objFuncCall()'', instead the translation loss here.
* FIX:DB: Preventing the warnings "Some messages completely cleaned for the base ..." for items with no translation fields.
* FIX:DAQ: Fixing dynamic translation the select items from the default field in ''addLinksAttrs()''.
* FIX:UI.VCAEngine: The configuration value fixed in translation on the tab "Links" and processing the field translation for values with the prefix "val:" and switching to its.

{{CntHdr|OpenSCADA libraries and projects}}
* LibsDB.OscadaLibs:
** Adding the new library "Json" of support JSON from Arkadii Kysil.
** FIX:{tmplib_base,tmplib_DevLib}.UPS: Fixing of writing to the writable attributes.
** tmplib_base:
*** digAlarm,anUnif,anUnifSt,codeState: The input processing procedure added by a parameter "args" as a link to arguments of the main procedure.
*** {{Anch|Upd9UPSDirDevs|UPS}}: Expanding by implementing devices directly in this template starting from Must EP2X. Appending of attributes transferring in parameters on the template base with their definition in the new attribute "Elements definition (defs)". Adding the ''alarm()'' function for true control of borders with hysteresis.
*** FIX:manInUnif: Preventing of setting stored value to PLC at start, so overwriting actual one, also at the signal out the scale.
*** FIX:{{Anch|Upd9DSMARTInProc|DiskSMART}}: Adding the input processing procedure for processing specific fields and adding new derivative fields. The "Item definitions" field added a default list of specific interpretation the SMART fields. Improving some original messages.
*** anUnif: The alarm message of signal exceeding hardware border added by this wrong value.
** tmplib_DevLib:
*** mbBase,ergomera625: Improving the syntax highlight rules for types like to "u4".
*** {{Anch|Upd9IEC62056Part21|IEC62056}}: Expanding by support part 21 (direct local data exchange) and improvements:
**** adding input procedure for processing read OBISes;
**** list of OBISes appeded by description and the syntax higflight;
**** adding an option of control bytes LE order of integers;
**** ID of the attribute of representing OBIS appended by "ClassId" and "a";
**** "ClassId" of OBIS expanded up to two bytes;
**** trimming the visible strings up to first zero byte;
**** adding preset devices with known main OBISes;
**** address field expanded for support single digit like to SN;
**** the "tr" and "ctx" attributes moved from IO.
*** {{Anch|Upd9MbBaseInProcAtrUpd|mbBase}}: Expanded by an input procedure for customizing without changing the template. Expanding in support by the types "Int8 (i8)" and "Double (d)", also as by recreation attributes with changed type and removing attributes are missing in the items list. Allowing to specify address of the register in HEX and OCTAL. Adding by applying entries of the register syntax of the module [[Special:MyLanguage/Modules/ModBus|DAQ.ModBus]].
* LibsDB.vcaBase:
** wlb_Main: The library appended by the frame "Dynamic frame (dynFrame)" with documenting.
*** The library appended by an extra icon 'weath13n' for the widget "Weather (weather)".
*** FIX:{{Anch|Upd9LabExtSt|TextLab,ImgLab}}: Expanding for processing conflict states "false && false" and "true && true" taking the parameters from item [2] and [3].
**** Adding alarms generation from the "Error (err)" attribute.
**** FIX: Renaming the states name "Enable" to "Enabled" and "Disable" to "Disabled".
**** FIX: Unifying the alarms blinking with just changing work color to alarm one in the second cycle.
*** alarmsAct,alarmsSt: Adaptation to human-readable names in messages.
*** FIX:{{Anch|Upd9StoreHouseExt|storeHouse}}: Moving the Control Panel formation and updating to the table updating code.
**** FIX: Separating data preparing part from formation the visual data for early preparing the lists and with limiting time of processed items.
**** Appending to processing the event ws_TableEdit of checking validity row and column.
**** The retry cycles and updating rewrote for specifying time in "toCalcCycles" in seconds and updating after its elapsing.
**** FIX: Preventing of show second filter field in the item form after change the user.
**** FIX: Fixing the images overview at selecting in the file combobox.
**** Specifying the transaction mode in all ''SQLReq()'' calls.
**** The control panel appended by the selection fields.
**** Rewrote in preparing the column list for filters with using redefined names of the standard fields "NAME", "DSCR", and with true sorting.
**** In file sizes used new function ''SYS.cpct2str()''.
*** FIX:ImgLab: Taking the background color even empty from images list at its presence.
**** FIX: Setting width of the border to 2 when it is zero at the selection blinking, that is for active elements.
**** Format of the attribute "Images (imgs)" moved to the help, that is to the second line.
*** FIX:objProps: Appending of tracing the user changing, appending for support real properties.
*** ElCadr: Adding the attribute "Parameter: Force disable PID (prmNotPID)" for disabling PID show at presence SP.
*** cntrPaspExt: Hide attributes in EVAL. Generating for user action messages at changing the editable properties.
*** TextLab: Adapted to use the default background at its missing in "st_text".
** wlb_doc:
*** FIX:docRepYear: Fixing of processing the last value in year for data from archives.
*** docUsersSet: Expanding by a possibility to specify-configure of used archivers.
* Model.AGLKS.Model.DAQ_BlockCalc.gen_cnt: Appending the description by the field "MessName: {Name}".

{{CntHdr|API}}
''!!!!:Changes'':
* SYS.ResString: ''getVal()'' set to constant.
* Archives,DAQ.*: Enumeration items of the source modes added by the "SRC_" prefix and "ActiveAttr" renamed to "DAQAttrAct"; items of the combination modes added by the "CMB_" prefix and an item "FromArchiver"; items of the data mode added by the "DM_" prefix instead "DM".
* DAQ.TFunction: Switching the method "mStor" to ResString.
''Appends'':
* SYS.CntrNode,Protocol.HTTP: Adding the service requests "select:/db/list" by an option "nostor" for the empty item.
* SYS,UI.VCAEngine: Appending the definition "starts_with" as link to the STL::String function "compare(0,strlen(str),str) == 0" to replace ''compare()'' and ''find()'' in this role.
* Archives,DAQ.DAQGate: The TMArchivator object appended by a reimplementation TMess::SRec with a container of storing double messages in one second.
* SYS: The file's User API functions appended by ''fileRotate()'' for files rotation mostly the logging type.
** TCntrNode: new function ''nodeMessSnthHgl()''.
** XMLNode: The function ''load()'' appended of parsing pure HTML with an option LD_HTML. The function ''save()'' appended by an option HoldEmptyAttr of holding empty attributes.
** XMLNodeObj: Added by the User API and API function ''childDel( AutoHD<XMLNodeObj> nd )''. The User API function ''setAttr()'' added by a synonym ''attrSet()''.
* DAQ:
** TController,TParamContr: Adding a function ''justCreated()'' of detection the just creation.
** TParamContr: Added by a virtual function ''loadVal()'' of reloading all or one stored values.
** TPrmTempl.Impl.''archAttrs()'': Appended by a timestamp argument for using common timestamp in archiving.
** {{Anch|Upd9DirValAccess|ModBus,OPC_UA,Siemens}}: The Controller Object added by a User API function ''value()'' of direct value getting and setting at the source-specific address and through the address registering for getting-setting in the generic pooling cycle of the source.
* Archives: The TVArchivator object is added by the functions ''combMode()'' and ''setCombMode()''.
* JavaLikeCalc: The User API functions to string appended by ''sep2path()''.

{{CntHdr|SYS}}
* Building:
** configure.ac: Core library version risen to 3:16:0 and the program version risen to 0.9.9. The module version of the subsystem "DAQ" risen to 16 and the subsystem "Archives" risen to 15.
** Appended for building to Debian 13 and Ubuntu 26.04 LTS.
** .,DAQ.Siemens: Generic adaptation for building on Debian 13, adaptation for support PCRE2 since missing old PCRE libraries on Debian 13 with moving the variable "vSz" to a definition TRegExp_vSz for old libraries.
** DB.MySQL: Adaption to build with headers without definition the "my_bool" type on Ubuntu 26.04 LTS.
* XMLNode: The function ''load()'' appended of parsing pure HTML with: tags without closing, attributes without a value, attribute values without quoting, closing tags switching.

{{CntHdr|DAQ}}
* Templates: Enabling the selectable fields in the "Template configuration" tab for constants.
* FIX:{ModBus,OPC_UA,Siemens}.LogicLev: Preventing of wrong writing to PLC at RO links, when the value changed in the procedure.
* LogicLev,ModBus,OPC_UA,Siemens: The User API functions ''attrAdd()'' and ''attrDel()'' of managing user attributes moved from LogicLev, ModBus, OPC_UA, Siemens to the core parameter object and for all dynamic parameters at ''dynElCntr()''. Adding of {{Anch|Upd9StoreDynVal|storing values}} of the user's dynamic attributes.
* FIX:{{Anch|Upd9SimStab|Siemens}}: Moving the SELF_ISO_TCP mode to the generic ''outAt()'' function. Debugging the connection errors for the modes SELF_ISO_TCP and ISO_TCP on the actual S7-1500 connection.
* System: Adding the data acquisition of the slow sources per some cycle by the new configuration field "In cycle call for slow sources".
** {{Anch|Upd9SystemSMART|DA_SMART}}: Adding for support reading the NVMe Log with moving on parsing by RE and reading string fields, like to temperature.
** DA_PROC: Appended by obtaining the field "User loading (%)" and "System loading (%)" from the file "/proc/{PID}/stat" also with the value concatenation for group selection.
* FIX:JavaLikeCalc: Fixing permission to the Function node after moving under ACL.
* FIX:{{Anch|Upd9LogicLevRefl|LogicLev}}: Improving the parameter reflection mode by a possibility to connect later the missing at the start sources, also as unlinking-unlocking disabled sources.
* FIX:DAQGate: Fixing ''messSet()'' by taking parameter whole ID from the first line of the argument "prm" and with its normalization by the prefix "prm_" removing. Set for writing to remote stations without checking the value at equality, due to the previous value can be not actual at situative reading.
* ModBus: Unified in registering values at the ModBus-specific address in other variant of the function ''regVal()''.

{{CntHdr|Archives-History}}
* FIX:Value: Prevented of crashing at zero period in ''TVArchEl::getVals()''.
** Added by a configuration field "Data combining mode (CombMode)", as in the archive object, for specifying the data combination in the archiver, and the field in archive added by an item "From Archiver" by default.
** The "Active DAQ Attribute (DEPRECATED)" item of the archive source renamed to "DAQ Attribute actively" and unmarked deprecated due to it is the single way of creation multiple archives to single source.

{{CntHdr|Transports}}
* FIX: The generic Control Interface requesting function ''cntrIfCmd()'' is prevented from any local-direct-custom authentication at reforwarding to intermediate OpenSCADA nodes, that is especially actual for remote connections of UI.Vision for different users.
* The traffic logging in the file appended by rotation the files.

{{CntHdr|User Interface}}
* FIX:Vision,WebVision: Fixing of compensation debries of the real numbers in position and size for true aligning the internal content of widgets with different size, when the scale greater of 1. Preventing of crashing in the ''VCADiagram::TrendObj::loadTrendsData()'' function at zero in "wantPer".
* QTCfg,Vision: The tab distance of the TextArea set dynamic and calculated from the font metric for standard eight symbols "00000000".
* {{Anch|Upd9WebCfgD|WebCfgD}}: Implemented for syntax highlight in the textareas.
* FIX:WebVision: Restoring a function of user changing after previous preventing the connection messages flooding with connection to the same session from other host or other agent. Adding the user of last request for preventing from new sessions opening after changing the user from original.
* FIX:VCAEngine: Moving setting the flag Attr::VizerSpec for attributes with the prefix "vs_" to the attributes inheritance and only for session widgets. Unification the Attribute's self flags by separation to storing and operative ones.
* FIX:QTStarter.lib_qtgen: The syntax highlight algorithm in ''SnthHgl::rule()'' cleaned from spare containers and unified.
* FIX:Vision: Preventing of crashing in the ShapeFormEl event handler at not finished initialisation, that is the "addrWdg" variable is missing. Preventing of the user changing for reforwarding connections.

Documents/Release 0.9/Update 9/uk

2026-05-12T16:16:13Z

FuzzyBot: Updating to match new version of source page

<noinclude><languages/></noinclude>


This update of the [[Special:MyLanguage/Documents/Release_0.9|0.9 LTS release]] fixes about 70 bugs and appends MANY improvements, which you can read wholly in [http://oscada.org/svn/tags/openscada_0.9/ChangeLog?p=3066 the update ChangeLog].

{{CntHdr|[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]}}
* adaptation of work the hosting server under constant DDoS in ~3 million unique IPs and with short time under power net by economy the batteries, and under OpenSCADA control;
* appending Debian 13 as the distributive base;
* moving back to the OpenSCADA server of building the Debian 9 base;
* moving of building the Debian 12,11,10 base to the Debian 13 environment with enabling back support SHA-1 here;
* switching the building conception to use '''sshfs''' in working remotely with the repositories;
* updating TDE to 14.1.4, 14.1.5 and next to 14.1.6;
* TDE > krusader-trinity > RAR: Loading the builtin TDEIO RAR library.
* TDE > tdebase-trinity > TDEIO > media: Translation the FS options in the "propsdlg" plugin.
* TDE > tde-i18n-trinity > uk: Adding messages translation in patched packages to the Ukrainian part.
* TDE > tdebase-trinity > KControl > Locale: Clearing the language settings to system ones.
* TDE > tdelibs-trinity > TDELocale: Adding of obtaining country from environment.
* TDE > tdelibs-trinity > TDEIO > SwitchLanguageDialog: Clearing all language setting.
* TDE > tdeutils-trinity > ARK: Adding "unrar-free" using.
* TDE > krusader-trinity > RAR: Adding "unrar-free" using.
* TDE > tdegraphics-trinity > kghostview: Represent PDF on Ghostscript 10.05.
* TDE > tdebase-trinity: KDesktop > Lock: Restoring the locking code to one in version 14.1.4 with extending for the lock dialog itself.
* TDE > tdepim-trinity > holiday_ua > HoliDays: Replacing by actual Holi Days and Memorial Days of Ukraine.
* TDE > kaffeine-trinity > xine-part: Adding translation the message "Impossible to obtain image!" to Ukrainian.
* TDE > tdebase-trinity: Preventing-oppressing double icons in the system tray from programs with equal window ID like to '''blueman''' and with an option of disabling that function, with fixing of using ''readBoolEntry()''.
* TDE > tqt3-trinity > Plugins > XIM: Calls ''XCloseIM()'' to prevent memory leaking.
* TDE > tdelibs-trinity > TDEIO > KFileView: Processes file extensions with patterns at saving and doesn't reset the dialog size.
* TDE > kaffeine-trinity > xine-part: Allows to screenshot in any supported image-file format.
* TDE > tdesvn-trinity: Fixing of conflicts resolving in KDiff3, preventing of crashes at conflicts resolving, updating parent of changed item with all expandings.
* TDE > tdebase-trinity > TDEIO > media: Restoring of using '''fuser'''.
* TDE > tdebase-trinity > ksysguard: Removing the processes loading limit in 100%.
* TDE > tdelibs-trinity > TDEIO > CopyJob: Don't rename directories and files overwrite for old, lesser and in different size.
* TDE > tdebase-trinity > TDEIO > SMB: Prevents double ''result()'' signal generation through errors.
* TDE > tdepim-trinity > knote: Adding the find only local per selected note.
* TDE > tdelibs-trinity: Complete disabling of processing for the unclassified devices due to it is very CPU intensive, especially on slow HW.

{{CntHdr|Main WWW-resources, documentation of the project and subprojects, and localisation}}
* appending the [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]] by description the new element-frame "Dynamic frame";
* updating information of the subproject [[Special:MyLanguage/Sub-projects/Automatic_Builder_of_OpenSCADA|Automatic Builder of OpenSCADA]];
* adding Portuguese translation from Diego Eckhard for parts: SYS, DAQ.ModBus, Transport.{Sockets,SSL,Serial}, UI.{QTStarter,QTCfg,VCAEngine,Vision}.

{{CntHdr|New and significantly updated parts}}
* OpenSCADA Core: 3:15:0 => '''3:16:0'''
: ([[#Upd9InitCon|Implementing initiative connections — fixes and expandings of the conceptual changes of the previous updates]], [[#Upd9MessTrFix|Messages Translation — fixes of the conceptual changes of the previous updates]])
* OpenSCADA "DAQ" subsystem: 15 => '''16'''
* OpenSCADA "Archives" subsystem: 14 => '''15'''
* DAQ.Siemens: 4.5 => <b style="color: red">4.8</b>
: ([[#Upd9SimStab|Common stabilization in the ISO_TCP connection]], [[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.System: 3.3 => <b style="color: red">3.5</b>
: ([[#Upd9SystemSMART|Reading the NVMe Log with moving on parsing by RE and reading string fields]])
* DAQ.LogicLev: 2.9 => <b style="color: red">2.11</b>
: ([[#Upd9LogicLevRefl|Improving the parameter reflection mode]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.OPC_UA: 2.8 => <b style="color: red">2.10</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.ModBus: 3.9 => <b style="color: red">3.11</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.DAQGate: 2.14 => '''2.15'''
* Protocol.HTTP: 3.9 => '''3.11'''
* UI.WebCfgD: 2.8 => <b style="color: red">3.0</b>
: ([[#Upd9WebCfgD|Syntax highlight in the textareas]])
* UI.VCAEngine: 7.17 => '''7.19'''
* UI.WebVision: 6.13 => '''6.16'''
* UI.QTStarter: 6.0 => '''6.1'''
* UI.QTCfg: 6.1 => '''6.2'''
* UI.WebCfgD: 3.0 => '''3.1'''
* LibsDB.OscadaLibs:
:* JavaLikeCalc.flb_Json: <b style="color: red">0.3</b>
:* base:
::* UPS: 1.3 => <b style="color: red">2.2</b>
::: ([[#Upd9UPSDirDevs|Implementing devices directly, attributes definition in "Elements definition (defs)"]])
::* DiskSMART: 1.0 => '''1.1'''
::: ([[#Upd9DSMARTInProc|Input processing procedure]])
::* initRemCntr: 1.1 => '''1.2'''
:* DevLib.mbBase: 1.3 => <b style="color: red">1.6</b>
:: ([[#Upd9MbBaseInProcAtrUpd|Input processing procedure, additional types and flexible attributes update]])
:* LowDevLib:
::* IEC62056: 1.1 => <b style="color: red">2.0</b>
::: ([[#Upd9IEC62056Part21|Support 21 part and many improvements]])
::* S1BP: 1.0 => '''1.1'''
* LibsDB.vcaBase.Main: 2.2 => '''2.3'''
:* dynFrame: <b style="color: red">1.2</b>
:* storeHouse: 2.1 => <b style="color: red">2.3</b>
:: ([[#Upd9StoreHouseExt|Significant extending and fixing]])
:* TextLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* ImgLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* cntrPaspExt: 1.2 => '''1.3'''

{{CntHdr|{{Anch|Upd9InitCon|CONCEPTUAL > [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Concentration the different OpenSCADA-hosts on the common server, both for IoT on OpenSCADA and other]] (fixes of the [[Special:MyLanguage/Documents/Release_0.9#Upd8InitCon|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase.wlb_Main.dynFrame: Advancing the frame implementation up to the possibility of items real placing, linking, generic control, saving and restoring.
* LibsDB.OscadaLibs:
** FIX:tmplib_base.initRemCntr: Fixing of saving the table of the remote OpenSCADA hosts after removing old ones.
*** Adding of direct freeing data of requests.
*** The key changed to force two symbols in HEX.
*** Allowed of updating the remote logical source objects for new sources.
*** The protection time of the execution increased to 60 seconds.
*** Checking and removing logical parameters with missing sources.
*** Setting the field "Allow the automatic removal of parameters and attributes" and "Synchronization time with the remote station, seconds" of the [[Special:MyLanguage/Modules/DAQGate|DAQGate module]].
** Security_user,Transport_in.{Sockets,SSL}::RemCntr: Appending detailed description of the objects target and using.
* data/{oscada_plc.xml,oscada_server.xml}: Simplifying the station name for short remote identifiers.

{{CntHdr|{{Anch|Upd9MessTrFix|CONCEPTUAL > Messages Translation (fixes of the [[Special:MyLanguage/Documents/Release_0.9#MessTrFix|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase:
** FIX:wlb_Main.ElViewGraph: The attribute "Dimension (ed)" set to the type "String (translate)" to restore the transitive translation of the DAQ-Source messages at the links in the DYNAMIC-MULTILANGUAGE mode.
* FIX:DAQ.TDAQS,Archive.TArchives: Fixing dynamic translation of names of the redundant objects.
* FIX:SYS,DAQ.{.,JavaLikeCalc}: TFunction::IO: Fixing-finishing of the default value translation in the constructor and for the DAQ-Templates with its implementations.
* SYS:
** The Translation Manager is appended by an information into the last line about achieving an limit time.
** FIX:TMess: Adding of processing prestored I18N messages in the long ''TMess::translGet()'' variant, which is called from ''objFuncCall()'', instead the translation loss here.
* FIX:DB: Preventing the warnings "Some messages completely cleaned for the base ..." for items with no translation fields.
* FIX:DAQ: Fixing dynamic translation the select items from the default field in ''addLinksAttrs()''.
* FIX:UI.VCAEngine: The configuration value fixed in translation on the tab "Links" and processing the field translation for values with the prefix "val:" and switching to its.

{{CntHdr|OpenSCADA libraries and projects}}
* LibsDB.OscadaLibs:
** Adding the new library "Json" of support JSON from Arkadii Kysil.
** FIX:{tmplib_base,tmplib_DevLib}.UPS: Fixing of writing to the writable attributes.
** tmplib_base:
*** digAlarm,anUnif,anUnifSt,codeState: The input processing procedure added by a parameter "args" as a link to arguments of the main procedure.
*** {{Anch|Upd9UPSDirDevs|UPS}}: Expanding by implementing devices directly in this template starting from Must EP2X. Appending of attributes transferring in parameters on the template base with their definition in the new attribute "Elements definition (defs)". Adding the ''alarm()'' function for true control of borders with hysteresis.
*** FIX:manInUnif: Preventing of setting stored value to PLC at start, so overwriting actual one, also at the signal out the scale.
*** FIX:{{Anch|Upd9DSMARTInProc|DiskSMART}}: Adding the input processing procedure for processing specific fields and adding new derivative fields. The "Item definitions" field added a default list of specific interpretation the SMART fields. Improving some original messages.
*** anUnif: The alarm message of signal exceeding hardware border added by this wrong value.
** tmplib_DevLib:
*** mbBase,ergomera625: Improving the syntax highlight rules for types like to "u4".
*** {{Anch|Upd9IEC62056Part21|IEC62056}}: Expanding by support part 21 (direct local data exchange) and improvements:
**** adding input procedure for processing read OBISes;
**** list of OBISes appeded by description and the syntax higflight;
**** adding an option of control bytes LE order of integers;
**** ID of the attribute of representing OBIS appended by "ClassId" and "a";
**** "ClassId" of OBIS expanded up to two bytes;
**** trimming the visible strings up to first zero byte;
**** adding preset devices with known main OBISes;
**** address field expanded for support single digit like to SN;
**** the "tr" and "ctx" attributes moved from IO.
*** {{Anch|Upd9MbBaseInProcAtrUpd|mbBase}}: Expanded by an input procedure for customizing without changing the template. Expanding in support by the types "Int8 (i8)" and "Double (d)", also as by recreation attributes with changed type and removing attributes are missing in the items list. Allowing to specify address of the register in HEX and OCTAL. Adding by applying entries of the register syntax of the module [[Special:MyLanguage/Modules/ModBus|DAQ.ModBus]].
* LibsDB.vcaBase:
** wlb_Main: The library appended by the frame "Dynamic frame (dynFrame)" with documenting.
*** The library appended by an extra icon 'weath13n' for the widget "Weather (weather)".
*** FIX:{{Anch|Upd9LabExtSt|TextLab,ImgLab}}: Expanding for processing conflict states "false && false" and "true && true" taking the parameters from item [2] and [3].
**** Adding alarms generation from the "Error (err)" attribute.
**** FIX: Renaming the states name "Enable" to "Enabled" and "Disable" to "Disabled".
**** FIX: Unifying the alarms blinking with just changing work color to alarm one in the second cycle.
*** alarmsAct,alarmsSt: Adaptation to human-readable names in messages.
*** FIX:{{Anch|Upd9StoreHouseExt|storeHouse}}: Moving the Control Panel formation and updating to the table updating code.
**** FIX: Separating data preparing part from formation the visual data for early preparing the lists and with limiting time of processed items.
**** Appending to processing the event ws_TableEdit of checking validity row and column.
**** The retry cycles and updating rewrote for specifying time in "toCalcCycles" in seconds and updating after its elapsing.
**** FIX: Preventing of show second filter field in the item form after change the user.
**** FIX: Fixing the images overview at selecting in the file combobox.
**** Specifying the transaction mode in all ''SQLReq()'' calls.
**** The control panel appended by the selection fields.
**** Rewrote in preparing the column list for filters with using redefined names of the standard fields "NAME", "DSCR", and with true sorting.
**** In file sizes used new function ''SYS.cpct2str()''.
*** FIX:ImgLab: Taking the background color even empty from images list at its presence.
**** FIX: Setting width of the border to 2 when it is zero at the selection blinking, that is for active elements.
**** Format of the attribute "Images (imgs)" moved to the help, that is to the second line.
*** FIX:objProps: Appending of tracing the user changing, appending for support real properties.
*** ElCadr: Adding the attribute "Parameter: Force disable PID (prmNotPID)" for disabling PID show at presence SP.
*** cntrPaspExt: Hide attributes in EVAL. Generating for user action messages at changing the editable properties.
*** TextLab: Adapted to use the default background at its missing in "st_text".
** wlb_doc:
*** FIX:docRepYear: Fixing of processing the last value in year for data from archives.
*** docUsersSet: Expanding by a possibility to specify-configure of used archivers.
* Model.AGLKS.Model.DAQ_BlockCalc.gen_cnt: Appending the description by the field "MessName: {Name}".

{{CntHdr|API}}
''!!!!:Changes'':
* SYS.ResString: ''getVal()'' set to constant.
* Archives,DAQ.*: Enumeration items of the source modes added by the "SRC_" prefix and "ActiveAttr" renamed to "DAQAttrAct"; items of the combination modes added by the "CMB_" prefix and an item "FromArchiver"; items of the data mode added by the "DM_" prefix instead "DM".
* DAQ.TFunction: Switching the method "mStor" to ResString.
''Appends'':
* SYS.CntrNode,Protocol.HTTP: Adding the service requests "select:/db/list" by an option "nostor" for the empty item.
* SYS,UI.VCAEngine: Appending the definition "starts_with" as link to the STL::String function "compare(0,strlen(str),str) == 0" to replace ''compare()'' and ''find()'' in this role.
* Archives,DAQ.DAQGate: The TMArchivator object appended by a reimplementation TMess::SRec with a container of storing double messages in one second.
* SYS: The file's User API functions appended by ''fileRotate()'' for files rotation mostly the logging type.
** TCntrNode: new function ''nodeMessSnthHgl()''.
** XMLNode: The function ''load()'' appended of parsing pure HTML with an option LD_HTML. The function ''save()'' appended by an option HoldEmptyAttr of holding empty attributes.
** XMLNodeObj: Added by the User API and API function ''childDel( AutoHD<XMLNodeObj> nd )''. The User API function ''setAttr()'' added by a synonym ''attrSet()''.
* DAQ:
** TController,TParamContr: Adding a function ''justCreated()'' of detection the just creation.
** TParamContr: Added by a virtual function ''loadVal()'' of reloading all or one stored values.
** TPrmTempl.Impl.''archAttrs()'': Appended by a timestamp argument for using common timestamp in archiving.
** {{Anch|Upd9DirValAccess|ModBus,OPC_UA,Siemens}}: The Controller Object added by a User API function ''value()'' of direct value getting and setting at the source-specific address and through the address registering for getting-setting in the generic pooling cycle of the source.
* Archives: The TVArchivator object is added by the functions ''combMode()'' and ''setCombMode()''.
* JavaLikeCalc: The User API functions to string appended by ''sep2path()''.

{{CntHdr|SYS}}
* Building:
** configure.ac: Core library version risen to 3:16:0 and the program version risen to 0.9.9. The module version of the subsystem "DAQ" risen to 16 and the subsystem "Archives" risen to 15.
** Appended for building to Debian 13 and Ubuntu 26.04 LTS.
** .,DAQ.Siemens: Generic adaptation for building on Debian 13, adaptation for support PCRE2 since missing old PCRE libraries on Debian 13 with moving the variable "vSz" to a definition TRegExp_vSz for old libraries.
** DB.MySQL: Adaption to build with headers without definition the "my_bool" type on Ubuntu 26.04 LTS.
* XMLNode: The function ''load()'' appended of parsing pure HTML with: tags without closing, attributes without a value, attribute values without quoting, closing tags switching.

{{CntHdr|DAQ}}
* Templates: Enabling the selectable fields in the "Template configuration" tab for constants.
* FIX:{ModBus,OPC_UA,Siemens}.LogicLev: Preventing of wrong writing to PLC at RO links, when the value changed in the procedure.
* LogicLev,ModBus,OPC_UA,Siemens: The User API functions ''attrAdd()'' and ''attrDel()'' of managing user attributes moved from LogicLev, ModBus, OPC_UA, Siemens to the core parameter object and for all dynamic parameters at ''dynElCntr()''. Adding of {{Anch|Upd9StoreDynVal|storing values}} of the user's dynamic attributes.
* FIX:{{Anch|Upd9SimStab|Siemens}}: Moving the SELF_ISO_TCP mode to the generic ''outAt()'' function. Debugging the connection errors for the modes SELF_ISO_TCP and ISO_TCP on the actual S7-1500 connection.
* System: Adding the data acquisition of the slow sources per some cycle by the new configuration field "In cycle call for slow sources".
** {{Anch|Upd9SystemSMART|DA_SMART}}: Adding for support reading the NVMe Log with moving on parsing by RE and reading string fields, like to temperature.
** DA_PROC: Appended by obtaining the field "User loading (%)" and "System loading (%)" from the file "/proc/{PID}/stat" also with the value concatenation for group selection.
* FIX:JavaLikeCalc: Fixing permission to the Function node after moving under ACL.
* FIX:{{Anch|Upd9LogicLevRefl|LogicLev}}: Improving the parameter reflection mode by a possibility to connect later the missing at the start sources, also as unlinking-unlocking disabled sources.
* FIX:DAQGate: Fixing ''messSet()'' by taking parameter whole ID from the first line of the argument "prm" and with its normalization by the prefix "prm_" removing. Set for writing to remote stations without checking the value at equality, due to the previous value can be not actual at situative reading.
* ModBus: Unified in registering values at the ModBus-specific address in other variant of the function ''regVal()''.

{{CntHdr|Archives-History}}
* FIX:Value: Prevented of crashing at zero period in ''TVArchEl::getVals()''.
** Added by a configuration field "Data combining mode (CombMode)", as in the archive object, for specifying the data combination in the archiver, and the field in archive added by an item "From Archiver" by default.
** The "Active DAQ Attribute (DEPRECATED)" item of the archive source renamed to "DAQ Attribute actively" and unmarked deprecated due to it is the single way of creation multiple archives to single source.

{{CntHdr|Транспорти}}
* FIX: Функція запиту загального Інтерфейсу Керування ''cntrIfCmd()'' попереджена від будь якої локальної-прямої-користувацької автентифікації за переспрямування до проміжних вузлів OpenSCADA, що особливо актуально для віддалених підключень UI.Vision від різних користувачів.
* Журналювання трафіку у файл доповнено ротацією файлів.

{{CntHdr|Інтерфейс Користувача}}
* FIX:Vision,WebVision: Виправлення компенсації часток реальних чисел у позиції і розмірі для правильного вирівнювання внутрішнього вмісту віджетів з різним розміром, коли масштаб більше 1. Запобігання аварійного завершення функції ''VCADiagram::TrendObj::loadTrendsData()'' за нуля у "wantPer".
* QTCfg,Vision: Розмір табуляції текстової області встановлено динамічним і обрахованим із метрики шрифту для стандартних восьми символів "00000000".
* {{Anch|Upd9WebCfgD|WebCfgD}}: Реалізовано підсвітлювання синтаксису у текстових полях.
* FIX:WebVision: Відновлення функції зміни користувача після запобігання заповненню повідомленнями підключення до того-ж сеансу від іншого вузла і іншого агента. Додання користувача останнього запиту для запобігання відкриття нових сеансів після зміни користувача від оригінального.
* FIX:VCAEngine: Перенесення встановлення прапорця Attr::VizerSpec для атрибутів із префіксом "vs_" до спадкування атрибутів і лише для віджетів сеансу. Уніфікація власних прапорців Атрибуту поділом на збережені і оперативні.
* FIX:QTStarter.lib_qtgen: Алгоритм підсвітлення синтаксису у ''SnthHgl::rule()'' очищено від зайвих контейнерів і уніфіковано.
* FIX:Vision: Запобігання аварійному завершенню у обробнику події ShapeFormEl за незавершеної ініціалізації, тобто відсутня змінна "addrWdg". Запобігання зміні користувача для переспрямованих підключень.

Translations:Documents/Release 0.9/Update 9/11/en

2026-05-12T16:16:06Z

FuzzyBot: Importing a new version from external source

{{CntHdr|Archives-History}}
* FIX:Value: Prevented of crashing at zero period in ''TVArchEl::getVals()''.
** Added by a configuration field "Data combining mode (CombMode)", as in the archive object, for specifying the data combination in the archiver, and the field in archive added by an item "From Archiver" by default.
** The "Active DAQ Attribute (DEPRECATED)" item of the archive source renamed to "DAQ Attribute actively" and unmarked deprecated due to it is the single way of creation multiple archives to single source.

Translations:Documents/Release 0.9/Update 9/7/en

2026-05-12T16:16:05Z

FuzzyBot: Importing a new version from external source

{{CntHdr|OpenSCADA libraries and projects}}
* LibsDB.OscadaLibs:
** Adding the new library "Json" of support JSON from Arkadii Kysil.
** FIX:{tmplib_base,tmplib_DevLib}.UPS: Fixing of writing to the writable attributes.
** tmplib_base:
*** digAlarm,anUnif,anUnifSt,codeState: The input processing procedure added by a parameter "args" as a link to arguments of the main procedure.
*** {{Anch|Upd9UPSDirDevs|UPS}}: Expanding by implementing devices directly in this template starting from Must EP2X. Appending of attributes transferring in parameters on the template base with their definition in the new attribute "Elements definition (defs)". Adding the ''alarm()'' function for true control of borders with hysteresis.
*** FIX:manInUnif: Preventing of setting stored value to PLC at start, so overwriting actual one, also at the signal out the scale.
*** FIX:{{Anch|Upd9DSMARTInProc|DiskSMART}}: Adding the input processing procedure for processing specific fields and adding new derivative fields. The "Item definitions" field added a default list of specific interpretation the SMART fields. Improving some original messages.
*** anUnif: The alarm message of signal exceeding hardware border added by this wrong value.
** tmplib_DevLib:
*** mbBase,ergomera625: Improving the syntax highlight rules for types like to "u4".
*** {{Anch|Upd9IEC62056Part21|IEC62056}}: Expanding by support part 21 (direct local data exchange) and improvements:
**** adding input procedure for processing read OBISes;
**** list of OBISes appeded by description and the syntax higflight;
**** adding an option of control bytes LE order of integers;
**** ID of the attribute of representing OBIS appended by "ClassId" and "a";
**** "ClassId" of OBIS expanded up to two bytes;
**** trimming the visible strings up to first zero byte;
**** adding preset devices with known main OBISes;
**** address field expanded for support single digit like to SN;
**** the "tr" and "ctx" attributes moved from IO.
*** {{Anch|Upd9MbBaseInProcAtrUpd|mbBase}}: Expanded by an input procedure for customizing without changing the template. Expanding in support by the types "Int8 (i8)" and "Double (d)", also as by recreation attributes with changed type and removing attributes are missing in the items list. Allowing to specify address of the register in HEX and OCTAL. Adding by applying entries of the register syntax of the module [[Special:MyLanguage/Modules/ModBus|DAQ.ModBus]].
* LibsDB.vcaBase:
** wlb_Main: The library appended by the frame "Dynamic frame (dynFrame)" with documenting.
*** The library appended by an extra icon 'weath13n' for the widget "Weather (weather)".
*** FIX:{{Anch|Upd9LabExtSt|TextLab,ImgLab}}: Expanding for processing conflict states "false && false" and "true && true" taking the parameters from item [2] and [3].
**** Adding alarms generation from the "Error (err)" attribute.
**** FIX: Renaming the states name "Enable" to "Enabled" and "Disable" to "Disabled".
**** FIX: Unifying the alarms blinking with just changing work color to alarm one in the second cycle.
*** alarmsAct,alarmsSt: Adaptation to human-readable names in messages.
*** FIX:{{Anch|Upd9StoreHouseExt|storeHouse}}: Moving the Control Panel formation and updating to the table updating code.
**** FIX: Separating data preparing part from formation the visual data for early preparing the lists and with limiting time of processed items.
**** Appending to processing the event ws_TableEdit of checking validity row and column.
**** The retry cycles and updating rewrote for specifying time in "toCalcCycles" in seconds and updating after its elapsing.
**** FIX: Preventing of show second filter field in the item form after change the user.
**** FIX: Fixing the images overview at selecting in the file combobox.
**** Specifying the transaction mode in all ''SQLReq()'' calls.
**** The control panel appended by the selection fields.
**** Rewrote in preparing the column list for filters with using redefined names of the standard fields "NAME", "DSCR", and with true sorting.
**** In file sizes used new function ''SYS.cpct2str()''.
*** FIX:ImgLab: Taking the background color even empty from images list at its presence.
**** FIX: Setting width of the border to 2 when it is zero at the selection blinking, that is for active elements.
**** Format of the attribute "Images (imgs)" moved to the help, that is to the second line.
*** FIX:objProps: Appending of tracing the user changing, appending for support real properties.
*** ElCadr: Adding the attribute "Parameter: Force disable PID (prmNotPID)" for disabling PID show at presence SP.
*** cntrPaspExt: Hide attributes in EVAL. Generating for user action messages at changing the editable properties.
*** TextLab: Adapted to use the default background at its missing in "st_text".
** wlb_doc:
*** FIX:docRepYear: Fixing of processing the last value in year for data from archives.
*** docUsersSet: Expanding by a possibility to specify-configure of used archivers.
* Model.AGLKS.Model.DAQ_BlockCalc.gen_cnt: Appending the description by the field "MessName: {Name}".

Translations:Documents/Release 0.9/Update 9/8/en

2026-05-12T16:16:05Z

FuzzyBot: Importing a new version from external source

{{CntHdr|API}}
''!!!!:Changes'':
* SYS.ResString: ''getVal()'' set to constant.
* Archives,DAQ.*: Enumeration items of the source modes added by the "SRC_" prefix and "ActiveAttr" renamed to "DAQAttrAct"; items of the combination modes added by the "CMB_" prefix and an item "FromArchiver"; items of the data mode added by the "DM_" prefix instead "DM".
* DAQ.TFunction: Switching the method "mStor" to ResString.
''Appends'':
* SYS.CntrNode,Protocol.HTTP: Adding the service requests "select:/db/list" by an option "nostor" for the empty item.
* SYS,UI.VCAEngine: Appending the definition "starts_with" as link to the STL::String function "compare(0,strlen(str),str) == 0" to replace ''compare()'' and ''find()'' in this role.
* Archives,DAQ.DAQGate: The TMArchivator object appended by a reimplementation TMess::SRec with a container of storing double messages in one second.
* SYS: The file's User API functions appended by ''fileRotate()'' for files rotation mostly the logging type.
** TCntrNode: new function ''nodeMessSnthHgl()''.
** XMLNode: The function ''load()'' appended of parsing pure HTML with an option LD_HTML. The function ''save()'' appended by an option HoldEmptyAttr of holding empty attributes.
** XMLNodeObj: Added by the User API and API function ''childDel( AutoHD<XMLNodeObj> nd )''. The User API function ''setAttr()'' added by a synonym ''attrSet()''.
* DAQ:
** TController,TParamContr: Adding a function ''justCreated()'' of detection the just creation.
** TParamContr: Added by a virtual function ''loadVal()'' of reloading all or one stored values.
** TPrmTempl.Impl.''archAttrs()'': Appended by a timestamp argument for using common timestamp in archiving.
** {{Anch|Upd9DirValAccess|ModBus,OPC_UA,Siemens}}: The Controller Object added by a User API function ''value()'' of direct value getting and setting at the source-specific address and through the address registering for getting-setting in the generic pooling cycle of the source.
* Archives: The TVArchivator object is added by the functions ''combMode()'' and ''setCombMode()''.
* JavaLikeCalc: The User API functions to string appended by ''sep2path()''.

Translations:Documents/Release 0.9/Update 9/9/en

2026-05-12T16:16:05Z

FuzzyBot: Importing a new version from external source

{{CntHdr|SYS}}
* Building:
** configure.ac: Core library version risen to 3:16:0 and the program version risen to 0.9.9. The module version of the subsystem "DAQ" risen to 16 and the subsystem "Archives" risen to 15.
** Appended for building to Debian 13 and Ubuntu 26.04 LTS.
** .,DAQ.Siemens: Generic adaptation for building on Debian 13, adaptation for support PCRE2 since missing old PCRE libraries on Debian 13 with moving the variable "vSz" to a definition TRegExp_vSz for old libraries.
** DB.MySQL: Adaption to build with headers without definition the "my_bool" type on Ubuntu 26.04 LTS.
* XMLNode: The function ''load()'' appended of parsing pure HTML with: tags without closing, attributes without a value, attribute values without quoting, closing tags switching.

Translations:Documents/Release 0.9/Update 9/10/en

2026-05-12T16:16:05Z

FuzzyBot: Importing a new version from external source

{{CntHdr|DAQ}}
* Templates: Enabling the selectable fields in the "Template configuration" tab for constants.
* FIX:{ModBus,OPC_UA,Siemens}.LogicLev: Preventing of wrong writing to PLC at RO links, when the value changed in the procedure.
* LogicLev,ModBus,OPC_UA,Siemens: The User API functions ''attrAdd()'' and ''attrDel()'' of managing user attributes moved from LogicLev, ModBus, OPC_UA, Siemens to the core parameter object and for all dynamic parameters at ''dynElCntr()''. Adding of {{Anch|Upd9StoreDynVal|storing values}} of the user's dynamic attributes.
* FIX:{{Anch|Upd9SimStab|Siemens}}: Moving the SELF_ISO_TCP mode to the generic ''outAt()'' function. Debugging the connection errors for the modes SELF_ISO_TCP and ISO_TCP on the actual S7-1500 connection.
* System: Adding the data acquisition of the slow sources per some cycle by the new configuration field "In cycle call for slow sources".
** {{Anch|Upd9SystemSMART|DA_SMART}}: Adding for support reading the NVMe Log with moving on parsing by RE and reading string fields, like to temperature.
** DA_PROC: Appended by obtaining the field "User loading (%)" and "System loading (%)" from the file "/proc/{PID}/stat" also with the value concatenation for group selection.
* FIX:JavaLikeCalc: Fixing permission to the Function node after moving under ACL.
* FIX:{{Anch|Upd9LogicLevRefl|LogicLev}}: Improving the parameter reflection mode by a possibility to connect later the missing at the start sources, also as unlinking-unlocking disabled sources.
* FIX:DAQGate: Fixing ''messSet()'' by taking parameter whole ID from the first line of the argument "prm" and with its normalization by the prefix "prm_" removing. Set for writing to remote stations without checking the value at equality, due to the previous value can be not actual at situative reading.
* ModBus: Unified in registering values at the ModBus-specific address in other variant of the function ''regVal()''.

Translations:Documents/Release 0.9/Update 9/16/en

2026-05-12T16:16:04Z

FuzzyBot: Importing a new version from external source

{{CntHdr|Main WWW-resources, documentation of the project and subprojects, and localisation}}
* appending the [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]] by description the new element-frame "Dynamic frame";
* updating information of the subproject [[Special:MyLanguage/Sub-projects/Automatic_Builder_of_OpenSCADA|Automatic Builder of OpenSCADA]];
* adding Portuguese translation from Diego Eckhard for parts: SYS, DAQ.ModBus, Transport.{Sockets,SSL,Serial}, UI.{QTStarter,QTCfg,VCAEngine,Vision}.

Translations:Documents/Release 0.9/Update 9/15/en

2026-05-12T16:16:04Z

FuzzyBot: Importing a new version from external source

{{CntHdr|New and significantly updated parts}}
* OpenSCADA Core: 3:15:0 => '''3:16:0'''
: ([[#Upd9InitCon|Implementing initiative connections — fixes and expandings of the conceptual changes of the previous updates]], [[#Upd9MessTrFix|Messages Translation — fixes of the conceptual changes of the previous updates]])
* OpenSCADA "DAQ" subsystem: 15 => '''16'''
* OpenSCADA "Archives" subsystem: 14 => '''15'''
* DAQ.Siemens: 4.5 => <b style="color: red">4.8</b>
: ([[#Upd9SimStab|Common stabilization in the ISO_TCP connection]], [[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.System: 3.3 => <b style="color: red">3.5</b>
: ([[#Upd9SystemSMART|Reading the NVMe Log with moving on parsing by RE and reading string fields]])
* DAQ.LogicLev: 2.9 => <b style="color: red">2.11</b>
: ([[#Upd9LogicLevRefl|Improving the parameter reflection mode]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.OPC_UA: 2.8 => <b style="color: red">2.10</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.ModBus: 3.9 => <b style="color: red">3.11</b>
: ([[#Upd9DirValAccess|Direct value getting and setting at the source-specific address]], [[#Upd9StoreDynVal|Storing values of the user's dynamic attributes]])
* DAQ.DAQGate: 2.14 => '''2.15'''
* Protocol.HTTP: 3.9 => '''3.11'''
* UI.WebCfgD: 2.8 => <b style="color: red">3.0</b>
: ([[#Upd9WebCfgD|Syntax highlight in the textareas]])
* UI.VCAEngine: 7.17 => '''7.19'''
* UI.WebVision: 6.13 => '''6.16'''
* UI.QTStarter: 6.0 => '''6.1'''
* UI.QTCfg: 6.1 => '''6.2'''
* UI.WebCfgD: 3.0 => '''3.1'''
* LibsDB.OscadaLibs:
:* JavaLikeCalc.flb_Json: <b style="color: red">0.3</b>
:* base:
::* UPS: 1.3 => <b style="color: red">2.2</b>
::: ([[#Upd9UPSDirDevs|Implementing devices directly, attributes definition in "Elements definition (defs)"]])
::* DiskSMART: 1.0 => '''1.1'''
::: ([[#Upd9DSMARTInProc|Input processing procedure]])
::* initRemCntr: 1.1 => '''1.2'''
:* DevLib.mbBase: 1.3 => <b style="color: red">1.6</b>
:: ([[#Upd9MbBaseInProcAtrUpd|Input processing procedure, additional types and flexible attributes update]])
:* LowDevLib:
::* IEC62056: 1.1 => <b style="color: red">2.0</b>
::: ([[#Upd9IEC62056Part21|Support 21 part and many improvements]])
::* S1BP: 1.0 => '''1.1'''
* LibsDB.vcaBase.Main: 2.2 => '''2.3'''
:* dynFrame: <b style="color: red">1.2</b>
:* storeHouse: 2.1 => <b style="color: red">2.3</b>
:: ([[#Upd9StoreHouseExt|Significant extending and fixing]])
:* TextLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* ImgLab: 1.2 => '''1.3'''
:: ([[#Upd9LabExtSt|States extending]])
:* cntrPaspExt: 1.2 => '''1.3'''

Translations:Documents/Release 0.9/Update 9/5/en

2026-05-12T16:16:04Z

FuzzyBot: Importing a new version from external source

{{CntHdr|{{Anch|Upd9InitCon|CONCEPTUAL > [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|Concentration the different OpenSCADA-hosts on the common server, both for IoT on OpenSCADA and other]] (fixes of the [[Special:MyLanguage/Documents/Release_0.9#Upd8InitCon|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase.wlb_Main.dynFrame: Advancing the frame implementation up to the possibility of items real placing, linking, generic control, saving and restoring.
* LibsDB.OscadaLibs:
** FIX:tmplib_base.initRemCntr: Fixing of saving the table of the remote OpenSCADA hosts after removing old ones.
*** Adding of direct freeing data of requests.
*** The key changed to force two symbols in HEX.
*** Allowed of updating the remote logical source objects for new sources.
*** The protection time of the execution increased to 60 seconds.
*** Checking and removing logical parameters with missing sources.
*** Setting the field "Allow the automatic removal of parameters and attributes" and "Synchronization time with the remote station, seconds" of the [[Special:MyLanguage/Modules/DAQGate|DAQGate module]].
** Security_user,Transport_in.{Sockets,SSL}::RemCntr: Appending detailed description of the objects target and using.
* data/{oscada_plc.xml,oscada_server.xml}: Simplifying the station name for short remote identifiers.

Translations:Documents/Release 0.9/Update 9/6/en

2026-05-12T16:16:04Z

FuzzyBot: Importing a new version from external source

{{CntHdr|{{Anch|Upd9MessTrFix|CONCEPTUAL > Messages Translation (fixes of the [[Special:MyLanguage/Documents/Release_0.9#MessTrFix|conceptual changes of the previous updates]]) }} }}
* LibsDB.vcaBase:
** FIX:wlb_Main.ElViewGraph: The attribute "Dimension (ed)" set to the type "String (translate)" to restore the transitive translation of the DAQ-Source messages at the links in the DYNAMIC-MULTILANGUAGE mode.
* FIX:DAQ.TDAQS,Archive.TArchives: Fixing dynamic translation of names of the redundant objects.
* FIX:SYS,DAQ.{.,JavaLikeCalc}: TFunction::IO: Fixing-finishing of the default value translation in the constructor and for the DAQ-Templates with its implementations.
* SYS:
** The Translation Manager is appended by an information into the last line about achieving an limit time.
** FIX:TMess: Adding of processing prestored I18N messages in the long ''TMess::translGet()'' variant, which is called from ''objFuncCall()'', instead the translation loss here.
* FIX:DB: Preventing the warnings "Some messages completely cleaned for the base ..." for items with no translation fields.
* FIX:DAQ: Fixing dynamic translation the select items from the default field in ''addLinksAttrs()''.
* FIX:UI.VCAEngine: The configuration value fixed in translation on the tab "Links" and processing the field translation for values with the prefix "val:" and switching to its.

Translations:Documents/Release 0.9/Update 9/2/en

2026-05-12T16:16:03Z

FuzzyBot: Importing a new version from external source

This update of the [[Special:MyLanguage/Documents/Release_0.9|0.9 LTS release]] fixes about 70 bugs and appends MANY improvements, which you can read wholly in [http://oscada.org/svn/tags/openscada_0.9/ChangeLog?p=3066 the update ChangeLog].

Translations:Documents/Release 0.9/Update 9/14/en

2026-05-12T16:16:03Z

FuzzyBot: Importing a new version from external source

{{CntHdr|[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]}}
* adaptation of work the hosting server under constant DDoS in ~3 million unique IPs and with short time under power net by economy the batteries, and under OpenSCADA control;
* appending Debian 13 as the distributive base;
* moving back to the OpenSCADA server of building the Debian 9 base;
* moving of building the Debian 12,11,10 base to the Debian 13 environment with enabling back support SHA-1 here;
* switching the building conception to use '''sshfs''' in working remotely with the repositories;
* updating TDE to 14.1.4, 14.1.5 and next to 14.1.6;
* TDE > krusader-trinity > RAR: Loading the builtin TDEIO RAR library.
* TDE > tdebase-trinity > TDEIO > media: Translation the FS options in the "propsdlg" plugin.
* TDE > tde-i18n-trinity > uk: Adding messages translation in patched packages to the Ukrainian part.
* TDE > tdebase-trinity > KControl > Locale: Clearing the language settings to system ones.
* TDE > tdelibs-trinity > TDELocale: Adding of obtaining country from environment.
* TDE > tdelibs-trinity > TDEIO > SwitchLanguageDialog: Clearing all language setting.
* TDE > tdeutils-trinity > ARK: Adding "unrar-free" using.
* TDE > krusader-trinity > RAR: Adding "unrar-free" using.
* TDE > tdegraphics-trinity > kghostview: Represent PDF on Ghostscript 10.05.
* TDE > tdebase-trinity: KDesktop > Lock: Restoring the locking code to one in version 14.1.4 with extending for the lock dialog itself.
* TDE > tdepim-trinity > holiday_ua > HoliDays: Replacing by actual Holi Days and Memorial Days of Ukraine.
* TDE > kaffeine-trinity > xine-part: Adding translation the message "Impossible to obtain image!" to Ukrainian.
* TDE > tdebase-trinity: Preventing-oppressing double icons in the system tray from programs with equal window ID like to '''blueman''' and with an option of disabling that function, with fixing of using ''readBoolEntry()''.
* TDE > tqt3-trinity > Plugins > XIM: Calls ''XCloseIM()'' to prevent memory leaking.
* TDE > tdelibs-trinity > TDEIO > KFileView: Processes file extensions with patterns at saving and doesn't reset the dialog size.
* TDE > kaffeine-trinity > xine-part: Allows to screenshot in any supported image-file format.
* TDE > tdesvn-trinity: Fixing of conflicts resolving in KDiff3, preventing of crashes at conflicts resolving, updating parent of changed item with all expandings.
* TDE > tdebase-trinity > TDEIO > media: Restoring of using '''fuser'''.
* TDE > tdebase-trinity > ksysguard: Removing the processes loading limit in 100%.
* TDE > tdelibs-trinity > TDEIO > CopyJob: Don't rename directories and files overwrite for old, lesser and in different size.
* TDE > tdebase-trinity > TDEIO > SMB: Prevents double ''result()'' signal generation through errors.
* TDE > tdepim-trinity > knote: Adding the find only local per selected note.
* TDE > tdelibs-trinity: Complete disabling of processing for the unclassified devices due to it is very CPU intensive, especially on slow HW.

Sub-projects/Automatic Builder of OpenSCADA/uk

2026-05-11T12:20:52Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Назва !! Заснування !! Стан !! Учасники
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Автоматичний Складальник OpenSCADA]] || Березень 2015 ||
Імплементовано у скриптах побудови, опрацювання репозиторіїв і гілок та перевірки цілей щодо складання до 100 цілей за допомогою: CHROOTів репозиторіїв Linux, VPS та різних під-оточень. Результатом функціонування Складальника є: [http://oscada.org/main/download/ свіжі та підписані репозиторії Linux, штампи Live Дисків та інші бінарні архіви OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Роман Савоченко]]
|-
! colspan="5" | Опис
|-
| colspan="5" | Спрямуванням підпроєкту є спрощення розповсюдження-дистриб'юції проєкту OpenSCADA через автоматичне складання бінарних пакетів, їх готових до використання репозиторіїв та інших складних дистрибутивів на кшталт Живих Дисків.
* '''[http://oscada.org/ua/rozrobka/zavdannja/posts/core/the_automatic_openscada_builder/ Завдання Керування]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Linux дистрибутив автоматизації проєкту OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|Як створити Живий Диск]]'''
* '''Стан підтримки''': Викликається вручну після вивантаження SVN-змін для загального складання на сервері через ''oscadaCheck'' та домашньому ПК щодо нових оточень через ''oscadaCheck_ExtGen'', а також автоматично на початку години для "Raspbian" цілей на RPi3 через ''oscadaCheck_RPi''.
|}

Складач представлено двома загальними BASH-скриптами та декільком BASH-скриптами перевірки:
* '''oscadaCheck*''' — прості скрипти із переліком профілів складання для перевірки у ''oscadaRepBranches'' і залежно від хосту складання; вони зазвичай запускаються CRON-планувальником для нічних складань або вручну. Відомий наразі перелік профілів відповідно до Таблиці 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — загальний, використовується на сервері OpenSCADA;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — додатковий загальний, використовується на сервері OpenSCADA при новому випуску LTS версії;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — зовнішній загальний, використовується на Домашньому ПК Автора;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — додатковий зовнішній загальний, використовується на Домашньому ПК Автора при новому випуску LTS версії;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — зовнішні "Raspbian" цілі, використовується на RPi Автора;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — додаткові зовнішні "Raspbian" цілі, використовується на RPi Автора при новому випуску LTS версії.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — для опрацювання переліку профілів вказаних в командному рядку у форматі "'''{Target}[:option[,optionN]][ =]{EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", де:
** "EN"{0|1} — увімкнення цілі;
** "ForWork"{0|1} — включення до складання для Робочої (Work) гілки;
** "ForLTS"{0|1} — включення до складання для загальних оновлень Стабільної (LTS) гілки;
** "ForLTSServ"{0|1} — включення до складання для сервісних оновлень Стабільної (LTS) гілки;
** "OmitSourceTree"{0|1} — оминати завантаження дерева вихідних із SVN, переважно для складання живих штампів.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — для безпосереднього складання і розміщення готових пакетів та іншого для Стабільної (LTS) і Робочої (Work) гілок OpenSCADA.

Files structure of the automation building system means:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => work building folder, which contains the unpacked CHROOTs
| | |-- log/ => logs of the builds
| | \-- *.stamp => stamps of the successful builds
| \-- chroot-data.tgz => contains the GPG singing key for the packages and their repositories of the builder
\-- share_res/
\-- ftp/ => FTP-folder of the building results
|-- {Debian,ALTLinux}/ => folders of the repositories of the Automation Linux distributive
|-- Misc/
| \-- chroots/ => folder of the archives of the CHROOTs of the building
\-- OpenSCADA/ => folders of the repositories of OpenSCADA
|-- LTS/ => folders of the LTS repositories of OpenSCADA
\-- Work/ => folders of the Work repositories of OpenSCADA
</pre>

The automatic building system supports also its distribution at specific environments (for some building types) like to different hardware platforms, instead their CHROOTs sometime. The distribution is performed by moving part of the automatic builder outward by: deploying the bottom file structure only for needed targets, organization for the local file server and scheduling the sync script [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] on the automatic builder core (say [[User:RomanSavochenko|Roman Savochenko]] for) — the main FTP-server.

Наразі автоматичний складальник передбачає складання:
* Робочої (Work) версії (1) щодо останньої SVN-ревізії із тегом "(stable)";
* Стабільної (LTS) версії (0.9.U.S) щодо загального (U) та сервісного (S) оновлення.

For Author's buildings, the specified scrips adapted to work with the FTP-folder of the building results directly on the OpenSCADA server by help '''sshfs''', and expanded also by options for a possibility of free specifying the SVN-revision to the both branches.

Адаптація [https://www.debian.org/devel/debian-live Живого проєкту Debian] до цього проєкту:
* ''/usr/lib/live/build/binary_iso'' — додання аргументу "-input-charset UTF-8" до змінної XORRISO_OPTIONS для дозволу на диску файлів в UTF-8;
* ''/usr/lib/live/build/installer_debian-installer'' — взято із Debian 12 оскільки він із Debian 13 має помилки зі складанням для Debian 10,11.

'''Table 1''': Реалізовані профілі — типи складання.
{| class="wikitable"
! Ціль !! Результат !! Метод складання !! Зовнішнє розгортання !! Додаткове
|-
| SrcTar || Пакети вихідних, запаковані XZ TAR пакетами || CHROOT "Debian_7_32" || Так || Оновлює документацію OpenSCADA для LTS.
|-
| SrcRPM, CentOs*, SuSE*, Fedora*, ALTLinux*, Mandriva* || Вихідні та бінарні RedHat пакети для апаратних архітектур x86_32 і x86_64 || CHROOT || Так || Допускає підлаштування до специфіки латками "openscada_*.patch".<br/>Викликом наданого сценарію "reposUpdate" у теці результатів, репозиторії пакетів можуть бути: створені, оновлені, підписані щодо пакетів та репозиторію загалом.<br/>Цільові параметри:
* "rep" — до теки репозиторію замість теки OpenSCADA;
* "dev" — монтувати системні теки до CHROOT (/dev, /dev/pts, /proc).
|-
| Debian*, Raspbian*, Ubuntu* || Пакети Debian для апаратних архітектур x86_32, x86_64, ARMHF, ARM64, NATIVE || CHROOT || Так || Допускає підлаштування до специфіки латками "openscada[-{platform}]_*.patch".<br/>Викликом наданого сценарію "reposUpdate" у теці результатів, репозиторії пакетів можуть бути: створені, оновлені, підписані щодо пакетів та репозиторію загалом.<br/>Цільові параметри:
* "rep" — до теки репозиторію замість теки OpenSCADA.
|-
| Nokia* || Пакети Debian для апаратної архітектури ARMEL || [http://www.scratchbox.org/ Scratchbox] || Так || Допускає підлаштування до специфіки латками "openscada_*.patch".
|-
| Gen32PLC*, LP8x81* || TAR пакети прошивок ПЛК для архітектури x86_32 || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || Ні || Використовує mkimage профілі ALTLinux: "mkimage-profiles-5-plc", "mkimage-profiles-5-plc-LP8x81", "mkimage-profiles-6-plc", "mkimage-profiles-6-plc-LP8x81".<br/>Цільові параметри:
* "UI" — включити Користувацький Інтерфейс, лише для ALTLinux 5;
* "rt1" — використати ядро "rt1-up", для ALTLinux 6.
|-
| Live_ALT || Гібридний ISO штамп або TAR пакет Живого Диску [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux|Linux дистрибутиву Автоматизації заснованого на ALTLinux]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || Ні || Використовує ALTLinux mkimage профіль "mkimage-profiles-6-kdesktop".<br/>Оновлює MD5SUM ISO штампів у файлі "MD5SUM".<br/>Цільові параметри:
* "flash" — скласти TAR пакет замість ISO штампу.
|-
| Live_Deb || Гібридний ISO штамп Живого Диску [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian|Linux дистрибутиву Автоматизації заснованого на Debian]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]]; home.home || Ні || Використовує [https://www.debian.org/devel/debian-live/ профілі Живої Побудови] Debian: live7-32, live7-64, live8-32, live8-64, live9-32, live9-64, live10-32, live10-64, live11-32, live11-64.<br/>Оновлює MD5SUM ISO штампів у файлі "MD5SUM".
|-
| ICP_DAS_LP_ARM, SMH2Gi || TAR пакети прошивок ПЛК для апаратної архітектури ARM. || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]] + TOOLCHAIN || Ні || Використовує відповідні TOOLCHAINs.
|}

'''Таблиця 2''': Актуальні цілі складання (на 01.01.7531/01.03.2023).
{| class="wikitable"
! Ціль(і) !! OpenSCADA !! Хост !! Примітки
|-
| SrcTar || Work+LTS || oscada.org ||
|-
| SrcRPM || LTS || oscada.org ||

|-
| colspan="4" | ''Debian''
|-
| Debian_13_{32,64,armhf,arm64} || - || ||
|-
| Debian_13_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_12_{32,64,armhf,arm64} || - || ||
|-
| Debian_12_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_11_{32,64,armhf,arm64} || - || ||
|-
| Debian_11_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_10_{32,64,armhf} || - || ||
|-
| Debian_10_{32,64,armhf}:rep || Work+LTS || home.home ||
|-
| Debian_9_{32,64,armhf} || - || ||
|-
| Debian_9_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_8_{32,64,armhf} || - || ||
|-
| Debian_8_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_7_{32,64} || - || ||
|-
| Debian_7_{32,64}:rep || Work+LTS || oscada.org ||
|-
| Debian_6_{32,64} || - || ||

|-
| colspan="4" | ''Raspbian, the same Debian but for [https://www.raspberrypi.org/ Raspberry Pi] — a very specific ARMv6 environment for the BCM2835 and early chips mostly.''
|-
| Raspbian_9_native || Work+LTS || pi.home ||
|-
| Raspbian_8_native || LTS || pi.home ||

|-
| colspan="4" | ''Ubuntu''
|-
| Ubuntu_26.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_24.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_22.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_20.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_18.04_{32,64} || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org
|-
| Ubuntu_16.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_14.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_12.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_11.10_{32,64} || - || ||
|-
| Ubuntu_10.04_{32,64} || - || ||

|-
| colspan="4" | ''CentOs''
|-
| CentOs_8_64:dev || Work+LTS || home.home ||
|-
| CentOs_7_64 || LTS || oscada.org ||
|-
| CentOs_6_{32,64} || LTS || oscada.org ||

|-
| colspan="4" | ''SuSE''
|-
| SuSE_15_64:dev || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org. GPG2 needs for mounting the system folders.
|-
| SuSE_13_{32,64} || LTS || oscada.org ||
|-
| SuSE_12_{32,64} || LTS || oscada.org ||
|-
| SuSE_11_{32,64} || - || ||

|-
| colspan="4" | ''ALTLinux''
|-
| ALTLinux_7_{32,64} || - || ||
|-
| ALTLinux_7_{32,64}:rep || LTS || oscada.org ||
|-
| ALTLinux_6_{32,64} || - || ||
|-
| ALTLinux_6_{32,64}:rep || Work+LTS || oscada.org ||
|-
| ALTLinux_5_{32,64} || - || ||
|-
| ALTLinux_5_{32,64}:rep || - || ||

|-
| colspan="4" | ''Fedora''
|-
| Fedora_12_32 || LTS || oscada.org ||

|-
| colspan="4" | ''Mandriva''
|-
| Mandriva_2011_{32,64} || - || ||
|-
| Mandriva_2010_{32,64} || - || ||

|-
| colspan="4" | ''Nokia''
|-
| Nokia_800 || LTS || oscada.org ||
|-
| Nokia_900 || Work+LTS || oscada.org ||
|-
| Nokia_950 || LTS || oscada.org ||

|-
| colspan="4" | ''PLC+Embedded''
|-
| Gen32PLC_ALT6 || LTS || oscada.org ||
|-
| Gen32PLC_ALT6:rt1 || LTS || oscada.org ||
|-
| Gen32PLC_ALT5 || - || ||
|-
| Gen32PLC_ALT5:UI || - || ||
|-
| LP8x81_ALT6 || LTS || oscada.org ||
|-
| LP8x81_ALT6:rt1 || LTS || oscada.org ||
|-
| LP8x81_ALT5 || - || ||
|-
| LP8x81_ALT5:UI || - || ||
|-
| SMH2Gi || LTS || oscada.org ||
|-
| ICP_DAS_LP_ARM || - || ||
|-
| TionPro270 || - || ||

|-
| colspan="4" | ''Live''
|-
| Live_Deb13_64 || Work+LTS || home.home ||
|-
| Live_Deb12_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb11_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb10_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb9_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb8_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb7_{32,64} || Work+LTS || oscada.org ||
|-
| Live_ALT || Work+LTS || oscada.org ||
|-
| Live_ALT:flash || - || ||
|}

Sub-projects/Automatic Builder of OpenSCADA/en

2026-05-11T12:20:51Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Name !! Founded !! Status !! Members
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Automatic Builder of OpenSCADA]] || May 2015 ||
Implemented in scripts of the building, repositories and branches processing and targets checking for building for up to 100 targets by: CHROOTs of the Linux repositories, VPS and different sub-environments.
As the result of the Builder work is: [http://oscada.org/main/download/ the fresh and signed packages repositories of Linux, Live Disk images and other binary archives of OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Roman Savochenko]]
|-
! colspan="5" | Description
|-
| colspan="5" | The sub-project is aimed to make easy the project OpenSCADA distribution through automatic building the binary packages, their ready to use repositories and other complex distributives like to Live Disks.
* '''[http://oscada.org/en/development/tasks/posts/core/the_automatic_openscada_builder/ Managing Task]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|How to Live Disk]]'''
* '''State of the support''': Called manually after committing SVN-changes for general build on the server via ''oscadaCheck'' and home PC for new environments via ''oscadaCheck_ExtGen'', and automatically at the beginning of an hour for "Raspbian" targets on RPi3 via ''oscadaCheck_RPi''.
|}

The builder is represented by two common BASH-scripts and several checking BASH-scripts:
* '''oscadaCheck*''' — simple scripts with list the building profiles for checking in ''oscadaRepBranches'' and depending on the building host; they are started typically by the CRON schedule for night builds or manually. Known currently profiles list corresponding to Table 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — generic one used on the OpenSCADA server;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — additional generic one used on the OpenSCADA server at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — external generic one used on the Author Home PC;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — additional external generic one used on the Author Home PC at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — external "Raspbian" targets' one used on the Author RPi;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — additional external "Raspbian" targets' one used on the Author RPi at the new LTS version release.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — for processing of the profiles list pointed in the command line and in the format "'''{Target}[:option[,optionN]][ =]{EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", where:
** "EN"{0|1} — enabling the target;
** "ForWork"{0|1} — enabling to build for the Work branch;
** "ForLTS"{0|1} — enabling to build for generic updates of the LTS branch;
** "ForLTSServ"{0|1} — enabling to build for service updates of the LTS branch;
** "OmitSourceTree"{0|1} — omit the source tree download from SVN, mostly for building the live images.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — for building and placing the result packages and other for the OpenSCADA's LTS or Work branches.

Files structure of the automation building system means:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => work building folder, which contains the unpacked CHROOTs
| | |-- log/ => logs of the builds
| | \-- *.stamp => stamps of the successful builds
| \-- chroot-data.tgz => contains the GPG singing key for the packages and their repositories of the builder
\-- share_res/
\-- ftp/ => FTP-folder of the building results
|-- {Debian,ALTLinux}/ => folders of the repositories of the Automation Linux distributive
|-- Misc/
| \-- chroots/ => folder of the archives of the CHROOTs of the building
\-- OpenSCADA/ => folders of the repositories of OpenSCADA
|-- LTS/ => folders of the LTS repositories of OpenSCADA
\-- Work/ => folders of the Work repositories of OpenSCADA
</pre>

The automatic building system supports also its distribution at specific environments (for some building types) like to different hardware platforms, instead their CHROOTs sometime. The distribution is performed by moving part of the automatic builder outward by: deploying the bottom file structure only for needed targets, organization for the local file server and scheduling the sync script [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] on the automatic builder core (say [[User:RomanSavochenko|Roman Savochenko]] for) — the main FTP-server.

Currently the automatic builder means for automatic building:
* The Work version (1) for the last SVN-revision with the tag "(stable)";
* The LTS version (0.9.U.S) for generic (U) and service (S) update.

For Author's buildings, the specified scrips adapted to work with the FTP-folder of the building results directly on the OpenSCADA server by help '''sshfs''', and expanded also by options for a possibility of free specifying the SVN-revision to the both branches.

Customization of [https://www.debian.org/devel/debian-live the Debian Live project] for this project:
* ''/usr/lib/live/build/binary_iso'' — appending the argument "-input-charset UTF-8" to the variable XORRISO_OPTIONS for allowing files in UTF-8 on the disk;
* ''/usr/lib/live/build/installer_debian-installer'' — taking from Debian 12 since that one from Debian 13 has errors with build for Debian 10,11.

'''Table 1''': Implemented profiles — the building types.
{| class="wikitable"
! Target !! Result !! Method of the building !! External deploying !! Additional
|-
| SrcTar || Source packages packed as XZ TAR packages || CHROOT "Debian_7_32" || Yes || Updates the OpenSCADA documentation for LTS.
|-
| SrcRPM, CentOs*, SuSE*, Fedora*, ALTLinux*, Mandriva* || RedHat source and binary packages for the hardware architectures x86_32 and x86_64 || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder;
* "dev" — mount the system folders to the CHROOT (/dev, /dev/pts, /proc).
|-
| Debian*, Raspbian*, Ubuntu* || Debian packages for the hardware architectures x86_32, x86_64, ARMHF, ARM64, NATIVE || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada[-{platform}]_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder.
|-
| Nokia* || Debian packages for the hardware architecture ARMEL || [http://www.scratchbox.org/ Scratchbox] || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".
|-
| Gen32PLC*, LP8x81* || TAR packages of the PLC firmwares for the hardware architecture x86_32 || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profiles: "mkimage-profiles-5-plc", "mkimage-profiles-5-plc-LP8x81", "mkimage-profiles-6-plc", "mkimage-profiles-6-plc-LP8x81".<br/>Target options:
* "UI" — include User Interface, for ALTLinux 5 only;
* "rt1" — use the kernel "rt1-up", for ALTLinux 6.
|-
| Live_ALT || Hybrid ISO image or TAR package of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux|the Automation Linux distributive based on ALTLinux]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profile "mkimage-profiles-6-kdesktop".<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".<br/>Target options:
* "flash" — build the TAR package instead the ISO image.
|-
| Live_Deb || Hybrid ISO image of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian|the Automation Linux distributive based on Debian]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]]; home.home || No || Uses [https://www.debian.org/devel/debian-live/ Live Build profiles] of Debian: live7-32, live7-64, live8-32, live8-64, live9-32, live9-64, live10-32, live10-64, live11-32, live11-64.<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".
|-
| ICP_DAS_LP_ARM, SMH2Gi || TAR packages of the PLC firmwares for the hardware architecture ARM. || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]] + TOOLCHAIN || No || Uses the proper TOOLCHAINs.
|}

'''Table 2''': The actual building targets (on 01.01.7531/01.03.2023).
{| class="wikitable"
! Target(s) !! OpenSCADA !! Host !! Notes
|-
| SrcTar || Work+LTS || oscada.org ||
|-
| SrcRPM || LTS || oscada.org ||

|-
| colspan="4" | ''Debian''
|-
| Debian_13_{32,64,armhf,arm64} || - || ||
|-
| Debian_13_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_12_{32,64,armhf,arm64} || - || ||
|-
| Debian_12_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_11_{32,64,armhf,arm64} || - || ||
|-
| Debian_11_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_10_{32,64,armhf} || - || ||
|-
| Debian_10_{32,64,armhf}:rep || Work+LTS || home.home ||
|-
| Debian_9_{32,64,armhf} || - || ||
|-
| Debian_9_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_8_{32,64,armhf} || - || ||
|-
| Debian_8_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_7_{32,64} || - || ||
|-
| Debian_7_{32,64}:rep || Work+LTS || oscada.org ||
|-
| Debian_6_{32,64} || - || ||

|-
| colspan="4" | ''Raspbian, the same Debian but for [https://www.raspberrypi.org/ Raspberry Pi] — a very specific ARMv6 environment for the BCM2835 and early chips mostly.''
|-
| Raspbian_9_native || Work+LTS || pi.home ||
|-
| Raspbian_8_native || LTS || pi.home ||

|-
| colspan="4" | ''Ubuntu''
|-
| Ubuntu_26.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_24.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_22.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_20.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_18.04_{32,64} || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org
|-
| Ubuntu_16.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_14.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_12.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_11.10_{32,64} || - || ||
|-
| Ubuntu_10.04_{32,64} || - || ||

|-
| colspan="4" | ''CentOs''
|-
| CentOs_8_64:dev || Work+LTS || home.home ||
|-
| CentOs_7_64 || LTS || oscada.org ||
|-
| CentOs_6_{32,64} || LTS || oscada.org ||

|-
| colspan="4" | ''SuSE''
|-
| SuSE_15_64:dev || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org. GPG2 needs for mounting the system folders.
|-
| SuSE_13_{32,64} || LTS || oscada.org ||
|-
| SuSE_12_{32,64} || LTS || oscada.org ||
|-
| SuSE_11_{32,64} || - || ||

|-
| colspan="4" | ''ALTLinux''
|-
| ALTLinux_7_{32,64} || - || ||
|-
| ALTLinux_7_{32,64}:rep || LTS || oscada.org ||
|-
| ALTLinux_6_{32,64} || - || ||
|-
| ALTLinux_6_{32,64}:rep || Work+LTS || oscada.org ||
|-
| ALTLinux_5_{32,64} || - || ||
|-
| ALTLinux_5_{32,64}:rep || - || ||

|-
| colspan="4" | ''Fedora''
|-
| Fedora_12_32 || LTS || oscada.org ||

|-
| colspan="4" | ''Mandriva''
|-
| Mandriva_2011_{32,64} || - || ||
|-
| Mandriva_2010_{32,64} || - || ||

|-
| colspan="4" | ''Nokia''
|-
| Nokia_800 || LTS || oscada.org ||
|-
| Nokia_900 || Work+LTS || oscada.org ||
|-
| Nokia_950 || LTS || oscada.org ||

|-
| colspan="4" | ''PLC+Embedded''
|-
| Gen32PLC_ALT6 || LTS || oscada.org ||
|-
| Gen32PLC_ALT6:rt1 || LTS || oscada.org ||
|-
| Gen32PLC_ALT5 || - || ||
|-
| Gen32PLC_ALT5:UI || - || ||
|-
| LP8x81_ALT6 || LTS || oscada.org ||
|-
| LP8x81_ALT6:rt1 || LTS || oscada.org ||
|-
| LP8x81_ALT5 || - || ||
|-
| LP8x81_ALT5:UI || - || ||
|-
| SMH2Gi || LTS || oscada.org ||
|-
| ICP_DAS_LP_ARM || - || ||
|-
| TionPro270 || - || ||

|-
| colspan="4" | ''Live''
|-
| Live_Deb13_64 || Work+LTS || home.home ||
|-
| Live_Deb12_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb11_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb10_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb9_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb8_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb7_{32,64} || Work+LTS || oscada.org ||
|-
| Live_ALT || Work+LTS || oscada.org ||
|-
| Live_ALT:flash || - || ||
|}

Translations:Sub-projects/Automatic Builder of OpenSCADA/3/en

2026-05-11T12:20:47Z

FuzzyBot: Importing a new version from external source

Files structure of the automation building system means:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => work building folder, which contains the unpacked CHROOTs
| | |-- log/ => logs of the builds
| | \-- *.stamp => stamps of the successful builds
| \-- chroot-data.tgz => contains the GPG singing key for the packages and their repositories of the builder
\-- share_res/
\-- ftp/ => FTP-folder of the building results
|-- {Debian,ALTLinux}/ => folders of the repositories of the Automation Linux distributive
|-- Misc/
| \-- chroots/ => folder of the archives of the CHROOTs of the building
\-- OpenSCADA/ => folders of the repositories of OpenSCADA
|-- LTS/ => folders of the LTS repositories of OpenSCADA
\-- Work/ => folders of the Work repositories of OpenSCADA
</pre>

Translations:Sub-projects/Automatic Builder of OpenSCADA/4/en

2026-05-11T12:20:47Z

FuzzyBot: Importing a new version from external source

The automatic building system supports also its distribution at specific environments (for some building types) like to different hardware platforms, instead their CHROOTs sometime. The distribution is performed by moving part of the automatic builder outward by: deploying the bottom file structure only for needed targets, organization for the local file server and scheduling the sync script [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] on the automatic builder core (say [[User:RomanSavochenko|Roman Savochenko]] for) — the main FTP-server.

Translations:Sub-projects/Automatic Builder of OpenSCADA/9/en

2026-05-11T12:20:47Z

FuzzyBot: Importing a new version from external source

For Author's buildings, the specified scrips adapted to work with the FTP-folder of the building results directly on the OpenSCADA server by help '''sshfs''', and expanded also by options for a possibility of free specifying the SVN-revision to the both branches.

Sub-projects/Automatic Builder of OpenSCADA/en

2026-05-11T11:51:24Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Name !! Founded !! Status !! Members
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Automatic Builder of OpenSCADA]] || May 2015 ||
Implemented in scripts of the building, repositories and branches processing and targets checking for building for up to 100 targets by: CHROOTs of the Linux repositories, VPS and different sub-environments.
As the result of the Builder work is: [http://oscada.org/main/download/ the fresh and signed packages repositories of Linux, Live Disk images and other binary archives of OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Roman Savochenko]]
|-
! colspan="5" | Description
|-
| colspan="5" | The sub-project is aimed to make easy the project OpenSCADA distribution through automatic building the binary packages, their ready to use repositories and other complex distributives like to Live Disks.
* '''[http://oscada.org/en/development/tasks/posts/core/the_automatic_openscada_builder/ Managing Task]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|How to Live Disk]]'''
* '''State of the support''': Called manually after committing SVN-changes for general build on the server via ''oscadaCheck'' and home PC for new environments via ''oscadaCheck_ExtGen'', and automatically at the beginning of an hour for "Raspbian" targets on RPi3 via ''oscadaCheck_RPi''.
|}

The builder is represented by two common BASH-scripts and several checking BASH-scripts:
* '''oscadaCheck*''' — simple scripts with list the building profiles for checking in ''oscadaRepBranches'' and depending on the building host; they are started typically by the CRON schedule for night builds or manually. Known currently profiles list corresponding to Table 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — generic one used on the OpenSCADA server;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — additional generic one used on the OpenSCADA server at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — external generic one used on the Author Home PC;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — additional external generic one used on the Author Home PC at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — external "Raspbian" targets' one used on the Author RPi;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — additional external "Raspbian" targets' one used on the Author RPi at the new LTS version release.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — for processing of the profiles list pointed in the command line and in the format "'''{Target}[:option[,optionN]][ =]{EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", where:
** "EN"{0|1} — enabling the target;
** "ForWork"{0|1} — enabling to build for the Work branch;
** "ForLTS"{0|1} — enabling to build for generic updates of the LTS branch;
** "ForLTSServ"{0|1} — enabling to build for service updates of the LTS branch;
** "OmitSourceTree"{0|1} — omit the source tree download from SVN, mostly for building the live images.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — for building and placing the result packages and other for the OpenSCADA's LTS or Work branches.

Files structure of the automation building system means:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => work building folder, which contains the unpacked CHROOTs
| | |-- log/ => logs of the builds
| | \-- *.stamp => stamps of the successful builds
| \-- chroot-data.tgz => contains the GPG singing key for the packages and their repositories of the builder
\-- share_res/
\-- ftp/ => FTP folder of the building results
|-- {ALTLinux,Debian}/ => Folders of the repositories of the Automation Linux distributive
|-- Misc/
| \-- chroots/ => Folder of the archives of the CHROOTs of the building
\-- OpenSCADA/ => Folders of the repositories of OpenSCADA
|-- LTS/ => Folders of the LTS repositories of OpenSCADA
\-- Work/ => Folders of the Work repositories of OpenSCADA
</pre>

The automatic building system supports also its distribution at specific environments (for some building types) like to different hardware platforms, instead their CHROOTs sometime. The distribution is performed by moving part of the automatic builder outward by: deploying the bottom file structure only for needed targets, organization for the local file server and scheduling the sync script [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] on the automatic builder core (say [[User:RomanSavochenko|Roman Savochenko]] for) — main FTP-server.

Currently the automatic builder means for automatic building:
* The Work version (1) for the last SVN-revision with the tag "(stable)";
* The LTS version (0.9.U.S) for generic (U) and service (S) update.

Customization of [https://www.debian.org/devel/debian-live the Debian Live project] for this project:
* ''/usr/lib/live/build/binary_iso'' — appending the argument "-input-charset UTF-8" to the variable XORRISO_OPTIONS for allowing files in UTF-8 on the disk;
* ''/usr/lib/live/build/installer_debian-installer'' — taking from Debian 12 since that one from Debian 13 has errors with build for Debian 10,11.

'''Table 1''': Implemented profiles — the building types.
{| class="wikitable"
! Target !! Result !! Method of the building !! External deploying !! Additional
|-
| SrcTar || Source packages packed as XZ TAR packages || CHROOT "Debian_7_32" || Yes || Updates the OpenSCADA documentation for LTS.
|-
| SrcRPM, CentOs*, SuSE*, Fedora*, ALTLinux*, Mandriva* || RedHat source and binary packages for the hardware architectures x86_32 and x86_64 || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder;
* "dev" — mount the system folders to the CHROOT (/dev, /dev/pts, /proc).
|-
| Debian*, Raspbian*, Ubuntu* || Debian packages for the hardware architectures x86_32, x86_64, ARMHF, ARM64, NATIVE || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada[-{platform}]_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder.
|-
| Nokia* || Debian packages for the hardware architecture ARMEL || [http://www.scratchbox.org/ Scratchbox] || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".
|-
| Gen32PLC*, LP8x81* || TAR packages of the PLC firmwares for the hardware architecture x86_32 || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profiles: "mkimage-profiles-5-plc", "mkimage-profiles-5-plc-LP8x81", "mkimage-profiles-6-plc", "mkimage-profiles-6-plc-LP8x81".<br/>Target options:
* "UI" — include User Interface, for ALTLinux 5 only;
* "rt1" — use the kernel "rt1-up", for ALTLinux 6.
|-
| Live_ALT || Hybrid ISO image or TAR package of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux|the Automation Linux distributive based on ALTLinux]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profile "mkimage-profiles-6-kdesktop".<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".<br/>Target options:
* "flash" — build the TAR package instead the ISO image.
|-
| Live_Deb || Hybrid ISO image of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian|the Automation Linux distributive based on Debian]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]]; home.home || No || Uses [https://www.debian.org/devel/debian-live/ Live Build profiles] of Debian: live7-32, live7-64, live8-32, live8-64, live9-32, live9-64, live10-32, live10-64, live11-32, live11-64.<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".
|-
| ICP_DAS_LP_ARM, SMH2Gi || TAR packages of the PLC firmwares for the hardware architecture ARM. || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]] + TOOLCHAIN || No || Uses the proper TOOLCHAINs.
|}

'''Table 2''': The actual building targets (on 01.01.7531/01.03.2023).
{| class="wikitable"
! Target(s) !! OpenSCADA !! Host !! Notes
|-
| SrcTar || Work+LTS || oscada.org ||
|-
| SrcRPM || LTS || oscada.org ||

|-
| colspan="4" | ''Debian''
|-
| Debian_13_{32,64,armhf,arm64} || - || ||
|-
| Debian_13_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_12_{32,64,armhf,arm64} || - || ||
|-
| Debian_12_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_11_{32,64,armhf,arm64} || - || ||
|-
| Debian_11_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_10_{32,64,armhf} || - || ||
|-
| Debian_10_{32,64,armhf}:rep || Work+LTS || home.home ||
|-
| Debian_9_{32,64,armhf} || - || ||
|-
| Debian_9_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_8_{32,64,armhf} || - || ||
|-
| Debian_8_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_7_{32,64} || - || ||
|-
| Debian_7_{32,64}:rep || Work+LTS || oscada.org ||
|-
| Debian_6_{32,64} || - || ||

|-
| colspan="4" | ''Raspbian, the same Debian but for [https://www.raspberrypi.org/ Raspberry Pi] — a very specific ARMv6 environment for the BCM2835 and early chips mostly.''
|-
| Raspbian_9_native || Work+LTS || pi.home ||
|-
| Raspbian_8_native || LTS || pi.home ||

|-
| colspan="4" | ''Ubuntu''
|-
| Ubuntu_26.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_24.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_22.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_20.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_18.04_{32,64} || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org
|-
| Ubuntu_16.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_14.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_12.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_11.10_{32,64} || - || ||
|-
| Ubuntu_10.04_{32,64} || - || ||

|-
| colspan="4" | ''CentOs''
|-
| CentOs_8_64:dev || Work+LTS || home.home ||
|-
| CentOs_7_64 || LTS || oscada.org ||
|-
| CentOs_6_{32,64} || LTS || oscada.org ||

|-
| colspan="4" | ''SuSE''
|-
| SuSE_15_64:dev || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org. GPG2 needs for mounting the system folders.
|-
| SuSE_13_{32,64} || LTS || oscada.org ||
|-
| SuSE_12_{32,64} || LTS || oscada.org ||
|-
| SuSE_11_{32,64} || - || ||

|-
| colspan="4" | ''ALTLinux''
|-
| ALTLinux_7_{32,64} || - || ||
|-
| ALTLinux_7_{32,64}:rep || LTS || oscada.org ||
|-
| ALTLinux_6_{32,64} || - || ||
|-
| ALTLinux_6_{32,64}:rep || Work+LTS || oscada.org ||
|-
| ALTLinux_5_{32,64} || - || ||
|-
| ALTLinux_5_{32,64}:rep || - || ||

|-
| colspan="4" | ''Fedora''
|-
| Fedora_12_32 || LTS || oscada.org ||

|-
| colspan="4" | ''Mandriva''
|-
| Mandriva_2011_{32,64} || - || ||
|-
| Mandriva_2010_{32,64} || - || ||

|-
| colspan="4" | ''Nokia''
|-
| Nokia_800 || LTS || oscada.org ||
|-
| Nokia_900 || Work+LTS || oscada.org ||
|-
| Nokia_950 || LTS || oscada.org ||

|-
| colspan="4" | ''PLC+Embedded''
|-
| Gen32PLC_ALT6 || LTS || oscada.org ||
|-
| Gen32PLC_ALT6:rt1 || LTS || oscada.org ||
|-
| Gen32PLC_ALT5 || - || ||
|-
| Gen32PLC_ALT5:UI || - || ||
|-
| LP8x81_ALT6 || LTS || oscada.org ||
|-
| LP8x81_ALT6:rt1 || LTS || oscada.org ||
|-
| LP8x81_ALT5 || - || ||
|-
| LP8x81_ALT5:UI || - || ||
|-
| SMH2Gi || LTS || oscada.org ||
|-
| ICP_DAS_LP_ARM || - || ||
|-
| TionPro270 || - || ||

|-
| colspan="4" | ''Live''
|-
| Live_Deb13_64 || Work+LTS || home.home ||
|-
| Live_Deb12_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb11_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb10_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb9_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb8_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb7_{32,64} || Work+LTS || oscada.org ||
|-
| Live_ALT || Work+LTS || oscada.org ||
|-
| Live_ALT:flash || - || ||
|}

Translations:Sub-projects/Automatic Builder of OpenSCADA/1/en

2026-05-11T11:51:21Z

FuzzyBot: Importing a new version from external source

{| class="wikitable"
|-
! Name !! Founded !! Status !! Members
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Automatic Builder of OpenSCADA]] || May 2015 ||
Implemented in scripts of the building, repositories and branches processing and targets checking for building for up to 100 targets by: CHROOTs of the Linux repositories, VPS and different sub-environments.
As the result of the Builder work is: [http://oscada.org/main/download/ the fresh and signed packages repositories of Linux, Live Disk images and other binary archives of OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Roman Savochenko]]
|-
! colspan="5" | Description
|-
| colspan="5" | The sub-project is aimed to make easy the project OpenSCADA distribution through automatic building the binary packages, their ready to use repositories and other complex distributives like to Live Disks.
* '''[http://oscada.org/en/development/tasks/posts/core/the_automatic_openscada_builder/ Managing Task]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|How to Live Disk]]'''
* '''State of the support''': Called manually after committing SVN-changes for general build on the server via ''oscadaCheck'' and home PC for new environments via ''oscadaCheck_ExtGen'', and automatically at the beginning of an hour for "Raspbian" targets on RPi3 via ''oscadaCheck_RPi''.
|}

Translations:Sub-projects/Automatic Builder of OpenSCADA/2/en

2026-05-11T11:51:21Z

FuzzyBot: Importing a new version from external source

The builder is represented by two common BASH-scripts and several checking BASH-scripts:
* '''oscadaCheck*''' — simple scripts with list the building profiles for checking in ''oscadaRepBranches'' and depending on the building host; they are started typically by the CRON schedule for night builds or manually. Known currently profiles list corresponding to Table 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — generic one used on the OpenSCADA server;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — additional generic one used on the OpenSCADA server at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — external generic one used on the Author Home PC;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — additional external generic one used on the Author Home PC at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — external "Raspbian" targets' one used on the Author RPi;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — additional external "Raspbian" targets' one used on the Author RPi at the new LTS version release.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — for processing of the profiles list pointed in the command line and in the format "'''{Target}[:option[,optionN]][ =]{EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", where:
** "EN"{0|1} — enabling the target;
** "ForWork"{0|1} — enabling to build for the Work branch;
** "ForLTS"{0|1} — enabling to build for generic updates of the LTS branch;
** "ForLTSServ"{0|1} — enabling to build for service updates of the LTS branch;
** "OmitSourceTree"{0|1} — omit the source tree download from SVN, mostly for building the live images.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — for building and placing the result packages and other for the OpenSCADA's LTS or Work branches.

Sub-projects/Automatic Builder of OpenSCADA/uk

2026-05-10T14:57:06Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Назва !! Заснування !! Стан !! Учасники
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Автоматичний Складальник OpenSCADA]] || Березень 2015 ||
Імплементовано у скриптах побудови, опрацювання репозиторіїв і гілок та перевірки цілей щодо складання до 100 цілей за допомогою: CHROOTів репозиторіїв Linux, VPS та різних під-оточень. Результатом функціонування Складальника є: [http://oscada.org/main/download/ свіжі та підписані репозиторії Linux, штампи Live Дисків та інші бінарні архіви OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Роман Савоченко]]
|-
! colspan="5" | Опис
|-
| colspan="5" | Спрямуванням підпроєкту є спрощення розповсюдження-дистриб'юції проєкту OpenSCADA через автоматичне складання бінарних пакетів, їх готових до використання репозиторіїв та інших складних дистрибутивів на кшталт Живих Дисків.
* '''[http://oscada.org/ua/rozrobka/zavdannja/posts/core/the_automatic_openscada_builder/ Завдання Керування]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Linux дистрибутив автоматизації проєкту OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|Як створити Живий Диск]]'''
* '''Стан підтримки''': Викликається вручну після вивантаження SVN-змін для загального складання на сервері через ''oscadaCheck'' та домашньому ПК щодо нових оточень через ''oscadaCheck_ExtGen'', а також автоматично на початку години для "Raspbian" цілей на RPi3 через ''oscadaCheck_RPi''.
|}

Складач представлено двома загальними BASH-скриптами та декільком BASH-скриптами перевірки:
* '''oscadaCheck*''' — дуже прості скрипти із переліком профілів складання для перевірки ''oscadaRepBranches'' та у залежності від хосту складання; вони запускаються зазвичай CRON планувальником, для нічних складань, або вручну. Відомий наразі перелік профілів відповідно до Таблиці 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — загальний, використовується на OpenSCADA сервері;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — додатковий загальний, використовується на OpenSCADA сервері при новому випуску LTS версії;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — зовнішній загальний, використовується на Домашньому ПК Автора;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — додатковий зовнішній загальний, використовується на Домашньому ПК Автора при новому випуску LTS версії;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — зовнішні "Raspbian" цілі, використовується на RPi3 Автора;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — додаткові зовнішні "Raspbian" цілі, використовується на RPi3 Автора при новому випуску LTS версії.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — для опрацювання переліку профілів вказаних у командному рядку у форматі "'''{Target}[:option[,optionN]] {EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", де:
** "EN"{0|1} — увімкнення цілі;
** "ForWork"{0|1} — включення до складання для Робочої (Work) гілки;
** "ForLTS"{0|1} — включення до складання для загальних оновлень Стабільної (LTS) гілки;
** "ForLTSServ"{0|1} — включення до складання для сервісних оновлень Стабільної (LTS) гілки;
** "OmitSourceTree"{0|1} — оминати завантаження дерева вихідних із SVN, переважно для складання Живих штампів.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — для складання та розміщення результатних пакетів і іншого для Стабільної (LTS) та Робочої (Work) гілок OpenSCADA.

Структура файлів системи автоматичного складання передбачає:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => робоча тека складання, яка містить розпаковані CHROOTи
| | |-- log/ => протоколи складань
| | \-- *.stamp => штампи-ознаки вдалих складань
| \-- chroot-data.tgz => містить GPG ключ підпису пакетів та їх репозиторіїв для складальника
\-- share_res/
\-- ftp/ => FTP тека результатів складання
|-- {ALTLinux,Debian}/ => Теки репозиторіїв Linux Дистрибутивів Автоматизації
|-- Misc/
| \-- chroots/ => Тека архівів складальних CHROOTів
\-- OpenSCADA/ => Теки репозиторіїв OpenSCADA
|-- LTS/ => Теки Стабільних (LTS) репозиторіїв OpenSCADA
\-- Work/ => Теки Робочих (Work) репозиторіїв OpenSCADA
</pre>

Автоматична складальна система підтримує також її розподіл за специфічними оточеннями (для деяких типів складання) на кшталт різних апаратних платформ, інколи замість їх CHROOTів. Розподіл відбувається перенесенням частини автоматичного складальника назовні шляхом: розгортання структури на горі лише для потрібних цілей, організації локального файлового серверу та планування синхронізації скрипту [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] на ядрі автоматичного складальника (скажіть [[User:RomanSavochenko|Роману Савоченко]] щодо цього) — основний FTP-сервер.

Наразі автоматичний складальник передбачає складання:
* Робочої (Work) версії (1) щодо останньої SVN-ревізії із тегом "(stable)";
* Стабільної (LTS) версії (0.9.U.S) щодо загального (U) та сервісного (S) оновлення.

Customization of [https://www.debian.org/devel/debian-live the Debian Live project] for this project:
* ''/usr/lib/live/build/binary_iso'' — appending the argument "-input-charset UTF-8" to the variable XORRISO_OPTIONS for allowing files in UTF-8 on the disk;
* ''/usr/lib/live/build/installer_debian-installer'' — taking from Debian 12 since that one from Debian 13 has errors with build for Debian 10,11.

'''Table 1''': Реалізовані профілі — типи складання.
{| class="wikitable"
! Ціль !! Результат !! Метод складання !! Зовнішнє розгортання !! Додаткове
|-
| SrcTar || Пакети вихідних, запаковані XZ TAR пакетами || CHROOT "Debian_7_32" || Так || Оновлює документацію OpenSCADA для LTS.
|-
| SrcRPM, CentOs*, SuSE*, Fedora*, ALTLinux*, Mandriva* || Вихідні та бінарні RedHat пакети для апаратних архітектур x86_32 і x86_64 || CHROOT || Так || Допускає підлаштування до специфіки латками "openscada_*.patch".<br/>Викликом наданого сценарію "reposUpdate" у теці результатів, репозиторії пакетів можуть бути: створені, оновлені, підписані щодо пакетів та репозиторію загалом.<br/>Цільові параметри:
* "rep" — до теки репозиторію замість теки OpenSCADA;
* "dev" — монтувати системні теки до CHROOT (/dev, /dev/pts, /proc).
|-
| Debian*, Raspbian*, Ubuntu* || Пакети Debian для апаратних архітектур x86_32, x86_64, ARMHF, ARM64, NATIVE || CHROOT || Так || Допускає підлаштування до специфіки латками "openscada[-{platform}]_*.patch".<br/>Викликом наданого сценарію "reposUpdate" у теці результатів, репозиторії пакетів можуть бути: створені, оновлені, підписані щодо пакетів та репозиторію загалом.<br/>Цільові параметри:
* "rep" — до теки репозиторію замість теки OpenSCADA.
|-
| Nokia* || Пакети Debian для апаратної архітектури ARMEL || [http://www.scratchbox.org/ Scratchbox] || Так || Допускає підлаштування до специфіки латками "openscada_*.patch".
|-
| Gen32PLC*, LP8x81* || TAR пакети прошивок ПЛК для архітектури x86_32 || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || Ні || Використовує mkimage профілі ALTLinux: "mkimage-profiles-5-plc", "mkimage-profiles-5-plc-LP8x81", "mkimage-profiles-6-plc", "mkimage-profiles-6-plc-LP8x81".<br/>Цільові параметри:
* "UI" — включити Користувацький Інтерфейс, лише для ALTLinux 5;
* "rt1" — використати ядро "rt1-up", для ALTLinux 6.
|-
| Live_ALT || Гібридний ISO штамп або TAR пакет Живого Диску [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux|Linux дистрибутиву Автоматизації заснованого на ALTLinux]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || Ні || Використовує ALTLinux mkimage профіль "mkimage-profiles-6-kdesktop".<br/>Оновлює MD5SUM ISO штампів у файлі "MD5SUM".<br/>Цільові параметри:
* "flash" — скласти TAR пакет замість ISO штампу.
|-
| Live_Deb || Гібридний ISO штамп Живого Диску [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian|Linux дистрибутиву Автоматизації заснованого на Debian]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]]; home.home || Ні || Використовує [https://www.debian.org/devel/debian-live/ профілі Живої Побудови] Debian: live7-32, live7-64, live8-32, live8-64, live9-32, live9-64, live10-32, live10-64, live11-32, live11-64.<br/>Оновлює MD5SUM ISO штампів у файлі "MD5SUM".
|-
| ICP_DAS_LP_ARM, SMH2Gi || TAR пакети прошивок ПЛК для апаратної архітектури ARM. || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]] + TOOLCHAIN || Ні || Використовує відповідні TOOLCHAINs.
|}

'''Таблиця 2''': Актуальні цілі складання (на 01.01.7531/01.03.2023).
{| class="wikitable"
! Ціль(і) !! OpenSCADA !! Хост !! Примітки
|-
| SrcTar || Work+LTS || oscada.org ||
|-
| SrcRPM || LTS || oscada.org ||

|-
| colspan="4" | ''Debian''
|-
| Debian_13_{32,64,armhf,arm64} || - || ||
|-
| Debian_13_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_12_{32,64,armhf,arm64} || - || ||
|-
| Debian_12_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_11_{32,64,armhf,arm64} || - || ||
|-
| Debian_11_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_10_{32,64,armhf} || - || ||
|-
| Debian_10_{32,64,armhf}:rep || Work+LTS || home.home ||
|-
| Debian_9_{32,64,armhf} || - || ||
|-
| Debian_9_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_8_{32,64,armhf} || - || ||
|-
| Debian_8_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_7_{32,64} || - || ||
|-
| Debian_7_{32,64}:rep || Work+LTS || oscada.org ||
|-
| Debian_6_{32,64} || - || ||

|-
| colspan="4" | ''Raspbian, the same Debian but for [https://www.raspberrypi.org/ Raspberry Pi] — a very specific ARMv6 environment for the BCM2835 and early chips mostly.''
|-
| Raspbian_9_native || Work+LTS || pi.home ||
|-
| Raspbian_8_native || LTS || pi.home ||

|-
| colspan="4" | ''Ubuntu''
|-
| Ubuntu_26.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_24.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_22.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_20.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_18.04_{32,64} || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org
|-
| Ubuntu_16.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_14.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_12.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_11.10_{32,64} || - || ||
|-
| Ubuntu_10.04_{32,64} || - || ||

|-
| colspan="4" | ''CentOs''
|-
| CentOs_8_64:dev || Work+LTS || home.home ||
|-
| CentOs_7_64 || LTS || oscada.org ||
|-
| CentOs_6_{32,64} || LTS || oscada.org ||

|-
| colspan="4" | ''SuSE''
|-
| SuSE_15_64:dev || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org. GPG2 needs for mounting the system folders.
|-
| SuSE_13_{32,64} || LTS || oscada.org ||
|-
| SuSE_12_{32,64} || LTS || oscada.org ||
|-
| SuSE_11_{32,64} || - || ||

|-
| colspan="4" | ''ALTLinux''
|-
| ALTLinux_7_{32,64} || - || ||
|-
| ALTLinux_7_{32,64}:rep || LTS || oscada.org ||
|-
| ALTLinux_6_{32,64} || - || ||
|-
| ALTLinux_6_{32,64}:rep || Work+LTS || oscada.org ||
|-
| ALTLinux_5_{32,64} || - || ||
|-
| ALTLinux_5_{32,64}:rep || - || ||

|-
| colspan="4" | ''Fedora''
|-
| Fedora_12_32 || LTS || oscada.org ||

|-
| colspan="4" | ''Mandriva''
|-
| Mandriva_2011_{32,64} || - || ||
|-
| Mandriva_2010_{32,64} || - || ||

|-
| colspan="4" | ''Nokia''
|-
| Nokia_800 || LTS || oscada.org ||
|-
| Nokia_900 || Work+LTS || oscada.org ||
|-
| Nokia_950 || LTS || oscada.org ||

|-
| colspan="4" | ''PLC+Embedded''
|-
| Gen32PLC_ALT6 || LTS || oscada.org ||
|-
| Gen32PLC_ALT6:rt1 || LTS || oscada.org ||
|-
| Gen32PLC_ALT5 || - || ||
|-
| Gen32PLC_ALT5:UI || - || ||
|-
| LP8x81_ALT6 || LTS || oscada.org ||
|-
| LP8x81_ALT6:rt1 || LTS || oscada.org ||
|-
| LP8x81_ALT5 || - || ||
|-
| LP8x81_ALT5:UI || - || ||
|-
| SMH2Gi || LTS || oscada.org ||
|-
| ICP_DAS_LP_ARM || - || ||
|-
| TionPro270 || - || ||

|-
| colspan="4" | ''Live''
|-
| Live_Deb13_64 || Work+LTS || home.home ||
|-
| Live_Deb12_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb11_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb10_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb9_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb8_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb7_{32,64} || Work+LTS || oscada.org ||
|-
| Live_ALT || Work+LTS || oscada.org ||
|-
| Live_ALT:flash || - || ||
|}

Sub-projects/Automatic Builder of OpenSCADA/en

2026-05-10T14:57:03Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Name !! Founded !! Status !! Members
|-
<section begin=info />
| [[Special:MyLanguage/Sub-projects/Automatic Builder of OpenSCADA|Automatic Builder of OpenSCADA]] || May 2015 ||
Implemented in scripts of the building, repositories and branches processing and targets checking for building for up to 100 targets by: CHROOTs of the Linux repositories, VPS and different sub-environments.
As the result of the Builder work is: [http://oscada.org/main/download/ the fresh and signed packages repositories of Linux, Live Disk images and other binary archives of OpenSCADA].
<section end=info />
| [[User:RomanSavochenko|Roman Savochenko]]
|-
! colspan="5" | Description
|-
| colspan="5" | The sub-project is aimed to make easy the project OpenSCADA distribution through automatic building the binary packages, their ready to use repositories and other complex distributives like to Live Disks.
* '''[http://oscada.org/en/development/tasks/posts/core/the_automatic_openscada_builder/ Managing Task]'''
* '''[[Special:MyLanguage/Sub-projects/Automation_Linux_distributive|Automation Linux distributive of the project OpenSCADA]]'''
* '''[[Special:MyLanguage/Documents/How_to/Live_disk|How to Live Disk]]'''
* '''State of the support''': Called manually after committing SVN-changes for general build on the server via ''oscadaCheck'' and home PC for new environments via ''oscadaCheck_ExtGen'', and automatically at the beginning of the hour for "Raspbian" targets on RPi3 via ''oscadaCheck_RPi''.
|}

The builder is represented by two common BASH-scripts and several checking BASH-scripts:
* '''oscadaCheck*''' — very simple scripts with the building profiles list only for checking by ''oscadaRepBranches'' and depending on the building host; they are started typically by the CRON schedule, for night builds, or manually. Known currently profiles list corresponding to Table 2:
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck oscadaCheck] — generic one used on the OpenSCADA server;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_WorkAtLTS oscadaCheck_WorkAtLTS] — additional generic one used on the OpenSCADA server at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen oscadaCheck_ExtGen] — external generic one used on the Author Home PC;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_ExtGen_WorkAtLTS oscadaCheck_ExtGen_WorkAtLTS] — additional external generic one used on the Author Home PC at the new LTS version release;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi oscadaCheck_RPi] — external "Raspbian" targets' one used on the Author RPi3;
** [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaCheck_RPi_WorkAtLTS oscadaCheck_RPi_WorkAtLTS] — additional external "Raspbian" targets' one used on the Author RPi3 at the new LTS version release.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaRepBranches '''oscadaRepBranches'''] — for processing of the profiles list pointed in the command line and in the format "'''{Target}[:option[,optionN]] {EN}{ForWork}{ForLTS}{ForLTSServ}{OmitSourceTree}'''", where:
** "EN"{0|1} — enabling the target;
** "ForWork"{0|1} — enabling to build for the Work branch;
** "ForLTS"{0|1} — enabling to build for generic updates of the LTS branch;
** "ForLTSServ"{0|1} — enabling to build for service updates of the LTS branch;
** "OmitSourceTree"{0|1} — omit the source tree download from SVN, mostly for building the Live images.
* [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaBuild '''oscadaBuild'''] — for building and placing the result packages and other for the OpenSCADA LTS or Work branches.

Files structure of the automation building system means:
<pre style="white-space: pre-wrap;">
\-- /data/
|-- oscada/
| |-- bin/
| | |-- oscadaBuild
| | |-- oscadaRepBranches
| | |-- oscadaCheck
| | \-- oscadaCheck_WorkAtLTS
| |-- build/ => work building folder, which contains the unpacked CHROOTs
| | |-- log/ => logs of the builds
| | \-- *.stamp => stamps of the successful builds
| \-- chroot-data.tgz => contains the GPG singing key for the packages and their repositories of the builder
\-- share_res/
\-- ftp/ => FTP folder of the building results
|-- {ALTLinux,Debian}/ => Folders of the repositories of the Automation Linux distributive
|-- Misc/
| \-- chroots/ => Folder of the archives of the CHROOTs of the building
\-- OpenSCADA/ => Folders of the repositories of OpenSCADA
|-- LTS/ => Folders of the LTS repositories of OpenSCADA
\-- Work/ => Folders of the Work repositories of OpenSCADA
</pre>

The automatic building system supports also its distribution at specific environments (for some building types) like to different hardware platforms, instead their CHROOTs sometime. The distribution is performed by moving part of the automatic builder outward by: deploying the bottom file structure only for needed targets, organization for the local file server and scheduling the sync script [http://oscada.org/svn/trunk/roman_do/Scripts/OpenSCADA/oscadaSyncFtp oscadaSyncFtp] on the automatic builder core (say [[User:RomanSavochenko|Roman Savochenko]] for) — main FTP-server.

Currently the automatic builder means for automatic building:
* The Work version (1) for the last SVN-revision with the tag "(stable)";
* The LTS version (0.9.U.S) for generic (U) and service (S) update.

Customization of [https://www.debian.org/devel/debian-live the Debian Live project] for this project:
* ''/usr/lib/live/build/binary_iso'' — appending the argument "-input-charset UTF-8" to the variable XORRISO_OPTIONS for allowing files in UTF-8 on the disk;
* ''/usr/lib/live/build/installer_debian-installer'' — taking from Debian 12 since that one from Debian 13 has errors with build for Debian 10,11.

'''Table 1''': Implemented profiles — the building types.
{| class="wikitable"
! Target !! Result !! Method of the building !! External deploying !! Additional
|-
| SrcTar || Source packages packed as XZ TAR packages || CHROOT "Debian_7_32" || Yes || Updates the OpenSCADA documentation for LTS.
|-
| SrcRPM, CentOs*, SuSE*, Fedora*, ALTLinux*, Mandriva* || RedHat source and binary packages for the hardware architectures x86_32 and x86_64 || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder;
* "dev" — mount the system folders to the CHROOT (/dev, /dev/pts, /proc).
|-
| Debian*, Raspbian*, Ubuntu* || Debian packages for the hardware architectures x86_32, x86_64, ARMHF, ARM64, NATIVE || CHROOT || Yes || Admits for tuning to the specific by the patches "openscada[-{platform}]_*.patch".<br/>Calling the provided script "reposUpdate" in the results directory there the packages repository can be: created, updated, signed for the packages and the repository in whole.<br/>Target options:
* "rep" — to the repository folder instead OpenSCADA folder.
|-
| Nokia* || Debian packages for the hardware architecture ARMEL || [http://www.scratchbox.org/ Scratchbox] || Yes || Admits for tuning to the specific by the patches "openscada_*.patch".
|-
| Gen32PLC*, LP8x81* || TAR packages of the PLC firmwares for the hardware architecture x86_32 || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profiles: "mkimage-profiles-5-plc", "mkimage-profiles-5-plc-LP8x81", "mkimage-profiles-6-plc", "mkimage-profiles-6-plc-LP8x81".<br/>Target options:
* "UI" — include User Interface, for ALTLinux 5 only;
* "rt1" — use the kernel "rt1-up", for ALTLinux 6.
|-
| Live_ALT || Hybrid ISO image or TAR package of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#ALTLinux|the Automation Linux distributive based on ALTLinux]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_ALTLinux32_builder|VPS: bldrALT32.oscada]] || No || Uses the ALTLinux mkimage profile "mkimage-profiles-6-kdesktop".<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".<br/>Target options:
* "flash" — build the TAR package instead the ISO image.
|-
| Live_Deb || Hybrid ISO image of the Live Disk of [[Special:MyLanguage/Sub-projects/Automation_Linux_distributive#Debian|the Automation Linux distributive based on Debian]] || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]]; home.home || No || Uses [https://www.debian.org/devel/debian-live/ Live Build profiles] of Debian: live7-32, live7-64, live8-32, live8-64, live9-32, live9-64, live10-32, live10-64, live11-32, live11-64.<br/>Updates MD5SUM of the ISO images in the file "MD5SUM".
|-
| ICP_DAS_LP_ARM, SMH2Gi || TAR packages of the PLC firmwares for the hardware architecture ARM. || [[Special:MyLanguage/Sub-projects/Server#VPS:_Debian.7B8.2C9.7D_builder|VPS: bldrDeb8.oscada]] + TOOLCHAIN || No || Uses the proper TOOLCHAINs.
|}

'''Table 2''': The actual building targets (on 01.01.7531/01.03.2023).
{| class="wikitable"
! Target(s) !! OpenSCADA !! Host !! Notes
|-
| SrcTar || Work+LTS || oscada.org ||
|-
| SrcRPM || LTS || oscada.org ||

|-
| colspan="4" | ''Debian''
|-
| Debian_13_{32,64,armhf,arm64} || - || ||
|-
| Debian_13_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_12_{32,64,armhf,arm64} || - || ||
|-
| Debian_12_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_11_{32,64,armhf,arm64} || - || ||
|-
| Debian_11_{32,64,armhf,arm64}:rep || Work+LTS+ServLTS || home.home ||
|-
| Debian_10_{32,64,armhf} || - || ||
|-
| Debian_10_{32,64,armhf}:rep || Work+LTS || home.home ||
|-
| Debian_9_{32,64,armhf} || - || ||
|-
| Debian_9_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_8_{32,64,armhf} || - || ||
|-
| Debian_8_{32,64,armhf}:rep || Work+LTS || oscada.org ||
|-
| Debian_7_{32,64} || - || ||
|-
| Debian_7_{32,64}:rep || Work+LTS || oscada.org ||
|-
| Debian_6_{32,64} || - || ||

|-
| colspan="4" | ''Raspbian, the same Debian but for [https://www.raspberrypi.org/ Raspberry Pi] — a very specific ARMv6 environment for the BCM2835 and early chips mostly.''
|-
| Raspbian_9_native || Work+LTS || pi.home ||
|-
| Raspbian_8_native || LTS || pi.home ||

|-
| colspan="4" | ''Ubuntu''
|-
| Ubuntu_26.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_24.04_{32,64} || Work+LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_22.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_20.04_{32,64} || LTS || home.home || The 32-bit architecture is some limited and there is missing the MariaDB and libphonon4qt5 packages.
|-
| Ubuntu_18.04_{32,64} || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org
|-
| Ubuntu_16.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_14.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_12.04_{32,64} || LTS || oscada.org ||
|-
| Ubuntu_11.10_{32,64} || - || ||
|-
| Ubuntu_10.04_{32,64} || - || ||

|-
| colspan="4" | ''CentOs''
|-
| CentOs_8_64:dev || Work+LTS || home.home ||
|-
| CentOs_7_64 || LTS || oscada.org ||
|-
| CentOs_6_{32,64} || LTS || oscada.org ||

|-
| colspan="4" | ''SuSE''
|-
| SuSE_15_64:dev || LTS || home.home || Very new Linux kernel for CHROOT on oscada.org. GPG2 needs for mounting the system folders.
|-
| SuSE_13_{32,64} || LTS || oscada.org ||
|-
| SuSE_12_{32,64} || LTS || oscada.org ||
|-
| SuSE_11_{32,64} || - || ||

|-
| colspan="4" | ''ALTLinux''
|-
| ALTLinux_7_{32,64} || - || ||
|-
| ALTLinux_7_{32,64}:rep || LTS || oscada.org ||
|-
| ALTLinux_6_{32,64} || - || ||
|-
| ALTLinux_6_{32,64}:rep || Work+LTS || oscada.org ||
|-
| ALTLinux_5_{32,64} || - || ||
|-
| ALTLinux_5_{32,64}:rep || - || ||

|-
| colspan="4" | ''Fedora''
|-
| Fedora_12_32 || LTS || oscada.org ||

|-
| colspan="4" | ''Mandriva''
|-
| Mandriva_2011_{32,64} || - || ||
|-
| Mandriva_2010_{32,64} || - || ||

|-
| colspan="4" | ''Nokia''
|-
| Nokia_800 || LTS || oscada.org ||
|-
| Nokia_900 || Work+LTS || oscada.org ||
|-
| Nokia_950 || LTS || oscada.org ||

|-
| colspan="4" | ''PLC+Embedded''
|-
| Gen32PLC_ALT6 || LTS || oscada.org ||
|-
| Gen32PLC_ALT6:rt1 || LTS || oscada.org ||
|-
| Gen32PLC_ALT5 || - || ||
|-
| Gen32PLC_ALT5:UI || - || ||
|-
| LP8x81_ALT6 || LTS || oscada.org ||
|-
| LP8x81_ALT6:rt1 || LTS || oscada.org ||
|-
| LP8x81_ALT5 || - || ||
|-
| LP8x81_ALT5:UI || - || ||
|-
| SMH2Gi || LTS || oscada.org ||
|-
| ICP_DAS_LP_ARM || - || ||
|-
| TionPro270 || - || ||

|-
| colspan="4" | ''Live''
|-
| Live_Deb13_64 || Work+LTS || home.home ||
|-
| Live_Deb12_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb11_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb10_{32,64} || Work+LTS || home.home ||
|-
| Live_Deb9_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb8_{32,64} || Work+LTS || oscada.org ||
|-
| Live_Deb7_{32,64} || Work+LTS || oscada.org ||
|-
| Live_ALT || Work+LTS || oscada.org ||
|-
| Live_ALT:flash || - || ||
|}

Translations:Sub-projects/Automatic Builder of OpenSCADA/8/en

2026-05-10T14:56:54Z

FuzzyBot: Importing a new version from external source

Customization of [https://www.debian.org/devel/debian-live the Debian Live project] for this project:
* ''/usr/lib/live/build/binary_iso'' — appending the argument "-input-charset UTF-8" to the variable XORRISO_OPTIONS for allowing files in UTF-8 on the disk;
* ''/usr/lib/live/build/installer_debian-installer'' — taking from Debian 12 since that one from Debian 13 has errors with build for Debian 10,11.

Modules/WebVision/ru

2026-05-10T04:54:26Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Имя !! Версия !! Лицензия !! Источник !! Языки !! Платформы !! Тип !! Автор
|-
<section begin=info />
| [[Special:MyLanguage/Modules/WebVision|WebVision]] || Рабочий пользовательский интерфейс (WEB)
| 6.16 || GPL2 || ui_WebVision.so || en,uk,ru,de || x86,x86_64,ARM
<section end=info />
| UI || {{Author|Roman Savochenko|Maxim Lysenko (2007-2012), Ksenia Yashina (2007-2008)}}
|-
! colspan="9" | Description
|-
| colspan="9" | Visual operation user interface, based on the WEB — front-end to the VCA engine.
* '''Total complexity:''' > 50 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for the primitive "Media" and Notification on 1.35 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Hadi Ramezani
* '''Sponsored by, for the Notification on 0.85 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
* '''Sponsored by, for finishing the mirroring of the primitive ElFigure on 0.5 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' SVItoVYR Ltd
* '''Sponsored by, for the Export on 0.8 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
* '''[[Special:MyLanguage/Works/To_do|To Do]]:'''
<section begin=ToDo />
: * revise and unify the keyboard focus forcing on a first active element considering them specifity, to ensure the keyboard shortcuts;
: - expand the primitive "Diagram" by the mouse scaling operations;
: - implement own RTE-editor for the view Text of the primitive FormEl;
: - ElFigure: fix some properties loss (line width at the least) at the actions processing, in the way of the primitive code common refactoring;
: - expand the status-bar, with the functions:
:: - printing and exporting the Diagram primitive after it moving to "SVG".
: - ElFigure,Diagram: enable or make the anti aliasing, for the library GD;
: - implement the primitives "Diagram", "ElFigure" in the tag "SVG";
: - expand the variant "Animation" of the primitive "Media" in using the raw image files, like to PNG.
<section end=ToDo />
|}

Модуль предоставляет в OpenSCADA механизм конечной визуализации среды визуализации и управления (СВУ). Модуль основан на WEB технологиях (XHTML, JavaScript, CSS, AJAX). В своей работе модуль использует данные движка СВУ — модуль [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].
{{#lst:Sub-projects/VCA/uk|Introduce}}
С целью избежания этих проблем, а также создания в кратчайшие сроки полного спектра различных типов СВУ, основан [[Special:MyLanguage/Sub-projects/VCA|проект создания концепции СВУ]]. Результатом этого проекта и стал данный модуль непосредственной визуализации (на основе Web-технологий), модуль непосредственной визуализации [[Special:MyLanguage/Modules/Vision|Vision]] и движок СВУ [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].

== Назначение ==
Данный модуль непосредственной визуализации СВУ предназначен только для исполнения интерфейсов СВУ в среде WEB-технологий!

Интерфейс пользователя формируется в WEB-браузере путём обращения к WEB-серверу и получения от него XHTML-документа по протоколу HTTP. В данном случае, в роли WEB-сервера выступает OpenSCADA, которая поддерживает стандартные коммуникационные механизмы TCP-сетей (модуль [[Special:MyLanguage/Modules/Sockets|Transport.Sockets]]), протокол передачи гипертекста (модуль [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]]), а также шифрование трафика между браузером и сервером ([[Special:MyLanguage/Modules/SSL|Transport.SSL]]). Исходя из этого, для получения доступа к интерфейсу пользователя, предоставляемого этим модулем, необходимо в OpenSCADA настроить транспорт (Transport.Sockets или Transport.SSL) в связке с протоколом HTTP (Protocol.HTTP). Вместе с OpenSCADA идут конфигурационные файлы, содержащие настройки Transport.Sockets для порта 10002. Следовательно, интерфейс модуля, по умолчанию, будет доступен по URL: "<nowiki>http://localhost:10002</nowiki>".

Финальная версия этого модуля СВУ, построенная на основе данного модуля, обеспечит:
{{#lst:Sub-projects/VCA/ru|TargetFeatures}}

== Исполнение интерфейсов СВУ ==
Исполнение интерфейса СВУ заключается в запуске нового сеанса проекта, или подключения к существующему, на уровне движка СВУ (рис.2). Перед запросом, на подключение к сеансу, выполняется запрос на аутентификацию пользователя (рис.1). Далее, модуль непосредственной визуализации отображает и управляет данными сеанса. Главное окно режима исполнения данного модуля имеет вид, представленный на рисунке 3. Административные пользователи ("root" или в группе "root") могут закрывать открытые сеансы.

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

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

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

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

Located in the status bar:
* On the right side:
** the current user, on whose behalf the VCA interface is executed — by a clicking this user can be changed, typing of the new username and password;
** the current interface style, which can be changed selecting need one in the combobox;
** the current alarm status by a lamp with color related to the alarm level and the active notifiers' icons; blinks at the alarm appearing or changing; pressing on the lamp you may quiet the alarm in whole or the desired type of the notification, pressing the correspond notifier icon near;
** the menu buttons of call the page printing and data exporting for:
*** printing: Main Page, Documents;
*** exporting: Documents (HTML,CSV), Tables (CSV).
** manual on the VCA-project — calls by a click the manual on the visualization project for the file "'''{ProjVCA_ID}.[pdf|html|odt]'''" in [[Special:MyLanguage/Documents/Program_manual#Config|the document folder]] or specified in the [[#SpecAttrs|"prjDoc" attribute]];
** panel of user statuses and actions when specified in the [[#SpecAttrs|"statLine" attribute]]; mouse clicking left, right and double forms events to the main interface page.
* In the main field of the status line various messages and assistance messages are displayed.

Модулем поддерживается многоязычность, которая включается [[Special:MyLanguage/Documents/Program_manual#ConfigTr|динамическим переводом сообщений OpenSCADA]]. Полученный язык передаётся модулем [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]] и определяется путём и в последовательности:
* URL параметр "lang".
* Язык пользователя, который вошёл.
* Язык Web-браузера из HTTP свойства "Accept-Language".
* Общий язык процесса OpenSCADA.

[[file:HTTP_auth_ru.png|center|frame|Рис.1. Страница аутентификации.]]

[[file:WebVision_wvis_connect_ru.png|center|frame|Рис.2. Подключение или создание нового сеанса исполнения проекта СВУ.]]

[[file:WebVision_wvis_run.png|center|frame|Рис.3. Главное окно режима исполнения.]]

== {{Anch|Primitives|Представление базовых элементов (примитивов)}} ==
Данной версией модуля реализованы не все образы примитивов, заложенные проектом. В целом, проектом заложены примитивы:
{| class="wikitable"
|-
! Идентификатор !! Наименование !! Функция
|-
| ElFigure || Элементарная графическая фигура ||
Примитив является основой отрисовки элементарных графических фигур со всевозможной комбинацией их в одном объекте. Предусматривается поддержка следующих элементарных фигур:
* Линия.
* Дуга.
* Кривая Безье.
* Заливка замкнутого пространства.<br/>
Для всех фигур, содержащихся в виджете, устанавливаются единые свойства толщины, цвета и т.д., также, предусматривается возможность указания вышеперечисленных атрибутов для каждой фигуры отдельно и их динамизация.
|-
| FormEl || Элемент формы ||
Включает поддержку стандартных компонентов формы:
* Редактирование строки.
* Редактирование текста.
* Флажок.
* Кнопка.
* Выбор из списка.
* Список.
* Дерево.
* Таблица.
* Слайдер.
* Строка прокрутки.
|-
| Text || Текст || Элемент текста-метка. Характеризуется типом шрифта, цветом, ориентацией и выравниванием. Предусматривается поддержка аргументов.
|-
| Media || Медиа || Элемент отображения растровых и векторных изображений различных форматов, проигрывания анимированных изображений, проигрывание аудио-фрагментов и просмотр видео-фрагментов.
|-
| Diagram || Диаграмма || Элемент диаграммы с поддержкой возможности отображения нескольких потоков в реальном времени для: трендов (временных графиков), частотного спектра, XY диаграмм.
|-
| Protocol || Протокол || Элемент протокола — визуализатор сообщений программы, с поддержкой нескольких режимов работы.
|-
| Document || Документ || Элемент формирования отчётов, журналов и другой документации на основе доступных данных.
|-
| Box || Контейнер || Содержит механизм размещения-включения других виджетов для формирования новых, более сложных, виджетов и страниц конечной визуализации.
|-
| Function, <span style="color: red">в планах</span> || Функция API объектной модели OpenSCADA || Невизуальный виджет, на стороне исполнения, позволяющий включать вычислительные функции объектной модели OpenSCADA в СВУ.
|}

{{Anch|SpecAttrs|The visualizer module provides and uses set of specific attributes}} of the generic means, the information of which is given in the table. These attributes are automatically created by the visualizer in their absence and during the first run, or created by the user in the frame of the specified area, as needed.
{| class="wikitable"
|-
! Identifier (area) !! Name !! Appointment
|-
| keepAspectRatio (main page) || Keep aspect ratio on scale || Keep aspect ratio of the pages on scale.
|-
| stBarNoShow (main page) || Do not show the status bar || Hide the status bar of the main window.
|-
| notify{N}, notifyVisWebVision{N} (page) || Notification: type {N} || [[File:at.png]] Create manually with the type "Text"!
Specifies a notifier and a procedure of the notification resource obtaining according to the [[Special:MyLanguage/Modules/VCAEngine#Alarms|"Signalling (Alarms)" conception]].
|-
| statLine (main page) || Status line items || [[File:at.png]] Create manually with the type "Text"!
Text field with description of the status line item in the string form "'''{Id}:{Label}:{ToolTip}:{Color}:{Img}'''", where:
* "Id" — identifier, uses also to form events from the widget "stIt_{Id}".
* "Label" — visual label of the status element.
* "ToolTip" — context help about the element.
* "Color" — label color.
* "Img" — image of the status element, instead the label.
|-
| userSetVis (main page) || Setting the user || [[File:at.png]] Create manually with the type "String"!
Change the user or call a dialog to select it. Variants of the value:
* "*" — call for a selecting dialog of the user;
* "$" — change the user to the default one;
* "{user}[:{password}]" — direct change to ''user'' with ''password''; for empty password, the user is changed only if its permission is lesser or equal; a useful example of changing to the "user" after one minute inactivity:
<syntaxhighlight lang="JavaScript" style="margin-left: 20pt">
if((SYS.time()-this.ownerSess().userActTm()) < 60)userSetVis = "";
else if(this.ownerSess().reqUser() != "user") userSetVis = "user";
</syntaxhighlight>
|-
| prjDoc (main page) || Project document || [[File:at.png]] Create manually with the type "String"!
Specifying the project documentation of call from the status line's button with a possibility of disabling-concealing the button at empty value. The documentation specified in view "'''<nowiki>{OffLine}|{OnLineOpenSCADAWiki}</nowiki>'''", for example for the [[Special:MyLanguage/Using/Model_AGLKS|AGLCS project]] — "<nowiki>AGLCS|Using/Model_AGLKS</nowiki>". The online part is used in first order at its specifying!
|-
| vs_goHttpUrl (view "Button" of the primitive "FormEl") || Go to the HTTP URL || [[File:at.png]] Create manually with the type "String"!
Go to the specified URL at the button press.
|-
| vs_background (views "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" of the primitive "FormEl") || Custom background || [[File:at.png]] Create manually with the type "String"!
Specifies for the custom background in the form '''{color}-{transp} {image}'''.
|-
| vs_border (views "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" of the primitive "FormEl") || Custom border || [[File:at.png]] Create manually with the type "String"!
Specifies for the custom border in the standard CSS-form '''{wdth}px {style} {color}'''.
|-
| vs_winTitle (the view "Box") || Window title || [[File:at.png]] Create manually with the type "String"!
Dynamic window title value.
|}

Рассмотрим реализацию каждого примитива более детально.

=== Примитив элементарной фигуры (ElFigure) ===
<section begin=ElFigure />
Реализована поддержка элементарных фигур: линии, эллиптической дуги, кривой Безье и заливка замкнутых контуров цветом и изображением; со свойствами:
* формирование произвольных изображений из трёх элементарных фигур и заполнений замкнутых пространств цветом или изображением;
* возможность определения свойств фигур как в целом, так и отдельно для каждой: ширина, цвет и стиль линии, ширина и цвет бордюра линии, цвет и изображение заполнения;
* масштабирование;
* трансформация: поворот и отражение;
* поддержка пользовательских атрибутов динамических: точек, ширин, цветов, стилей и изображений;
* формирование событий по действиям манипулятором мыши в замкнутом пространстве и в целом.

На рисунке представлена часть экрана с кадром, содержащим вышеперечисленные элементарные фигуры.

[[file:WebVision_wvis_run_elfig.png|center]]
<section end=ElFigure />

=== Примитив текста (Text) ===
<section begin=Text />
Реализована поддержка элемента текста со свойствами:
* Шрифт со свойствами: типа-класса, размера, усиления, наклонности, подчёркивания и перечёркивания.
* Цвет текста.
* Ориентация текста.
* Автоматический перенос по словам.
* Выравнивание текста по горизонтали и вертикали, со всеми вариантами.
* Отображение фона в виде цвета и изображения.
* Отображение бордюра вокруг текста с указанным цветом, шириной и стилем.
* Отображение HTML.
* Дополнение текста аргументами различного типа и свойств.

На рисунке представлена часть экрана с кадром, содержащим примеры текста с использованием различных параметров.

[[file:WebVision_wvis_run_txt_ru.png|center]]
<section end=Text />

=== Примитив элемента формы (FormEl) ===
<section begin=FormEl />
Реализована поддержка элементов формы на кадрах СВУ с заложенными свойства, включая следующие типы:
* ''Редактор строки'' — Представлено следующими видами: "Текст", "Combo", "Целое", "Вещественное", "Время", "Дата", "Время и Дата". Все виды редактора строки поддерживают подтверждение ввода.
* ''Редактор текста'' — Представляет редактор плоского текста с подтверждением или отказом от ввода.
* ''Поле флажка'' — Предоставляет поле бинарного флажка.
* ''Кнопка'' — Предоставляет кнопку с поддержкой цвета кнопки, изображения в кнопке и режимов:
** стандартный;
** переключаемый;
** вызов меню;
** вызов загрузки файла;
** вызов сохранения файла.
* ''Выбор из списка'' — Предоставляет поле выбора элемента со списка указанных элементов.
* ''Список'' — Предоставляет поле списка с контролем за текущим элементом.
* ''Дерево'' — Предоставляет элемент дерева с возможностью выбора элементов.
* ''Таблица'' — Предоставляет элемент таблицы с возможностью выбора ячеек, строк или колонок, а также редактирования содержимого ячейки.
* ''Слайдер'' — Элемент слайдера.
* ''Прогрес-бар'' — Полоска прогресс-бара (идентично Слайдер).
* ''Пароль'' — Скрытый ввод пароля.

Реализованы режимы "Включен" и "Активен", а также передача изменений и событий в модель данных СВУ — движок. Режим "Активный" приводит к установке курсора активности для непустого фона и дополнительных условий различных видов "Text", "Media" и "Box":
* ''Text'' — не пустой текст;
* ''Media'' — не пустой источник изображения.

На рисунке представлена часть экрана с кадром, содержащим вышеперечисленные элементы формы.

[[file:WebVision_wvis_run_formel_ru.png|center]]
<section end=FormEl />

=== Primitive of the displaying the media-materials (Media) ===
<section begin=Media />
Support of the element of the displaying of the media-materials with the following properties is provided:
* Indication of the media data source: images or video-material.
* Review of the images of most well-known formats with the possibility of fitting in the widget size and keeping aspect ratio here.
* Playback of the simple animated images and video formats with the possibility to control the playback speed (<font color="red">inaccessible</font>).
* Playback of the full-formatted video and audio by HTML5.
* Displaying the background as the color and image.
* Displaying the border along the perimeter of the widget, with the specified color, width and style.
* Formation of the active areas and generating the events when they are activated.

На рисунке представлена часть экрана с кадром, содержащим примеры просмотра/проигрывания медиа-данных.

[[file:WebVision_wvis_run_media.png|center]]
<section end=Media />

=== Примитив построения диаграмм (Diagram) ===
<section begin=Diagram />
Реализована поддержка элемента построения диаграмм для типов "График", "Спектр" и "XY", со свойствами:
* Общие свойства типов диаграммы "График", "Спектр" и "XY":
** возможность выбора архиватора, буфера архива или всех данных, при работе с архивными данными;
** адаптация графика параметра к реальным значениям данных путём подстройки шкалы, в случае отсутствия прямо указанного диапазона значений;
** управление масштабом шкалы значений путём увеличения, уменьшения и смещения;
** широкий диапазон масштабирования и адаптации шкалы времени с автоматическим приведением запрашиваемых данных к качеству достаточному для отображения, или нужному для экспорта — указанием предельного количества измерений в пикселе;
** отображение размерной сетки и маркеров по горизонтали и вертикали с адаптацией к диапазону отображения;
** следящий режим за текущим временем путём периодического обновления и смещения времени диаграммы к текущему времени — времени последних данных в буфере архива.
* Свойства типа диаграммы "График":
** построение графиков до 100 параметров на одной диаграмме в процентной шкале и возможностью отображения выбранных параметров в собственной шкале;
** построение графика для: текущих, архивных и пользовательских данных;
** формирования промежуточного буфера отображения для текущих значений;
** поддержка активного режима с курсором и получением значений под курсором;
** возможность построения графиков как в линейной, так и логарифмической шкале значений.
* Свойства типа диаграммы "Спектр":
** построение графиков частотного спектра параметров до 100 на одной диаграмме в процентной шкале и возможностью отображения выбранных параметров в собственной шкале;
** построение графика для: архивных и пользовательских данных;
** поддержка активного режима с курсором и получением значений под курсором.
* Свойства типа диаграммы "XY":
** построение XY графиков параметров до 50 на одной диаграмме в процентной шкале и возможностью отображения выбранных параметров в собственной шкале;
** построение графика для: текущих, архивных и пользовательских данных;
** формирования промежуточного буфера отображения для текущих значений;
** параметры распределяются парами на график, где чётные по оси Y (0,2,4...) и нечётные по оси X (1,3,5...);
** возможность построения графиков как в линейной, так и логарифмической шкале значений.

На рисунке представлена часть экрана с кадром, содержащим примеры диаграмм: "График", "Спектр" и "XY".

[[file:WebVision_wvis_run_diag.png|center]]
<section end=Diagram />

=== Примитив формирования протокола (Protocol) ===
<section begin=Protocol />
Реализована поддержка элемента формирования протокола со свойствами:
* Формирование протокола из архива сообщений за указанное время и глубину.
* Запрос данных из указанных архиваторов сообщений.
* Выборка данных из архивов по уровню важности и шаблону категории сообщений.
* Поддержка режима слежения за появлением сообщений в архиве сообщений.

На рисунке представлена часть экрана с кадром, содержащим пример протокола.

[[file:WebVision_wvis_run_prot_ru.png|center]]
<section end=Protocol />

=== Примитив формирования отчётной документации (Document) ===
<section begin=Document />
Реализована поддержка элемента формирования отчётной документации со свойствами:
* Гибкое формирование структуры документа на основе языка гипертекстовой разметки, что предоставляет поддержку широких возможностей форматирования документов.
* Формирование документов по команде или расписанию, что необходимо для формирования отчётной документации в архив, с последующим просмотром архива.
* Формирование документов в режиме реального времени, для предоставления их полностью динамически и на основе архивов за указанное время.
* Использование атрибутов виджета для передачи в документ значений и адресов на архивы, что позволяет использовать виджет документа как шаблон, при формировании отчётов с другими входными данными.

В основе любого документа лежит XHTML-шаблон. XHTML-шаблон это тег "body" WEB-страницы, содержащий статику документа в стандарте XHTML 1.0, и элементы исполняемых инструкций на одном из языков пользовательского программирования OpenSCADA в виде '''<?dp {procedure} ?>'''. Результирующий документ формируется путём исполнения процедур и вставки их результата в документ.

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

На рисунке представлен кадр, содержащий пример документа.

[[file:WebVision_wvis_run_doc_ru.png|center]]
<section end=Document />

=== Примитив контейнера (Box) ===
<section begin=Box />
Реализована поддержка примитива контейнера, по совместительству выполняющего роль страниц проектов. Данный примитив является единственным элементом-контейнером, который может включать в себя ссылки на кадры из библиотеки, формируя тем самым пользовательские элементы нужной конфигурации. Примитив реализует предусмотренные проектом свойства. Перечислим, по пунктам, свойства данного примитива:
* ''Контейнер'' — Позволяет формировать нужные объекты путём группировки базовых в рамках данного примитива.
* ''Страница'' — Элементы, построенные на данном примитиве, могут выполнять роль страницы пользовательского интерфейса.
* ''Контейнер страниц'' — Свойство замещения, в процессе исполнения, собственного содержимого другой страницей. Используется для формирования фреймов на страницах пользовательского интерфейса. Например, главная страница типовой SCADA-системы с объектами сигнализации строится именно таким образом.
* ''Фон'' — Поддерживает возможность указания фона в виде цвета и изображения.
* ''Бордюр'' — Поддерживает возможность изображения бордюра с указанным цветом, толщиной и стилем.
<section end=Box />

== Общая конфигурация модуля ==
Для конфигурации и управления этим модулем, предоставляется конфигурационная страница интерфейса управления OpenSCADA (Рис.4) где Вы можете осуществлять:
* Контроль за активными WEB-сеансами.
* Конфигурацию:
** Время жизни, в минутах, и максимальное количество сеансов.
** Время жизни, в часах, и максимальное количество страниц в кеше.
** Уровень сжатия PNG-изображений. Наиболее оптимальным является минимальный уровень 1, поскольку без сжатия получаются большие файлы, а большие уровни сжатия создают более высокую нагрузку на процессор.
** Изменение размера растровых изображений на стороне сервера. В основном чтобы уменьшить размер очень больших изображений, а соответственно и трафика, что приводит к увеличению нагрузки на сервер.
** Пользовательские CSS правила интерфейса. CSS правила переопределения стандартных, которые размещаются по специальному знаку ##CUST_CSS## файла WebVisionVCA.html.

[[file:WebVision_wvis_cfg_ru.png|center|frame|Рис.4. Страница конфигурации модуля.]]

You can deeply customise main interface of the module overriding and adding the HTML and JavaScript code by placing to folder of your OpenSCADA project files WebVisionVCA.html and WebVisionVCA.js which initially you can obtain from the module source code — [http://oscada.org/svn/trunk/OpenSCADA/src/moduls/ui/WebVision/ UI.WebVision].

== {{Anch|Efficiency|Эффективность и масштабируемость}} ==
{{CntHdr|31.07.2019}}
GROUNDS: The Web-sessions may create many objects servicing the VCA-session for generating images, processing documents and performing other background functions of the end user Web-interface. Moreover, in difference to [[Special:MyLanguage/Modules/Vision|Vision]], the VCA-sessions may be created, closed and recreated again multiple times for different users and remote hosts. In the time the memory heap is affected by the memory fragmentation, so the program consumes more memory than at the start. The table below represents the phenomenon for different environments and the first page of [[Special:MyLanguage/Using/Model_AGLKS|the DemoDB (AGLKS) project]] reopening:
{| class="wikitable"
|-
! Environment !! Initially, MB !! Iter. 1, MB !! Iter. 2, MB !! Iter. 3, MB !! Iter. 4, MB !! Iter. 5, MB !! Resume
|-
| colspan="9" | ''Complete creation the Web- and VCA-sessions''

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=2 || 181 || 189 || 190 || 195 || 195 || 194 || Satiated on the iteration '''3''', base consumption 8 MB, extra consumption 5 MB ('''62.5''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 177 || 185 || 186 || 186 || 185 || 186 || Satiated on the iteration '''2''', base consumption 8 MB, extra consumption 1 MB ('''13''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 9 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 160 || 168 || 168 || 168.5 || 168.5 || 168.5 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0.5 MB ('''6''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + optional background objects in WebVision || 184 || 194.5 || 200 || 207 || 207 || 212.5 || Satiated on the iteration '''5''', base consumption 10.5 MB, extra consumption 18 MB ('''171''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 182 || 191.5 || 199 || 206 || 212 || 212 || Satiated on the iteration '''4''', base consumption 9.5 MB, extra consumption 20 MB ('''200''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.74 MB
|-
| Debian 9 amd64, GLibC 2.24, GCC 6.3.0 || 160 || 170 || 178 || 179 || 183 || 185 || Satiated on the iteration '''5''', base consumption 10 MB, extra consumption 15 MB ('''150''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.72 MB
|-
| Debian 8 amd64, GLibC 2.19, GCC 4.9.2 || 125.5 || 133 || 139 || 139 || 139 || 139 || Satiated on the iteration '''2''', base consumption 7.5 MB, extra consumption 6 MB ('''80''' %), liboscada.so 3.8 MB, ui_WebVision.so 0.79 MB
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 101 || 108 || 111 || 112 || 112 || 112 || Satiated on the iteration '''2''', base consumption 7 MB, extra consumption 4 MB ('''57''' %), liboscada.so 3.4 MB, ui_WebVision.so 0.85 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 144 || 152 || 152 || 152 || 152 || 152 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0 MB ('''0''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 + MALLOC_ARENA_MAX=1 || 126.5 || 132.5 || 133 || 133 || 133 || 133 || Satiated on the iteration '''1''', base consumption 6 MB, extra consumption 0.5 MB ('''8''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 151 || 158 || 162.5 || 166 || 166 || 166 || Satiated on the iteration '''3''', base consumption 7 MB, extra consumption 8 MB ('''114''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 || 125 || 131 || 132 || 136 || 136 || 139 || Satiated on the iteration '''5''', base consumption 6 MB, extra consumption 8 MB ('''133''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 8 i386, GLibC 2.19, GCC 4.9.2 || 92.5 || 99 || 101.5 || 103 || 103.5 || 103.5 || Satiated on the iteration '''2''', base consumption 6.5 MB, extra consumption 4.5 ('''69''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.94 MB
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 70 || 76 || 76 || 76 || 77 || 77 || Satiated on the iteration '''2''', base consumption 6 MB, extra consumption 1 MB ('''16''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.9 MB
|-
| ALTLinux 6 i386, GLibC 2.11.3, GCC 4.5.4 || 69 || 74 || 75 || 75 || 75 || 75 || Satiated on the iteration '''2''', base consumption 5 MB, extra consumption 1 MB ('''20''' %), liboscada.so 2.3 MB, ui_WebVision.so 0.9 MB

|-
| colspan="9" | ''Creation only VCA-session, from remote connection to the visualizer server''
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 180 || 186 || 186 || 186 || 186 || 186 || Satiated on the iteration '''1''', extra consumption 0.2 MB (3 %)
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 100 || 104 || 105 || 105 || 105 || 105 || Satiated on the iteration '''1''', extra consumption 1 MB (25 %)

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 148 || 154 || 155 || 155 || 155 || 155 || Satiated on the iteration '''1''', extra consumption 1 MB (16 %)
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 69 || 72 || 72 || 72 || 72 || 72 || Satiated on the iteration '''1''', extra consumption 0 MB (0 %)
|}

CONCLUSION: We see obvious degradation in the memory effectivity on the last Debian releases starting at Debian 8 (GLibC 2.19) on I386 and Debian 9 (GLibC 2.24) on AMD64, when the memory consumption increased up to 200% after 3,4 free-allocate iterations of the same data. To more presenting of the problem there have built follow images on the data basis:

[[file:WebVision_MemEffectAMD64.png|center|frame|Fig.5. Memory effectivity on AMD64 platform.]]

[[file:WebVision_MemEffectI386.png|center|frame|Fig.6. Memory effectivity on I386 platform.]]

[[file:WebVision_AbsInitSizeAMD64.png|center|frame|Fig.7. Absolute initial size of OpenSCADA "AGLKS" on the platform AMD64.]]

[[file:WebVision_AbsInitSizeAI386.png|center|frame|Fig.8. Absolute initial size of OpenSCADA "AGLKS" on the platform I386.]]

MEASURES:
# The optional background objects were implemented for the primitives "FormEl" and "Text", what will have most effect on mnemonic-schemes with these elements and wont have many effect for other, see the measuring data above.
# There were some tries to tune the memory allocator of GLibC using "[https://www.gnu.org/software/libc/manual/html_node/Memory-Allocation-Tunables.html Memory Allocation Tunables]" without any significant effect, so we will [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=934080 notify the Debian community], firstly.
# The problem was detected in arenas of the memory allocator, setting whose number to 1 (MALLOC_ARENA_MAX=1) completely resolves the problem and the effect you may see on Figures 9, 10, for a real big application.

[[file:WebVision_MemoryDef.png|center|frame|Fig.9. Tendency of the memory consumption on a real big application at the default conditions.]]

[[file:WebVision_MemoryArenas1.png|center|frame|Fig.10. Tendency of the memory consumption on a real big application at the environment variable MALLOC_ARENA_MAX=1.]]

{{CntHdr|20.06.2013}}
GROUNDS: At working with the board [[Special:MyLanguage/Using/Kontron_MOPSlcdLX|MOPSlcdLX]], attention was drawn to the heavy load of the task of forming full-size trends. As it turned out later, a large load is created by the formation of a PNG image in the GD2 library, or rather, the packing procedure of ZLib. The subject analysis of the performance of the formation of images of various formats on this board is summarized in the table below:
{| class="wikitable"
|-
! Format !! Trend building, milliseconds !! Converting to the image format, milliseconds !! Size of the image, bytes
|-
| PNG (0) || 200 || 800 || 1700365
|-
| PNG (1) || 200 || 690 || 24000
|-
| PNG (-1) || 200 || 1000 || 14800
|-
| PNG (9) || 200 || 1900 || 13354
|-
| JPEG (-1) || 200 || 180 || 53157
|-
| GIF || 200 || 380 || 14300
|}

CONCLUSION: As can be seen from the table above, the operation of forming PNG as a whole is resource-intensive and the most optimal level of compression is "1". At the same time, the formation of JPEG and GIF is much faster, but these image formats have a number of critical flaws, namely: JPEG does not have an alpha channel (transparency), and GIF is limited by the number of colors, which in both cases leads to loss of transparency and distortion of text smoothing and images in general.

MEASURES: The ability to select the compression level for the generated PNG images is added, and the default value is set to the optimal level "1". The implementation of the formation of the "Diagram" primitive on the browser side in the "svg" or "canvas" tags is planned.

== Замечания ==
На данном этапе модуль может быть использован для построения реальных интерфейсов пользователя с поддержкой основных функций. Однако, отдельные проблемы могут возникать как по причине недоработанности, так и различия браузеров. Сейчас достаточно качественно обеспечена работоспособность на браузерах: Chromium (Google Chrome), FireFox, Opera, Konqueror.

== Ссылки ==
* [[:File:WebVision MemAllocFree.ods|Электронная таблица: Анализ эффективности распределения памяти.]]

Modules/WebVision/uk

2026-05-10T04:54:24Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Ім'я !! Версія !! Ліцензія !! Джерело !! Мови !! Платформи !! Тип !! Автор
|-
<section begin=info />
| [[Special:MyLanguage/Modules/WebVision|WebVision]] || Робочий користувацький інтерфейс (WEB)
| 6.16 || GPL2 || ui_WebVision.so || en,uk,ru,de || x86,x86_64,ARM
<section end=info />
| Користувацькі інтерфейси || {{Author|Роман Савоченко|Максим Лисенко (2007-2012), Ксенія Яшина (2007-2008)}}
|-
! colspan="9" | Опис
|-
| colspan="9" | Робочий інтерфейс користувача, заснований на WEB — зовнішній інтерфейс до рушія СВУ.
* '''Загальна працемісткість:''' > 50 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}
* '''Спонсорування, примітиву "Медіа" та Сповіщення на 1.35 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' Хайді Рамазані
* '''Спонсорування, Сповіщення на 0.85 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' Вінницька Птахофабрика
* '''Спонсорування, завершення відображення примітиву ElFigure на 0.5 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' ТОВ "СВІТоВИР"
* '''Спонсорування, Експорту на 0.8 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' Вінницька Птахофабрика
* '''[[Special:MyLanguage/Works/To_do|Завдання (To Do)]]:'''
<section begin=ToDo />
: * відревізувати та уніфікувати примушення клавіатурного фокусу на першому активному елементі з урахуванням їх специфіки, для гарантування клавіатурних скорочень;
: - розширити примітив "Діаграма" операціями масштабування мишею;
: - реалізувати власний RTE-редактор для вигляду Text примітиву FormEl;
: - ElFigure: виправити втрату деяких властивостей (щонайменш товщину лінії) при опрацюванні дій, у процесі загальної переробки коду примітиву;
: - доповнити панель статусу, функціями:
:: - друк і експорт примітиву Діаграма після її переведення на "SVG".
: - ElFigure,Diagram: ввімкнути або реалізувати згладжування, для бібліотеки GD;
: - реалізувати примітиви "Діаграма", "ElFigure" тегом "SVG";
: - розширити варіант "Анімація" примітиву "Медіа" використанням RAW файлів зображень, на кшталт PNG.
<section end=ToDo />
|}

Модуль надає до OpenSCADA механізм кінцевої візуалізації середовища візуалізації та управління (СВУ). Модуль засновано на WEB технологіях (XHTML, JavaScript, CSS, AJAX). У своїй роботі модуль використовує дані рушія СВУ — модуль [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].
{{#lst:Sub-projects/VCA/ru|Introduce}}
З метою запобігання цих проблем, а також створення у коротші терміни повного спектру різних типів СВУ, засновано [[Special:MyLanguage/Sub-projects/VCA|проєкт створення концепції СВУ]]. Результатом цього проєкту й став цей модуль безпосередньої візуалізації (на основі Web-технологій), модуль безпосередньої візуалізації [[Special:MyLanguage/Modules/Vision|Vision]] та рушій СВУ [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].

== Призначення ==
Даний модуль безпосередньої візуалізації СВУ призначено тільки для виконання інтерфейсів СВУ у середовищі WEB-технологій!

Інтерфейс користувача формується у WEB-браузері шляхом звернення до WEB-серверу та отримання від нього XHTML-документу за протоколом HTTP. У цьому випадку, у ролі WEB-серверу виступає OpenSCADA, яка підтримує стандартні комунікаційні механізми TCP-мереж (модуль [[Special:MyLanguage/Modules/Sockets|Transport.Sockets]]), протокол передачі гіпертексту (модуль [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]]), а також шифрування трафіку між браузером та сервером ([[Special:MyLanguage/Modules/SSL|Transport.SSL]]). Виходячи з цього, для отримання доступу до інтерфейсу користувача, який надається цим модулем, потрібно у OpenSCADA налаштувати транспорт (Transport.Sockets або Transport.SSL) у поєднані з протоколом HTTP (Protocol.HTTP). Разом з OpenSCADA постачаються конфігураційні файли, які містять налаштування Transport.Sockets для порту 10002. Відповідно, інтерфейс модуля, по замовченню, буде доступний за URL: "<nowiki>http://localhost:10002</nowiki>".

Фінальна версія цього модуля СВУ, яка побудована на основі даного модуля, забезпечить:
{{#lst:Sub-projects/VCA/uk|TargetFeatures}}

== Виконання інтерфейсів СВУ ==
Виконання інтерфейсу СВУ полягає в запуску нового сеансу проєкту, або підключення до існуючого, на рівні рушія СВУ (рис.2). Перед запитом на підключення до сеансу здійснюється запит на аутентифікацію користувача (рис.1). Далі, модуль безпосередньої візуалізації відображає та керує даними сеансу. Головне вікно режиму виконання даного модуля має вигляд, наведений на рисунку 3. Адміністративні користувачі ("root" або у групі "root") можуть закривати відкриті сеанси.

Інтерфейс вікна виконання повністю будується динамічно, скриптом JavaScript та виходячи із вмісту сеансу проєкту, шляхом прямих XML запитів до серверу.

Реалізовано оновлення вмісту відкритих сторінок інтерфейсу візуалізації з періодичністю виконання візуалізованого сеансу проєкту візуалізації. В процесі оновлення здійснюється:
* запит у моделі переліку відкритих сторінок, з ознакою модифікації сторінки, та перевірка відповідності реально відкритих сторінок цьому переліку;
* запит гілки даних модифікованих сторінок;
* оновлення вмісту модифікованих сторінок та їх віджетів у відповідності до отриманих змінених даних.

Механізм запиту тільки змінених даних засновано на абсолютному лічильнику виконання сеансу. При внесенні реальних змін до атрибутів віджетів здійснюється запам'ятовування значення цього лічильника, що й дозволяє ідентифікувати змінені атрибути. Такий підхід дозволяє підвищити продуктивність та зменшити трафік, у випадку доступу до рушія СВУ через мережу.

Ієрархічно, модулем передбачається можливість розташування сторінок проєкту як на головному вікні виконання (рис.3), так і вкладаючи всередину віджетів контейнерів, а також шляхом відкриття додаткових вікон поверх основного.

На рядку статусу розташовуються:
* Праворуч:
** поточний користувач, від ім'я якого виконується інтерфейс СВУ — кліком можна змінити цього користувача, ввівши нове ім'я та пароль;
** поточний стиль інтерфейсу, який можна змінити обравши з комбобоксу потрібний;
** поточний статус порушення у лампі кольором, який відповідає рівню порушення, та іконки активних сповіщувачів; блимає при появі та зміні порушення; натиснувши на лампу Ви можете сквітувати (стишити) ці порушення цілком або бажаний тип сповіщення, натиснувши іконку відповідного сповіщувача поряд;
** кнопка меню із виклику друку та експорту даних сторінки для:
*** друку: Основної Сторінки, Документів;
*** експорту: Документів (HTML,CSV), Таблиць (CSV).
** підручнику на проєкт СВУ — кліком викликає підручник на проєкт візуалізації щодо файлу "'''{ProjVCA_ID}.[pdf|html|odt]'''" у [[Special:MyLanguage/Documents/Program_manual#Config|теці документів]] або визначеного у [[#SpecAttrs| атрибуті "prjDoc"]];
** панель користувацьких статусів і дій за визначенням у [[#SpecAttrs|атрибуті "statLine"]]; клацання лівою, правою та подвійним миші формує події до головної сторінки інтерфейсу.
* У головному полі рядка статусу виводяться різні інформаційні повідомлення та повідомлення допомоги.

Модуль підтримує багатомовність, яка вмикається [[Special:MyLanguage/Documents/Program_manual#ConfigTr|динамічним перекладом повідомлень OpenSCADA]]. Отримана мова передається модулем [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]] та визначається шляхом та у послідовності:
* URL параметр "lang".
* Мова користувача, що увійшов.
* Мова Web-браузеру з HTTP властивості "Accept-Language".
* Загальна мова процесу OpenSCADA.

[[file:HTTP_auth_uk.png|center|frame|Рис.1. Сторінка аутентифікації.]]

[[file:WebVision_wvis_connect_uk.png|center|frame|Рис.2. Підключення або створення нового сеансу виконання проєкту СВУ.]]

[[file:WebVision_wvis_run_uk.png|center|frame|Рис.3. Головне вікно режиму виконання.]]

== {{Anch|Primitives|Представлення базових елементів (примітивів)}} ==
Даною версією модуля реалізовано не всі образи примітивів, закладені проєктом. Загалом, проєктом закладено примітиви:
{| class="wikitable"
|-
! Ідентифікатор !! Найменування !! Функція
|-
| ElFigure || Елементарна графічна фігура ||
Примітив є основою відмальовки елементарних графічних фігур зі всілякими комбінаціями їх у одному об'єкті. Передбачається підтримка наступних елементарних фігур:
* Лінія.
* Дуга.
* Крива Без'є.
* Заливка замкненого простору.<br/>
Для всіх фігур, що містяться у віджеті, встановлюються єдині властивості товщини, кольору та інше, також, передбачається можливість указання вищеперелічених атрибутів для кожної фігури окремо та їх динамізація.
|-
| FormEl || Елемент форми ||
Включає підтримку стандартних компонентів форми:
* Редагування рядку.
* Редагування тексту.
* Прапорець.
* Кнопка.
* Вибір з переліку.
* Перелік.
* Дерево.
* Таблиця.
* Слайдер.
* Стрічка прокрутки.
|-
| Text || Текст || Елемент тексту-мітка. Характеризується типом шрифту, кольором, орієнтацією та вирівнюванням. Передбачається підтримка аргументів.
|-
| Media || Медіа || Елемент відображення растрових та векторних зображень різних форматів, програвання анімованих зображень, програвання аудіо-фрагментів та перегляд відео-фрагментів.
|-
| Diagram || Діаграма || Елемент діаграми з підтримкою можливості відображення декількох потоків у реальному часі для: трендів (часових графіків), частотного спектру, XY діаграм.
|-
| Protocol || Протокол || Елемент протоколу — візуалізатор повідомлень програми, з підтримкою декількох режимів роботи.
|-
| Document || Документ || Елемент формування звітів, журналів та іншої документації на основі доступних даних.
|-
| Box || Контейнер || Містить механізм розташування-включення інших віджетів для формування нових, більш складних, віджетів та сторінок кінцевої візуалізації.
|-
| Function, <span style="color: red">у планах</span> || Функція API об'єктної моделі OpenSCADA || Невізуальний віджет, на боці виконання, що дозволяє включати обчислювальні функції об'єктної моделі OpenSCADA до СВУ.
|}

{{Anch|SpecAttrs|Модулем візуалізатору надається та використовується низка специфічних атрибутів}} загального характеру, інформацію про які наведено у таблиці. Ці атрибути автоматично створюються візуалізатором за їх відсутності та під час першого запуску, або створюються користувачем у кадрі вказаної області, за потреби.
{| class="wikitable"
|-
! Ідентифікатор (область) !! Ім'я !! Призначення
|-
| keepAspectRatio (головна сторінка) || Зберігати пропорцію при масштабуванні || Зберігати пропорцію сторінок при масштабуванні.
|-
| stBarNoShow (головна сторінка) || Не показувати рядок статусу || Приховати рядок статусу головного вікна.
|-
| notify{N}, notifyVisWebVision{N} (сторінка) || Сповіщувач: тип {N} || [[File:at.png]] Створити вручну із типом "Текст"!
Визначає сповіщувач та процедуру отримання ресурсу сповіщення згідно до [[Special:MyLanguage/Modules/VCAEngine#Alarms|концепції "Сигналізації (Аларми)"]].
|-
| statLine (головна сторінка) || Елементи рядку статусу || [[File:at.png]] Створити вручну із типом "Текст"!
Текстове поле з описом елементів рядка статусу користувача, у форматі рядка "'''{Id}:{Label}:{ToolTip}:{Color}:{Img}'''", де:
* "Id" — ідентифікатор, використовується також для формування повідомлень від віджету "stIt_{Id}".
* "Label" — візуальна мітка елементу статусу.
* "ToolTip" — спливаюча підказка стосовно елементу.
* "Color" — колір мітки.
* "Img" — зображення елементу статусу, замість мітки.
|-
| userSetVis (головна сторінка) || Встановлення користувача || [[File:at.png]] Створити вручну із типом "Рядок"!
Зміна користувача або виклик діалогу для його обрання. Варіанти значення:
* "*" — виклик діалогу обрання користувача;
* "$" — зміна користувача на типового;
* "{користувач}[:{пароль}]" — пряма зміна на ''користувач'' із ''паролем''; для порожнього пароля користувач змінюється лише якщо його права менше або дорівнюють; корисний приклад зміни на користувача "user" після хвилини неактивності:
<syntaxhighlight lang="JavaScript" style="margin-left: 20pt">
if((SYS.time()-this.ownerSess().userActTm()) < 60)userSetVis = "";
else if(this.ownerSess().reqUser() != "user") userSetVis = "user";
</syntaxhighlight>
|-
| prjDoc (головна сторінка) || Документ проєкту || [[File:at.png]] Створити вручну із типом "Рядок"!
Визначення документу проєкту виклику кнопкою рядка статусу із можливістю вимкнення-приховання кнопки за порожнього значення. Документ визначається у вигляді "'''<nowiki>{OffLine}|{OnLineOpenSCADAWiki}</nowiki>'''", до прикладу для [[Special:MyLanguage/Using/Model_AGLKS|проєкту АГЛКС]] — "<nowiki>AGLCS|Using/Model_AGLKS</nowiki>". Мережева частина використовується у першу чергу за її визначення.
|-
| vs_goHttpUrl (вигляд "Кнопка" примітиву "FormEl") || Перехід за HTTP URL || [[File:at.png]] Створити вручну із типом "Рядок"!
Перехід на визначений URL за натисканням кнопки.
|-
| vs_background (види "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" примітиву "FormEl") || Користувацький фон || [[File:at.png]] Створити вручну із типом "Рядок"!
Визначає користувацький фон у формі '''{color}-{transp} {image}'''.
|-
| vs_border (види "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" примітиву "FormEl") || Користувацька границя || [[File:at.png]] Створити вручну із типом "Рядок"!
Визначає користувацьку границю у стандартній формі CSS '''{wdth}px {style} {color}'''.
|-
| vs_winTitle (вид "Box") || Заголовок вікна || [[File:at.png]] Створити вручну із типом "Рядок"!
Значення динамічного заголовку вікна.
|}

Розглянемо реалізацію кожного примітиву більш детально.

=== Примітив елементарної фігури (ElFigure) ===
<section begin=ElFigure />
Реалізовано підтримку елементарних фігур: лінії, еліптичної дуги, кривої Без'є та заливка замкнених контурів кольором та зображенням; з властивостями:
* формування довільних зображень із трьох елементарних фігур та заповнень замкнених просторів кольором або зображенням;
* можливість визначення властивостей фігур як загалом, так і окремо для кожної: ширина, колір та стиль лінії, ширина та колір бордюру лінії, колір та зображення заповнення;
* масштабування;
* трансформація: поворот та віддзеркалення;
* підтримка користувацьких атрибутів динамічних: точок, ширин, кольорів, стилів та зображень;
* формування подій за діями маніпулятором миші у замкненому просторі та загалом.

На рисунку представлено частину екрану з кадром, який містить елементарні фігури.

[[file:WebVision_wvis_run_elfig.png|center]]
<section end=ElFigure />

=== Примітив тексту (Text) ===
<section begin=Text />
Реалізовано підтримку елементу тексту зі властивостями:
* Шрифт зі властивостями: типу-класу, розміру, підсилення, нахилу, підкреслення та перекреслення.
* Колір тексту.
* Орієнтація тексту.
* Автоматичне перенесення за словами.
* Вирівнювання тексту по горизонталі та вертикалі, з усіма варіантами.
* Відображення фону у вигляді кольору та зображення.
* Відображення бордюру довкола тексту з вказаним кольором, шириною та стилем.
* Відображення HTML.
* Доповнення тексту аргументами різного типу та властивостей.

На рисунку представлено частину екрана з кадром, що містить приклади тексту з використанням різних параметрів.

[[file:WebVision_wvis_run_txt_uk.png|center]]
<section end=Text />

=== Примітив елементу форми (FormEl) ===
<section begin=FormEl />
Реалізовано підтримку елементів форми на кадрах СВУ із закладеними властивостями, включаючи наступні типи:
* ''Редактор рядку'' — Представлено наступними видами: "Текст", "Combo", "Ціле", "Реальне", "Час", "Дата", "Час та Дата". Всі види редактору рядка підтримують підтвердження вводу.
* ''Редактор тексту'' — Надає редактор плаского тексту з підтвердженням або відмовою від вводу.
* ''Поле ознаки'' — Надає поле бінарної ознаки.
* ''Кнопка'' — Надає кнопку з підтримкою кольору кнопки, зображення у кнопці та режимів:
** стандартний;
** перемикальний;
** виклик меню;
** виклик завантаження файлу;
** виклик збереження файлу.
* ''Вибір з переліку'' — Надає поле вибору елементу з переліку вказаних елементів.
* ''Перелік'' — Надає поле переліку з контролем за поточним елементом.
* ''Дерево'' — Надає елемент дерева з можливістю обрання елементів.
* ''Таблиця'' — Надає елемент таблиці з можливістю вибору клітинок, рядків або стовпчиків, а також редагування вмісту клітинки.
* ''Слайдер'' — Елемент слайдеру.
* ''Прогрес-бар'' — Стрічка прогрес-бару (ідентично до Слайдер).
* ''Пароль'' — Приховане введення паролю.

Реалізовано режими "Ввімкнено" та "Активний", а також передача змін та повідомлень у модель даних СВУ — рушій. Режим "Активний" призводить до встановлення курсору активності для непорожнього фону та додаткових умов різних видів "Text", "Media" та "Box":
* ''Text'' — не порожній текст;
* ''Media'' — не порожнє джерело зображення.

На рисунку представлено частину екрану з кадром, що містить вищеперелічені елементи форми.

[[file:WebVision_wvis_run_formel_uk.png|center]]
<section end=FormEl />

=== Примітив відображення медіа-матеріалів (Media) ===
<section begin=Media />
Реалізовано підтримку елементу відображення медіа-матеріалів з властивостями:
* Вказання джерела медіа даних: зображення або відео-матеріалу.
* Перегляд зображень більшості відомих форматів з можливістю їх вписування у розмір віджету і збереження співвідношення сторін тут.
* Програвання простих анімованих форматів зображень та відео з можливістю управління швидкістю програвання (<font color="red">недоступно</font>).
* Програвання повноформатного відео та аудіо за допомогою HTML5.
* Відображення фону у вигляді кольору та зображення.
* Відображення бордюру по периметру віджету, з вказаним кольором, шириною та стилем.
* Формування активних областей та генерація повідомлень при їх активації.

На рисунку представлено частину екрану з кадром, що містить приклади перегляду/програвання медіа-даних.

[[file:WebVision_wvis_run_media.png|center]]
<section end=Media />

=== Примітив побудови діаграм (Diagram) ===
<section begin=Diagram />
Реалізовано підтримку елементу побудови діаграм для типів "Графік", "Спектр" та "XY", з властивостями:
* Загальні властивості типів діаграми "Графік", "Спектр" та "XY":
** можливість вибору архіватору, буферу архіву або всіх даних, при роботі з архівними даними;
** адаптація графіку параметра до реальних значень даних шляхом підлаштування шкалы, у випадку відсутності прямо вказаного діапазону значень;
** управління масштабом шкали значень шляхом збільшення, зменшення та зсуву;
** широкий діапазон масштабування та адаптації шкали часу з автоматичним приведенням запитаних даних до якості достатньої до відображення, або потрібної для експорту — вказанням граничної кількості вимірів у пікселі;
** відображення розмірної ґратки та маркерів по горизонталі та вертикалі з адаптацією до діапазону відображення;
** слідкуючий режим за поточним часом шляхом періодичного оновлення та зміщення часу діаграми до поточного часу — часу останніх даних у буфері архіву.
* Властивості типу діаграми "Графік":
** побудова графіків до 100 параметрів на одній діаграмі у процентній шкалі та можливістю відображення обраних параметрів у власній шкалі;
** побудова графіку для: поточних, архівних та користувацьких даних;
** формування проміжного буферу відображення для поточних значень;
** підтримка активного режиму з курсором та отриманням значень під курсором;
** можливість побудови графіків як у лінійній, так і логарифмічній шкалі значень.
* Властивості типу діаграми "Спектр":
** побудова графіків частотного спектру параметрів до 100 на одній діаграмі у процентній шкалі та можливістю відображення обраних параметрів у власній шкалі;
** побудова графіку для: архівних та користувацьких даних;
** підтримка активного режиму з курсором та отриманням значень під курсором.
* Властивості типу діаграми "XY":
** побудова XY графіків параметрів до 50 на одній діаграмі у процентній шкалі та можливістю відображення обраних параметрів у власній шкалі;
** побудова графіку для: поточних, архівних та користувацьких даних;
** формування проміжного буферу відображення для поточних значень;
** параметри розподіляються парами на графік, де парні за осі Y (0,2,4...) та непарні за осі X (1,3,5...);
** можливість побудови графіків як у лінійній, так і логарифмічній шкалі значень.

На рисунку представлено частину екрану з кадром, що містить приклади діаграм: "Графік", "Спектр" та "XY".

[[file:WebVision_wvis_run_diag.png|center]]
<section end=Diagram />

=== Примітив формування протоколу (Protocol) ===
<section begin=Protocol />
Реалізовано підтримку елементу формування протоколу з властивостями:
* Формування протоколу з архіву повідомлень на вказаний час та глибину.
* Запит даних з вказаних архіваторів повідомлень.
* Вибірка даних з архівів за рівнем важливості та шаблоном категорії повідомлень.
* Підтримка режиму слідкування за появою повідомлень у архіві повідомлень.

На рисунку представлено частину екрану з кадром, що містить приклад протоколу.

[[file:WebVision_wvis_run_prot_uk.png|center]]
<section end=Protocol />

=== Примітив формування звітної документації (Document) ===
<section begin=Document />
Реалізовано підтримку елементу формування звітної документації з властивостями:
* Гнучке формування структури документу на основі мови гіпертекстової розмітки, що надає підтримку широких можливостей форматування документів.
* Формування документів за командою або розкладом, що необхідно для формування звітної документації до архіву, з подальшим переглядом архіву.
* Формування документів у режимі реального часу, для надання їх повністю динамічно та на основі архівів за вказаний час.
* Використання атрибутів віджету для передачі у документ значень та адрес на архіви, що дозволяє використовувати віджет документу як шаблон, при формуванні звітів з іншими вхідними даними.

У основі будь-якого документу лежить XHTML-шаблон. XHTML-шаблон це тег "body" WEB-сторінки, що містить статику документу у стандарті XHTML 1.0 та елементи виконувальних інструкцій на мові користувацького програмування OpenSCADA, у вигляді '''<?dp {procedure} ?>'''. Результуючий документ формується шляхом виконання процедур та вставки їх результату у документ.

Джерелом значень виконуваних інструкцій є атрибути віджету цього примітиву, а також всі механізми мови користувацького програмування OpenSCADA. Атрибути можуть додаватися користувачем та лінкуватися на реальні атрибути параметрів або-ж бути автономними, значення яких будуть формуватися у процедурі віджету. У випадку зі злінкованими атрибутами, значення можуть вийматися з архіву-історії.

На рисунку представлено кадр, який містить приклад документу.

[[file:WebVision_wvis_run_doc_uk.png|center]]
<section end=Document />

=== Примітив контейнеру (Box) ===
<section begin=Box />
Реалізовано підтримку примітиву контейнеру, що, за сумісництвом, виконує роль сторінок проєктів. Даний примітив є єдиним елементом-контейнером, який може включати у себе посилання на кадри з бібліотеки, формуючи тим самим користувацькі елементи потрібної конфігурації. Примітив реалізує передбачені проєктом властивості. Перелічимо, по пунктах, властивості даного примітиву:
* ''Контейнер'' — Дозволяє формувати потрібні об'єкти шляхом групування базових у межах даного примітиву.
* ''Сторінка'' — Елементи, побудовані на даному примітиві, можуть виконувати роль сторінки користувацького інтерфейсу.
* ''Контейнер сторінок'' — Властивість заміщення, у процесі виконання, власного вмісту іншою сторінкою. Використовується для формування фреймів на сторінках користувацького інтерфейсу. Наприклад, головна сторінка типової SCADA-системи з об'єктами сигналізації будується саме таким чином.
* ''Фон'' — Підтримує можливість указання фону у вигляді кольору та зображення.
* ''Бордюр'' — Підтримує можливість зображення бордюру з вказаним кольором, товщиною та стилем.
<section end=Box />

== Загальна конфігурація модуля ==
Для конфігурації та керування цим модулем, надається конфігураційна сторінка інтерфейсу керування OpenSCADA (Рис.4) де Ви можете здійснювати:
* Контроль за активними WEB-сеансами.
* Конфігурацію:
** Час життя, у хвилинах, та максимальна кількість сеансі.
** Час життя, у годинах, та максимальна кількість сторінок у кеші.
** Рівень компресії PNG-зображень. Більш оптимальним є мінімальний рівень 1, оскільки без стиснення виходять великі файли, а більші рівні стиснення створюють більш високе навантаження на процесор.
** Зміна розміру растрових зображень на боці серверу. Переважно щоб зменшити розмір занадто великий зображень відтак і трафіку, що призводить до збільшення навантаження на сервер.
** Користувацькі CSS правила інтерфейсу. CSS правила перевизначення стандартних, що розташовуються за спеціальним знаком ##CUST_CSS## файлу WebVisionVCA.html.

[[file:WebVision_wvis_cfg_uk.png|center|frame|Рис.4. Сторінка конфігурації модуля.]]

Ви можете глибоко налаштувати основний інтерфейс модуля замінивши та доповнивши код HTML і JavaScript шляхом розташування до теки вашого проєкту OpenSCADA файлів WebVisionVCA.html і WebVisionVCA.js, які початково можете отримати з вихідного коду модуля — [http://oscada.org/svn/trunk/OpenSCADA/src/moduls/ui/WebVision/ UI.WebVision].

== {{Anch|Efficiency|Ефективність та масштабованість}} ==
{{CntHdr|31.07.2019}}
GROUNDS: The Web-sessions may create many objects servicing the VCA-session for generating images, processing documents and performing other background functions of the end user Web-interface. Moreover, in difference to [[Special:MyLanguage/Modules/Vision|Vision]], the VCA-sessions may be created, closed and recreated again multiple times for different users and remote hosts. In the time the memory heap is affected by the memory fragmentation, so the program consumes more memory than at the start. The table below represents the phenomenon for different environments and the first page of [[Special:MyLanguage/Using/Model_AGLKS|the DemoDB (AGLKS) project]] reopening:
{| class="wikitable"
|-
! Environment !! Initially, MB !! Iter. 1, MB !! Iter. 2, MB !! Iter. 3, MB !! Iter. 4, MB !! Iter. 5, MB !! Resume
|-
| colspan="9" | ''Complete creation the Web- and VCA-sessions''

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=2 || 181 || 189 || 190 || 195 || 195 || 194 || Satiated on the iteration '''3''', base consumption 8 MB, extra consumption 5 MB ('''62.5''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 177 || 185 || 186 || 186 || 185 || 186 || Satiated on the iteration '''2''', base consumption 8 MB, extra consumption 1 MB ('''13''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 9 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 160 || 168 || 168 || 168.5 || 168.5 || 168.5 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0.5 MB ('''6''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + optional background objects in WebVision || 184 || 194.5 || 200 || 207 || 207 || 212.5 || Satiated on the iteration '''5''', base consumption 10.5 MB, extra consumption 18 MB ('''171''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 182 || 191.5 || 199 || 206 || 212 || 212 || Satiated on the iteration '''4''', base consumption 9.5 MB, extra consumption 20 MB ('''200''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.74 MB
|-
| Debian 9 amd64, GLibC 2.24, GCC 6.3.0 || 160 || 170 || 178 || 179 || 183 || 185 || Satiated on the iteration '''5''', base consumption 10 MB, extra consumption 15 MB ('''150''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.72 MB
|-
| Debian 8 amd64, GLibC 2.19, GCC 4.9.2 || 125.5 || 133 || 139 || 139 || 139 || 139 || Satiated on the iteration '''2''', base consumption 7.5 MB, extra consumption 6 MB ('''80''' %), liboscada.so 3.8 MB, ui_WebVision.so 0.79 MB
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 101 || 108 || 111 || 112 || 112 || 112 || Satiated on the iteration '''2''', base consumption 7 MB, extra consumption 4 MB ('''57''' %), liboscada.so 3.4 MB, ui_WebVision.so 0.85 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 144 || 152 || 152 || 152 || 152 || 152 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0 MB ('''0''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 + MALLOC_ARENA_MAX=1 || 126.5 || 132.5 || 133 || 133 || 133 || 133 || Satiated on the iteration '''1''', base consumption 6 MB, extra consumption 0.5 MB ('''8''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 151 || 158 || 162.5 || 166 || 166 || 166 || Satiated on the iteration '''3''', base consumption 7 MB, extra consumption 8 MB ('''114''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 || 125 || 131 || 132 || 136 || 136 || 139 || Satiated on the iteration '''5''', base consumption 6 MB, extra consumption 8 MB ('''133''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 8 i386, GLibC 2.19, GCC 4.9.2 || 92.5 || 99 || 101.5 || 103 || 103.5 || 103.5 || Satiated on the iteration '''2''', base consumption 6.5 MB, extra consumption 4.5 ('''69''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.94 MB
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 70 || 76 || 76 || 76 || 77 || 77 || Satiated on the iteration '''2''', base consumption 6 MB, extra consumption 1 MB ('''16''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.9 MB
|-
| ALTLinux 6 i386, GLibC 2.11.3, GCC 4.5.4 || 69 || 74 || 75 || 75 || 75 || 75 || Satiated on the iteration '''2''', base consumption 5 MB, extra consumption 1 MB ('''20''' %), liboscada.so 2.3 MB, ui_WebVision.so 0.9 MB

|-
| colspan="9" | ''Creation only VCA-session, from remote connection to the visualizer server''
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 180 || 186 || 186 || 186 || 186 || 186 || Satiated on the iteration '''1''', extra consumption 0.2 MB (3 %)
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 100 || 104 || 105 || 105 || 105 || 105 || Satiated on the iteration '''1''', extra consumption 1 MB (25 %)

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 148 || 154 || 155 || 155 || 155 || 155 || Satiated on the iteration '''1''', extra consumption 1 MB (16 %)
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 69 || 72 || 72 || 72 || 72 || 72 || Satiated on the iteration '''1''', extra consumption 0 MB (0 %)
|}

CONCLUSION: We see obvious degradation in the memory effectivity on the last Debian releases starting at Debian 8 (GLibC 2.19) on I386 and Debian 9 (GLibC 2.24) on AMD64, when the memory consumption increased up to 200% after 3,4 free-allocate iterations of the same data. To more presenting of the problem there have built follow images on the data basis:

[[file:WebVision_MemEffectAMD64.png|center|frame|Fig.5. Memory effectivity on AMD64 platform.]]

[[file:WebVision_MemEffectI386.png|center|frame|Fig.6. Memory effectivity on I386 platform.]]

[[file:WebVision_AbsInitSizeAMD64.png|center|frame|Fig.7. Absolute initial size of OpenSCADA "AGLKS" on the platform AMD64.]]

[[file:WebVision_AbsInitSizeAI386.png|center|frame|Fig.8. Absolute initial size of OpenSCADA "AGLKS" on the platform I386.]]

MEASURES:
# The optional background objects were implemented for the primitives "FormEl" and "Text", what will have most effect on mnemonic-schemes with these elements and wont have many effect for other, see the measuring data above.
# There were some tries to tune the memory allocator of GLibC using "[https://www.gnu.org/software/libc/manual/html_node/Memory-Allocation-Tunables.html Memory Allocation Tunables]" without any significant effect, so we will [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=934080 notify the Debian community], firstly.
# The problem was detected in arenas of the memory allocator, setting whose number to 1 (MALLOC_ARENA_MAX=1) completely resolves the problem and the effect you may see on Figures 9, 10, for a real big application.

[[file:WebVision_MemoryDef.png|center|frame|Fig.9. Tendency of the memory consumption on a real big application at the default conditions.]]

[[file:WebVision_MemoryArenas1.png|center|frame|Fig.10. Tendency of the memory consumption on a real big application at the environment variable MALLOC_ARENA_MAX=1.]]

{{CntHdr|20.06.2013}}
GROUNDS: At working with the board [[Special:MyLanguage/Using/Kontron_MOPSlcdLX|MOPSlcdLX]], attention was drawn to the heavy load of the task of forming full-size trends. As it turned out later, a large load is created by the formation of a PNG image in the GD2 library, or rather, the packing procedure of ZLib. The subject analysis of the performance of the formation of images of various formats on this board is summarized in the table below:
{| class="wikitable"
|-
! Format !! Trend building, milliseconds !! Converting to the image format, milliseconds !! Size of the image, bytes
|-
| PNG (0) || 200 || 800 || 1700365
|-
| PNG (1) || 200 || 690 || 24000
|-
| PNG (-1) || 200 || 1000 || 14800
|-
| PNG (9) || 200 || 1900 || 13354
|-
| JPEG (-1) || 200 || 180 || 53157
|-
| GIF || 200 || 380 || 14300
|}

CONCLUSION: As can be seen from the table above, the operation of forming PNG as a whole is resource-intensive and the most optimal level of compression is "1". At the same time, the formation of JPEG and GIF is much faster, but these image formats have a number of critical flaws, namely: JPEG does not have an alpha channel (transparency), and GIF is limited by the number of colors, which in both cases leads to loss of transparency and distortion of text smoothing and images in general.

MEASURES: The ability to select the compression level for the generated PNG images is added, and the default value is set to the optimal level "1". The implementation of the formation of the "Diagram" primitive on the browser side in the "svg" or "canvas" tags is planned.

== Зауваження ==
На цьому етапі модуль може бути використаний для побудови реальних інтерфейсів користувача з підтримкою основних функцій. Однак, окремі проблеми можуть виникати як з причини недопрацьованості, так й різниці браузерів. На цей час достатньо якісно забезпечено працездатність на браузерах: Chromium (Google Chrome), FireFox, Opera, Konqueror.

== Посилання ==
* [[:File:WebVision MemAllocFree.ods|Електронна таблиця: Аналіз ефективності розподілу пам'яті.]]

Modules/WebVision/en

2026-05-10T04:54:23Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Module !! Name !! Version !! License !! Source !! Languages !! Platforms !! Type !! Author
|-
<section begin=info />
| [[Special:MyLanguage/Modules/WebVision|WebVision]] || Operation user interface (WEB)
| 6.16 || GPL2 || ui_WebVision.so || en,uk,ru,de || x86,x86_64,ARM
<section end=info />
| UI || {{Author|Roman Savochenko|Maxim Lysenko (2007-2012), Ksenia Yashina (2007-2008)}}
|-
! colspan="9" | Description
|-
| colspan="9" | Visual operation user interface, based on the WEB — front-end to the VCA engine.
* '''Total complexity:''' > 50 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for the primitive "Media" and Notification on 1.35 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Hadi Ramezani
* '''Sponsored by, for the Notification on 0.85 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
* '''Sponsored by, for finishing the mirroring of the primitive ElFigure on 0.5 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' SVItoVYR Ltd
* '''Sponsored by, for the Export on 0.8 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' Vinnica Poultry Farm
* '''[[Special:MyLanguage/Works/To_do|To Do]]:'''
<section begin=ToDo />
: * revise and unify the keyboard focus forcing on a first active element considering them specifity, to ensure the keyboard shortcuts;
: - expand the primitive "Diagram" by the mouse scaling operations;
: - implement own RTE-editor for the view Text of the primitive FormEl;
: - ElFigure: fix some properties loss (line width at the least) at the actions processing, in the way of the primitive code common refactoring;
: - expand the status-bar, with the functions:
:: - printing and exporting the Diagram primitive after it moving to "SVG".
: - ElFigure,Diagram: enable or make the anti aliasing, for the library GD;
: - implement the primitives "Diagram", "ElFigure" in the tag "SVG";
: - expand the variant "Animation" of the primitive "Media" in using the raw image files, like to PNG.
<section end=ToDo />
|}

The module provides in OpenSCADA a mechanism of the final visualization of the visual control area (VCA). The module is based on WEB technologies (XHTML, JavaScript, CSS, AJAX). In its work, the module uses the data from the VCA engine — module [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].
{{#lst:Sub-projects/VCA|Introduce}}
In order to avoid these problems, as well as to create as soon as possible the full spectrum of different types of VCA, [[Special:MyLanguage/Sub-projects/VCA|the generic concept of VCA]] is established. The result of this project — this direct visualization module (based on the Web-technologies), direct visualization module [[Special:MyLanguage/Modules/Vision|Vision]] and the VCA engine [[Special:MyLanguage/Modules/VCAEngine|VCAEngine]].

== Purpose ==
This module of the direct visualization of the VCA serves only for the execution of the VCA interfaces in the area of WEB-technologies!

The user interface forms in WEB-browser, by reference to the WEB-server and receiving from it XHTML-document over HTTP. In this case, the WEB-server — OpenSCADA, which supports standard communication mechanisms of the TCP-networks (module [[Special:MyLanguage/Modules/Sockets|Transport.Sockets]]), hypertext transfer protocol (module [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]]), as well as encryption of the traffic between the browser and the server ([[Special:MyLanguage/Modules/SSL|Transport.SSL]]). Therefore, in order to access the user interface provided by this module, OpenSCADA must configure transport (Transport.Sockets or Transport.SSL) in conjunction with the HTTP protocol (Protocol.HTTP). OpenSCADA comes with configuration files that contain the Transport.Sockets configuration for port 10002. Consequently, the module interface, in the default, will be available at URL: "<nowiki>http://localhost:10002</nowiki>".

The final version of this VCA module, built on the basis of this module, will provide:
{{#lst:Sub-projects/VCA|TargetFeatures}}

== Execution of the VCA interfaces ==
Execution of the VCA interface is to run a new project session, or connect to the existing one, on the level of the VCA engine (Fig.2). Before the connection request to the session the user authentication request (Fig.1) is done. Then the module of direct visualization displays and controls the data of the session. The main window of the execution mode of this module has the form presented at Figure 3. The administrator users ("root" or in the group "root") can close the opened sessions.

The interface of the execution window is built fully dynamically by the JavaScript script on the basis of the contents of the project session through direct XML requests to the server.

Update of the contents of the open pages of the visual interface with periodicity of the project session is implemented. During the upgrade process:
:- request, in the model, of opened pages list and checking consistency of the really opened pages to this list;
:- requests of modified data on each opened page and its widgets;
:- updating content of the pages and their widgets in accordance with the received modified data.

The mechanism of the request for only modified data is based on the absolute counter of the session execution. When you make real changes in the attributes of widgets the remembering of the value of this counter is made, which allows us to identify the modified attributes. This approach allows to increase productivity and reduce the load on the traffic in case of access to the model through the network.

Hierarchically, the module assumes the possibility of placing pages of the project as in the main window of execution (Fig. 3), and by placing inside the container widgets, as well as by opening additional windows over the main one.

Located in the status bar:
* On the right side:
** the current user, on whose behalf the VCA interface is executed — by a clicking this user can be changed, typing of the new username and password;
** the current interface style, which can be changed selecting need one in the combobox;
** the current alarm status by a lamp with color related to the alarm level and the active notifiers' icons; blinks at the alarm appearing or changing; pressing on the lamp you may quiet the alarm in whole or the desired type of the notification, pressing the correspond notifier icon near;
** the menu buttons of call the page printing and data exporting for:
*** printing: Main Page, Documents;
*** exporting: Documents (HTML,CSV), Tables (CSV).
** manual on the VCA-project — calls by a click the manual on the visualization project for the file "'''{ProjVCA_ID}.[pdf|html|odt]'''" in [[Special:MyLanguage/Documents/Program_manual#Config|the document folder]] or specified in the [[#SpecAttrs|"prjDoc" attribute]];
** panel of user statuses and actions when specified in the [[#SpecAttrs|"statLine" attribute]]; mouse clicking left, right and double forms events to the main interface page.
* In the main field of the status line various messages and assistance messages are displayed.

The module supports multi-language which one enabled by the [[Special:MyLanguage/Documents/Program_manual#ConfigTr|dynamic messages translation of OpenSCADA]]. The gotten language passes by the module [[Special:MyLanguage/Modules/HTTP|Protocol.HTTP]] and detects in way and by the order:
* URL's parameter "lang".
* Authenticated user's language.
* Language of the Web-browser from the HTTP property "Accept-Language".
* Generic language of the OpenSCADA process.

[[file:HTTP_auth.png|center|frame|Fig.1. Authentication page.]]

[[file:WebVision_wvis_connect.png|center|frame|Fig.2. Connection or creation of a new session of the execution project of the VCA.]]

[[file:WebVision_wvis_run.png|center|frame|Fig.3. Main execution window.]]

== {{Anch|Primitives|Presentation of the basic elements (primitives)}} ==
This version of the module does not implement all the shapes of the primitives laid by the project. In general, the project provides the following primitives:
{| class="wikitable"
|-
! Identifier !! Name !! Function
|-
| ElFigure || Elementary graphical figure ||
The primitive is the basis for drawing elementary graphical shapes with their possible combinations in a single object. The support of the following elementary figures is provided:
* Line.
* Arc.
* Bézier curve.
* Fill of the enclosed space.<br/>
For all the figures, contained in the widget, set the common properties of thickness, color, etc., provides the possibility to specify the above-mentioned attributes for each figure separately and their dynamization.
|-
| FormEl || Element of the form ||
Includes support for the standard form components:
* Line edit.
* Text edit.
* Check box.
* Button.
* Combo box.
* List.
* Tree.
* Table.
* Slider.
* Scroll bar.
|-
| Text || Text || Text element-label. Characterized by the font type, color, orientation and alignment. Support for arguments is provided.
|-
| Media || Media || Element of the visualization of raster and vector images of various formats, playback of the animated images, playback of the audio fragments and view of the video fragments.
|-
| Diagram || Diagram || Element of the diagram with the support of the visualization in the real-time for the flow of several: trends (time charts), spectrum, XY diagrams.
|-
| Protocol || Protocol || Element of the protocol — visualizer of the program messages, with support of the multiple operating modes.
|-
| Document || Document || Element of the generating reports, journals and other documentation on the basis of available data.
|-
| Box || Container || Contains the mechanism for other widgets placement-including with the purpose of creation of new, more complex, widgets and pages of the end visualization.
|-
| Function, <span style="color: red">in plane</span> || Function of API of the object model of OpenSCADA || Not visual widget, on the runtime side, which allows to include a computing function of the object model of OpenSCADA in the VCA.
|}

{{Anch|SpecAttrs|The visualizer module provides and uses set of specific attributes}} of the generic means, the information of which is given in the table. These attributes are automatically created by the visualizer in their absence and during the first run, or created by the user in the frame of the specified area, as needed.
{| class="wikitable"
|-
! Identifier (area) !! Name !! Appointment
|-
| keepAspectRatio (main page) || Keep aspect ratio on scale || Keep aspect ratio of the pages on scale.
|-
| stBarNoShow (main page) || Do not show the status bar || Hide the status bar of the main window.
|-
| notify{N}, notifyVisWebVision{N} (page) || Notification: type {N} || [[File:at.png]] Create manually with the type "Text"!
Specifies a notifier and a procedure of the notification resource obtaining according to the [[Special:MyLanguage/Modules/VCAEngine#Alarms|"Signalling (Alarms)" conception]].
|-
| statLine (main page) || Status line items || [[File:at.png]] Create manually with the type "Text"!
Text field with description of the status line item in the string form "'''{Id}:{Label}:{ToolTip}:{Color}:{Img}'''", where:
* "Id" — identifier, uses also to form events from the widget "stIt_{Id}".
* "Label" — visual label of the status element.
* "ToolTip" — context help about the element.
* "Color" — label color.
* "Img" — image of the status element, instead the label.
|-
| userSetVis (main page) || Setting the user || [[File:at.png]] Create manually with the type "String"!
Change the user or call a dialog to select it. Variants of the value:
* "*" — call for a selecting dialog of the user;
* "$" — change the user to the default one;
* "{user}[:{password}]" — direct change to ''user'' with ''password''; for empty password, the user is changed only if its permission is lesser or equal; a useful example of changing to the "user" after one minute inactivity:
<syntaxhighlight lang="JavaScript" style="margin-left: 20pt">
if((SYS.time()-this.ownerSess().userActTm()) < 60)userSetVis = "";
else if(this.ownerSess().reqUser() != "user") userSetVis = "user";
</syntaxhighlight>
|-
| prjDoc (main page) || Project document || [[File:at.png]] Create manually with the type "String"!
Specifying the project documentation of call from the status line's button with a possibility of disabling-concealing the button at empty value. The documentation specified in view "'''<nowiki>{OffLine}|{OnLineOpenSCADAWiki}</nowiki>'''", for example for the [[Special:MyLanguage/Using/Model_AGLKS|AGLCS project]] — "<nowiki>AGLCS|Using/Model_AGLKS</nowiki>". The online part is used in first order at its specifying!
|-
| vs_goHttpUrl (view "Button" of the primitive "FormEl") || Go to the HTTP URL || [[File:at.png]] Create manually with the type "String"!
Go to the specified URL at the button press.
|-
| vs_background (views "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" of the primitive "FormEl") || Custom background || [[File:at.png]] Create manually with the type "String"!
Specifies for the custom background in the form '''{color}-{transp} {image}'''.
|-
| vs_border (views "Line edit", "Text edit", "Combo box", "List", "Tree", "Table" of the primitive "FormEl") || Custom border || [[File:at.png]] Create manually with the type "String"!
Specifies for the custom border in the standard CSS-form '''{wdth}px {style} {color}'''.
|-
| vs_winTitle (the view "Box") || Window title || [[File:at.png]] Create manually with the type "String"!
Dynamic window title value.
|}

Consider the implementation of each primitive in more detail.

=== Elementary figure primitive (ElFigure) ===
<section begin=ElFigure />
Support of the elementary figures is implemented: lines, elliptical arcs, Bézier curves and fill of the enclosed space with the color and image with the properties:
* formation of arbitrary images from three elemental shapes and fillings of closed spaces with color or image;
* there is the possibility of determination of the figures' properties both in general and individual to each one: line width, color and style, line border's width and color, filling's color and image;
* scaling;
* transformation: rotation and mirroring;
* user's attributes support for dynamic: points, widths, colors, styles and images;
* formation of events by action of the mouse manipulator in a closed space and in general.

Figure shows a part of the screen with a frame containing the elementary figures.

[[file:WebVision_wvis_run_elfig.png|center]]
<section end=ElFigure />

=== Text primitive (Text) ===
<section begin=Text />
Support of the text element with the following properties is implemented:
* Font with the properties: type-class, size, bold, italic, strikeout and underline.
* Text color.
* Text orientation.
* Automatic word wrap.
* Alignment of the text horizontally and vertically with all variants.
* Displaying the background as the color and image.
* Displaying the border around the text, with the specified color, width and style.
* Displaying HTML.
* Addition of the text by arguments of different type and properties.

Figure represents a part of the screen with the frame containing the text examples using various parameters.

[[file:WebVision_wvis_run_txt.png|center]]
<section end=Text />

=== Primitive of the form element (FormEl) ===
<section begin=FormEl />
Provides support for the form elements on the VCA frames with the planed properties, including the types:
* ''Line edit'' — Represented by the following types: "Text", "Combo", "Integer", "Real", "Time", "Date", "Date and time". All kinds of line editor support the confirmation of entry.
* ''Text edit'' — Provides the flat-text editor with the confirmation or denial of entry.
* ''Check box'' — Provides a field of binary flag.
* ''Button'' — Provides the button with support of the button color, image in the button and the modes:
** standard;
** checkable;
** call the menu;
** call the file loading;
** call the file saving.
* ''Combo box'' — Provides a field for selecting an item from the list of specified items
* ''List'' — Provides the list box with the control of the current item.
* ''Tree'' — Provides the tree element with possibility of an item selection.
* ''Table'' — Provides the table element with the possibility of selecting for cells, rows or columns and editing the cell content.
* ''Slider'' — Slider element.
* ''Scroll bar'' — Scroll bar (Equal to Slider).
* ''Password'' — Hidden password typing.

The "Enabled" and "Active" modes are implemented, as well as the transfer of changes and events to the data model of the VCA — engine. The mode "Active" cause to the activity cursor set for not empty background and the addition conditions of the different views "Text", "Media" and "Box":
* ''Text'' — not empty text;
* ''Media'' — not empty source image.

Figure represents a part of the screen with the frame containing the above-listed elements of the form.

[[file:WebVision_wvis_run_formel.png|center]]
<section end=FormEl />

=== Primitive of the displaying the media-materials (Media) ===
<section begin=Media />
Support of the element of the displaying of the media-materials with the following properties is provided:
* Indication of the media data source: images or video-material.
* Review of the images of most well-known formats with the possibility of fitting in the widget size and keeping aspect ratio here.
* Playback of the simple animated images and video formats with the possibility to control the playback speed (<font color="red">inaccessible</font>).
* Playback of the full-formatted video and audio by HTML5.
* Displaying the background as the color and image.
* Displaying the border along the perimeter of the widget, with the specified color, width and style.
* Formation of the active areas and generating the events when they are activated.

Figure represents a part of the screen with the frame containing examples of reviewing/playback of the media-data.

[[file:WebVision_wvis_run_media.png|center]]
<section end=Media />

=== Primitive of constructing diagrams (Diagram) ===
<section begin=Diagram />
The diagrams construction element releases for types: "Graph", "Spectrum" and "XY", with properties:
* General properties of the diagram types "Graph", "Spectrum" and "XY":
** possibility to select the archiver, the archive buffer or all their, at working with the archiving data;
** adaptation of the parameter graph to real data values by adjusting the scale, in the absence of a directly specified range of values;
** controlling by axis ranges in way increasing, decreasing and shifting;
** wide range of scaling and adapting the time axis with automatic fitting the requested data to quality pretty for imaging, or needed for export — specifying the maximum number of measurements per pixel;
** imaging dimensional grid and markers in horizontal and vertical with adapting to the imaging range;
** tracing mode of the current time by periodically updating and shifting the time of the diagram to the current time — the time of the last data in the archive buffer.
* Properties of the diagram type "Graph":
** constructing graphics up to 100 parameters per diagram in a percentage scale and displaying the selected parameters in its own scale;
** constructing graph for: current, archiving and users data;
** forming of an intermediate display buffer for current values;
** support for the active mode with cursor and getting values under the cursor;
** possibility of construction graphics as into both linear and logarithmic scale of the values.
* Properties of the diagram type "Spectrum":
** construction of graphics of the frequency spectrum of parameters up to 100 on one diagram in a percentage scale and the ability to display selected parameters in its own scale;
** constructing graph for: archiving and users data;
** support for the active mode with cursor and getting values under the cursor;
* Properties of the diagram type "XY":
** construction of XY graphs of parameters up to 50 on one diagram in a percentage scale and the ability to display selected parameters on its own scale;
** constructing graph for: current, archiving and users data;
** forming of an intermediate display buffer for current values;
** the parameters distributed by pairs at one graph, where paired by axis Y (0,2,4...) and unpaired by axis X (1,3,5...);
** possibility of construction graphics as into both linear and logarithmic scale of the values.

Figure represents a part of the screen with the frame containing examples of the diagrams: "Graph", "Spectrum" and "XY".

[[file:WebVision_wvis_run_diag.png|center]]
<section end=Diagram />

=== Primitive of the protocol formation (Protocol) ===
<section begin=Protocol />
Provides for support of the element of the protocol formation with the following properties:
* Protocol formation from the message archive for the specified time and depth.
* Request of the data from the message archivers.
* Selection of the data from the archives by the level of importance and the template of the message category.
* Support the mode of the tracking for the messages appearance in the message archive.

Figure represents a part of the screen with the frame containing an example of the protocol.

[[file:WebVision_wvis_run_prot.png|center]]
<section end=Protocol />

=== Primitive of the report formation (Document) ===
<section begin=Document />
Provides for support element of the report formation with the following properties:
* Flexible formation of document structure based on HyperText Markup Language, which provides support for a wide range of features in the documents formatting.
* Formation of the documents at a command or a schedule, which necessary for creation of reports to the archive and then reviewing the archive.
* Formation of the documents in real time, to provide them completely dynamically and on the basis of archives at the specified time.
* Using the widget attributes for transmission to the document of values and addresses to the archives, which allows you to use the document widget as a template when generating reports with other input data.

The basis of any document is the XHTML template. The XHTML-template is the tag "body" of the WEB-page which contains the document's static in the standard XHTML 1.0 and elements of the executable instructions in the user programming language of OpenSCADA in the view '''<?dp {procedure} ?>'''. The resulting document is formed by the procedures execution and insertion of their result into the document.

The source for values of the executable instructions are the widget attributes of the primitive, as well as all the mechanisms of the user programming language OpenSCADA. Attributes may be added by the user and they can be linked to the actual attributes or parameters or they can be autonomous, values of which will be formed in the widget procedure. In the case of linked attributes the values can be extracted from the archive-history.

Figure represents the frame, containing a sample of the document.

[[file:WebVision_wvis_run_doc.png|center]]
<section end=Document />

=== Primitive of the box-container (Box) ===
<section begin=Box />
Provides for support of the container primitive, which, in combination, plays the role of project pages. This primitive is the only container-element, which can itself include links to frames from the library, thus forming the user elements of the desired configuration. The primitive implements the properties provided by the project. Let's list, in points, the properties of this primitive:
* ''Container'' — Allows forming the desired objects by grouping in the primitive borders.
* ''Page'' — Elements, constructed on the basis of the primitive, may serve as a page of the user interface.
* ''Container of pages'' — Property of substitution, in the execution process, of its own content by another page. Used to create frames on the pages of the user interface. For example, the main page of the typical SCADA-system with signal objects is constructed in this way.
* ''Background'' — Supports for ability to specify the background as color and image.
* ''Border'' — Supports for displaying of the border with the specified color, width and style.
<section end=Box />

== Overall configuration of the module ==
To configure and control this module, you have the configuration page of the OpenSCADA control interface (Fig.4):
* Control for the active WEB-sessions.
* Configuring:
** Lifetime, in minutes, and maximum number of the sessions.
** Lifetime, in hours, and maximum number of the cached pages.
** Level of the PNG-images compression. The optimum is the minimum level 1, since large files get uncompressed, and higher compression levels create a higher load on the processor.
** Resizing raster images on the server side. Mostly to decrease too big images size then decrease the traffic, what causes to rise the server load.
** Custom interface CSS rules. CSS rules to override the standard ones what placed in the special token ##CUST_CSS## of the file WebVisionVCA.html.

[[file:WebVision_wvis_cfg.png|center|frame|Fig.4. Configuration page of the module.]]

You can deeply customise main interface of the module overriding and adding the HTML and JavaScript code by placing to folder of your OpenSCADA project files WebVisionVCA.html and WebVisionVCA.js which initially you can obtain from the module source code — [http://oscada.org/svn/trunk/OpenSCADA/src/moduls/ui/WebVision/ UI.WebVision].

== {{Anch|Efficiency|Efficiency and scalability}} ==
{{CntHdr|31.07.2019}}
GROUNDS: The Web-sessions may create many objects servicing the VCA-session for generating images, processing documents and performing other background functions of the end user Web-interface. Moreover, in difference to [[Special:MyLanguage/Modules/Vision|Vision]], the VCA-sessions may be created, closed and recreated again multiple times for different users and remote hosts. In the time the memory heap is affected by the memory fragmentation, so the program consumes more memory than at the start. The table below represents the phenomenon for different environments and the first page of [[Special:MyLanguage/Using/Model_AGLKS|the DemoDB (AGLKS) project]] reopening:
{| class="wikitable"
|-
! Environment !! Initially, MB !! Iter. 1, MB !! Iter. 2, MB !! Iter. 3, MB !! Iter. 4, MB !! Iter. 5, MB !! Resume
|-
| colspan="9" | ''Complete creation the Web- and VCA-sessions''

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=2 || 181 || 189 || 190 || 195 || 195 || 194 || Satiated on the iteration '''3''', base consumption 8 MB, extra consumption 5 MB ('''62.5''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 177 || 185 || 186 || 186 || 185 || 186 || Satiated on the iteration '''2''', base consumption 8 MB, extra consumption 1 MB ('''13''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB
|-
| Debian 9 amd64, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 160 || 168 || 168 || 168.5 || 168.5 || 168.5 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0.5 MB ('''6''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 + optional background objects in WebVision || 184 || 194.5 || 200 || 207 || 207 || 212.5 || Satiated on the iteration '''5''', base consumption 10.5 MB, extra consumption 18 MB ('''171''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.75 MB

|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 182 || 191.5 || 199 || 206 || 212 || 212 || Satiated on the iteration '''4''', base consumption 9.5 MB, extra consumption 20 MB ('''200''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.74 MB
|-
| Debian 9 amd64, GLibC 2.24, GCC 6.3.0 || 160 || 170 || 178 || 179 || 183 || 185 || Satiated on the iteration '''5''', base consumption 10 MB, extra consumption 15 MB ('''150''' %), liboscada.so 3.5 MB, ui_WebVision.so 0.72 MB
|-
| Debian 8 amd64, GLibC 2.19, GCC 4.9.2 || 125.5 || 133 || 139 || 139 || 139 || 139 || Satiated on the iteration '''2''', base consumption 7.5 MB, extra consumption 6 MB ('''80''' %), liboscada.so 3.8 MB, ui_WebVision.so 0.79 MB
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 101 || 108 || 111 || 112 || 112 || 112 || Satiated on the iteration '''2''', base consumption 7 MB, extra consumption 4 MB ('''57''' %), liboscada.so 3.4 MB, ui_WebVision.so 0.85 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 + MALLOC_ARENA_MAX=1 || 144 || 152 || 152 || 152 || 152 || 152 || Satiated on the iteration '''1''', base consumption 8 MB, extra consumption 0 MB ('''0''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 + MALLOC_ARENA_MAX=1 || 126.5 || 132.5 || 133 || 133 || 133 || 133 || Satiated on the iteration '''1''', base consumption 6 MB, extra consumption 0.5 MB ('''8''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 151 || 158 || 162.5 || 166 || 166 || 166 || Satiated on the iteration '''3''', base consumption 7 MB, extra consumption 8 MB ('''114''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 9 i386, GLibC 2.24, GCC 6.3.0 || 125 || 131 || 132 || 136 || 136 || 139 || Satiated on the iteration '''5''', base consumption 6 MB, extra consumption 8 MB ('''133''' %), liboscada.so 3.7 MB, ui_WebVision.so 0.9 MB
|-
| Debian 8 i386, GLibC 2.19, GCC 4.9.2 || 92.5 || 99 || 101.5 || 103 || 103.5 || 103.5 || Satiated on the iteration '''2''', base consumption 6.5 MB, extra consumption 4.5 ('''69''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.94 MB
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 70 || 76 || 76 || 76 || 77 || 77 || Satiated on the iteration '''2''', base consumption 6 MB, extra consumption 1 MB ('''16''' %), liboscada.so 3.6 MB, ui_WebVision.so 0.9 MB
|-
| ALTLinux 6 i386, GLibC 2.11.3, GCC 4.5.4 || 69 || 74 || 75 || 75 || 75 || 75 || Satiated on the iteration '''2''', base consumption 5 MB, extra consumption 1 MB ('''20''' %), liboscada.so 2.3 MB, ui_WebVision.so 0.9 MB

|-
| colspan="9" | ''Creation only VCA-session, from remote connection to the visualizer server''
|-
| Debian 10 amd64, GLibC 2.28, GCC 8.3.0 || 180 || 186 || 186 || 186 || 186 || 186 || Satiated on the iteration '''1''', extra consumption 0.2 MB (3 %)
|-
| Debian 7 amd64, GLibC 2.13, GCC 4.7.2 || 100 || 104 || 105 || 105 || 105 || 105 || Satiated on the iteration '''1''', extra consumption 1 MB (25 %)

|-
| Debian 10 i386, GLibC 2.28, GCC 8.3.0 || 148 || 154 || 155 || 155 || 155 || 155 || Satiated on the iteration '''1''', extra consumption 1 MB (16 %)
|-
| Debian 7 i386, GLibC 2.13, GCC 4.7.2 || 69 || 72 || 72 || 72 || 72 || 72 || Satiated on the iteration '''1''', extra consumption 0 MB (0 %)
|}

CONCLUSION: We see obvious degradation in the memory effectivity on the last Debian releases starting at Debian 8 (GLibC 2.19) on I386 and Debian 9 (GLibC 2.24) on AMD64, when the memory consumption increased up to 200% after 3,4 free-allocate iterations of the same data. To more presenting of the problem there have built follow images on the data basis:

[[file:WebVision_MemEffectAMD64.png|center|frame|Fig.5. Memory effectivity on AMD64 platform.]]

[[file:WebVision_MemEffectI386.png|center|frame|Fig.6. Memory effectivity on I386 platform.]]

[[file:WebVision_AbsInitSizeAMD64.png|center|frame|Fig.7. Absolute initial size of OpenSCADA "AGLKS" on the platform AMD64.]]

[[file:WebVision_AbsInitSizeAI386.png|center|frame|Fig.8. Absolute initial size of OpenSCADA "AGLKS" on the platform I386.]]

MEASURES:
# The optional background objects were implemented for the primitives "FormEl" and "Text", what will have most effect on mnemonic-schemes with these elements and wont have many effect for other, see the measuring data above.
# There were some tries to tune the memory allocator of GLibC using "[https://www.gnu.org/software/libc/manual/html_node/Memory-Allocation-Tunables.html Memory Allocation Tunables]" without any significant effect, so we will [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=934080 notify the Debian community], firstly.
# The problem was detected in arenas of the memory allocator, setting whose number to 1 (MALLOC_ARENA_MAX=1) completely resolves the problem and the effect you may see on Figures 9, 10, for a real big application.

[[file:WebVision_MemoryDef.png|center|frame|Fig.9. Tendency of the memory consumption on a real big application at the default conditions.]]

[[file:WebVision_MemoryArenas1.png|center|frame|Fig.10. Tendency of the memory consumption on a real big application at the environment variable MALLOC_ARENA_MAX=1.]]

{{CntHdr|20.06.2013}}
GROUNDS: At working with the board [[Special:MyLanguage/Using/Kontron_MOPSlcdLX|MOPSlcdLX]], attention was drawn to the heavy load of the task of forming full-size trends. As it turned out later, a large load is created by the formation of a PNG image in the GD2 library, or rather, the packing procedure of ZLib. The subject analysis of the performance of the formation of images of various formats on this board is summarized in the table below:
{| class="wikitable"
|-
! Format !! Trend building, milliseconds !! Converting to the image format, milliseconds !! Size of the image, bytes
|-
| PNG (0) || 200 || 800 || 1700365
|-
| PNG (1) || 200 || 690 || 24000
|-
| PNG (-1) || 200 || 1000 || 14800
|-
| PNG (9) || 200 || 1900 || 13354
|-
| JPEG (-1) || 200 || 180 || 53157
|-
| GIF || 200 || 380 || 14300
|}

CONCLUSION: As can be seen from the table above, the operation of forming PNG as a whole is resource-intensive and the most optimal level of compression is "1". At the same time, the formation of JPEG and GIF is much faster, but these image formats have a number of critical flaws, namely: JPEG does not have an alpha channel (transparency), and GIF is limited by the number of colors, which in both cases leads to loss of transparency and distortion of text smoothing and images in general.

MEASURES: The ability to select the compression level for the generated PNG images is added, and the default value is set to the optimal level "1". The implementation of the formation of the "Diagram" primitive on the browser side in the "svg" or "canvas" tags is planned.

== Notes ==
At this stage, the module can be used to construct real user interfaces with support for the main functions. However, some problems may arise due to the differences between browsers. At this time, provided enough quality performance on browsers: Chromium (Google Chrome), FireFox, Opera, Konqueror.

== Links ==
* [[:File:WebVision MemAllocFree.ods|Spreadsheet: Analysis of effectivity of the memory allocation.]]

Modules/WebCfgD/uk

2026-05-10T04:52:44Z

FuzzyBot: Updating to match new version of source page

Modules/WebCfgD/ru

2026-05-10T04:52:37Z

FuzzyBot: Updating to match new version of source page

Modules/WebCfgD/en

2026-05-10T04:52:37Z

FuzzyBot: Updating to match new version of source page

Modules/QTCfg/en

2026-05-10T04:51:53Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Module !! Name !! Version !! License !! Source !! Languages !! Platforms !! Type !! Author !! Description
|-
<section begin=info />
| [[Special:MyLanguage/Modules/QTCfg|QTCfg]] || Program configurator (Qt)
| 6.2 || GPL2 || ui_QTCfg.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| UI || {{Author|Roman Savochenko|Maxim Lysenko (2009) — the page initial translation}} || Provides the Qt-based configurator of OpenSCADA.
* '''[[Special:MyLanguage/Works/To_do|To Do]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

The module provides the configurator of OpenSCADA, which based on the multi-platform library [http://qt.io Qt] of the graphical user interface (GUI) of initially created by the firm [http://www.trolltech.com TrollTech].

The module is based on [[Special:MyLanguage/Documents/API|the control interface of OpenSCADA]], which means providing a single configuration interface. Update of the module may be required only in the case of updating the specification of the control interface language. To query the page context, group query of the control interface is used, which allows you to optimize the time of remote access on high-latency and slow communication channels.

Let's examine the working window of the configurator in Figure 1.

[[file:QTCfg_workplacestruct.png|center|frame|Fig.1. Working window of the configurator]]

The operating window of the configurator consists of the following parts:
:1 ''Menu'' — contains the drop-down menu of the configurator.
:2 ''Toolbar'' — contains quick control buttons.
:3 ''Navigator'' — designed for direct navigation by the control tree.
::: [[file:at.png]] Icon's image of [[Special:MyLanguage/Documents/Program_manual#Projects|the OpenSCADA project]] is taken firstly from the file "'''{StationName}.[png|gif|jpg|jpeg]'''" and next, at the first one missing, from the file "'''{StationID}.[png|gif|jpg|jpeg]'''", in [[Special:MyLanguage/Documents/Program_manual#Config|the icons folder]].
::3.1 Text entry field to search for an item in the current tree branch.
:4 ''Status line'' — indicating the configurator status with a button calling the status history.
::4.1 ''Indicator/choice of the user'' — displays the current user, by double-clicking the user selection dialog opens. Contains also an indicator of changes in the configuration.
:5 ''Workplace field'' — divided to parts:
::5.1 ''Node name'' — contains the current node name.
::5.2 ''Tabulator of the working areas'' — the root pages (control areas) of the node are placed into the tabulator. The control areas of the following levels are placed on the main control place.

Menu of the configurator contains the following items:
* ''File'' — group of the general commands:
** ''Load from DB'' — loads the selected object or branch of the object from the database.
** ''Load from DB forcibly'' — loads the selected object or branch of the object from the database forcibly, not only when it changed.
** ''Save to DB'' — saves the selected object or branch of the object to the database.
** ''Save to DB forcibly'' — saves the selected object or branch of the object to the database forcibly, not only when it changed.
** ''Close'' — closes the configurator window.
** ''Quit'' — quits OpenSCADA.
* ''Edit'' — editing commands:
** ''Add'' — adds a new object to the container.
** ''Delete'' — deletes the selected object.
** ''Copy item'' — copies the selected object.
** ''Cut item'' — cuts of the selected object. The original object is removed after paste.
** ''Paste item'' — pastes of the copied or cut item.
* ''View'' — navigation and control of the view commands:
** ''Up'' — goes to the parent page.
** ''Back'' — goes back to the previous page, with a menu of direct access items.
** ''Forward'' — goes forward to the forward page, with a menu of direct access items.
** ''Refresh'' — refreshes the current page.
** ''Start'' — runs periodically update of the current page content with an interval of one second.
** ''Stop'' — stops the periodically update of the current page content with an interval of one second.
** ''Favorite'' — going to the selected favorite pages.
** ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Help'' — assistance call commands:
** ''About'' — information about this module and OpenSCADA.
** ''About Qt'' — information about the Qt library.
** ''Manual on 'QTCfg' '' — calls inline or offline manual on the module QTCfg.
** ''Manual on 'OpenSCADA 0.9' '' — calls inline or offline index of links to documents and manuals on OpenSCADA.
** ''Manual on the page'' — calls inline or offline manual on selected page.
** ''What's This'' — requests information for the interface elements and receive their full contextual help.

The toolbar contains the following management buttons (from left to right):
* ''Load from the DB'' — loads the selected object or branch of the object from the database.
* ''Save to the DB'' — saves the selected object or branch of the object to the database.
* ''Add'' — adds a new object to the container.
* ''Delete'' — deletes the selected object.
* ''Copy item'' — copies the selected object.
* ''Cut item'' — cuts of the selected object. The original object is removed after paste.
* ''Paste item'' — pastes of the copied or cut item.
* ''Up'' — goes to the parent page.
* ''Back'' — goes back to the previous page, with a menu of direct access items.
* ''Forward'' — goes forward to the forward page, with a menu of direct access items.
* ''Refresh'' — refreshes the current page.
* ''Start'' — runs periodically update of the current page content with an interval of one second.
* ''Stop'' — stops periodically update of the current page content with an interval of one second.
* ''Favorite'' — going to the selected favorite pages.
* ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Manual on the page'' — calls inline or offline manual on selected page.
* Call buttons of the graphical interface modules of OpenSCADA based on the Qt library

In the navigation tree the context menu of following contents is supported:
* ''Load from the DB'' — loads the selected object or branch of the object from the database.
* ''Save to the DB'' — saves the selected object or branch of the object to the database.
* ''Add'' — adds a new object to the container.
* ''Delete'' — deletes the selected object.
* ''Copy item'' — copies the selected object.
* ''Cut item'' — cuts of the selected object. The original object is removed after paste.
* ''Paste item'' — pastes of the copied or cut item.
* ''Favorite'' — going to the selected favorite pages.
* ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Refresh the items tree'' — refreshes the navigation tree content.

The control elements are divided to: basic, commands, lists, tables and images. All items are displayed in the sequence strictly appropriate to their location in the description of the control interface language.

== Configuration ==
In order to customize its own behavior in some cases, the module provides the ability to configure the parameters through the control interface of OpenSCADA (Fig.2). These parameters are:
* Timeouts of the connection checking '{fail}:{good}' — sometimes (for the SSH tunnels), it is useful to reduce the connecting timeout up to 30 seconds to keep the connection.
* Initial path of the configurator — allows to determine what local page to open when you start the configurator.
* Initial user of the configurator — points on behalf of the which user to open configuration without requiring a password.
* ToolTip limit in chars to prevent of big emerging help windows, by default 150. Set zero for disable.
* Go to configuration of the remote OpenSCADA hosts list, which is used to provide the remote configuration.

[[file:QTCfg.png|center|frame|Fig.2. Configuration page of the configurator.]]

Vertically scalable fields (list, text, and table) provide automatic scaling for available space and field contents. In addition, they have the ability to manually change their height by snapping and dragging the bottom of the widget, which, however, does not work for all Qt widget styles.

== Basic elements ==
Into the number of the basic elements are included: information elements, the field to input values, the elements of combo box, flags, text fields. In the case of absence of an element name, the basic element connects to the previous basic element. Examples of the basic elements with the connection is shown in Figure 3.

For input elements that do not provide immediate changes and can be edited for a long time before final completion, a confirmation mechanism is provided. This mechanism eliminates the delay when editing, especially in the case of the remote stations configuration, and to make changes on the confirmation. The input elements with confirmation include: fields for entering text strings or numerical values and text fields. Confirmation is made by pressing the button that appears next to the input field after the start of editing.

Text fields support finding also as the syntax highlighting, the rules are transmitted in the form of regular expressions from the control interface or can be builtin to the text value as a commentary in [[Special:MyLanguage/Documents/API#SnthHgl|the XML-tag "SnthHgl"]].

[[file:QTCfg_genelem.png|center|frame|Fig.3. Connection of the basic elements.]]

== Commands ==
The commands are the elements of transferring of certain instructions of an action to the node and for organization of links-transitions on other pages. Commands may contain parameters. The parameters are formed from the basic elements. Example of the commands with the parameters is shown in Figure 4.

[[file:QTCfg_commandelem.png|center|frame|Fig.4. The command.]]

== Lists ==
The lists contain a group of basic elements of the same type. Operations under the elements are accessible via the context menu of the list. Through the elements of the list can be performed the moving operations to other pages, mostly children. The transition is implemented by double-clicking of the mouse on an element of the list. Lists can be indexed. An example of the list is shown in Figure 5.

[[file:QTCfg_listelem.png|center|frame|Fig.5. The list.]]

== Tables ==
The tables contain values of the basic elements and support finding. Type of the basic element is an individual for each column. Example of the table is given in Figure 6. Operations on the structure of the table for editable tables are accessible through the context menu. Editing of the table is done by double-clicking on the desired cell.

[[file:QTCfg_tableelem.png|center|frame|Fig.6. The table.]]

== Images ==
The images are designed to transmit graphic information into the configurators. Example of the image is shown in Figure 7. From the context menu you can save the image and writable ones you can also load and clear.

[[file:QTCfg_imgelem.png|center|frame|Fig.7. The image.]]

Modules/QTCfg/ru

2026-05-10T04:51:53Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Имя !! Версия !! Лицензия !! Источник !! Языки !! Платформы !! Тип !! Автор !! Описание
|-
<section begin=info />
| [[Special:MyLanguage/Modules/QTCfg|QTCfg]] || Конфигуратор программы (Qt)
| 6.2 || GPL2 || ui_QTCfg.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| Пользовательские интерфейсы || Роман Савоченко || Предоставляет основанный на Qt конфигуратор OpenSCADA.
* '''[[Special:MyLanguage/Works/To_do|Задачи (To Do)]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

Модуль предоставляет конфигуратор OpenSCADA, который основан на многоплатформенной библиотеке [http://qt.io Qt] графического пользовательского интерфейса (GUI), изначально созданного фирмой [http://www.trolltech.com TrollTech].

В основе модуля лежит [[Special:MyLanguage/Documents/API|интерфейс управления OpenSCADA]], а значит предоставляется единый интерфейс конфигурации. Обновление модуля может потребоваться только в случае обновления спецификации языка интерфейса управления. Для запроса контекста страницы используется групповой запрос интерфейса управления, что позволяет оптимизировать время удалённого доступа по высоколатентным и медленным каналам связи.

Рассмотрим рабочее окно конфигуратора на рисунке 1.

[[file:QTCfg_workplacestruct.png|center|frame|Рис.1. Рабочее окно конфигуратора.]]

Рабочее окно конфигуратора состоит из следующих частей:
:1 ''Меню'' — содержит выпадающее меню конфигуратора.
:2 ''Панель инструментов'' — содержит кнопки быстрого управления.
:3 ''Навигатор'' — предназначен для прямой навигации по дереву управления.
::: [[file:at.png]] Изображение иконки [[Special:MyLanguage/Documents/Program_manual#Projects|проекта OpenSCADA]] сначала получается из файла "'''{StationName}.[png|gif|jpg|jpeg]'''", а затем, при отсутствии первого, из файла "'''{StationID}.[png|gif|jpg|jpeg]'''", в [[Special:MyLanguage/Documents/Program_manual#Config|каталоге иконок]].
::3.1 Поле ввода текста для поиска элемента в текущей ветви дерева.
:4 ''Строка статуса'' — отображает состояний конфигуратора с кнопкой вызова истории строки статуса.
::4.1 ''Индикатор/выбор пользователя'' — отображает текущего пользователя, по двойному клику открывается диалог выбора пользователя. Также содержит индикатор факта внесения изменений в конфигурацию.
:5 ''Рабочее поле'' — поделено на части:
::5.1 ''Имя узла'' — содержит имя текущего узла.
::5.2 ''Табулятор рабочих областей'' — в табулятор помещаются корневые страницы (области управления) узла. Области управления следующих уровней помещаются в основном пространстве контроля.

Menu of the configurator contains the following items:
* ''File'' — group of the general commands:
** ''Load from DB'' — loads the selected object or branch of the object from the database.
** ''Load from DB forcibly'' — loads the selected object or branch of the object from the database forcibly, not only when it changed.
** ''Save to DB'' — saves the selected object or branch of the object to the database.
** ''Save to DB forcibly'' — saves the selected object or branch of the object to the database forcibly, not only when it changed.
** ''Close'' — closes the configurator window.
** ''Quit'' — quits OpenSCADA.
* ''Edit'' — editing commands:
** ''Add'' — adds a new object to the container.
** ''Delete'' — deletes the selected object.
** ''Copy item'' — copies the selected object.
** ''Cut item'' — cuts of the selected object. The original object is removed after paste.
** ''Paste item'' — pastes of the copied or cut item.
* ''View'' — navigation and control of the view commands:
** ''Up'' — goes to the parent page.
** ''Back'' — goes back to the previous page, with a menu of direct access items.
** ''Forward'' — goes forward to the forward page, with a menu of direct access items.
** ''Refresh'' — refreshes the current page.
** ''Start'' — runs periodically update of the current page content with an interval of one second.
** ''Stop'' — stops the periodically update of the current page content with an interval of one second.
** ''Favorite'' — going to the selected favorite pages.
** ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Help'' — assistance call commands:
** ''About'' — information about this module and OpenSCADA.
** ''About Qt'' — information about the Qt library.
** ''Manual on 'QTCfg' '' — calls inline or offline manual on the module QTCfg.
** ''Manual on 'OpenSCADA 0.9' '' — calls inline or offline index of links to documents and manuals on OpenSCADA.
** ''Manual on the page'' — calls inline or offline manual on selected page.
** ''What's This'' — requests information for the interface elements and receive their full contextual help.

The toolbar contains the following management buttons (from left to right):
* ''Load from the DB'' — loads the selected object or branch of the object from the database.
* ''Save to the DB'' — saves the selected object or branch of the object to the database.
* ''Add'' — adds a new object to the container.
* ''Delete'' — deletes the selected object.
* ''Copy item'' — copies the selected object.
* ''Cut item'' — cuts of the selected object. The original object is removed after paste.
* ''Paste item'' — pastes of the copied or cut item.
* ''Up'' — goes to the parent page.
* ''Back'' — goes back to the previous page, with a menu of direct access items.
* ''Forward'' — goes forward to the forward page, with a menu of direct access items.
* ''Refresh'' — refreshes the current page.
* ''Start'' — runs periodically update of the current page content with an interval of one second.
* ''Stop'' — stops periodically update of the current page content with an interval of one second.
* ''Favorite'' — going to the selected favorite pages.
* ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Manual on the page'' — calls inline or offline manual on selected page.
* Call buttons of the graphical interface modules of OpenSCADA based on the Qt library

In the navigation tree the context menu of following contents is supported:
* ''Load from the DB'' — loads the selected object or branch of the object from the database.
* ''Save to the DB'' — saves the selected object or branch of the object to the database.
* ''Add'' — adds a new object to the container.
* ''Delete'' — deletes the selected object.
* ''Copy item'' — copies the selected object.
* ''Cut item'' — cuts of the selected object. The original object is removed after paste.
* ''Paste item'' — pastes of the copied or cut item.
* ''Favorite'' — going to the selected favorite pages.
* ''Append to favorite for {Page}/Remove from favorite for {Page}'' — toggles the current page as favorite.
* ''Refresh the items tree'' — refreshes the navigation tree content.

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

== Configuration ==
In order to customize its own behavior in some cases, the module provides the ability to configure the parameters through the control interface of OpenSCADA (Fig.2). These parameters are:
* Timeouts of the connection checking '{fail}:{good}' — sometimes (for the SSH tunnels), it is useful to reduce the connecting timeout up to 30 seconds to keep the connection.
* Initial path of the configurator — allows to determine what local page to open when you start the configurator.
* Initial user of the configurator — points on behalf of the which user to open configuration without requiring a password.
* ToolTip limit in chars to prevent of big emerging help windows, by default 150. Set zero for disable.
* Go to configuration of the remote OpenSCADA hosts list, which is used to provide the remote configuration.

[[file:QTCfg_ru.png|center|frame|Рис.2. Страница конфигурации самого конфигуратора.]]

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

== Базовые элементы ==
В число базовых элементов входят: информационные элементы, поля ввода значений, элементы выбора из списка, флаги, текстовые поля. В случае отсутствия имени элемента, базовый элемент присоединяется к предыдущему базовому элементу. Пример группы базовых элементов с присоединением приведён на рисунке 3.

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

Текстовые поля поддерживает поиск, также как подсветку синтаксиса, правила которой передаются в виде регулярных выражений из интерфейса управления или могут быть встроены в значение текста как комментарий в [[Special:MyLanguage/Documents/API#SnthHgl|XML-теге "SnthHgl"]].

[[file:QTCfg_genelem_ru.png|center|frame|Рис.3. Присоединение базовых элементов.]]

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

[[file:QTCfg_commandelem_ru.png|center|frame|Рис.4. Команда.]]

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

[[file:QTCfg_listelem_ru.png|center|frame|Рис.5. Список.]]

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

[[file:QTCfg_tableelem_ru.png|center|frame|Рис.6. Таблица.]]

== Images ==
The images are designed to transmit graphic information into the configurators. Example of the image is shown in Figure 7. From the context menu you can save the image and writable ones you can also load and clear.

[[file:QTCfg_imgelem_ru.png|center|frame|Рис.7. Изображение.]]

Modules/QTCfg/uk

2026-05-10T04:51:45Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Модуль !! Ім'я !! Версія !! Ліцензія !! Джерело !! Мови !! Платформи !! Тип !! Автор !! Опис
|-
<section begin=info />
| [[Special:MyLanguage/Modules/QTCfg|QTCfg]] || Конфігуратор програми (Qt)
| 6.2 || GPL2 || ui_QTCfg.so || en,uk,ru,de,pt || x86,x86_64,ARM
<section end=info />
| Користувацькі інтерфейси || Роман Савоченко || Надає заснований на Qt конфігуратор OpenSCADA.
* '''[[Special:MyLanguage/Works/To_do|Завдання (To Do)]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

Модуль надає конфігуратор OpenSCADA, який засновано на багатоплатформеній бібліотеці [http://qt.io Qt] графічного користувацького інтерфейсу (GUI), початково створеного фірмою [http://www.trolltech.com TrollTech].

У основі модуля лежить [[Special:MyLanguage/Documents/API|інтерфейс управління OpenSCADA]], що означає надання єдиного інтерфейсу конфігурації. Оновлення модуля може знадобитися лише у випадку оновлення специфікації мови інтерфейсу управління. Для запиту контексту сторінки використовується груповий запит інтерфейсу управління, що дозволяє оптимізувати час віддаленого доступу за високо-латентними та повільними каналами зв'язку.

Розглянемо робоче вікно конфігуратору на рисунку 1.

[[file:QTCfg_workplacestruct_uk.png|center|frame|Рис.1. Робоче вікно конфігуратору.]]

Робоче вікно конфігуратору складається з наступних частин:
:1 ''Меню'' — містить меню конфігуратору, що випадає.
:2 ''Панель інструментів'' — містить кнопки швидкого управління.
:3 ''Навігатор'' — призначений для прямої навігації за деревом управління.
::: [[file:at.png]] Зображення іконки [[Special:MyLanguage/Documents/Program_manual#Projects|проекту OpenSCADA]] спочатку отримується із файлу "'''{StationName}.[png|gif|jpg|jpeg]'''", а потім, за відсутності першого, із файлу "'''{StationID}.[png|gif|jpg|jpeg]'''", у [[Special:MyLanguage/Documents/Program_manual#Config|теці іконок]].
::3.1 Поле вводу тексту для пошуку елементу у поточній гілці дерева.
:4 ''Рядок статусу'' — відображає стан конфігуратора з кнопкою виклику історії рядку статусу.
::4.1 ''Індикатор/обрання користувача'' — відображає поточного користувача, подвійним кліком відкривається діалог вибору користувача. Також містить індикатор факту внесення змін до конфігурації.
:5 ''Робоче поле'' — поділено на частини:
::5.1 ''Ім'я вузла'' — містить ім'я поточного вузла.
::5.2 ''Табулятор робочих областей'' — до табулятору розташовуються кореневі сторінки (області управління) вузла. Області управління наступних рівнів розташовуються у основному просторі контролю.

Меню конфігуратору містить наступні пункти:
* ''Файл'' — група загальних команд:
** ''Завантажити з БД'' — завантаження обраного об'єкту або гілки об'єктів з БД.
** ''Примусово завантажити з БД'' — примусове завантаження обраного об'єкту або гілки об'єктів з БД, не тільки коли змінено.
** ''Зберегти у БД'' — збереження обраного об'єкту або гілки об'єктів у БД.
** ''Примусово зберегти у БД'' — примусове збереження обраного об'єкту або гілки об'єктів у БД, не тільки коли змінено.
** ''Закрити'' — закриття вікна конфігуратору.
** ''Вихід'' — завершення роботи програми.
* ''Редагування'' — команди редагування:
** ''Додати'' — додання нового об'єкту до контейнеру.
** ''Видалити'' — видалення обраного об'єкту.
** ''Копіювати елемент'' — копіювання обраного об'єкту.
** ''Вирізати елемент'' — вирізання обраного об'єкту. Початковий об'єкт видаляється після вставки.
** ''Вставити елемент'' — вставка скопійованого або вирізаного елементу.
* ''Вид'' — команди навігації та управління видом:
** ''Нагору'' — піднятися вверх по дереву.
** ''Попередня'' — відкриття попередньої сторінки, що відкривалася, із меню прямо доступних елементів.
** ''Наступна'' — відкриття наступної сторінки, що відкривалася, із меню прямо доступних елементів.
** ''Оновити'' — оновлення вмісту поточної сторінки.
** ''Запустити'' — запуск періодичного оновлення вмісту поточної сторінки з інтервалом одна секунда.
** ''Зупинити'' — зупинка періодичного оновлення вмісту поточної сторінки з інтервалом одна секунда.
** ''Улюблене'' — перехід до улюбленої обраної сторінки.
** ''Додати до улюблених для {Сторінки}/Видалити із улюблених для для {Сторінки}'' — перемикає поточну сторінку в улюблених.
* ''Допомога'' — команди виклику допомоги:
** ''Про'' — інформація про цей модуль та OpenSCADA.
** ''Про Qt'' — інформація про бібліотеку Qt.
** ''Підручник на 'QTCfg' '' — виклик локального або віддаленого підручника по модулю QTCfg.
** ''Підручник на 'OpenSCADA 0.9' '' — виклик локального або віддаленого індексу посилань на документацію та підручники на OpenSCADA.
** ''Підручник на сторінку'' — виклик локального або віддаленого підручника обраної сторінки.
** ''Що це'' — запит інформації за елементами інтерфейсу та отримання їх повної контекстної допомоги.

Панель інструментів містить наступні кнопки швидкого управління (зліва на право):
* ''Завантажити з БД'' — завантаження обраного об'єкту або гілки об'єктів з БД.
* ''Зберегти у БД'' — збереження обраного об'єкту або гілки об'єктів у БД.
* ''Додати'' — додання нового об'єкту до контейнеру.
* ''Видалити'' — видалення обраного об'єкту.
* ''Копіювати елемент'' — копіювання обраного об'єкту.
* ''Вирізати елемент'' — вирізання обраного об'єкту. Початковий об'єкт видаляється після вставки.
* ''Вставити елемент'' — вставка скопійованого або вирізаного елементу.
* ''Нагору'' — підняття нагору по дереву.
* ''Попередня'' — відкриття попередньої сторінки, що відкривалася, із меню прямо доступних елементів.
* ''Наступна'' — відкриття наступної сторінки, що відкривалася, із меню прямо доступних елементів.
* ''Оновити'' — оновлення вмісту поточної сторінки.
* ''Запустити'' — запуск періодичного оновлення вмісту поточної сторінки з інтервалом одна секунда.
* ''Зупинити'' — зупинка періодичного оновлення вмісту поточної сторінки з інтервалом одна секунда.
* ''Улюблене'' — перехід до улюбленої обраної сторінки.
* ''Додати до улюблених для {Сторінки}/Видалити із улюблених для для {Сторінки}'' — перемикає поточну сторінку в улюблених.
* ''Підручник на сторінку'' — виклик локального або віддаленого підручника обраної сторінки.
* Кнопки виклику модулів графічних інтерфейсів OpenSCADA на бібліотеці Qt.

У дереві навігації підтримується контекстне меню наступного вмісту:
* ''Завантажити з БД'' — завантаження обраного об'єкту або гілки об'єктів з БД.
* ''Зберегти у БД'' — збереження обраного об'єкту або гілки об'єктів у БД.
* ''Додати'' — додання нового об'єкту до контейнеру.
* ''Видалити'' — видалення обраного об'єкту.
* ''Копіювати елемент'' — копіювання обраного об'єкту.
* ''Вирізати елемент'' — вирізання обраного об'єкту. Початковий об'єкт видаляється після вставки.
* ''Вставити елемент'' — вставка скопійованого або вирізаного елементу.
* ''Улюблене'' — перехід до улюбленої обраної сторінки.
* ''Додати до улюблених для {Сторінки}/Видалити із улюблених для для {Сторінки}'' — перемикає поточну сторінку в улюблених.
* ''Оновити елементи дерева'' — оновлення вмісту дерева навігації.

Елементи управління поділяються на: базові, команди, переліки, таблиці та зображення. Всі елементи відображаються у послідовності, яка суворо відповідає їх розташуванню у описі мови інтерфейсу управління.

== Конфігурація ==
Для налаштування власної поведінки у окремих випадках, модулем надається можливість налаштування параметрів за посередництвом інтерфейсу управління OpenSCADA (рис.2). Такими параметрами є:
* Таймаути перевірки підключення, у секундах, "{немає}:{є}" — інколи (для тунелю SSH) корисно зменшити таймаут перевірки наявності підключення до 30 секунд з метою утримання підключення.
* Початковий шлях конфігуратору — дозволяє визначити, яку локальну сторінку відкривати при запуску конфігуратору.
* Початковий користувач конфігуратору — вказує, від ім'я якого користувача відкривати конфігуратор без запиту пароля.
* Обмеження ToolTip, у символах, для запобігання спливання великих вікон допомоги, по замовченню 150. Встановити нуль для вимкнення.
* Перейти до конфігурації переліку віддалених хостів OpenSCADA, що використовується для надання можливості віддаленої конфігурації.

[[file:QTCfg_uk.png|center|frame|Рис.2. Сторінка конфігурації самого конфігуратору.]]

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

== Базові елементи ==
До числа базових елементів входять: інформаційні елементи, поля вводу значень, елементи обрання з переліку, прапорці-ознаки, текстові поля. У випадку відсутності ім'я елементу, базовий елемент приєднується до попереднього базового елементу. Приклад групи базових елементів з приєднанням наведено на рисунку 3.

Для елементів вводу, які не передбачають миттєвих змін та можуть тривалий час редагуватися перед остаточним завершенням, передбачено механізм підтвердження. Цей механізм дозволяє виключити затримки при редагуванні, особливо у випадках конфігурації віддалених станцій, та вносити зміни за підтвердженням. До елементів вводу з підтвердженням відносяться: поля вводу рядків тексту або чисельних значень та текстові поля. Підтвердження здійснюється натиском кнопки, яка з'являється поряд з полем вводу після початку редагування.

Текстові поля підтримують пошук, також як підсвічення синтаксису, правила чого передаються у вигляді регулярних виразів з інтерфейсу управління або можуть бути вбудовані до значення тексту як коментар у [[Special:MyLanguage/Documents/API#SnthHgl|XML-тегу "SnthHgl"]].

[[file:QTCfg_genelem_uk.png|center|frame|Рис.3. Приєднання базових елементів.]]

== Команди ==
Команди — це елементи передачі визначених вказівок дії вузлу та організації посилань-переходів на інші сторінки. Команди можуть містити параметри. Параметри формуються з базових елементів. Приклад команди з параметрами приведено на рисунку 4.

[[file:QTCfg_commandelem_uk.png|center|frame|Рис.4. Команда.]]

== Переліки ==
Переліки містять групу базових елементів одного типу. Операції над елементами доступні через контекстне меню переліку. Через елементи переліку можуть виконуватися операції переходу на інші сторінки, зазвичай дочірні. Перехід здійснюється посередництвом подвійного кліку мишею на елементі переліку. Переліки можуть бути індексованими. Приклад переліку наведено на рисунку 5.

[[file:QTCfg_listelem_uk.png|center|frame|Рис.5. Список.]]

== Таблиці ==
Таблиці містять значення базових елементів та підтримують пошук. Тип базового елементу є індивідуальним для кожного стовпчика. Приклад таблиці наведено на рисунку 6. Операції над структурою таблиці, для редагованих таблиць, доступні за посередництвом контекстного меню. Редагування елементів таблиці здійснюється шляхом подвійного кліку по потрібній клітинці.

[[file:QTCfg_tableelem_uk.png|center|frame|Рис.6. Таблиця.]]

== Зображення ==
Зображення призначено передавати графічну інформацію до конфігураторів. Приклад зображення наведено на рисунку 7. Із контекстного меню ви можете зберегти зображення, та доступні до запису можете також завантажити і очистити.

[[file:QTCfg_imgelem_uk.png|center|frame|Рис.7. Зображення.]]

Libs/Main graphical elements/en

2026-05-10T04:51:16Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Name !! Version !! License !! Source !! Languages !! Author !! Icon
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]
| 2.3 || 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 />
| {{Author|[[User:RomanSavochenko|Roman Savochenko]]|Maxim Lysenko (2011-2012) — the page initial translation}} || [[File:LibMainGraphElements.png]]
|-
! colspan="9" | Description
|-
| colspan="9" | Provides the library of the main elements of the user interface of common and the industrial automation.
* '''Founded:''' September 2007
* '''Initially created:''' in [http://wiki.oscada.org/HomePageEn/Using/GraphicElementsLibraries/MainElements the old Wiki]
* '''Used by:''' [[Special:MyLanguage/Using|most projects on OpenSCADA]]
* '''[[Special:MyLanguage/Works/To_do|To Do]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

The library is created to provide main elements of the user interface and it contains graphic elements, often need when forming the user interface of the automation of technological and common processes. The library is built on the basis [[Special:MyLanguage/Modules/VCAEngine#WidgetPrimitives|primitives of the widgets]] and the internal programming language [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc]].

The element's names and their parameters are available in languages: English, Ukrainian and mRussian. Their source code wrote in the human-language independent mode with calls for the translations by the function ''tr()'' and the message's translation also allowed for English, Ukrainian and mRussian.

For connection the library to a project of the OpenSCADA station you can obtain the database file as:
* supplied with a ready and proper package of the Linux distribution like to "openscada-libdb-vca", "openscada-LibDB.VCA";
* directly taken for most actual one from [http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/vcaBase.sql the subversion repository] and converted to the DB SQLite file in the way:
<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>
* downloaded for [[:File:vcaBase.db.gz|the one attached here]].

This obtained file next you can place into the project directory of the station and create the database object for the DB module "SQLite", registering the database file in the configuration.

== {{Anch|Widgets|Widgets — graphical elements}} ==
Contains general-purpose widgets that are intended to be placed on [[#MainFrames|the main frames]]. These main frames can also be frames outside of this [[#RootPgSo|concept of the signal objects of the root page "RootPgSo"]], but it should be taken in account that they often refer to and call certain [[#Panels|control panels]]!

{| class="wikitable"
<section begin=anShow />
| {{Anch|anShow|<h3>Analog show ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow|anShow]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=anShow />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.1 is used to display the current value of the analog parameter and the regulator mode, if the parameter is a regulator. Also this element generates notifications of violations on the corresponding parameter settings. The element commonly uses and represents the representative structure of [[Special:MyLanguage/Libs/Main#anUnif|the "Analog signal" DAQ-template]].

[[file:LibMainEls_AnShow.png|center|frame|Fig.1.1. The element "Analog show" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used by the developer to create mnemonic schemes with displaying of values of the analog parameters and PID-regulators. 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.

{{CntHdr|Using — runtime}}
In the runtime mode, in the main field of the element, there are displayed the parameter name, the regulator mode (only for the regulators) and the current value-variable of this parameter; which, depending on the presence of a violation, are displayed in the color style: ''labColorGood'', ''labColorWarning'', ''labColorAlarm''; and in which value the image of the inquieted parameter may blink. At the hardware errors and non validity the data, the last value is grayed out and crossed out. In the tooltip the user may get the linked parameter description and its errors.

In the active mode of the element you can obtain [[#Passport|the parameter passport]] clicking the right mouse button on the body of the widget. The passport will present all properties of the parameter. Pressing the left mouse button in the widget body will cause to appear in the panels area for [[#ElCadr|control panel]] of the parameter, and the selection of this widget will be displayed with the blinking frame.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pErr || Parameter: error || String || Input link || Parameter|err || Code and text of the parameter error. It is used to generate alarm. The following error codes are processed:
* 1,2 — failure, parameter is not valid, be shown in gray and cross out besides the case with ''redEVAL'';
* 3,4 — above and below the alarm limit, be shown in the styled color ''labColorAlarm'';
* 5,6 — above and below the warning limit, be shown in the styled color ''labColorWarning'';
* 10,11 — the user alarm codes of the statuses warning and alarm, be sown accordingly in the styled color ''labColorWarning'' and ''labColorAlarm''.
|-
| pModeA || Parameter: regulator mode: auto || Boolean || Input link || Parameter|auto || The large letter "A" is displayed on the left when the value checked.
|-
| pModeC || Parameter: regulator mode: cascade || Boolean || Input link || Parameter|casc || The large letter "C" is displayed on the left when the value checked.
|-
| pName || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter displayed over the value and inserted to the alarm messages.
|-
| pPrec || Parameter: precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| pVal || Parameter: value || Real || Input link || Parameter|var || Engineeric real value of the parameter.
|-
| redEVAL || Red parameter name in case of failure || Boolean || Constant || || By default, the color of the parameter's name for the "failure" state (EVAL value) is gray. But some critical for the process parameters must have the "failure" state displayed with the red parameter's name.
|-
| spName || Speech name || String (translate) || Constant || || The parameter name for speech synthesis during the formation of alarm messages taking into account accents of words, pauses, etc. Empty value disables the speech notification!
|}

{| class="wikitable"
<section begin=anShow1 />
| {{Anch|anShow1|<h3>Analog show 1 ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|anShow1]]); Analog show 1, short ([[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|anShow1s]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru
<section end=anShow1 />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.2 is used to display the current value of the analog parameter and a short prefix of the measured value type. Also this element generates notifications of violations on the corresponding parameter settings. The element commonly uses and represents the representative structure of [[Special:MyLanguage/Libs/Main#anUnif|the "Analog signal" DAQ-template]].

These two elements differ only in their initial horizontal size, that is, the second "Analog show 1, short" is a short version for very short cases and it is directly inherited from the first one.

[[file:LibMainEls_anShow1.png|center|frame|Fig.1.2. The element "Analog show 1" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used by the developer to create mnemonic schemes with displaying of values of the analog parameters with a prefix and/or as an element of the static screen table. 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.

{{CntHdr|Using — runtime}}
In the runtime mode, in the main field of the element, there are displayed the short prefix and the current value-variable of this parameter; which, depending on the presence of a violation, are displayed in the color style: ''labColorGood'', ''labColorWarning'', ''labColorAlarm''; and in which value the image of the inquieted parameter may blink. At the hardware errors and non validity the data, the last value is grayed out and crossed out. In the tooltip the user may get the linked parameter description and its errors.

In the active mode of the element you can obtain [[#Passport|the parameter passport]] clicking the right mouse button on the body of the widget. The passport will present all properties of the parameter. Pressing the left mouse button in the widget body will cause to appear in the panels area for [[#ElCadr|control panel]] of the parameter, and the selection of this widget will be displayed with the blinking frame.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pErr || Parameter: error || String || Input link || Parameter|err || Code and text of the parameter error. It is used to generate alarm. The following error codes are processed:
* 1,2 — failure, parameter is not valid, be shown in gray and cross out;
* 3,4 — above and below the alarm limit, be shown in the styled color ''labColorAlarm'';
* 5,6 — above and below the warning limit, be shown in the styled color ''labColorWarning'';
* 10,11 — the user alarm codes of the statuses warning and alarm, be sown accordingly in the styled color ''labColorWarning'' and ''labColorAlarm''.
|-
| pNAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter inserted to the alarm messages.
|-
| prec || Parameter: precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| pVal || Parameter: value || Real || Input link || Parameter|var || Engineeric real value of the parameter.
|-
| spName || Speech name || String (translate) || Constant || || The parameter name for speech synthesis during the formation of alarm messages taking into account accents of words, pauses, etc. Empty value disables the speech notification!
|-
| pName || Short name || String || Constant || || Short name-prefix value.
|-
| pNameSz || Short name size || Integer || Constant || || Size of the short name-prefix in pixels, use the zero value to disable the field.
|}

{| class="wikitable"
<section begin=TextLab />
| {{Anch|TextLab|<h3>Text label ([[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|TextLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=TextLab />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.3 is used to display the dynamic text labels, which form on basis of the discrete signals. Also this element generates notifications of violations on the locally defined condition, the attribute '''ntf''', additionally it cans generate alarms from the attribute "Error (err)". The element commonly uses and represents the representative structure of DAQ-templates of [[Special:MyLanguage/Libs/Main#digitBlockUnif|the discrete block]] and [[Special:MyLanguage/Libs/Main#codeState|the code state]].

* '''Sponsored by:''' Vassily Grigoriev, [http://e-beam.ru the Laboratory of Vacuum Technologies]

[[file:LibMainEls_TextLab.png|center|frame|Fig.1.3. The element "Text label" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used by the developer to create mnemonic schemes with displaying of text labels and/or as an element of the static screen table. To use it you need to add this widget to a mnemonic scheme, adjust for the horizontal, vertical size and link to the data source parameter.

{{CntHdr|Using — runtime}}
In the runtime mode, in the main field of the element, there are displayed the text label, what related to values of the discrete signals of the parameter and the attribute '''digStts''' configuration; where the background, depending to availability of a violation related to the attribute '''ntf''' condition, sets to the violation color; and to what the inquieted parameter may blink. At the hardware errors and non validity the data, the background shows in the gray color.

In the active mode of the element you can obtain [[#Passport|the parameter passport]] clicking twice the left mouse button on the body of the widget. The passport will present all properties of the parameter. Pressing the left mouse button in the widget body will cause to appear in the panels area for [[#ElCadr|control panel]] of the parameter, and the selection of this widget will be displayed with the blinking frame. The commands are duplicated in the context menu that appears when the right mouse button is pressed in the widget area.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| err || Parameter: error || Address || Input link || Parameter|err || Used as the address for accessing the DAQ-Parameter object of messages sending and the value also used for alarms generation.
|-
| NAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| DESCR || Parameter: description || String (translate) || Input link || Parameter|DESCR || Description or long name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| st_open || Parameter: status-open || Boolean || Input link || Parameter|st_open || The state "Opened" of the parameter or the common state of the switch at missing the state signal "Closed".
|-
| st_close || Parameter: status-close || Boolean || Input link || Parameter|st_close || The state "Closed" of the parameter.
|-
| st_text || Parameter: status (text) || String (translate) || Input link || Parameter|st_text || Text of the parameter state, at the mode "Code state".
|-
| digStts || Parameter: statuses || String (translate) || Input link || Parameter|digStts || Configuration of the parameter statuses with the structure '''{openedLabel}-{color};{closedLabel}-{color};{noOpenedClosedLabel}-{color};{OpenedClosedLabel}-{color};{errLabel}-{color}''', for the discrete block.
|-
| com || Parameter: command || Boolean || Full link || Parameter|com || The command "Open" of the parameter or the common command of the switch at missing the command signal "Close".
|-
| close || Parameter: close || Boolean || Full link || Parameter|close || The command "Close" of the parameter.
|-
| stop || Parameter: stop || Boolean || Full link || Parameter|stop || The command "Stop" of the parameter.
|-
| com_text || Parameter: command text (from digComs) || String || Full link || Parameter|com_text || Text of the parameter command, at the mode "Code state".
|-
| digComs || Parameter: commands || String (translate) || Input link || Parameter|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status.
|-
| ntf || Notification "{st}:{modes}:{Speech text}" || String (translate) || Constant || || Configuration of the notification forming at the status (st) [0|1|2(both)|3(err)] and [[Special:MyLanguage/Modules/VCAEngine#Alarms|the notification modes-methods (modes)]], as a string of the digital methods, and by the speech, if pointed such method. The speech message for "3(err)" is taken from the "Error (err)" attribute.
|}

{| class="wikitable"
<section begin=ImgLab />
| {{Anch|ImgLab|<h3>Image label ([[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|ImgLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=ImgLab />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.4 is used to display the dynamic image labels, which form on basis of the discrete signals. Also this element generates notifications of violations on the locally defined condition, the attribute '''ntf''', additionally it cans generate alarms from the attribute "Error (err)". The element commonly uses and represents the representative structure of DAQ-templates of [[Special:MyLanguage/Libs/Main#digitBlockUnif|the discrete block]] and [[Special:MyLanguage/Libs/Main#codeState|the code state]].

* '''Sponsored by:''' Vinnica Poultry Farm

[[file:LibMainEls_ImgLab.png|center|frame|Fig.1.4. The element "Image label" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used by the developer to create mnemonic schemes with displaying of image labels and/or as an element of the static screen table. To use it you need to add this widget to a mnemonic scheme, adjust for the horizontal, vertical size and link to the data source parameter.

{{CntHdr|Using — runtime}}
In the runtime mode, in the main field of the element, there are displayed the image label, what related to values of the discrete signals of the parameter and the attribute '''imgs''' configuration; where the background, depending to availability of a violation related to the attribute '''ntf''' condition, sets to the violation color; and to what the inquieted parameter may blink. At the hardware errors and non validity the data, the background shows in the gray color.

In the active mode of the element you can obtain [[#Passport|the parameter passport]] clicking twice the left mouse button on the body of the widget. The passport will present all properties of the parameter. Pressing the left mouse button in the widget body will cause to appear in the panels area for [[#ElCadr|control panel]] of the parameter, and the selection of this widget will be displayed with the blinking frame. The commands are duplicated in the context menu that appears when the right mouse button is pressed in the widget area.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| err || Parameter: error || Address || Input link || Parameter|err || Used as the address for accessing the DAQ-Parameter object of messages sending and the value also used for alarms generation.
|-
| NAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| DESCR || Parameter: description || String (translate) || Input link || Parameter|DESCR || Description or long name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| st_open || Parameter: status-open || Boolean || Input link || Parameter|st_open || The state "Opened" of the parameter or the common state of the switch at missing the state signal "Closed".
|-
| st_close || Parameter: status-close || Boolean || Input link || Parameter|st_close || The state "Closed" of the parameter.
|-
| st_img || Parameter: status "{img}:{bCol}:{blink}" || String || Input link || Parameter|st_text || Image of the parameter state, at the mode "Code state", where:
* ''img'' — image name, see [[Special:MyLanguage/Modules/VCAEngine#Media|the image attributes]];
* ''bCol'' — background color;
* ''blink'' — blink sign [0|1] of the background.
|-
| imgs || Images, for "{openedImage}-{bCol}:{closedImage}-{bCol}:{noOpenedClosedImage}-{bCol}:{OpenedClosedImage}-{bCol}:{errImage}-{bCol}" || String || Constant || || Configuration of the parameter statuses with the structure '''{openedImage}-{bCol}:{closedImage}-{bCol}:{noOpenedClosedImage}-{bCol};{OpenedClosedImage}-{bCol};{errImage}-{bCol}''', for the discrete block.
|-
| digStts || Parameter: statuses || String (translate) || Input link || Parameter|digStts || Standard configuration of the parameter statuses with the structure '''{notUsed}-{openedColor};{notUsed}-{closedColor};{notUsed}-{noOpenedClosedColor};{notUsed}-{OpenedClosedColor};{notUsed}-{errColor}''', for the discrete block and missing of the attribute '''imgs''.
|-
| com || Parameter: command || Boolean || Full link || Parameter|com || The command "Open" of the parameter or the common command of the switch at missing the command signal "Close".
|-
| close || Parameter: close || Boolean || Full link || Parameter|close || The command "Close" of the parameter.
|-
| stop || Parameter: stop || Boolean || Full link || Parameter|stop || The command "Stop" of the parameter.
|-
| com_text || Parameter: command text (from digComs) || String || Full link || Parameter|com_text || Text of the parameter command, at the mode "Code state".
|-
| digComs || Parameter: commands || String (translate) || Input link || Parameter|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status.
|-
| ntf || Notification "{st}:{modes}:{Speech text}" || String (translate) || Constant || || Configuration of the notification forming at the status (st) [0|1|2(both)|3(err)] and [[Special:MyLanguage/Modules/VCAEngine#Alarms|the notification modes-methods (modes)]], as a string of the digital methods, and by the speech, if pointed such method. The speech message for "3(err)" is taken from the "Error (err)" attribute.
|}

{| class="wikitable"
<section begin=alarmsAct />
| {{Anch|alarmsAct|<h3>Alarms — active ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsAct|alarmsAct]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru
<section end=alarmsAct />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element in Figure 1.5 serves to dynamically display the active violations in a tabular form and to highlight them in color and text. The violations are obtained from [[Special:MyLanguage/Documents/Program_manual#ArchMess|the buffer of current-active violations of OpenSCADA]]. In fact, the element implements the primitive "[[Special:MyLanguage/Sub-projects/VCA#ImplProtocol|Protocol]]" functions for violations and extension opportunities.

Messages sorting is fixed by the rule "active + highest level + last" to the messages top, which can only be changed by editing the element's source code.

For detailed study of current violations, the element provides a function of increasing the height up or down in focus.

The element is created, and is usually used, in pair with the [[#alarmsSt|full-format frame of presenting the violations history]], which is completed with most features of this element but also for the violations history.

The main user extension is the ability to define visible table fields from a list of options:
* ''atm'' — time of the violation appearing;
* ''qttm'' — time of the violation confirmation (quietation), for quieted violations;
* ''lev'' — level of the violation;
* ''type'' — type-name of the violation from the level ''lev'' and the attribute "types";
* ''cat'' — category of the violation;
* ''mess'' — full and unparsed text of the violation message;
* ''prm'' — address of the DAQ-parameter of the data source;
* ''dscr'' — description of the violation from the source DAQ-parameter;
* ''dscrCust{N}'' — description of the user field ''N'';
* ''alrm'' — text of the violation;
* ''cmnt'' — commentary of the violation.

[[file:at.png]] This element and its fields generally represent the structure of the violation message, which is described in detail in [[Special:MyLanguage/Documents/Program_manual#ArchMess|the Program manual]].

As you can see from the list of possible table fields, this item supports confirmation (quietation), commenting, and user fields.

* '''Sponsored by:''' Ustijancev Michael
* '''Sponsored by, for appending the new user field "Type" on 0.2 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' INSERTEC LTDA

[[file:LibMainEls_alarmsAct.png|center|frame|Fig.1.5. The element "Alarms — active" in the development and runtime modes (top to down).]]

{{CntHdr|Using — development}}
This widget can be used by the developer in creating mnemonic schemes with constant display of active violations or for their general display on [[#RootPgSo|the root page]]. To use it you need to add this widget to a mnemonic scheme or the root page, adjust for the horizontal, vertical size, configure vertical extension and adjust other properties, such as the list and the order in which the table fields are displayed.

If you want to exclude the validation function then you have to exclude the validation time "qttm" from the list and make the element inactive.

{{CntHdr|Using — runtime}}
In the runtime mode, a table is created to list the active violations, by defined fields, rules of sorting and highlighting; the contents of which are updated periodically and dynamically. When the table is selected and the focus is obtained, its height can be expanded to display more messages if this feature is enabled and the condition accordance is got for a certain number of violations.

The user is given the opportunity to confirm the violation, by changing the value of the confirmation time field or by using the control panel that pops up after selecting the element and the violation item.

The user can also comment on the violation by correcting appropriate field of the table.

{{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.
To 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 || Names list of the user fields, separated by ';' || String (translate) || At the support of user fields and their visibility, their names are given here.
|-
| types || Types list at the level from 0, separated by ';' || String (translate) || Types-names of alarms at their level, typically "Debug;Info;Notice;Warning;Error;Critical;Alert;Emergency"
|-
| messCat || Message category || String || Category of the processing alarm messages, typically it is empty for all alarms.
|}

{| class="wikitable"
<section begin=objProps />
| {{Anch|objProps|<h3>Object properties ([[Special:MyLanguage/Libs/Main_graphical_elements#objProps|objProps]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=objProps />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element on Figure 1.6 serves to display the properties of the data source in tabular form and to highlight them in color, as an object, and to allow the values of the recordable properties to be changed. This element also generates violation notifications according to the features of the object. The element generally uses and represents a representative structure "[[Special:MyLanguage/Libs/Main#ComplexObject|Complex objects]]" of the DAQ-templates.

* '''Sponsored by:''' PAC HARTRON

[[file:LibMainEls_objProps.png|center|frame|Fig.1.6. The element "Object properties" in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
This widget can be used by the developer in creating mnemonic schemes with consolidated rendering of the object as a whole and entity with properties. 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#ComplexObject|Complex objects]]".

{{CntHdr|Using — runtime}}
In the runtime mode, a table is displayed with properties in the rows where the first column is the property name and the second column is its value. Row can be backlit by an alarm color in case of violation of this property. Of particular importance is the title of the widget, which displays the name of the object background color which can become an emergency color in the presence of violations in the object.

The properties table is active and at selecting the property row, which means the writing, a field for setting the property value will appear below.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| objName || Object: name || String || Input link || Object|NAME || The object name for the title.
|-
| objDescr || Object: description || Text || Input link || Object|DESCR || The object description for tooltip to the title.
|-
| objErr || Object: error || String || Input link || Object|err || The object error to form notifications and to highlight the title, the conception error codes are processed.
|-
| objItems || Object: items || Object || Input link || Object|items || Descriptive object of the properties of the physical object, according to the concept.
|}

{| class="wikitable"
<section begin=calendar />
| {{Anch|calendar|<h3>Calendar ([[Special:MyLanguage/Libs/Main_graphical_elements#calendar|calendar]])</h3>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=calendar />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element on Figure 1.7 is used to display the month of the calendar by week, which allows you to select the year, month and day, as well as switch to the current day.

* '''Sponsored by:''' SVItoVYR LTD

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

{{CntHdr|Using — development}}
This widget can be used by the developer to create mnemonic schemes with displaying the calendar. To use it you need to add this widget to a mnemonic scheme, adjust for the horizontal, vertical size, by scaling, and use the attribute "selTime" of this widget to obtain and to set the date.

{{CntHdr|Using — runtime}}
In the runtime mode, the year, month, and day are displayed according to the "selTime" attribute.

The user can select the year and month from the list, as well as the day in the represented weeks. An appropriate button is provided for a quick return to the current day.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| selTime || Selected time || Integer || The calendar in seconds from the UNIX-epoch.
|}

{| 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|current || The object with current data.
|-
| forecast || Weather: Forecast || Object || Input link || Parameter|forecast || The object with forecast data.
|}

{| class="wikitable"
<section begin=RootPgSo />
| {{Anch|RootPgSo|<h2>Root page (SO) ([[Special:MyLanguage/Libs/Main_graphical_elements#RootPgSo|RootPgSo]])</h2>}}
| 2.7 || GPLv2 || * || en, uk, ru
<section end=RootPgSo />
| [[User:RomanSavochenko|Roman Savochenko]] || 1000 ms
|}
The element-frame, shown in Figure 2, serves as the basis for the user interfaces creating, initially for control the technological processes, grounded on the signal objects (SO).

The root page contains four areas:
* signal objects area of the buttons-indicators (top);
* navigation area by types of view (right-top);
* container of the main frames of the user interface (in the centr);
* container of the control panels (right-bottom).

''Signal objects area of the buttons-indicators'' provides information on the presence of violations in the signal object and for switching between them.

To show the signal objects selection the background color is used, by the styles: ''backColorButton'' and ''backColorButtonSel''. And the violations are displayed in the color of the text according to the styles: ''labColorGood'', ''labColorWarning'', ''labColorAlarm''; and in which value the text of the inquieted signal object may blink.

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.

''Navigation area by types of view'' — indication of the choice and selection of the type of view, such as: "Mnemonic schemes", "Graph groups", "Contour groups", "Documents" and more; and the listing buttons or the direct selection combobox of the frames into the signal object.

The buttons area of the types of view is dynamic, in the sense of occupying the space of the missing ones, and the meaning of the types of view themselves are configured to different from the default value, i.e. there are two main types of view (view1 and view2), three auxiliary (view3, view4 and view5), as well as one common to the whole interface (view6).

Below are also the buttons of quietation those appear in the event of violations, and at the top is a customizable logo.

''Container of the main frames of the user interface'' — the area of the container for inclusion in it of the basic frames by their choice of buttons of types of view or change of the signal object.

''[[#alarmsAct|The generic table of active violations]]'' — contains coloured rows of actual alarms sorted by their importance with the more important on the top. The widget disabled initially.

''Container of the control panels'' — container area to include control panels of various objects in the container area of the main frames, for example — panel of the parameter, document, graph and more.

Under the control panels container placed a button to start the demo mode — mode in which performed periodic switching for representative frames, changing regimes and other operations by a scenario.

* '''Sponsored in the dynamization by''': Vinnica Poultry Farm

[[file:LibMainEls_RootPgSoD.png|center|frame|Fig.2a. The "Root page (SO)" frame in the development mode.]]

{{CntHdr|Using — development}}
This widget can be used only in the root page mode that should be placed in the project's tree as an element "so". Additionally, around the main page should be made following tree hierarchy:
: /'''control'''/* — logical container, contains a variety of control panels;
: /'''so'''/ — this frame as a container, contains of logical containers of the signal objects:
:: '''{n}'''/ — logical container of the signal object ''n'' (1...), contains logical containers and templates of the types of view:
::: ['''view1'''|'''mn''']/* — the type of view 1 (typically and early it is the mnemonic schemes), contains a lot of pages of the end frames;
::: ['''view2'''|'''ggraph''']/* — the type of view 2 (typically and early it is a template of [[#grpGraph|the graphics group]]), contains a lot of pages of the end frames;
::: ['''view3'''|'''gcadr''']/* — the type of view 3 (typically and early it is a template of [[#grpCadr|the contours group]]), contains a lot of pages of the end frames;
::: ['''view4'''|'''gview''']/* — the type of view 4 (typically and early it is a template of [[#ViewCadr|the overview frames panel]]), contains a lot of pages of the end frames;
::: ['''view5'''|'''doc''']/* — the type of view 5 (typically and early it is a logical container of the documents), contains a lot of pages of the end frames;
::: '''greg'''/* — the specific page template of [[#cntrRegul|the PID-regulator configuration]], contains a lot of pages of the end PID-regulators configuration, statically connected and which are call only by the "PID" button of [[#ElCadr|the element cadre]].
:: ['''view6'''|'''rg''']/ — logical container of the global type of view 6 (typically and early it is [[#ResultGrph|the result graphics]] — common graphs for the entire interface):
::: ['''view6'''|'''rg''']/* — the type of view 6 (typically and early it is a template of [[#ResultGrph|the result graphics]]), contains a lot of pages of the end frames.

[[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!

As the text of the signal object buttons, there are used name of the logical container with the corresponding ''n'' identifier. The description of this container also takes the text of the tooltip to this button if it is not empty. Description of the container also taken into tooltip for this button, if it is not empty.

All further adjustments and edits around this frame must be made for its copy-link in the project tree, and it is strongly not recommended to edit it in the library, otherwise you will lose the ability to update the library or these changes when updating it!

The text and the tooltip of the buttons of the types of view are directly changed in the corresponding properties of these widgets. The fast keys of the type of view are taken from the toolbar brackets, such as "Graphs (CtrlAlt+G)", and processed accordingly. To change the image of the type of view, it is enough to override the icon of the corresponding view, such as "view1", by loading the image with the appropriate name in the project Mime-data.

To enable [[#alarmsAct|the generic table of active violations]] just set '''1 (one)''' in the frame links configuration for "alarms > en".

To enable and configure the returning to some non privilege user after some time of the inactivity just set '''{minutes)-{user}''' in the frame links configuration for "defUser".

You can change the image of the logo in the same way as the image of the type of view, that is, upload a new image called "logo" to the project's Mime-data, and then adjust the geometry of the logo widget to the desired proportions. You can move the image widget to the left by moving the signal object button to the right by the size of the logo. If you do not need the logo at all then to nullify the widget width, but do not remove it!

Potentially, you can also move the navigation bar and the control panel container to the left by moving the main frame container, and maybe the signal object button, to the right.

If necessary, the root page can be appended with additional elements that do not require special processing, that is, changes to the initial procedure of the frame, that is no longer using but editing. [[file:at.png]] It should be noted here that reducing the size of the containers will lead to the appearance of scrollbars and-or will require adjusting the frames of placement in the container but this may not be necessary given the extension of the container to unused button rows of the signal objects.

{{CntHdr|Using — runtime}}
When starting the frame in the runtime mode, there are first constructed the buttons of the signal objects, which are formed in two rows, after which the container of the main frames expands up for one row if there is enough one, or for two if the signal object is one. Next, there are formed buttons of the types of view, present of which are activated and expanded to fill the space of the missing ones.

After the dynamic forming, the frame periodically controls the frame change in the main frame container, which is displayed by the corresponding background color in a button of the signal object and the type of view to which the frame belongs. Between the listing buttons, information about the total number of frames and the current position is updated, and the buttons themselves are activated according to the possibility of listing in the current frame position. For the combobox of direct frames selection from list, respectively, the current list of frames is formed and the name of the current one is set. It also monitors the status of violation-notification of the signal objects, which is accordingly displayed by the text color of the buttons of the signal object and its flashing, as well as the quietation buttons are activated or deactivated.

[[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.

Changing of the frame in the control panel container are not tracked and their are generally called from the main frame interface, unless it is cleared by changing the main frame by opening the panel-terminator.

From the basic actions, the frame allows the user to select the signal object, the type of view and the corresponding frame. By pressing the button of the signal object, the type of view, directly selecting in the combobox or listing; resulting in a call to the corresponding frame in the main frame container. From the ancillary actions, the user can quiet the violation-notification and start the Demo-mode, if one provided. The default frame setting involves servicing a number of hotkeys, such as '''CtrlAlt+[1...0]''' to call the signal objects 1 to 10, and '''CtrlAlt+[MGCVDR]''' to call appropriate types of view.

[[file:LibMainEls_RootPgSoR.png|center|frame|Fig.2b. The "Root page (SO)" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| alarms > en (config) || Alarms > Enabled || Boolean || [[#alarmsAct|The generic table of active violations]] enabling
|-
| defUser (config) || Default to return, {minutes)-{user} || String || Enabling and configuring the returning to some non privilege user after some time of the inactivity by the string '''{minutes)-{user}'''.
|-
| demoPlayProc || Procedure of the Demo play || Text || A procedure on [[Special:MyLanguage/Modules/JavaLikeCalc|the JavaLikeCalc language]] to play some demo. Enables the Demo-mode button in the runtime mode. To an example of such procedure see the demo-projects [[Special:MyLanguage/Using/Model_AGLKS|AGLKS]] and [[Special:MyLanguage/Using/Model_Boiler|Boiler]]!
|-
| colspan=4 | ''The visualizer specific attributes common for both [[Special:MyLanguage/Modules/Vision|UI.Vision]] ([[Special:MyLanguage/Modules/Vision#SpecAttrs|more]]) and [[Special:MyLanguage/Modules/WebVision|UI.WebVision]] ([[Special:MyLanguage/Modules/WebVision#SpecAttrs|more]])''
|-
| keepAspectRatio || Keep aspect ratio on scale || Boolean || Keep aspect ratio of the pages on scale.
|-
| stBarNoShow || Do not show the status bar || Boolean || Hide the status bar of the main window.
|-
| colspan=4 | ''The visualizer specific attributes for [[Special:MyLanguage/Modules/Vision|UI.Vision]] ([[Special:MyLanguage/Modules/Vision#SpecAttrs|more]])''
|-
| runWin || Run window || Integer numbers selection || Setting the mode of the main window execution:
* "Original size (0)".
* "Maximize (1)".
* "Full screen (2)".
|-
| statLine || Status line items || Text || Text field with description of the status line items.
|-
| winPosCntrSave || Windows position control and save || Boolean || Enabling the windows position control and save.
|-
| colspan=4 | ''Main procedures of [[Special:MyLanguage/Modules/VCAEngine#Alarms|the notification mechanism]]''
|-
| notify0 || Notification: type 0 (Light) || Text ||
|-
| notify1 || Notification: type 1 (Buzzer) || Text ||
|-
| notify2 || Notification: type 2 (TextSpeech) || Text ||
|}

== {{Anch|MainFrames|Main frames}} ==
Contains elements-frames of the template and end types, as well as elements-widgets and panels from which they are built and used. These frames are intended to be placed in the project tree of the pages, built on [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]]. However, they may be located as separate entities or as part of your own concept of the page management, but it should be take in account that frames often refer and call certain [[#Panels|control panels]] of the common usage and related elements!

{| 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.png|center|frame|Fig.3.1a. The "Graphics group" frame in the development mode.]]

{{CntHdr|Using — development}}
The frame is designed to perform the role of page-template, and should therefore be placed directly in the project's tree. In the project-template "[[#RootPgSo|Signal groups]]", for each signal object, this frame is included in the role of a template that allows you to create on its basis a set of pages of the graphics group. To each frame can be connected up to eight-ten parameters, setting the links. Trends, for which there are not set the links, will be hidden at runtime or allowed for user's selection at case of presence the list of the parameters to select in the attribute "Select: parameters accessible to select" (the list format described in [[#graphSelPrm|the parameters selection dialog]]).

The default trend depth in the past is set at 10 minutes — for current operational control, which can be changed directly by editing the corresponding field of the diagram widget, for example, for the project template page, to spread to all end pages.

{{CntHdr|Using — runtime}}
In the runtime mode, the trends, for which links have been set, are displayed. Control of the parameters from the graphics group element, described in detail in the section of the "[[#ElViewGraph|Graphics group element (ElViewGraph)]]" widget. Additionally you can control the display properties of graphs, for what, together this page, there automatically opens [[#grph_panel|the graph control panel]] or you have to click the left mouse button in the graph area.

[[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.png|center|frame|Fig.3.1b. The "Graphics group" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String (translate) || Constant || || Group name
|-
| allowSelLst || Select: parameters accessible to select || Text || No || || Place here the parameters for selection by the user in a list of the DAQ-paths to them (for more details see the "[[#graphSelPrm|Graph parameter selection]]" dialog):
<pre style="white-space:">
/LogicLev/proc/prm_CPU/prm_load
/LogicLev/proc/prm_MEM/prm_use
/LogicLev/proc/prm_CPU/prm_T </pre>
|-
| perUserSel || Select: save the selection per user || Boolean || No || || Set to save the user selection separately
|-
| colspan="6" | ''Element {n} from 1 to 8(10)''
|-
| el{n} || colspan="5" | ''List of the linking parameters corresponds to the list of the "Graphics group element (ElViewGraph)" widget''
|}

{| 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.png|center|frame|Fig.3.1.1a. The "Graphics group element" widget in the development mode.]]

{{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|Using — runtime}}
In the runtime mode, in the main field of the element, there are displayed the parameter name, the regulator mode (only for the regulators), the current value-variable and the unit of this parameter; which, depending on the presence of a violation, are displayed in the color style: ''labColorGood'', ''labColorWarning'', ''labColorAlarm''. At the hardware errors and non validity the data, the last value is greyed out.

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.

The widget saves of a user selected parameter in the session table of the project and loads the parameter at next run, include the trend color which default value typically takes from a style.

[[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.png|center|frame|Fig.3.1.1b. The "Graphics group element" widget in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String (translate) || Input link || Parameter|NAME || Parameter name-code, to display in the name field.
|-
| dscr || Description || Text (translate) || Input link || Parameter|DESCR || Parameter description, to place in the tooltip and statusbar.
|-
| addr || Address || Address || Input link || Parameter|var || Address to the parameter attribute for the trend building.
|-
| color || Graphic color || String || No || || Working color of the trend
|-
| colorDef || Default color from the style || String || No || || Default color of the trend on the cadre level
|-
| colspan="6" | ''Analog parameters''
|-
| ed || Dimension || String (translate) || Input link || Parameter|ed ||
|-
| prec || Precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| log || Logarithmic scale || Boolean || Input link || Parameter|log ||
|-
| max || Maximum || Real || Input link || Parameter|max || Upper limit value of the parameter.
|-
| min || Minimum || Real || Input link || Parameter|min || Minimum limit values of the parameter.
|-
| aMax || Border up alarm || Real || Input link || Parameter|aMax ||
|-
| aMin || Border down alarm || Real || Input link || Parameter|aMin ||
|-
| wMax || Border up warning || Real || Input link || Parameter|wMax ||
|-
| wMin || Border down warning || Real || Input link || Parameter|wMin ||
|-
| pModeA || Regulator mode: auto || Boolean || Input link || Parameter|auto || The regulator mode "Automatic".
|-
| pModeC || Regulator mode: cascade || Boolean || Input link || Parameter|casc || The regulator mode "Cascade".
|-
| colspan="6" | ''Discrete parameters''
|-
| digComs || Digital: commands || String (translate) || Constant || || Names and colors of the buttons of the commands are in the format '''{On}[-color]:{Off}[-color][:{Stop}[-color]]'''. Default colors are: green, red and yellow.
|-
| digStts || Digital: states || String (translate) || Constant || || Names and colors of the labels of the states are in the format '''{On}[-color]:{Off}[-color]'''. Default colors are: green and red.
|-
| digRevers || Digital: reversion || Boolean || Constant || || Discrete signal reverse.
|}

{| class="wikitable"
<section begin=graphSelPrm />
| {{Anch|graphSelPrm|<h4>Graph parameter selection ([[Special:MyLanguage/Libs/Main_graphical_elements#graphSelPrm|graphSelPrm]])</h4>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=graphSelPrm />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element, shown in Figure 3.1.2, implements a dialog of selection the data source, often the archive ones, for the trend formation in the "[[#grpGraph|Graphics group]]" frame. Selection is provided from the list, specified in the attribute "Select: parameters accessible to select (allowSelLst)" of the frame-initiator. For the selected source you can specify the name, scale, logarithmic scale, dimension and the color of the trend.

In the "Select: parameters accessible to select (allowSelLst)" attribute the data sources should be placed in the following way:
* '''{DAQ_Arh_addr}[:Name[:min:max[:dim]]''', where:
** "DAQ_Arh_addr" — address of the parameter, for the group linking, or address of the attribute with data from the "Data acquisition (DAQ)" subsystem, as well as the address of the values' archive, for example:
*** '''/LogicLev/gen/prm_F3''' — address of the "F3" parameter ;
*** '''/DAQ/System/AutoDA/prm_CPULoad/load''' — address of the "load" attribute of the "CPULoad" parameter;
*** '''/Archive/va_LC21_1_var''' — address of the "LC21_1_var" archive.
** "Name" — name of the source to display. At the group linking the name will be taken from the "NAME" attribute.
** "min", "max" — display scale. At group linking the scale will be taken from the "min" and "max" attributes, respectively. In the case of the scale absence (min >= max) the auto-scale will be enabled.
** "dim" — dimension (measuring unit) of the parameter to display. At the group linking it will be taken from the "ed" attribute.
* '''<varhs>''' — template of the group selection, if you specify it all available archives in the system will be included into the selection list.

Examples of the "Select: parameters accessible to select (allowSelLst)" attribute's content:

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

[[file:LibMainEls_graphSelPrm.png|center|frame|Fig.3.1.2. The "Graph parameter selection" frame in the development and runtime mode.]]

{{CntHdr|Using — development}}
This frame should be placed to the panels' logical container of the project tree. The "Select: parameters accessible to select (allowSelLst)" attribute must be defined to a list of sources according to the rules described above in the "[[#grpGraph|Graphics groups]]", which should provide the selection of the sources by the user. As a result, the "Select" item will appear in the context menu of the [[#ElViewGraph|Graphics group element]].

{{CntHdr|Using — runtime}}
Calling the dialogue is made by the "Select" item of the [[#ElViewGraph|Graphics group element]] context menu. The dialogue provides the user to the possibility of selection the data source from the list, as well as an indication of its basic parameters: name, scale, logarithmic scale, dimension and the color of the trend, which you also can select typical/styled one by clearing. When you accept the dialogue the selected parameters are applied to the graphics group element chart, replacing the links. The "<Clear>" item selection and applying causes to clearing all the links and the graph's item. Into a text field under the list you can rapidly find any needed parameter.

{| class="wikitable"
<section begin=graphCalc />
| {{Anch|graphCalc|<h4>Graph parameter calculation ([[Special:MyLanguage/Libs/Main_graphical_elements#graphCalc|graphCalc]])</h4>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=graphCalc />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element, shown in Figure 3.1.3, implements a dialog of user calculation of the selected graph parameter for the graphically visible data. The user is given an option to select calculations from the built-in library, the privileged user ("root" or in the "ITW" group) has the opportunity to edit or write their own calculation procedure.

In general, the built-in library currently contains the following functions of the user calculation:
* Sum, at hour.
* Average and range.

[[file:LibMainEls_graphCalc.png|center|frame|Fig.3.1.3. The "Graph parameter calculation" frame in the development and runtime mode.]]

{{CntHdr|Using — development}}
This frame should be placed to the panels' logical container of the project tree.

{{CntHdr|Using — runtime}}
Calling the dialogue is made by the "Calculation" item of the [[#ElViewGraph|Graphics group element]] context menu. The dialog gives the user the choice of the function of calculation the visible data of the selected parameter and the ability to edit-write their own function, for the privileged user. The calculation result is located in the corresponding text box.

{| class="wikitable"
<section begin=grpCadr />
| {{Anch|grpCadr|<h3>Contours group ([[Special:MyLanguage/Libs/Main_graphical_elements#grpCadr|grpCadr]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=grpCadr />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.2, provides for simultaneous monitoring and control of contours of several parameters, up to eight, includes both instances of the widget "[[#ElCadr|Element cadre]] for each contour, and [[Special:MyLanguage/Sub-projects/VCA#Diagram|the primitive "Diagram"]] to monitor the trends of the contours and viewing history.

[[file:LibMainEls_grpCadrD.png|center|frame|Fig.3.2a. The "Contours group" frame in the development mode.]]

{{CntHdr|Using — development}}
The frame is designed to perform the role of page-template, and should therefore be placed directly in the project's tree. In the project-template "[[#RootPgSo|Signal groups]]", for the first signal object, this frame is included in the role of a template that allows you to create on its basis a set of pages of the contours group. To each frame can be connected up to eight parameters, setting the links. Contours and trends, for which there are not set the links, will be hidden at runtime.

The default trend depth in the past is set at 10 minutes — for current operational control, which can be changed directly by editing the corresponding field of the diagram widget, for example, for the project template page, to spread to all end pages.

{{CntHdr|Using — runtime}}
In the runtime mode, the contours and trends, for which links have been set, are displayed. Control of the parameters by contours, described in detail in the section of the "[[#ElCadr|Element cadre]]" panel. In addition to this you can control the trends display properties, which requires the left mouse button to click in the trend's area and by means of appeared [[#grph_panel|trend's control panel]] to make the necessary actions.

[[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.png|center|frame|Fig.3.2b. The "Contours group" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| grpName || Group name || String || Constant || || Group's name
|-
| colspan="6" | ''Element {n} from 1 to 8.''
|-
| el{n} || colspan="5" | ''The list of the linking parameters corresponds to the "Element cadre (ElCadr)" panel''
|}

{| class="wikitable"
<section begin=ViewCadr />
| {{Anch|ViewCadr|<h3>Group of overview frames ([[Special:MyLanguage/Libs/Main_graphical_elements#ViewCadr|ViewCadr]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=ViewCadr />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame shown in Figure 3.3 is used to display the current parameter trends in individual frames-widgets with up to 24 units (6x4) for which scaling is supported depending on their configured number. The frames-widgets of the parameter trends are implemented with the satellite widget "[[#ElViewCadr|Frame of the group of overview]]".

[[file:LibMainEls_ViewCadrD.png|center|frame|Fig.3.3a. The "Group of overview frames" frame in the development mode.]]

{{CntHdr|Using — development}}
The frame is designed to perform the role of page-template, and should therefore be placed directly in the project's tree. In the project-template "[[#RootPgSo|Signal groups]]", for the first signal object, this frame is included in the role of a template that allows you to create on its basis a set of pages of the group of overview. Frames-widgets, for which there are not set the links, will be hidden at runtime and will be performed the proportional scaling to missing full rows and columns to fill the entire frame.

{{CntHdr|Using — runtime}}
In the runtime mode, the frames-widgets, for which links have been set, are displayed. Control of the parameters from the frames-widgets, described in detail in the section of the "[[#ElViewCadr|Frame of the group of overview]]" widget.

[[file:LibMainEls_ViewCadrR.png|center|frame|Fig.3.3b. The "Group of overview frames" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String || Constant || || Frame's name
|-
| colspan="6" | ''Frame-widget {r}_{c}, where {r} — rows from 1 to 4 and {c} - columns from 1 to 6.''
|-
| el{r}_{c} || colspan="5" | ''The list of linked parameters corresponds to ones of the "Frame of the group of overview (ElViewCadr)" widget''
|}

{| class="wikitable"
<section begin=ElViewCadr />
| {{Anch|ElViewCadr|<h4>Frame of the group of overview ([[Special:MyLanguage/Libs/Main_graphical_elements#ElViewCadr|ElViewCadr]])</h4>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=ElViewCadr />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-widget, shown in Figure 3.3.1, serves as the basis for [[#ViewCadr|the group of overview frames]] and is not usually used independently. The widget displays the text information about parameter in the form of the name and value, and a trend of the parameter for small period of time (2 minutes) to observe the current trend of the parameter with auto-scaling on the value scale. The widget commonly uses and represents the representative structure of the DAQ-template "[[Special:MyLanguage/Libs/Main#anUnif|Analog signal]]".

[[file:LibMainEls_ElViewCadr.png|center|frame|Fig.3.3.1. The "Frame of the group of overview" widget in the development and runtime modes (left to right).]]

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

{{CntHdr|Using — runtime}}
In the runtime mode, the main field of the element displays the parameter name, the current value-variable and the trend of the parameter; which are always displayed in the style color: ''labColorGood''.

In the active mode of the element you can obtain [[#Passport|the parameter passport]] clicking the right mouse button on the body of the widget. The passport will present all properties of the parameter. Pressing the left mouse button in the widget body will cause to appear in the panels area for [[#ElCadr|control panel]] of the parameter, and the selection of this widget will be displayed with the blinking frame.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String || Input link || Parameter|NAME || Parameter name (code) for display in the name's field.
|-
| addr || Address || Address || Input link || Parameter|var || Address to the value attribute of the parameter to construct the trend.
|-
| var || Variable || Real || Input link || Parameter|var || Directly the parameter value to be displayed in the value field.
|}

{| class="wikitable"
<section begin=ResultGraph />
| {{Anch|ResultGraph|<h3>Result graphics ([[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraph|ResultGraph]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=ResultGraph />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame shown in Figure 3.4 is used to display a group of the current parameter trends (up to 5) in individual frames-widgets with up to 16 units (4x4) for which scaling is supported depending on their configured number. The frames-widgets of the parameter trends are implemented with the satellite widget "[[#ResultGraphEl|Frame of the result graphics]]".

Summary the total number of displayed graphs in one frame reaches 80, and it is intended to form a separate type of view that is used outside [[#RootPgSo|the signal objects]] — globally for the entire visualization project.

[[file:at.png]] The frame doesn't support any control.

[[file:LibMainEls_ResultGraphD.png|center|frame|Fig.3.4a. The "Result graphics" frame in the development mode.]]

{{CntHdr|Using — development}}
The frame is designed to perform the role of page-template, and should therefore be placed directly in the project's tree. In the project-template "[[#RootPgSo|Signal groups]]", at the root page level it has a special virtual page "Result graphics" with the result graphics template, that allows you to create on its basis a set of pages of the result graphics. Frames-widgets, for which there are not set any links, will be hidden at runtime and will be performed the proportional scaling to missing full rows and columns to fill the entire frame.

{{CntHdr|Using — runtime}}
In the runtime mode, the frames-widgets, for which links have been set, are displayed.

[[file:LibMainEls_ResultGraphR.png|center|frame|Fig.3.4b. The "Result graphics" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| grpName || Group name || String || Constant || || Group name
|-
| colspan="6" | ''Frame-widget {n} from 1 to 16.''
|-
| el{n} || colspan="5" | ''The list of linking parameters corresponds to the "Frame of the result graphics (ResultGraphEl)" widget.''
|}

{| class="wikitable"
<section begin=ResultGraphEl />
| {{Anch|ResultGraphEl|<h4>Frame of the result graphics ([[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraphEl|ResultGraphEl]])</h4>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=ResultGraphEl />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-widget, shown in Figure 3.4.1, serves as the basis for [[#ResultGraph|the result graphics]] and is not usually used independently. The widget displays the name of the group and up to five trends, with their text labels, over a fixed period of time (10 minutes) to observe the current trend of the parameters. The widget commonly uses and represents the representative structure of the DAQ-template "[[Special:MyLanguage/Libs/Main#anUnif|Analog signal]]".

[[file:LibMainEls_ResultGraphEl.png|center|frame|Fig.3.4.1. The "Frame of the result graphics" widget in the development and runtime modes (left to right).]]

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

{{CntHdr|Using — runtime}}
In the runtime mode, the main element field displays the group header, headers and trends of the parameters in the configuration-defined or styled colors.

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| title || Title || String || Constant || || Displays at the top of the graphs, in the absence the graphs field expands up.
|-
| colspan="6" | ''Parameter {n} from 1 to 5.''
|-
| p{n}_addr || Parameter{n}: address || Address || Input link || Parameter {n}|var || Address to the parameter attribute for plotting the graph {n}.
|-
| p{n}_clr || Parameter{n}: color || Color || From style || labColorGrph{n} ||
|-
| p{n}_max || Parameter{n}: maximum || Real || Input link || Parameter {n}|max || Upper limit of the trend.
|-
| p{n}_min || Parameter{n}: minimum || Real || Input link || Parameter {n}|min || Lower limit of the trend.
|-
| p{n}_name || Parameter{n}: name || String || Input link || Parameter {n}|NAME || Short name of the parameter to display in the field on the left.
|}

{| class="wikitable"
<section begin=cntrRegul />
| {{Anch|cntrRegul|<h3>Regulator's control panel ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrRegul|cntrRegul]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=cntrRegul />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
Element-frame, shown in Figure 3.5, is used for adjustment of PID-regulator, includes information about the parameter-regulator, fields of the regulator's settings and [[Special:MyLanguage/Sub-projects/VCA#Diagram|the "Diagram" primitive]], to monitor the trends of the regulator and browsing history. The frame commonly uses and represents the representative structure of the DAQ-template for the [[Special:MyLanguage/Libs/Main#pidUnif|analog]] and [[Special:MyLanguage/Libs/Main#pidUnifImp|pulse]] PID-regulators.

* '''Sponsored by:''' [http://diyaorg.dp.ua DIYA Ltd]

[[file:LibMainEls_cntrRegulD.png|center|frame|Fig.3.5a. The "Regulator's control panel" frame in the development mode.]]

{{CntHdr|Using — Development}}
This frame can be used as a panel, called from [[#ElCadr|the control of panel of the parameters]], as well as a template-page. The frame should be placed directly in the project's tree, namely to [[#RootPgSo|the panels container]], where the dynamic linking will be performed to the regulator parameter. To create a static list of contours of the regulators' configuration, with the possibility of listing in it, you must place them in the container "greg" of the regulators' contours of each [[#RootPgSo|signal object]] and statically link them with the corresponding parameter, and to ensure equality of the panel's ID and the linked parameter.

The default trend depth in the past is set at 20 minutes — for current operational control, which can be changed directly by editing the corresponding field of the diagram widget.

{{CntHdr|Using — runtime}}
In the runtime mode, you can see:
* name of the regulator parameter;
* field with the regulator properties in the composition: identifier, name, description, measuring unit, set-point, variable output, scale and mode;
* coefficients of the regulator configuration: Gain, Ci, Ti, Cd, Td, TdLg, Zin, H1, H2, C1, C2, C3, C4, Tpl, Tml and Rfkt;
* the diagram area with displaying the trends: variable (green, the style "labColorGrph4"), set-point (blue, the style "labColorGrph3"), the analog output (cyan, the style "labColorGrph5"), the regulator mode "Automate" (magenta, the style "labColorGrph7") and the digital outputs (orange, the style "labColorGrph2").

Users have an ability to change the PID-regulator's coefficients, mode, set-point, output and immediately to see the reaction on the diagram. In addition, the user may learn the history of the regulator work, which requires the left mouse button click in the graph area and by means of appeared [[#grph_panel|trend's control panel]] to make the necessary navigation actions. To return [[#ElCadr|the control panel of the parameter]] the left mouse button must be clicked in an empty area of the frame.

[[file:LibMainEls_cntrRegulR.png|center|frame|Fig.3.5b. The "Regulator's control panel" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| SHIFR || Parameter: code || String || Input link || Parameter|SHIFR ||
|-
| NAME || Parameter: code || String || Input link || Parameter|NAME ||
|-
| DESCR || Parameter: description || String || Input link || Parameter|DESCR ||
|-
| max || Parameter: scale maximum || Real || Input link || Parameter|max ||
|-
| min || Parameter: scale minimum || Real || Input link || Parameter|min ||
|-
| ed || Parameter: dimension of variable || String || Input link || Parameter|ed ||
|-
| prec || Parameter: precision || Integer || Input link || Parameter|prec || Number of digits after coma, placed in value and set-point of the PID.
|-
| var || Parameter: variable || Real || Input link || Parameter|var ||
|-
| var_addr || Parameter: variable address || Address || Input link || Parameter|var || Address for the trend building of the variable.
|-
| colspan="6" | ''PID-regulator''
|-
| auto_addr || Parameter: auto || Address || Input link || Parameter|auto || Address for the trend building of the mode "Auto".
|-
| sp || Parameter: set-point || Real || Input link || Parameter|sp ||
|-
| sp_addr || Parameter: set-point address || Address || Input link || Parameter|sp || Address for the trend building of the set-point.
|-
| out || Parameter: output || Real || Input link || Parameter|out ||
|-
| out_addr || Parameter: output address || Address || Input link || Parameter|out || Address for the trend building of the analog output.
|-
| Hdwn || Parameter: bottom output border || Real || Full link || Parameter|Hdwn || Limit the analog output value at the bottom.
|-
| Hup || Parameter: upper output border || Real || Full link || Parameter|Hup || Limit the analog output value at the top.
|-
| Kp || Parameter: gain coefficient || Real || Full link || Parameter|Kp ||
|-
| Ki || Parameter: coeff. of integration || Real || Full link || Parameter|Ki ||
|-
| Ti || Parameter: time of integration || Real || Full link || Parameter|Ti ||
|-
| Kd || Parameter: coeff. of differential || Real || Full link || Parameter|Kd ||
|-
| Td || Parameter: time of differentiation || Real || Full link || Parameter|Td ||
|-
| Tzd || Parameter: differential part lag time || Real || Full link || Parameter|Tzd ||
|-
| Zi || Parameter: insensitivity area || Real || Full link || Parameter|Zi ||
|-
| K1 || Parameter: input 1 coefficient || Real || Full link || Parameter|K1 ||
|-
| K2 || Parameter: input 2 coefficient || Real || Full link || Parameter|K2 ||
|-
| K3 || Parameter: input 3 coefficient || Real || Full link || Parameter|K3 ||
|-
| K4 || Parameter: input 4 coefficient || Real || Full link || Parameter|K4 ||
|-
| colspan="6" | ''Pulse PID-regulator''
|-
| impQdwn_addr || Parameter: address of impulse output down || Address || Input link || Parameter|impQdwn || Address for the trend building of the pulse output "Down".
|-
| impQup_addr || Parameter: address of impulse output up || Address || Input link || Parameter|impQup || Address for the trend building of the pulse output "Up".
|-
| KImpRfact || Parameter: rate factor || Real || Full link || Parameter|KImpRfact || Asymmetry in up and down pulse width generation.
|-
| TImpMin || Parameter: minimal impulse time || Integer || Full link || Parameter|TImpMin || Pulses are generated from the specified width.
|-
| TImpPer || Parameter: pulses period || Integer || Full link || Parameter|TImpPer || Periodicity of repetition of pulse generation.
|}

{| class="wikitable"
<section begin=alarmsSt />
| {{Anch|alarmsSt|<h3>Alarms — state ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsSt|alarmsSt]])</h3>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=alarmsSt />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The element-frame in Figure 3.6 serves to display the violations history and to update their dynamically for the current time in a full-format tabular form, to highlight them in color and text and the possibility of multilevel filtering. The violations are obtained from [[Special:MyLanguage/Documents/Program_manual#ArchMess|the buffer of current-active violations of OpenSCADA]] and archive(s), specified in the configuration field "'''alArch'''". In fact, the element implements the primitive "[[Special:MyLanguage/Sub-projects/VCA#ImplProtocol|Protocol]]" functions for violations and extension opportunities.

The frame in general contains elements:
* the messages table — the main area;
* a button of the mass confirmation — the top left;
* a combobox of selection of the data model level sort rule, it provides sorting by the selected column from the list defined in '''colms''' and by default this is time, as the second criterion (last on the top) — the next one top left;
* a navigation panel at the messages history-archive — the top centre and right, consisting of:
** the top-end time of the data;
** size — depth of the data requesting;
** the buttons of fast listing — per one and five intervals-depths forward and backward and at the current time;
** a button to quickly move to the next part of a large query interval, divided by the limit on the number of messages in the table — for very dense-active messages generation;
** a button to call-form of the report document for the actual table's data.
* elements of the five-level filter with displaying the next level at activation the last one, by selecting a column from the list of specified ones in '''colms''' — the top after the previous one.

According to the announced list of the control elements, message sorting can be modified by the user, both by the built-in column sorting mechanism of a single visualizer and at the data model level, if such function the visualizer is not provided. Considering the basic purpose of the frame is the status of the violations (ie history), the default sorting rule is the "last" to the messages top.

The frame is created, and is usually used, in pair with the [[#alarmsAct|widget of dynamically display the active violations]], which is completed with main features of this frame but only for active violations and in the small widget.

The main user extension is the ability to define visible table fields from a list of options:
* ''atm'' — time of the violation appearing;
* ''qttm'' — time of the violation confirmation;
* ''nrmtm'' — time of coming-returning the violation to the state "NORM";
* ''lev'' — level of the violation;
* ''type'' — type-name of the violation from the level ''lev'' and the attribute "types";
* ''cat'' — category of the violation;
* ''mess'' — full and unparsed text of the violation message;
* ''prm'' — address of the DAQ-parameter of the data source;
* ''dscr'' — description of the violation from the source DAQ-parameter;
* ''dscrCust{N}'' — description of the user field ''N'';
* ''alrm'' — text of the violation;
* ''cmnt'' — commentary of the violation.

[[file:at.png]] This frame and its fields generally represent the structure of the violation message, which is described in detail in [[Special:MyLanguage/Documents/Program_manual#ArchMess|the Program manual]].

As you can see from the list of possible table fields, this item supports confirmation, commenting, and user fields.

* '''Sponsored by:''' Ustijancev Michael
* '''Sponsored by, for appending the new user field "Type" on 0.2 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' INSERTEC LTDA

[[file:LibMainEls_alarmsStD.png|center|frame|Fig.3.6a. The frame "Alarms — state" in the development mode.]]

{{CntHdr|Using — development}}
The widget is designed to perform the role of page, and should therefore be placed directly in the project's tree. After adding, the frame must be adjusted for the properties, such as the list and the order in which the table fields are displayed.

[[file:at.png]] Because the frame displays the status and the history of the violations, the creation and use of [[Special:MyLanguage/Documents/Program_manual#ArchMess|the message archiver]] is mandatory. Therefore, create or use a template archiver "Alarms" of the startup project with duplicate exclusion options, and specify it (FSArch.alarms) in the frame property "'''alArch'''".

The combobox of selecting sorting rule is disabled by default for the sake of using the built-in column sort function of the table of the corresponding visualizer. If this feature is not provided by the visualizer then enable this combo box.

If you want to exclude the validation function then you have to exclude the validation time "qttm" from the list and make the table element inactive.

The report building at the table data is also disabled by default. To enable it, you have to place [[#alarmsStReport|the frame of alarms reporting]] in the logical container of panels of the project tree and then enable the characteristic report generation button in the upper right corner of this frame.

{{CntHdr|Using — runtime}}
In the runtime mode, a table is created from the active violations list, for the current time, and violations from the history by defined fields, with the activity control and marking and rules of the highlighting; the contents of which are updated periodically and dynamically for the current time.

The user can use the navigation bar to determine the time interval of the data in the table, specifying the top-end and depth of the required data. In the process of requesting too tight data spaces, only the number of messages specified in the property '''messLim''' will be readable, and the user can use the button in the navigation bar, what appears in that case, to move to the next piece.

The data obtained in the table can be filtered by the content of the column selected accordingly, which can be performed at up to five levels, the filter elements of which will appear after the last filter level is selected.

The user is given the opportunity to confirm the violation, by changing the value of the confirmation time field or by using the control panel that pops up after selecting the table element and the violation item. The user may also confirm all active violations by clicking the mass confirmation button.

If there is a column sort function in the visualizer, or enable sorting at the data model level, the user can select a column to sort the table rows at that content.

The user may also comment on the violation by correcting appropriate field of the table.

To generate a separate report, the user can click the characteristic button in the top right corner if this feature is enabled.

[[file:LibMainEls_alarmsStR.png|center|frame|Fig.3.6b. The frame "Alarms — state" in the runtime mode.]]

{{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.
To 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 || Names list of the user fields, separated by ';' || String (translate) || At the support of user fields and their visibility, their names are given here.
|-
| types || Types list at the level from 0, separated by ';' || String (translate) || Types-names of alarms at their level, typically "Debug;Info;Notice;Warning;Error;Critical;Alert;Emergency"
|}

{| 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]].

The main purpose and function of this frame is to provide an opportunity to print the violations history table and export data from it.

* '''Sponsored by:''' Ustijancev Michael

[[file:LibMainEls_alarmsStReport.png|center|frame|Fig.3.6.1. The frame "Alarms — report".]]

{{CntHdr|Using — development}}
This frame should be placed to the panels' logical container of the project tree.

{{CntHdr|Using — runtime}}
Calling the dialogue is made by a characteristic button, at the top right, of [[#alarmsSt|the full-format frame of presenting the violations history]]. The dialog provides the text of the report document and a button at the bottom right to close it.

{| class="wikitable"
<section begin=userManager />
| {{Anch|userManager|<h3>Users manager ([[Special:MyLanguage/Libs/Main_graphical_elements#userManager|userManager]])</h3>}}
| 1.7 || 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.

* '''Sponsored by:''' Vinnica Poultry Farm

[[file:LibMainEls_userManagerD.png|center|frame|Fig.3.7a. The "Users manager" 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 acception dialog frame]] and some attribute configuration is required, below, where no links are provided.

{{CntHdr|Using — runtime}}
In the runtime mode, a list is formed with available users and, at their selection, on the right displayed their information that can be changed. The user can be added and removed by the appropriate interface commands under the list of users.

[[file:LibMainEls_userManagerR.png|center|frame|Fig.3.7b. The "Users manager" frame in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| owner || Owner || String || Owner and group of the frame that have access to it, typically "root:Security" — to allow the frame to be accessed, the user must be included in the "Security" group.
|-
| perm || Access || Integer numbers selection || Frame access rules, typically "RWRW__" — the frame is viewable and controllable only for "root" and users in the "Security" group.
|-
| denyUsers || Deny to control: users, separated by ';' || String || A list of do not controlled users, typically "root;".
|-
| denyGroups || Deny to control: groups, separated by ';' || String || A list of do not controlled groups, typically "root;users;Archive;BD;DAQ;ModSched;Protocol;Security;Special;Transport;UI;".
|-
| newUseGrps || Groups of new created user || String || Groups to which the user is automatically included, after creation, are typically "UI;Guest".
|-
| storeDB || DB of saving new users || String || Database of storage of newly created users, by default — the work one.
|}

{| class="wikitable"
<section begin=storeHouse />
| {{Anch|storeHouse|<h3>Storehouse ([[Special:MyLanguage/Libs/Main_graphical_elements#storeHouse|storeHouse]])</h3>}}
| 2.3 || 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, also as other OpenSCADA parts:
{{#lst:Documents/Release_0.9/Update4/en|FormElTable}}
::* VCAEngine: Appending of the not processed events sending to a page who opened the source page.
::* JavaLikeCalc: Implementing the "var" statement for true scope processing, that is defining new variables in functions with the statement and using global ones without.

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;
** fast control and accessing data of the complex fields through the dynamic Control Panel based on the [[#terminator|Terminator frame]].

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, on the control panel 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 with the control panel.]]

[[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}'''.
|}

{| class="wikitable"
<section begin=dynFrame />
| {{Anch|dynFrame|<h3>Dynamic frame ([[Special:MyLanguage/Libs/Main_graphical_elements#dynFrame|dynFrame]])</h3>}}
| 1.2 || GPLv2 || * || en, uk
<section end=dynFrame />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.9, serves to form frames in runtime whether by the user or automatically, and it is initially created to represent data of the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|initiative connections]].

During the frame implementing there significantly expanded some OpenSCADA parts:
* VCAEngine, Vision, WebVision: allowing of frame's geometry tracing and adjusting-expanding the content to its real size;
* Vision: fixing in processing small scale and unexpected apply events in LineEdit.

The frame provides currently and in future for next features:
* specifying sources as fixed or selectable; also as relinking changed sources of the same type and tracing their appearance/disappearance with automatic placing;
* specifying visual items in a XML-Tree with the possibility to configure all interface here or manually from the running interface;
* providing a hiding table of the sources and the dynamically formed control panel for adding/removing visual items per source with control their parameters: position, geometry, constants;
* providing visual items without sources, as constants-static, and setting attributes directly;
* enabling the archiving locally and remotely for DAQGate.

XML-Tree of the visual elements allowed to place in the root node, placed visual items in the visual elements and sources with constants in the visual items.
<syntaxhighlight lang="XML">
<vEls>
<el id='Main.anShow' wId="aShw" geom="100-1:40-1"
lnkAttrs='pVal-var'
constAttrs='pName-;pPrec-;pErr-;pDscr-;pModeA-;pModeC-;spName;redEVAL'>
<it id='aShw_1' geom="100:40" pos="0:0">
<src id="LogicLev.gen.prm_F3" />
<const id="pName" isLnk="1" lnk="prm:/LogicLev/gen/F3/NAME (+)">Test</const>
</it>
</el>
<el id="Main.TextLab" wId="txtLb" geom="60-1:22-1"
lnkAttrs="st_open;st_close;st_text;com;close;com_text"
constAttrs="digStts-;digComs-;NAME-;err-;DESCR-">
<it id="txtLb_1" geom="100:22" pos="10:10">
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_open" vAttr="st_open" />
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_close" vAttr="st_close" />
</it>
</el>
<el id="originals.Text" wId="txt" geom="100:20" preset="color=red;" resize="1"
constAttrs="*text;*alignment;*font;*color;*orient">
<it id="txt_2" geom="100:20" pos="0:50">
<const id="*text" isLnk="0">Text label</const>
<const id="*color" isLnk="0">blue</const>
</it>
</el>
</vEls>
</syntaxhighlight>

Where:
* ''id'' — identifier;
* ''wId'' — widget identifier base;
* ''geom'' — typical geometry with scale or for concrete visual item;
* ''lnkAttrs'' — list of the generic attributes through ';' for linking as data source in the form "{vis}[-{src}]":
** ''vis'' — ID of the visual attribute;
** ''src'' — ID of the source attribute, it is the same as visual one at missing;
* ''constAttrs'' — list of the additional attributes through ';' for specifying manually in the form "{vis}[-[{src}]]";
** ''src'' — ID of the source attribute, it is the same as visual one at missing and that is a constant at missing even the symbol ''-'', it is spare here and pointed only for its storing for ''lnkAttrs''.
* ''pos'' — position of the visual item;
* ''isLnk'' — the link sign;
* ''lnk'' — link value for restoring;
* ''sAttr'', ''vAttr'' — source and visual attributes of linking.

The default XML-Tree stored in the "visualEls" attribute and can be appended by the user for needed elements or restricted only needed by removing unnecessary ones.

After edition during running the "visualEls" attribute appended and stored in the session for using at next start.

[[file:LibMainEls_dynFrameD.png|center|frame|Fig.3.9a. The "Dynamic 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.

{{CntHdr|Using — runtime}}
In the runtime mode you will see content dependent from the mode:
* at default "Visual elements (visualEls)" and first start you'll see nothing except title, combobox of selection the source and the button of call the sources table;
* at "Visual elements (visualEls)" with preset items and correct sources you'll see those items.

And both of the modes can be configured to show title, combobox of selection the source, the source table and the correspond control panel (Fig.3.9b), where you can add/remove items linked to a source and set parameters for them.

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

[[file:LibMainEls_dynFrameR.png|center|frame|Fig.3.9b. The "Dynamic frame" in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| srcDAQ || Source DAQ
In the format "{type}.{cntr}[;{type}.{cntr}]", where:<br/>
- type: DAQ type, as LogicLev, DAQGate, ...;<br/>
- cntr: controller ID strictly or by RE as "/{RE}/".
| String || Sources for representing on this frame with their selection for not fixed mode.
|-
| srcFIX || Fixed source(s) || Boolean || The fixed sources are appended all to the sources table and without a possibility to select ones by the user.
|-
| titleFIX || Fixed title || String || The fixed title without changing with changing the source.
|-
| visualEls || Visual elements || Text || XML-Tree of the visual elements and their preset items, which are saved in the session after edition in runtime.
|-
| btEdit > en || Enabled || Boolean || Enabling(default)/disabling a button of call the source table for editing.
|-
| srcTitle > en || Enabled || Boolean || Enabling(default)/disabling the source title.
|}

== {{Anch|Panels|Control panels and simple dialogs}} ==
Contains elements-frames of control panels and simple dialogues, that are difficult or unnecessary to be implemented as panels. These frames are intended to be placed in the respective panels directory of the project tree, built on [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]]. The frames are generally not intended to be used separately, as they often represent the specifics of the data to which their provide control elements or expanded information, and should therefore be used with them, except in the case of unification, generalization and extended control of the primitives!

These elements are mostly opened dynamically upon call from the primary view element-widget, performing in that [[Special:MyLanguage/Sub-projects/VCA#LinkingDyn|the dynamic linking of links in the group "<page>" of the panel]] with the widget (often page) that called this panel. Further work, until closing, is done with the data of the calling widget.

{| class="wikitable"
<section begin=terminator />
| {{Anch|terminator|<h3>Terminator panel ([[Special:MyLanguage/Libs/Main_graphical_elements#terminator|terminator]])</h3>}} || 1.1 || GPLv2 || * || en, uk, ru <section end=terminator />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The panel element shown in Figure 4.1 serves to fill the panel container space when no active visual control element is selected in the main frame, since closing or clearing frames in the container area is not provided, only the replacement.

[[file:LibMainEls_terminatorD.png|center|frame|Fig.4.1. The panel element "Terminator panel".]]

{{CntHdr|Using — development}}
This element should be placed in the logical container of the project's tree.

{{CntHdr|Using — runtime}}
Calling the panel is made from [[#RootPgSo|the root page "RootPgSo"]] by changing the signal object or the type of view.

{| class="wikitable"
<section begin=ElCadr />
| {{Anch|ElCadr|<h3>Element cadre ([[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|ElCadr]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru <section end=ElCadr />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element shown in Figures 4.2 is in fact a universal panel of generic and extended control by different devices for all known and defined representative structures of the basic data of the control systems at the DAQ-templates:
* analog: [[Special:MyLanguage/Libs/Main#anUnif|analog signal]], [[Special:MyLanguage/Libs/Main#manInUnif|manual input of the analog signal]], PID-regulator ([[Special:MyLanguage/Libs/Main#pidUnif|analog]] and [[Special:MyLanguage/Libs/Main#pidUnifImp|pulse]]);
* [[Special:MyLanguage/Libs/Main#digitBlockUnif|discrete blocks]]: valves, automatic shut off valves, motors, fans and switches;
* [[Special:MyLanguage/Libs/Main#codeState|arbitrary discrete states]].

In the primary function of the pannel — advanced and common control, this item is called from:
* [[#Widgets|the primary data representing widgets]] of this library: "[[#anShow|Analog show]]", "[[#anShow|Analog show 1]]", "[[#TextLab|Text label]]", "[[#ImgLab|Image label]]";
* [[#MainFrames|the main frames]]: "[[#grpGraph|Graphics group]]", "[[#ViewCadr|Overview frames panel]]", "[[#cntrRegul|Regulator's control panel]]".

If this element using as a control panel is not required, it is firstly in the primary data representing widgets and by their specializing in particular types of data to what a separate panel can be created. Therefore, due to its high universality, due to the support of all known representative structures of DAQ-templates, it is obligatory to use in main frames, as is done in the frame "[[#grpCadr|Contours group]]".

[[file:LibMainEls_ElCadrD.png|center|frame|Fig.4.2a. The "Element cadre" widget in the development mode.]]

{{CntHdr|Using — development}}
The panel does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened in the control panels container of the root page.

The panel Identifier, when placed, should be saved and its line of call, upon receiving focus, in the events processing attribute "evProc" of the primary widget will look "ws_FocusIn::open:/pg_control/pg_ElCadr".

{{CntHdr|Using — runtime}}
''Indications of the analog parameter'' — in this mode, there is no any control, and there are only units displaying, the value's histogram and the name of the parameter.

''Manual input of the analog parameter'' — in addition to displaying indications of analog parameters the buttons to enter a new value are displayed. Enter of the value is displayed in the field at the top, in the backlight rectangle. To validate the input, press the left mouse button in the area of the backlight rectangle, without that the typed value will be reset after a few seconds.

''PID-regulator's mode'' — to the value of a variable and its histogram are added values and histograms of set-point and out of the PID-regulator, the buttons to enter a new value of the set-point or out, as well as the mode adjustment buttons and the field to display the current mode. Also, for the user with appropriate privileges ("root:ITW"), it is available the button to go to a frame to set the coefficients of the PID-regulator. In the case of pulse PID instead of histogram of the analog output it is displayed the status of pulse output with the help of triangles "Up" and "Down" and the manual entry of output leads to direct formation of pulse, respectively down or up.

''Mode of the discrete device'' — in this mode the name and the field of discrete assemble of the parameter are displayed. The field of the discrete assemble contains the current state of discrete device, on the left, and the buttons of commands, on the right. There are two states of the device: "Open", "Closed" and the three commands: "Open", "Close", "Stop". The names of the states and commands can be adjusted during set up. Changing the state of the discrete device is determined by pressing the corresponding command. In direct discrete mode, a combo box is formed with a list of elements from ''digComs'', the current state from ''st_text'' and sending commands to ''com_text''.

Every action on this panel (change of PID-regulator set-point, state of the discrete parameter, ...) is recorded in the actions log by the generation of appropriate messages according to [[Special:MyLanguage/Documents/Program_manual#ArchMess|the message structure of the operator actions]].

For any displayed or controlled parameter the [[#Passport|passport]] can be obtained by clicking the right mouse button on the contour field. The passport will present all the properties of the parameter.

[[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.png|center|frame|Fig.4.2b. The "Element cadre" widget in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| prmId || Parameter: identifier || String || Input link || <page>|SHIFR || Identifier of the parameter, used only to detect the appropriate PID-control pages.
|-
| prmShifr || Parameter: code || String (translate) || Input link || <page>|NAME || Short name of the parameter — code, to be placed below the frame and in actions of the user-operator.
|-
| prmDescr || Parameter: description || String (translate) || Input link || <page>|DESCR || Description of the parameter to be placed in actions of the user-operator.
|-
| prmColor || Parameter: border color || String || Input link || <page>|color || Sets the border color of the contour.
|-
| colspan="6" | ''Properties of the Analog Devices''
|-
| prmDemention || Parameter: dimension || String (translate) || Input link || <page>|ed ||
|-
| prmPrec || Parameter: precision (signs) || Integer || Input link || <page>|prec || Number of digits after the dot in the parameter value and the step of changing the manual input of the value, as well as the set-point and output of the PID-regulator.
|-
| prmVar || Parameter: variable || Real || Full link || <page>|var || Directly the value of the analog parameter.
|-
| max || Parameter: maximum || Real || Input link || <page>|max || Maximum limit of the parameter value.
|-
| min || Parameter: minimum || Real || Input link || <page>|min || Minimum limit of the parameter value.
|-
| prmAMax || Parameter: border up alarm || Real || Input link || <page>|aMax ||
|-
| prmAMin || Parameter: border down alarm || Real || Input link || <page>|aMin ||
|-
| prmWMax || Parameter: border up warning || Real || Input link || <page>|wMax ||
|-
| prmWMin || Parameter: border down warning || Real || Input link || <page>|wMin ||
|-
| colspan="6" | ''Manual Analog Input''
|-
| prmVarIn || Parameter: variable input || Real || Full link || <page>|varIn || Output for manual input of analog parameter value. The presence of this parameter is an indication that the parameter is defined as "Manual Analog Input".
|-
| colspan="6" | ''PID-regulator''
|-
| prmAnalog || Parameter: analog regulator || Boolean || Input link || <page>|analog || The indication of the analog regulator, in the absence of which the regulator is considered as impulse.
|-
| prmAuto || Parameter: automate || Boolean || Full link || <page>|auto || The regulator mode "Automatic".
|-
| prmCasc || Parameter: cascade || Boolean || Full link || <page>|casc || The regulator mode "Cascade".
|-
| prmSp || Parameter: set-point || Real || Full link || <page>|sp || The PID-regulator set-point, which can be set by the user.
|-
| prmImpQdwnTm || Parameter: imp. out down || Boolean || Input link || <page>|impQdwn || The output "Down" of the impulse (PWM) regulator.
|-
| prmImpQupTm || Parameter: imp. out up || Boolean || Input link || <page>|impQup || The output "Up" of the impulse (PWM) regulator.
|-
| prmOut || Parameter: output || Real || Full link || <page>|out || Output of the analog PID-regulator to display and manual input of the output value of PID in the manual mode.
|-
| prmManIn || Parameter: manual input || Real || Full link || <page>|manIn || Manual input of the new output value of the PID-regulator in the manual mode.
|-
| prmNotPID || Parameter: Force disable PID || Boolean || Input link || <page>|notPID || Use when you want to disable PID representing for parameters with SP.
|-
| colspan="6" | ''Properties of the discrete devices''
|-
| prmCom || Parameter: command - "Open" || Boolean || Full link || <page>|com ||
|-
| prmClose || Parameter: command - "Close" || Boolean || Full link || <page>|close ||
|-
| prmStop || Parameter: command - "Stop" || Boolean || Full link || <page>|stop ||
|-
| prmComText || Parameter: text of command || String || Full link || <page>|com_text || The command text directly, taken from ''digComs'' at building the selection combobox.
|-
| digComs || Parameter: discrete commands || String (translate) || Input link || <page>|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status. Default colours for the discrete block are: "green", "red" and "yellow".
|-
| prmOpenSt || Parameter: state - "Opened" || Boolean || Input link || <page>|st_open ||
|-
| prmCloseSt || Parameter: state - "Closed" || Boolean || Input link || <page>|st_close ||
|-
| prmStText || Parameter: status text || String || Input link || <page>|st_text || The status text directly.
|-
| digStts || Parameter: discrete stats || String (translate) || Input link || <page>|digStts || Configuration of the parameter statuses with the structure '''{openedLabel}-{color};{closedLabel}-{color}''', for the discrete block. Default colours are: "green" and "red".
|}

{| class="wikitable"
<section begin=cntrPaspExt />
| {{Anch|cntrPaspExt|<h3>Passport, extended ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|cntrPaspExt]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru
<section end=cntrPaspExt />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element shown in Figure 4.3 is an information-control dialog around the data source parameter — an expanded parameter passport. Unlike [[#cntrPasp|the simple passport]], the expanded one, in addition to information, provides the ability to control the parameter attributes and display the history of the standard attributes in both a trend and a data table.

''Information and control'' for parameter attributes remains the primary function provided in the "View" tab, where the attribute table is formed as their are, with the "Name" and "Value" columns. The table is active and if you select an entry of the accessible to write attribute and at corresponding permissions (root:op), a field for entering new values will be provided at the bottom.

''The history'' is provided in the following two tabs "Trends" and "Data", which may not be available in the absence of the history-archives at standard attributes. The "Trends" tab contains a graphics area, of [[Special:MyLanguage/Sub-projects/VCA#Diagram|the primitive "Diagram"]], on most of the window, and a table at the bottom with the names, colours, and graph scales. The graphs are updated periodically and built with a period of 1 second and a fixed depth of 1 hour. The "Data" tab contains only [[Special:MyLanguage/Sub-projects/VCA#Document|the "Document" primitive]] field with a table with attribute values in columns that is updated with a period of 1 second for the history data period and to a depth of 100 records. The following items of [[Special:MyLanguage/Libs/Main|the representative parameter structures]] are considered standard attributes with history:
* [[Special:MyLanguage/Libs/Main#anUnif|Analog signal]]:
** '''var''' — variable.
* [[Special:MyLanguage/Libs/Main#pidUnif|PID-regulator]]:
** '''sp''' — setpoint;
** '''out''' — output;
** '''auto''' — mode: automate.
* [[Special:MyLanguage/Libs/Main#codeState|Discrete assembles]]:
** '''com''' — command "Open";
** '''close''' — command "Close";
** '''stop''' — command "Stop";
** '''st_open''' — state "Opened";
** '''st_close''' — state "closed".

In the trends of the analog parameters building the attributes are separately processed for alarm ['''aMin'''...'''aMax'''] and warning scales ['''wMin'''...'''wMax'''], which are also displayed in the graph.

[[file:at.png]] This dialogue is currently the main one and has replaced [[#cntrPasp|the simple passport dialogue]].

* '''Sponsored by:''' PAC HARTRON

[[file:LibMainEls_cntrPaspExt.png|center|frame|Fig.4.3. The "Passport, extended" dialogue in the runtime mode.]]

{{CntHdr|Using — development}}
The dialogue does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened as an external dialogue window.

The dialogue Identifier, when placed, should be changed to "cntrPasp" and its line of call, upon pressing right mouse button, in the events processing attribute "evProc" of the primary widget will look "key_mousePresRight::open:/pg_control/pg_cntrPasp".

{{CntHdr|Using — runtime}}
The dialogue provides the user in the tab "View" with information about the data source parameter in the list and the values of all the properties-attributes of the parameter in the table. Where writable attributes may be edited at the permissions "root:op" in the appeared at the bottom field for entering new values, at selecting the attribute.

For the history the user may observe the trends in the tab "Trends" and the data in the tab "Data". For the trends the user may also highlight some one, selecting it in the bottom table, and correct the scales if it is wrong.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pName || Parameter name || Address || Input link || Parameter|NAME || Address to the parameter's name to refer to the parameter entirely and get all of its properties.
|}

{| class="wikitable"
<section begin=cntrPasp />
| {{Anch|cntrPasp|<h3>Passport ([[Special:MyLanguage/Libs/Main_graphical_elements#cntrPasp|cntrPasp]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=cntrPasp />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element shown in Figure 4.4 is an information dialog around the parameter of the data source — the parameter passport, accordingly it allows to receive such information as: cipher, name, description, unit of measure, emergency boundaries and other, corresponding to [[Special:MyLanguage/Libs/Main|the parameter representative structure]] — parameter attributes. The dialogue is based on [[Special:MyLanguage/Sub-projects/VCA#Document|the primitive "Document"]], whose content is generated dynamically and updated periodically.

In building the passport the attributes are separately processed for alarm ['''aMin'''...'''aMax'''] and warning scales ['''wMin'''...'''wMax'''], which combined in a single entry, and can be hidden when turned off.

[[file:at.png]] Currently, this dialogue has actually been replaced by [[#cntrPaspExt|the more functional and expanded passport dialogue]] and is largely disabled in all template and demonstration projects, though no one interferes with its use if only information is required.

[[file:LibMainEls_cntrPasp.png|center|frame|Fig.4.4. The "Passport" dialogue in the runtime mode.]]

{{CntHdr|Using — development}}
The dialogue does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened as an external dialogue window.

The dialogue Identifier, when placed, should be saved and its line of call, upon pressing right mouse button, in the events processing attribute "evProc" of the primary widget will look "key_mousePresRight::open:/pg_control/pg_cntrPasp".

{{CntHdr|Using — runtime}}
The dialogue only provides the user with information about the data source parameter in the list and the values of all the properties-attributes of the parameter in the table.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pName || Parameter name || Address || Input link || Parameter|NAME || Address to the parameter's name to refer to the parameter entirely and get all of its properties.
|}

{| class="wikitable"
<section begin=grph_panel />
| {{Anch|grph_panel|<h3>Panel of the graphs ([[Special:MyLanguage/Libs/Main_graphical_elements#grph_panel|grph_panel]])</h3>}}
| 1.6 || GPLv2 || * || en, uk, ru
<section end=grph_panel />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element shown in Figure 4.5 is a specialised panel for dynamic control of basic user properties of [[Special:MyLanguage/Sub-projects/VCA#Diagram|the primitive "Diagram"]]. So, the panel allows you to view graphs of the history for the required period of time and the desired resolution, supports: the scale, the selection of archiver for display and the graphs presentation in a spectrum of present frequencies or XY.

[[file:LibMainEls_grph_panel.png|center|frame|Fig.4.5. The panel of the graphs in the development and runtime modes (left to right).]]

{{CntHdr|Using — development}}
The panel does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened in the control panels container of the root page.

The panel Identifier, when placed, should be saved and its line of call, upon receiving focus, in the events processing attribute "evProc" of the primary widget will look "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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| tSek || Trend time || DateTime || Full link || <page>|tSek ||
|-
| tSize || Trend size || Real || Full link || <page>|tSize || Time size-interval of the graph in the history from the trend time.
|-
| trcPer || Trace period || Integer || Full link || <page>|trcPer || Period of the trend updating-tracing.
|-
| type || Type || Integer || Full link || <page>|type || Graph's type: "Trend", "Spectrum of frequencies", "XY".
|-
| valArch || Archiver || String || Full link || <page>|valArch ||
|-
| curSek || Cursor || DateTime || Full link || <page>|curSek || Time of the cursor setting.
|-
| curUSek || Cursor, microseconds || Integer || Full link || <page>|curUSek || Time of the cursor setting, microseconds.
|-
| sclVer || Vertical scale || Real || Full link || <page>|sclVerScl || Percentage of the vertical scale.
|-
| sclVerOff || Vertical scale offset || Real || Full link || <page>|sclVerSclOff || Percentage of the offset on the vertical scale.
|-
| sclHor || Horizontal scale || Real || Full link || <page>|sclHorScl || Percentage of the horizontal scale.
|-
| sclHorOff || Horizontal scale offset || Real || Full link || <page>|sclHorSclOff || Percentage of the offset on the horizontal scale.
|-
| sclWin || Scale by window || Boolean || Full link || <page>|sclWin || Switching the window scaling mode.
|-
| sclWinCtx || Scale: by window save context || Object || Input link || <page>|sclWinCtx || Context of storing of the original scale parameters for return.
|}

{| class="wikitable"
<section begin=doc_panel />
| {{Anch|doc_panel|<h3>Panel of documents ([[Special:MyLanguage/Libs/Main_graphical_elements#doc_panel|doc_panel]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=doc_panel />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element shown in Figure 4.6 is a specialized panel for dynamic control of basic user properties of [[Special:MyLanguage/Sub-projects/VCA#Document|the primitive "Document"]]. So, the panel allows you to manage documents and navigate through their histories; supported dynamic and archival documents.

[[file:LibMainEls_doc_panel.png|center|frame|Fig.4.6. The panel of the documents in the development and runtime (dynamic and archival) modes, left to right.]]

{{CntHdr|Using — development}}
The panel does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened in the control panels container of the root page.

The panel Identifier, when placed, should be saved and its line of call, upon receiving focus, in the events processing attribute "evProc" of the primary widget will look "ws_FocusIn::open:/pg_control/pg_doc_panel".

{{CntHdr|Using — runtime}}
The panel provides tools that are somewhat different for the dynamic and archival modes.

''The dynamic document'' provides:
* selection of the document formation time;
* selection of the document formation size (depth) or the begin time;
* navigation through the document for one or five sizes-depths of the document;
* setting the generation time of the document to the current time.

''The archival document'' provides only navigation through documents in the archive by listing them, and display current and overall documents.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| colspan="6" | ''Dynamic documents''
|-
| time || Document time || DateTime || Full link || <page>|time ||
|-
| bTime || Document begin || DateTime || Full link || <page>|bTime ||
|-
| doc || Document || String || Full link || <page>|doc ||
|-
| colspan="6" | ''Archive documents''
|-
| n || Archive size || Integer || Input link || <page>|n ||
|-
| vCur || View cursor || Integer || Full link || <page>|vCur ||
|-
| aCur || Archive cursor || Integer || Input link || <page>|aCur ||
|-
| aSize || Archive size || Integer || Input link || <page>|aSize ||
|}

{| class="wikitable"
<section begin=accept />
| {{Anch|accept|<h3>Accept ([[Special:MyLanguage/Libs/Main_graphical_elements#accept|accept]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=accept />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 4.7 implements a simple operations' acception dialog. The dialog contains a message with a question and two buttons "Apply" and "Cancel". The dialogue, for example, is used in the frame [[#userManager|Users manager]] to accept the deleting operation.

* '''Sponsored by:''' Vassily Grigoriev, [http://e-beam.ru the Laboratory of Vacuum Technologies]

[[file:LibMainEls_accept.png|center|frame|Fig.4.7. The "Accept" dialog in the development and runtime mode.]]

{{CntHdr|Using — development}}
The dialogue does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened as an external dialogue window.

The dialogue Identifier, when placed, should be stored and its line of call, upon pressing the button "progDel", in the events processing attribute "evProc" of the primary widget will look "ws_BtPress:/progDel:open:/pg_control/pg_accept". The question message is taken from the "mess" attribute and the "dlg_Apply" signal is transmitted to the "event" at acception.

{{CntHdr|Using — runtime}}
Calling the dialogue is made from the frame-initiator, and closing is made by pressing any button of the dialog. If you click the "Apply" button the "dlg_Apply" signal will be sent to the frame-initiator, by which it can perform the desired actions.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| elEvent || Element: event || String || Full link || <page>|event || It is used to send the "dlg_Apply" event if accepted.
|-
| elMess || Element: message || String || Input link || <page>|mess || Source of the question message in the dialogue.
|}

{| class="wikitable"
<section begin=treeSelect />
| {{Anch|treeSelect|<h3>Select item into tree ([[Special:MyLanguage/Libs/Main_graphical_elements#treeSelect|treeSelect]])</h3>}}
| 1.0 || GPLv2 || * || en, uk, ru
<section end=treeSelect />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element in Figure 4.8 implements a simple dialog for selecting an item in a tree. The dialog contains the tree itself and the two buttons "Accept" and "Cancel". This dialog, for example, was used and originally designed for it in the frame "[[Special:MyLanguage/Libs/Prescriptions#prescrRunSimple|Prescription: run (simple)]]" for hierarchical selection of an element in a tree.

* '''Sponsored by:''' Vassily Grigoriev, [http://e-beam.ru the Laboratory of Vacuum Technologies]

[[file:LibMainEls_treeSelect.png|center|frame|Fig.4.8. The "Select item into tree" dialog in the development and runtime mode.]]

{{CntHdr|Using — development}}
The dialogue does not require any special configuration by the user, it should only be located in the panels folder of the project tree of [[#RootPgSo|the concept of the signal objects of the root page "RootPgSo"]], which will allow it to be dynamically invoked and opened as an external dialogue window.

The dialogue Identifier, when placed, should be stored and its line of call, upon pressing the button "lib", in the events processing attribute "evProc" of the primary widget will look "ws_BtPress:/lib:open:/pg_control/pg_treeSelect". The items list is taken from the "items" attribute, the selected value from "selValue" and the "dlg_Apply" signal is transmitted to the "event" at acception.

{{CntHdr|Using — runtime}}
Calling the dialogue is made from the frame-initiator, and closing is made by pressing any button of the dialog. If you click the "Apply" button the "dlg_Apply" signal will be sent to the frame-initiator, by which it will apply the selected item.

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| elEvent || Element: event || String || Full link || <page>|event || It is used to send the "dlg_Apply" event if accepted.
|-
| elItems || Element: items list || Text || Input link || <page>|items || Source of the items list in the dialogue.
|-
| selValue || Element: selected value || String || Full link || <page>|selValue || Source of the selected item in the dialogue.
|}

Libs/Main graphical elements/ru

2026-05-10T04:51:15Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Название !! Версия !! Лицензия !! Источник !! Языки !! Автор !! Иконка
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main_graphical_elements|Библиотека основных элементов интерфейса пользователя]]
| 2.3 || 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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pErr || Parameter: error || String || Input link || Parameter|err || Code and text of the parameter error. It is used to generate alarm. The following error codes are processed:
* 1,2 — failure, parameter is not valid, be shown in gray and cross out besides the case with ''redEVAL'';
* 3,4 — above and below the alarm limit, be shown in the styled color ''labColorAlarm'';
* 5,6 — above and below the warning limit, be shown in the styled color ''labColorWarning'';
* 10,11 — the user alarm codes of the statuses warning and alarm, be sown accordingly in the styled color ''labColorWarning'' and ''labColorAlarm''.
|-
| pModeA || Parameter: regulator mode: auto || Boolean || Input link || Parameter|auto || The large letter "A" is displayed on the left when the value checked.
|-
| pModeC || Parameter: regulator mode: cascade || Boolean || Input link || Parameter|casc || The large letter "C" is displayed on the left when the value checked.
|-
| pName || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter displayed over the value and inserted to the alarm messages.
|-
| pPrec || Parameter: precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| pVal || Parameter: value || Real || Input link || Parameter|var || Engineeric real value of the parameter.
|-
| redEVAL || Red parameter name in case of failure || Boolean || Constant || || By default, the color of the parameter's name for the "failure" state (EVAL value) is gray. But some critical for the process parameters must have the "failure" state displayed with the red parameter's name.
|-
| spName || Speech name || String (translate) || Constant || || The parameter name for speech synthesis during the formation of alarm messages taking into account accents of words, pauses, etc. Empty value disables the speech notification!
|}

{| 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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| pErr || Parameter: error || String || Input link || Parameter|err || Code and text of the parameter error. It is used to generate alarm. The following error codes are processed:
* 1,2 — failure, parameter is not valid, be shown in gray and cross out;
* 3,4 — above and below the alarm limit, be shown in the styled color ''labColorAlarm'';
* 5,6 — above and below the warning limit, be shown in the styled color ''labColorWarning'';
* 10,11 — the user alarm codes of the statuses warning and alarm, be sown accordingly in the styled color ''labColorWarning'' and ''labColorAlarm''.
|-
| pNAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter inserted to the alarm messages.
|-
| prec || Parameter: precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| pVal || Parameter: value || Real || Input link || Parameter|var || Engineeric real value of the parameter.
|-
| spName || Speech name || String (translate) || Constant || || The parameter name for speech synthesis during the formation of alarm messages taking into account accents of words, pauses, etc. Empty value disables the speech notification!
|-
| pName || Short name || String || Constant || || Short name-prefix value.
|-
| pNameSz || Short name size || Integer || Constant || || Size of the short name-prefix in pixels, use the zero value to disable the field.
|}

{| class="wikitable"
<section begin=TextLab />
| {{Anch|TextLab|<h3>Текстовая метка ([[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|TextLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=TextLab />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.3 is used to display the dynamic text labels, which form on basis of the discrete signals. Also this element generates notifications of violations on the locally defined condition, the attribute '''ntf''', additionally it cans generate alarms from the attribute "Error (err)". The element commonly uses and represents the representative structure of DAQ-templates of [[Special:MyLanguage/Libs/Main#digitBlockUnif|the discrete block]] and [[Special:MyLanguage/Libs/Main#codeState|the code state]].

* '''Спонсирование:''' Василий Григорьев, [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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| err || Parameter: error || Address || Input link || Parameter|err || Used as the address for accessing the DAQ-Parameter object of messages sending and the value also used for alarms generation.
|-
| NAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| DESCR || Parameter: description || String (translate) || Input link || Parameter|DESCR || Description or long name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| st_open || Parameter: status-open || Boolean || Input link || Parameter|st_open || The state "Opened" of the parameter or the common state of the switch at missing the state signal "Closed".
|-
| st_close || Parameter: status-close || Boolean || Input link || Parameter|st_close || The state "Closed" of the parameter.
|-
| st_text || Parameter: status (text) || String (translate) || Input link || Parameter|st_text || Text of the parameter state, at the mode "Code state".
|-
| digStts || Parameter: statuses || String (translate) || Input link || Parameter|digStts || Configuration of the parameter statuses with the structure '''{openedLabel}-{color};{closedLabel}-{color};{noOpenedClosedLabel}-{color};{OpenedClosedLabel}-{color};{errLabel}-{color}''', for the discrete block.
|-
| com || Parameter: command || Boolean || Full link || Parameter|com || The command "Open" of the parameter or the common command of the switch at missing the command signal "Close".
|-
| close || Parameter: close || Boolean || Full link || Parameter|close || The command "Close" of the parameter.
|-
| stop || Parameter: stop || Boolean || Full link || Parameter|stop || The command "Stop" of the parameter.
|-
| com_text || Parameter: command text (from digComs) || String || Full link || Parameter|com_text || Text of the parameter command, at the mode "Code state".
|-
| digComs || Parameter: commands || String (translate) || Input link || Parameter|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status.
|-
| ntf || Notification "{st}:{modes}:{Speech text}" || String (translate) || Constant || || Configuration of the notification forming at the status (st) [0|1|2(both)|3(err)] and [[Special:MyLanguage/Modules/VCAEngine#Alarms|the notification modes-methods (modes)]], as a string of the digital methods, and by the speech, if pointed such method. The speech message for "3(err)" is taken from the "Error (err)" attribute.
|}

{| class="wikitable"
<section begin=ImgLab />
| {{Anch|ImgLab|<h3>Метка изображением ([[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|ImgLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=ImgLab />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element on Figure 1.4 is used to display the dynamic image labels, which form on basis of the discrete signals. Also this element generates notifications of violations on the locally defined condition, the attribute '''ntf''', additionally it cans generate alarms from the attribute "Error (err)". The element commonly uses and represents the representative structure of DAQ-templates of [[Special:MyLanguage/Libs/Main#digitBlockUnif|the discrete block]] and [[Special:MyLanguage/Libs/Main#codeState|the code state]].

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

[[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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| err || Parameter: error || Address || Input link || Parameter|err || Used as the address for accessing the DAQ-Parameter object of messages sending and the value also used for alarms generation.
|-
| NAME || Parameter: name || String (translate) || Input link || Parameter|NAME || Short name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| DESCR || Parameter: description || String (translate) || Input link || Parameter|DESCR || Description or long name of the parameter to be inserted in the notification of violations and actions of the user-operator.
|-
| st_open || Parameter: status-open || Boolean || Input link || Parameter|st_open || The state "Opened" of the parameter or the common state of the switch at missing the state signal "Closed".
|-
| st_close || Parameter: status-close || Boolean || Input link || Parameter|st_close || The state "Closed" of the parameter.
|-
| st_img || Parameter: status "{img}:{bCol}:{blink}" || String || Input link || Parameter|st_text || Image of the parameter state, at the mode "Code state", where:
* ''img'' — image name, see [[Special:MyLanguage/Modules/VCAEngine#Media|the image attributes]];
* ''bCol'' — background color;
* ''blink'' — blink sign [0|1] of the background.
|-
| imgs || Images, for "{openedImage}-{bCol}:{closedImage}-{bCol}:{noOpenedClosedImage}-{bCol}:{OpenedClosedImage}-{bCol}:{errImage}-{bCol}" || String || Constant || || Configuration of the parameter statuses with the structure '''{openedImage}-{bCol}:{closedImage}-{bCol}:{noOpenedClosedImage}-{bCol};{OpenedClosedImage}-{bCol};{errImage}-{bCol}''', for the discrete block.
|-
| digStts || Parameter: statuses || String (translate) || Input link || Parameter|digStts || Standard configuration of the parameter statuses with the structure '''{notUsed}-{openedColor};{notUsed}-{closedColor};{notUsed}-{noOpenedClosedColor};{notUsed}-{OpenedClosedColor};{notUsed}-{errColor}''', for the discrete block and missing of the attribute '''imgs''.
|-
| com || Parameter: command || Boolean || Full link || Parameter|com || The command "Open" of the parameter or the common command of the switch at missing the command signal "Close".
|-
| close || Parameter: close || Boolean || Full link || Parameter|close || The command "Close" of the parameter.
|-
| stop || Parameter: stop || Boolean || Full link || Parameter|stop || The command "Stop" of the parameter.
|-
| com_text || Parameter: command text (from digComs) || String || Full link || Parameter|com_text || Text of the parameter command, at the mode "Code state".
|-
| digComs || Parameter: commands || String (translate) || Input link || Parameter|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status.
|-
| ntf || Notification "{st}:{modes}:{Speech text}" || String (translate) || Constant || || Configuration of the notification forming at the status (st) [0|1|2(both)|3(err)] and [[Special:MyLanguage/Modules/VCAEngine#Alarms|the notification modes-methods (modes)]], as a string of the digital methods, and by the speech, if pointed such method. The speech message for "3(err)" is taken from the "Error (err)" attribute.
|}

{| 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.
To 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|NAME || Имя объекта для заголовка.
|-
| objDescr || Объект: описание || Текст || Входная связь || Object|DESCR || Описание объекта для подсказки к заголовку.
|-
| objErr || Объект: ошибка || Строка || Входная связь || Object|err || Ошибка объекта для формирования сообщения и подсвечивания заголовка, обрабатываются коды концепции.
|-
| objItems || Объект: элементы || Объект || Входная связь || Object|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|current || The object with current data.
|-
| forecast || Weather: Forecast || Object || Input link || Parameter|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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String (translate) || Constant || || Group name
|-
| allowSelLst || Select: parameters accessible to select || Text || No || || Place here the parameters for selection by the user in a list of the DAQ-paths to them (for more details see the "[[#graphSelPrm|Graph parameter selection]]" dialog):
<pre style="white-space:">
/LogicLev/proc/prm_CPU/prm_load
/LogicLev/proc/prm_MEM/prm_use
/LogicLev/proc/prm_CPU/prm_T </pre>
|-
| perUserSel || Select: save the selection per user || Boolean || No || || Set to save the user selection separately
|-
| colspan="6" | ''Element {n} from 1 to 8(10)''
|-
| el{n} || colspan="5" | ''List of the linking parameters corresponds to the list of the "Graphics group element (ElViewGraph)" widget''
|}

{| 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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| name || Name || String (translate) || Input link || Parameter|NAME || Parameter name-code, to display in the name field.
|-
| dscr || Description || Text (translate) || Input link || Parameter|DESCR || Parameter description, to place in the tooltip and statusbar.
|-
| addr || Address || Address || Input link || Parameter|var || Address to the parameter attribute for the trend building.
|-
| color || Graphic color || String || No || || Working color of the trend
|-
| colorDef || Default color from the style || String || No || || Default color of the trend on the cadre level
|-
| colspan="6" | ''Analog parameters''
|-
| ed || Dimension || String (translate) || Input link || Parameter|ed ||
|-
| prec || Precision || Integer || Input link || Parameter|prec || Number signs after the dot, for positive values, and precision (signs in whole), for negative, to display the real end variable on the screen.
|-
| log || Logarithmic scale || Boolean || Input link || Parameter|log ||
|-
| max || Maximum || Real || Input link || Parameter|max || Upper limit value of the parameter.
|-
| min || Minimum || Real || Input link || Parameter|min || Minimum limit values of the parameter.
|-
| aMax || Border up alarm || Real || Input link || Parameter|aMax ||
|-
| aMin || Border down alarm || Real || Input link || Parameter|aMin ||
|-
| wMax || Border up warning || Real || Input link || Parameter|wMax ||
|-
| wMin || Border down warning || Real || Input link || Parameter|wMin ||
|-
| pModeA || Regulator mode: auto || Boolean || Input link || Parameter|auto || The regulator mode "Automatic".
|-
| pModeC || Regulator mode: cascade || Boolean || Input link || Parameter|casc || The regulator mode "Cascade".
|-
| colspan="6" | ''Discrete parameters''
|-
| digComs || Digital: commands || String (translate) || Constant || || Names and colors of the buttons of the commands are in the format '''{On}[-color]:{Off}[-color][:{Stop}[-color]]'''. Default colors are: green, red and yellow.
|-
| digStts || Digital: states || String (translate) || Constant || || Names and colors of the labels of the states are in the format '''{On}[-color]:{Off}[-color]'''. Default colors are: green and red.
|-
| digRevers || Digital: reversion || Boolean || Constant || || Discrete signal reverse.
|}

{| 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|NAME || Имя параметра (шифр) для отображения в поле имени.
|-
| addr || Адрес || Адрес || Входная связь || Parameter|var || Адрес к атрибуту значения параметра для построения тренда.
|-
| var || Переменная || Вещественный || Входная связь || Parameter|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}|var || Адрес к атрибуту значения параметра для построения графика {n}.
|-
| p{n}_clr || Параметр{n}: цвет || Цвет || Из стиля || labColorGrph{n} ||
|-
| p{n}_max || Параметр{n}: максимум || Вещественный || Входная связь || Parameter {n}|max || Максимальная граница графика.
|-
| p{n}_min || Параметр{n}: минимум || Вещественный || Входная связь || Parameter {n}|min || Минимальная граница графика.
|-
| p{n}_name || Параметр{n}: имя || Строка || Входная связь || Parameter {n}|NAME || Короткое имя параметра для отображения в поле слева.
|}

{| 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|SHIFR ||
|-
| NAME || Параметр: шифр || Строка || Входная связь || Parameter|NAME ||
|-
| DESCR || Параметр: описание || Строка || Входная связь || Parameter|DESCR ||
|-
| max || Параметр: максимум шкалы || Вещественный || Входная связь || Parameter|max ||
|-
| min || Параметр: минимум шкалы || Вещественный || Входная связь || Parameter|min ||
|-
| ed || Параметр: единица измерения || Строка || Входная связь || Parameter|ed ||
|-
| prec || Параметр: точность || Целый || Входная связь || Parameter|prec || Количество знаков после запятой в значении и задании параметра ПИД.
|-
| var || Параметр: переменная || Вещественный || Входная связь || Parameter|var ||
|-
| var_addr || Параметр: адрес переменной || Адрес || Входная связь || Parameter|var || Адрес для построения графика переменной.
|-
| colspan="6" | ''ПИД-регулятор''
|-
| auto_addr || Параметр: автомат || Адрес || Входная связь || Parameter|auto || Адрес для построения графика режима "Автомат".
|-
| sp || Параметр: задание || Вещественный || Входная связь || Parameter|sp ||
|-
| sp_addr || Параметр: адрес задания || Адрес || Входная связь || Parameter|sp || Адрес для построения графика задания.
|-
| out || Параметр: выход || Вещественный || Входная связь || Parameter|out ||
|-
| out_addr || Параметр: адрес выхода || Адрес || Входная связь || Parameter|out || Адрес для построения графика аналогового выхода.
|-
| Hdwn || Параметр: нижняя граница выхода || Вещественный || Полная связь || Parameter|Hdwn || Ограничение значения аналогового выхода по низу.
|-
| Hup || Параметр: верхняя граница выхода || Вещественный || Полная связь || Parameter|Hup || Ограничение значения аналогового выхода по верху.
|-
| Kp || Параметр: коэф. пропорциональности || Вещественный || Полная связь || Parameter|Kp ||
|-
| Ki || Параметр: коэф. пропорциональности интеграла || Вещественный || Полная связь || Parameter|Ki ||
|-
| Ti || Параметр: время интегрирования || Вещественный || Полная связь || Parameter|Ti ||
|-
| Kd || Параметр: коэф. пропорциональности производной || Вещественный || Полная связь || Parameter|Kd ||
|-
| Td || Параметр: время дифференцирования || Вещественный || Полная связь || Parameter|Td ||
|-
| Tzd || Параметр: время задержки дифференциальной части || Вещественный || Полная связь || Parameter|Tzd ||
|-
| Zi || Параметр: зона нечувствительности || Вещественный || Полная связь || Parameter|Zi ||
|-
| K1 || Параметр: коэф. входа 1 || Вещественный || Полная связь || Parameter|K1 ||
|-
| K2 || Параметр: коэф. входа 2 || Вещественный || Полная связь || Parameter|K2 ||
|-
| K3 || Параметр: коэф. входа 3 || Вещественный || Полная связь || Parameter|K3 ||
|-
| K4 || Параметр: коэф. входа 4 || Вещественный || Полная связь || Parameter|K4 ||
|-
| colspan="6" | ''Импульсный ПИД-регулятор''
|-
| impQdwn_addr || Параметр: адрес выхода импульса вниз || Адрес || Входная связь || Parameter|impQdwn || Адрес для построения графика импульсного выхода "Вниз".
|-
| impQup_addr || Параметр: адрес выхода импульса вверх || Адрес || Входная связь || Parameter|impQup || Адрес для построения графика импульсного выхода "Вверх".
|-
| KImpRfact || Параметр: рейтинг фактор || Вещественный || Полная связь || Parameter|KImpRfact || Асимметрия в генерации ширины импульса вверх и вниз.
|-
| TImpMin || Параметр: минимальное время импульса || Целый || Полная связь || Parameter|TImpMin || Генерируются импульсы начиная с указанной ширины.
|-
| TImpPer || Параметр: период повторения импульсов || Целый || Полная связь || Parameter|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.
To 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.7 || 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>}}
| 2.3 || 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, also as other OpenSCADA parts:
{{#lst:Documents/Release_0.9/Update4/en|FormElTable}}
::* VCAEngine: Appending of the not processed events sending to a page who opened the source page.
::* JavaLikeCalc: Implementing the "var" statement for true scope processing, that is defining new variables in functions with the statement and using global ones without.

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;
** fast control and accessing data of the complex fields through the dynamic Control Panel based on the [[#terminator|Terminator frame]].

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, on the control panel 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 with the control panel.]]

[[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}'''.
|}

{| class="wikitable"
<section begin=dynFrame />
| {{Anch|dynFrame|<h3>Dynamic frame ([[Special:MyLanguage/Libs/Main_graphical_elements#dynFrame|dynFrame]])</h3>}}
| 1.2 || GPLv2 || * || en, uk
<section end=dynFrame />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.9, serves to form frames in runtime whether by the user or automatically, and it is initially created to represent data of the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|initiative connections]].

During the frame implementing there significantly expanded some OpenSCADA parts:
* VCAEngine, Vision, WebVision: allowing of frame's geometry tracing and adjusting-expanding the content to its real size;
* Vision: fixing in processing small scale and unexpected apply events in LineEdit.

The frame provides currently and in future for next features:
* specifying sources as fixed or selectable; also as relinking changed sources of the same type and tracing their appearance/disappearance with automatic placing;
* specifying visual items in a XML-Tree with the possibility to configure all interface here or manually from the running interface;
* providing a hiding table of the sources and the dynamically formed control panel for adding/removing visual items per source with control their parameters: position, geometry, constants;
* providing visual items without sources, as constants-static, and setting attributes directly;
* enabling the archiving locally and remotely for DAQGate.

XML-Tree of the visual elements allowed to place in the root node, placed visual items in the visual elements and sources with constants in the visual items.
<syntaxhighlight lang="XML">
<vEls>
<el id='Main.anShow' wId="aShw" geom="100-1:40-1"
lnkAttrs='pVal-var'
constAttrs='pName-;pPrec-;pErr-;pDscr-;pModeA-;pModeC-;spName;redEVAL'>
<it id='aShw_1' geom="100:40" pos="0:0">
<src id="LogicLev.gen.prm_F3" />
<const id="pName" isLnk="1" lnk="prm:/LogicLev/gen/F3/NAME (+)">Test</const>
</it>
</el>
<el id="Main.TextLab" wId="txtLb" geom="60-1:22-1"
lnkAttrs="st_open;st_close;st_text;com;close;com_text"
constAttrs="digStts-;digComs-;NAME-;err-;DESCR-">
<it id="txtLb_1" geom="100:22" pos="10:10">
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_open" vAttr="st_open" />
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_close" vAttr="st_close" />
</it>
</el>
<el id="originals.Text" wId="txt" geom="100:20" preset="color=red;" resize="1"
constAttrs="*text;*alignment;*font;*color;*orient">
<it id="txt_2" geom="100:20" pos="0:50">
<const id="*text" isLnk="0">Text label</const>
<const id="*color" isLnk="0">blue</const>
</it>
</el>
</vEls>
</syntaxhighlight>

Where:
* ''id'' — identifier;
* ''wId'' — widget identifier base;
* ''geom'' — typical geometry with scale or for concrete visual item;
* ''lnkAttrs'' — list of the generic attributes through ';' for linking as data source in the form "{vis}[-{src}]":
** ''vis'' — ID of the visual attribute;
** ''src'' — ID of the source attribute, it is the same as visual one at missing;
* ''constAttrs'' — list of the additional attributes through ';' for specifying manually in the form "{vis}[-[{src}]]";
** ''src'' — ID of the source attribute, it is the same as visual one at missing and that is a constant at missing even the symbol ''-'', it is spare here and pointed only for its storing for ''lnkAttrs''.
* ''pos'' — position of the visual item;
* ''isLnk'' — the link sign;
* ''lnk'' — link value for restoring;
* ''sAttr'', ''vAttr'' — source and visual attributes of linking.

The default XML-Tree stored in the "visualEls" attribute and can be appended by the user for needed elements or restricted only needed by removing unnecessary ones.

After edition during running the "visualEls" attribute appended and stored in the session for using at next start.

[[file:LibMainEls_dynFrameD.png|center|frame|Fig.3.9a. The "Dynamic 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.

{{CntHdr|Using — runtime}}
In the runtime mode you will see content dependent from the mode:
* at default "Visual elements (visualEls)" and first start you'll see nothing except title, combobox of selection the source and the button of call the sources table;
* at "Visual elements (visualEls)" with preset items and correct sources you'll see those items.

And both of the modes can be configured to show title, combobox of selection the source, the source table and the correspond control panel (Fig.3.9b), where you can add/remove items linked to a source and set parameters for them.

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

[[file:LibMainEls_dynFrameR.png|center|frame|Fig.3.9b. The "Dynamic frame" in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| srcDAQ || Source DAQ
In the format "{type}.{cntr}[;{type}.{cntr}]", where:<br/>
- type: DAQ type, as LogicLev, DAQGate, ...;<br/>
- cntr: controller ID strictly or by RE as "/{RE}/".
| String || Sources for representing on this frame with their selection for not fixed mode.
|-
| srcFIX || Fixed source(s) || Boolean || The fixed sources are appended all to the sources table and without a possibility to select ones by the user.
|-
| titleFIX || Fixed title || String || The fixed title without changing with changing the source.
|-
| visualEls || Visual elements || Text || XML-Tree of the visual elements and their preset items, which are saved in the session after edition in runtime.
|-
| btEdit > en || Enabled || Boolean || Enabling(default)/disabling a button of call the source table for editing.
|-
| srcTitle > en || Enabled || Boolean || Enabling(default)/disabling the source title.
|}

== {{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|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Configuration !! Configuration template !! Description
|-
| prmId || Parameter: identifier || String || Input link || <page>|SHIFR || Identifier of the parameter, used only to detect the appropriate PID-control pages.
|-
| prmShifr || Parameter: code || String (translate) || Input link || <page>|NAME || Short name of the parameter — code, to be placed below the frame and in actions of the user-operator.
|-
| prmDescr || Parameter: description || String (translate) || Input link || <page>|DESCR || Description of the parameter to be placed in actions of the user-operator.
|-
| prmColor || Parameter: border color || String || Input link || <page>|color || Sets the border color of the contour.
|-
| colspan="6" | ''Properties of the Analog Devices''
|-
| prmDemention || Parameter: dimension || String (translate) || Input link || <page>|ed ||
|-
| prmPrec || Parameter: precision (signs) || Integer || Input link || <page>|prec || Number of digits after the dot in the parameter value and the step of changing the manual input of the value, as well as the set-point and output of the PID-regulator.
|-
| prmVar || Parameter: variable || Real || Full link || <page>|var || Directly the value of the analog parameter.
|-
| max || Parameter: maximum || Real || Input link || <page>|max || Maximum limit of the parameter value.
|-
| min || Parameter: minimum || Real || Input link || <page>|min || Minimum limit of the parameter value.
|-
| prmAMax || Parameter: border up alarm || Real || Input link || <page>|aMax ||
|-
| prmAMin || Parameter: border down alarm || Real || Input link || <page>|aMin ||
|-
| prmWMax || Parameter: border up warning || Real || Input link || <page>|wMax ||
|-
| prmWMin || Parameter: border down warning || Real || Input link || <page>|wMin ||
|-
| colspan="6" | ''Manual Analog Input''
|-
| prmVarIn || Parameter: variable input || Real || Full link || <page>|varIn || Output for manual input of analog parameter value. The presence of this parameter is an indication that the parameter is defined as "Manual Analog Input".
|-
| colspan="6" | ''PID-regulator''
|-
| prmAnalog || Parameter: analog regulator || Boolean || Input link || <page>|analog || The indication of the analog regulator, in the absence of which the regulator is considered as impulse.
|-
| prmAuto || Parameter: automate || Boolean || Full link || <page>|auto || The regulator mode "Automatic".
|-
| prmCasc || Parameter: cascade || Boolean || Full link || <page>|casc || The regulator mode "Cascade".
|-
| prmSp || Parameter: set-point || Real || Full link || <page>|sp || The PID-regulator set-point, which can be set by the user.
|-
| prmImpQdwnTm || Parameter: imp. out down || Boolean || Input link || <page>|impQdwn || The output "Down" of the impulse (PWM) regulator.
|-
| prmImpQupTm || Parameter: imp. out up || Boolean || Input link || <page>|impQup || The output "Up" of the impulse (PWM) regulator.
|-
| prmOut || Parameter: output || Real || Full link || <page>|out || Output of the analog PID-regulator to display and manual input of the output value of PID in the manual mode.
|-
| prmManIn || Parameter: manual input || Real || Full link || <page>|manIn || Manual input of the new output value of the PID-regulator in the manual mode.
|-
| prmNotPID || Parameter: Force disable PID || Boolean || Input link || <page>|notPID || Use when you want to disable PID representing for parameters with SP.
|-
| colspan="6" | ''Properties of the discrete devices''
|-
| prmCom || Parameter: command - "Open" || Boolean || Full link || <page>|com ||
|-
| prmClose || Parameter: command - "Close" || Boolean || Full link || <page>|close ||
|-
| prmStop || Parameter: command - "Stop" || Boolean || Full link || <page>|stop ||
|-
| prmComText || Parameter: text of command || String || Full link || <page>|com_text || The command text directly, taken from ''digComs'' at building the selection combobox.
|-
| digComs || Parameter: discrete commands || String (translate) || Input link || <page>|digComs || Configuration of the parameter commands with the structure '''{openLabel}-{color};{closeLabel}-{color}''', for the discrete block, and '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', for the code status. Default colours for the discrete block are: "green", "red" and "yellow".
|-
| prmOpenSt || Parameter: state - "Opened" || Boolean || Input link || <page>|st_open ||
|-
| prmCloseSt || Parameter: state - "Closed" || Boolean || Input link || <page>|st_close ||
|-
| prmStText || Parameter: status text || String || Input link || <page>|st_text || The status text directly.
|-
| digStts || Parameter: discrete stats || String (translate) || Input link || <page>|digStts || Configuration of the parameter statuses with the structure '''{openedLabel}-{color};{closedLabel}-{color}''', for the discrete block. Default colours are: "green" and "red".
|}

{| 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|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|NAME || Адрес к имени параметра для обращения к параметру целиком и изъятия всех его свойств.
|}

{| class="wikitable"
<section begin=grph_panel />
| {{Anch|grph_panel|<h3>Панель графиков ([[Special:MyLanguage/Libs/Main_graphical_elements#grph_panel|grph_panel]])</h3>}}
| 1.6 || 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>|tSek ||
|-
| tSize || Размер тренда || Вещественный || Полная связь || <page>|tSize || Временной размер-интервал графика в историю от времени тренда.
|-
| trcPer || Период слежения || Целый || Полная связь || <page>|trcPer || Период обновления-слежения графика.
|-
| type || Тип || Целый || Полная связь || <page>|type || Тип графика: "Тренд", "Спектр частот", "XY".
|-
| valArch || Архиватор || Строка || Полная связь || <page>|valArch ||
|-
| curSek || Курсор || ДатаВремя || Полная связь || <page>|curSek || Время установки курсора.
|-
| curUSek || Курсор, микросекунды || Целый || Полная связь || <page>|curUSek || Время установки курсора, микросекунды.
|-
| sclVer || Вертикальный масштаб || Вещественный || Полная связь || <page>|sclVerScl || Процент вертикального масштаба.
|-
| sclVerOff || Смещение вертикального масштаба || Вещественный || Полная связь || <page>|sclVerSclOff || Процент смещения по вертикальной шкале.
|-
| sclHor || Горизонтальная шкала || Вещественный || Полная связь || <page>|sclHorScl || Процент горизонтального масштаба.
|-
| sclHorOff || Смещение горизонтальной шкалы || Вещественный || Полная связь || <page>|sclHorSclOff || Процент смещения по горизонтальной шкале.
|-
| sclWin || Масштаб окном || Логический || Полная связь || <page>|sclWin || Переключение режима масштабирования окном.
|-
| sclWinCtx || Масштаб: контекст окном || Объект || Входная связь || <page>|sclWinCtx || Контекст сохранения исходных параметров масштабирования окном, для возврата.
|}

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

[[file:LibMainEls_doc_panel.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>|time ||
|-
| bTime || Начало документа || ДатаВремя || Полная связь || <page>|bTime ||
|-
| doc || Документ || Строка || Полная связь || <page>|doc ||
|-
| colspan="6" | ''Архивные документы''
|-
| n || Размер архива || Целый || Входная связь || <page>|n ||
|-
| vCur || Курсор отображения || Целый || Полная связь || <page>|vCur ||
|-
| aCur || Курсор архива || Целый || Входная связь || <page>|aCur ||
|-
| aSize || Размер архива || Целый || Входная связь || <page>|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>|event || Используется для отправки события "dlg_Apply" в случае подтверждения.
|-
| elMess || Элемент: сообщение || Строка || Входная связь || <page>|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>|event || Используется для отправки события "dlg_Apply" в случае подтверждения.
|-
| elItems || Элемент: список элементов || Текст || Входная связь || <page>|items || Источник перечня элементов в диалоге.
|-
| selValue || Элемент: выбранное значение || Строка || Полная связь || <page>|selValue || Источник выбранного элемента в диалоге.
|}

Libs/Main graphical elements/uk

2026-05-10T04:51:09Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Назва !! Версія !! Ліцензія !! Джерело !! Мови !! Автор !! Іконка
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]
| 2.3 || 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/HomePageEn/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_uk.png|center|frame|Рис.1.1. Елемент "Відображення аналогового" у режимі розробки та виконання (зліва праворуч).]]

{{CntHdr|Використання — розробка}}
Цей віджет може бути використано розробником при створені мнемосхем з відображенням значень аналогових параметрів та ПІД-регуляторів. Для використання потрібно додати цей віджет на мнемосхему, підлаштувати горизонтальний, вертикальний розмір масштабом та зв'язати з параметром джерела даних.

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

У активному режимі елементу можна отримати [[#Passport|паспорт]], натиснувши праву клавішу миші на полі віджету. У паспорті будуть представлені всі властивості параметру. За натиском лівої клавіші миші у області панелей з'явиться [[#ElCadr|панель управління]] параметром, та вибір даного віджету буде відображатися блимаючою рамкою.

[[file:at.png]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

{| 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]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

{| class="wikitable"
<section begin=TextLab />
| {{Anch|TextLab|<h3>Текстова мітка ([[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|TextLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=TextLab />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Елемент на рисунку 1.3 слугує для відображення динамічних текстових міток, що формується на основі дискретних сигналів. Також цей елемент генерує повідомлення про порушення за локально визначеною умовою, атрибут '''ntf''', додатково він може генерувати сигнали із атрибуту "Помилка (err)". Елемент загалом використовує та представляє представницьку структуру 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]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

{| class="wikitable"
<section begin=ImgLab />
| {{Anch|ImgLab|<h3>Мітка зображенням ([[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|ImgLab]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru
<section end=ImgLab />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Елемент на рисунку 1.4 слугує для відображення динамічних міток зображень, що формується на основі дискретних сигналів. Також цей елемент генерує повідомлення про порушення за локально визначеною умовою, атрибут '''ntf''', додатково він може генерувати сигнали із атрибуту "Помилка (err)". Елемент загалом використовує та представляє представницьку структуру 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]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| err || Параметр: помилка || Адреса || Вхідний зв'язок || Parameter|err || Використовується у якості адреси для доступу до об'єкту DAQ-Параметру із надсилання повідомлень і значення також використовується для генерації сигналів.
|-
| NAME || Параметр: ім'я || Рядок (переклад) || Вхідний зв'язок || Parameter|NAME || Коротке найменування параметру, що вставляється у повідомлення про порушення та дії оператору-користувача.
|-
| DESCR || Параметр: опис || Рядок (переклад) || Вхідний зв'язок || Parameter|DESCR || Опис або розгорнута назва параметру, що вставляється у повідомлення про порушення та дії оператору-користувача.
|-
| st_open || Параметр: статус-відкрито || Логічний || Вхідний зв'язок || Parameter|st_open || Статус параметру "Відкрито" або загальний статус перемикача за відсутності сигналу стану "Закрито".
|-
| st_close || Параметр: статус-закрито || Логічний || Вхідний зв'язок || Parameter|st_close || Статус параметру "Закрито".
|-
| st_img || Параметр: статус "{img}:{bCol}:{blink}" || Рядок || Вхідний зв'язок || Parameter|st_text || Зображення стану параметру, за режимом "Стан за кодом", де:
* ''img'' — ім'я зображення, дивіться [[Special:MyLanguage/Modules/VCAEngine#Media|атрибути зображення]];
* ''bCol'' — фоновий колір;
* ''blink'' — ознака блимання [0|1] фону.
|-
| imgs || Зображення, для "{openedImage}-{bCol}:{closedImage}-{bCol}:{noOpenedClosedImage}-{bCol}:{OpenedClosedImage}-{bCol}:{errImage}-{bCol}" || Рядок || Стала || || Конфігурація станів параметру зі структурою '''{openedLabel}-{color}:{closedLabel}-{color}:{noOpenedClosedImage}-{bCol}:{OpenedClosedImage}-{bCol}:{errImage}-{bCol}''', для дискретного блоку.
|-
| digStts || Параметр: статуси || Рядок (переклад) || Вхідний зв'язок || Parameter|digStts || Стандартна конфігурація статусів параметру зі структурою '''{notUsed}-{openedColor};{notUsed}-{closedColor};{notUsed}-{noOpenedClosedColor};{notUsed}-{OpenedClosedColor};{notUsed}-{errColor}''', для дискретного блоку та відсутності атрибуту '''imgs''.
|-
| com || Параметр: команда || Логічний || Повний зв'язок || Parameter|com || Команда параметру "Відкрити" або загальна команда перемикача за відсутності сигналу команди "Закрити".
|-
| close || Параметр: закрити || Логічний || Повний зв'язок || Parameter|close || Команда параметру "Закрити".
|-
| stop || Параметр: зупинка || Логічний || Повний зв'язок || Parameter|stop || Команда параметру "Зупинити".
|-
| com_text || Параметр: текст команди (з digComs) || Рядок || Повний зв'язок || Parameter|com_text || Текст команди параметру, за режимом "Стан за кодом".
|-
| digComs || Параметр: команди || Рядок (переклад) || Вхідний зв'язок || Parameter|digComs || Конфігурація команд параметру зі структурою '''{openLabel}-{color};{closeLabel}-{color};{stopLabel}-{color}''', для дискретного блоку, та '''{com1Label}-{color};{com2Label}-{color};...;{comNLabel}-{color}''', для статусу за кодом.
|-
| ntf || Повідомлення "{st}:{modes}:{Текст мови}" || Рядок (переклад) || Стала || || Конфігурація формування повідомлення за статусом (st) [0|1|2(both)|3(err)] та [[Special:MyLanguage/Modules/VCAEngine#Alarms|режимами-методами повідомлення (modes)]], як рядок чисел методів, та мовою, якщо вказано такий метод. Повідомлення мови для "3(err)" береться із атрибуту "Помилка (err)".
|}

{| 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_uk.png|center|frame|Рис.1.5. Елемент "Порушення — активне" у режимі розробки та виконання (згори додолу).]]

{{CntHdr|Використання — розробка}}
Цей віджет може бути використано розробником при створені мнемосхем з постійним відображенням активних порушень або для загального їх відображення на [[#RootPgSo|кореневій сторінці]]. Для використання потрібно додати цей віджет на мнемосхему або кореневу сторінку, підлаштувати горизонтальний, вертикальний розмір, налаштувати вертикальне розширення та відкоригувати інші властивості на кшталт переліку та послідовності відображуваних полів таблиці.

Якщо треба виключити функцію підтвердження то ви маєте виключити час підтвердження "qttm" з переліку полів та встановити елемент неактивним.

{{CntHdr|Використання — виконання}}
У режимі виконання будується таблиця із переліку активних порушень, за визначеними полями, правилом сортування та виокремлення; вміст якої періодично та динамічно оновлюється. За обранням таблиці, отримання фокусу, її висота може розширюватися, відобразивши більше повідомлень, якщо цю функцію увімкнено та є відповідність умови із визначеної кількості порушень.

Користувачу надається можливість підтвердити порушення, змінивши значення поля часу підтвердження або за допомогою панелі керування, що спливе за обранням елементу та рядка порушення.

Ще користувач може залишити коментар до порушення, відкоригувавши відповідне поле таблиці.

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Опис
|-
| active || Активний || Логічний || Вимкнути якщо виключено підтвердження, розширення за отримання фокусу та редагування взагалі — суто відображення.
|-
| hHdrVis || Показувати заголовок: горизонтальний ||Логічний ||
|-
| vHdrVis || Показувати заголовок: вертикальний || Логічний ||
|-
| formDtTm || Формат дати та часу (%Y-%m-%d %H.%M.%S[.%MS,%US]) || Рядок || Формат відображення часу порушення та підтвердження.
|-
| expOnItems || Розширяти при фокусі: елементів (<=0-відключено) || Цілий || Гранична кількість повідомлень для спрацювання функції розширення елементу, збільшення висоти, за отримання фокусу.
|-
| expOnFocus || Розширяти при фокусі: пікселів (0-відключено,>-донизу,<-догори) || Цілий || Встановити у потрібне значення розширення елементу, збільшення висоти, за набуттям фокусу.
|-
| colms || Стовпчики
Перелік поділений ',' з варіантів: atm, qttm, lev, type, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.
| Рядок || Визначити у потрібну послідовність та наповнення полів.
|-
| highLght || Правила підсвітлення
Рядки у формі "{lev}[{slev}]{quitt}:{color}:{font}:{fontColor}".
| Текст || Правила підсвітлення, де:
* ''lev'' — основний рівень повідомлення [0...7];
* ''slev'' — підрівень повідомлення [0...9], опціонально;
* ''quitt'' — ознака підтвердження (квітації) повідомлення [0|1];
* ''color'' — колір фону рядка з повідомленням;
* ''font'' — шрифт тексту рядка з повідомленням;
* ''fontColor'' — колір тексту рядка з повідомленням.
Наприклад:
<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_uk.png|center|frame|Рис.1.6. Елемент "Властивості об'єкту" у режимі розробки та виконання (зліва праворуч).]]

{{CntHdr|Використання — розробка}}
Цей віджет може бути використано розробником при створені мнемосхем з консолідованим відображенням об'єкту як ціле та сутності із властивостями. Для використання потрібно додати цей віджет на мнемосхему, підлаштувати горизонтальний, вертикальний розмір масштабом та зв'язати з параметром джерела даних за DAQ-шаблоном "[[Special:MyLanguage/Libs/Main#ComplexObject|Комплексний об'єкт]]".

{{CntHdr|Використання — виконання}}
У режимі виконання відображається таблиця з властивостями у рядках, де перший стовпчик це назва властивості, а другий її значення. Рядок може підсвічуватися фоном аварійного кольору, у випадку порушення за цією властивістю. Особливе значення має й заголовок віджету де відображається назва об'єкту, фон кольору якого може набувати аварійних кольорів, за наявністю порушень у об'єкта.

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

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| objName || Об'єкт: ім'я || Рядок || Вхідний зв'язок || Object|NAME || Ім'я об'єкту для заголовку.
|-
| objDescr || Об'єкт: опис || Текст || Вхідний зв'язок || Object|DESCR || Опис об'єкту для підказки до заголовку.
|-
| objErr || Об'єкт: помилка || Рядок || Вхідний зв'язок || Object|err || Помилка об'єкту для формування повідомлення та підсвітлення заголовку, опрацьовуються коди концепції.
|-
| objItems || Об'єкт: елементи || Об'єкт || Вхідний зв'язок || Object|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_uk.png|center|frame|Рис.1.7. Елемент "Календар" у режимі розробки та виконання (зліва праворуч).]]

{{CntHdr|Використання — розробка}}
Цей віджет може бути використано розробником при створені мнемосхем з відображенням календаря. Для використання потрібно додати цей віджет на мнемосхему, підлаштувати горизонтальний, вертикальний розмір масштабом, та використовувати атрибут "selTime" цього віджету для отримання та встановлення дати.

{{CntHdr|Використання — виконання}}
У режимі виконання відображається відповідний до обраного рік, місяць та підсвічено день, відповідно до значення атрибуту "selTime".

Користувач має можливість обрати рік та місяця з переліку, а також день у зображені тижнів. Для швидкого повернення до поточної доби передбачено відповідну кнопку.

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

{| class="wikitable"
<section begin=weather />
| {{Anch|weather|<h3>Погода ([[Special:MyLanguage/Libs/Main_graphical_elements#weather|weather]])</h3>}} || 1.0 || GPLv2 || * || en, uk <section end=weather />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Елемент на рисунку 1.8 використовується для відображення даних погоди із параметрів на DAQ-шаблоні "[[Special:MyLanguage/Libs/Main#weather|Погода]]".

[[file:LibMainEls_weather_uk.png|center|frame|Рис.1.8. Елемент "Погода" у режимі розробки та виконання (зліва праворуч).]]

{{CntHdr|Використання — розробка}}
Цей віджет може бути використано розробником при створені мнемосхем з відображенням погоди. Для використання потрібно додати цей віджет на мнемосхему, підлаштувати горизонтальний, вертикальний розмір масштабом та зв'язати з параметром джерела даних за DAQ-шаблоном "[[Special:MyLanguage/Libs/Main#weather|Погода]]".

{{CntHdr|Використання — виконання}}
У режимі виконання відображається поточна погода на горі і прогноз знизу з деталізацією у спливаючій підказці на зображені.

[[File:at.png]] Все ще можуть бути відсутні зображення для деяких погодних умов оскільки вони продовжують додаватися!

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| current || Погода: поточне || Об'єкт || Вхідний зв'язок || Parameter|current || Об'єкт із поточними даними.
|-
| forecast || Погода: прогноз || Об'єкт || Вхідний зв'язок || Parameter|forecast || Об'єкт із прогнозованими даними.
|}

{| 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''; та яким текст незквітованого об'єкту сигналізації може блимати.

Кнопки наразі генеруються динамічно, шляхом копіювання першої та єдиної, відповідно до наявних у дереві проекту віртуальних сторінок об'єктів сигналізації з послідовною цифровою ідентифікацією від 1 (один). Обмеження на кількість кнопок, або об'єктів сигналізації, полягає лише у сумарній довжині назв об'єктів сигналізації, які можна розташувати у два ряди цих кнопок. Тобто, за коротких назв можна отримати до близька 100 об'єктів сигналізація. Якщо об'єкт сигналізації один то навіть ця єдина-базова кнопка ховається.

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

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

Нижче також містяться кнопки квітації, які з'являються за виникнення порушень, а на горі зображення логотипу, яке налаштовується.

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

''[[#alarmsAct|Загальна таблиця активних порушень]]'' — містить кольорові рядки актуальних порушень, яких впорядковано за їх важливістю із більш важливими нагорі. Початково віджет вимкнено.

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

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

* '''Спонсорування динамізації:''' Вінницька Птахофабрика

[[file:LibMainEls_RootPgSoD_uk.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]] Ідентифікатори сторінок видів відображення, вказані як ['''view1'''|'''mn'''], мають вказуватися у дереві або за новою схемою "view1", або за старою "mn". Їх змішування не підтримується і елементи огляду не мають бути порожніми, тобто містити принаймні одну активну сторінку!

У якості тексту кнопок об'єктів сигналізації використовується назва логічного контейнеру з відповідним ідентифікатором ''n''. З опису цього контейнеру також береться і текст спливаючої підказки до цієї кнопки, якщо він не порожній.

Всі подальші налаштування та редагування довкола цього кадру треба здійснювати для його копії-посилання у дереві проекту, та наполегливо не рекомендується редагувати його у бібліотеці, інакше Ви втратите можливість оновлення бібліотеки або ці зміни, при її оновленні!

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

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

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

Зображення логотипу можна змінити так само, як і зображення виду відображення, тобто завантажити до Mime-даних проекту нове зображення із назвою "logo", після чого можна підкоригувати геометрію віджету логотипу під потрібні пропорції. Віджет зображення можна перенести ліворуч, посунувши попередньо кнопку об'єкту сигналізації праворуч на розмір логотипу. Якщо логотип у загалі не потрібен то онуліть ширину його віджету, але не видаляйте його!

Панель навігації та контейнер панелей управління потенційно також можна перенести ліворуч, посунувши контейнер основних кадрів, а може й кнопку об'єкту сигналізації праворуч.

За потреби, кореневу сторінку можна доповнити додатковими елементами, що не потребують особливої обробки, тобто — зміна початкової процедури кадру, що вже є не використанням, а редагуванням. [[file:at.png]] Тут треба зауважити, що зменшення розмірів контейнерів призведе до появи смуг гортання та-або вимагатиме коригування кадрів розташування у контейнер, але цього може бути не потрібно здійснювати, враховуючи розширення контейнеру на невикористані рядки кнопок об'єктів сигналізації.

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

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

[[file:at.png]] Кадр наразі підтримує функціювання із дуже великим значенням "Період опрацювання" або й вимкнення періодичного опрацювання взагалі (значення -2) та це значення також розповсюджується до дочірніх сторінок та віджетів якщо вони бажають такої поведінки (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

Зміна кадру у контейнері панелей управління не відстежуються та вони загалом викликаються із інтерфейсу основних кадрів, хіба-що він очищується зі зміною основного кадру шляхом відкриття панелі-заглушки.

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

[[file:LibMainEls_RootPgSoR_uk.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>Група графіків ([[Special:MyLanguage/Libs/Main_graphical_elements#grpGraph|grpGraph]]); Група графіків 10 ([[Special:MyLanguage/Libs/Main_graphical_elements#grpGraph|grpGraph10]])</h3>}}
| 1.6 || GPLv2 || * || en, uk, ru
<section end=grpGraph />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Елемент-кадр представлений на рисунку 3.1 слугує для одночасного спостереження трендів та управління параметрами у об'єкті сигналізації, включає у себе екземпляри віджету "[[#ElViewGraph|Елемент групи графіків]]" кожного параметру (до 8 або 10) і віджет "Діаграма" для спостереження за графіками параметрів та перегляду історії, а також горизонтальну стрічку гортання для швидкої навігації за доступною історією обраних для відображення параметрів. Варіант у 10 трендів успадковано від базового варіанту у 8 трендів і ви можете створити власні варіанти спадкуючи базу і додати більше елементів групи графіків.

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

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

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

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

[[file:at.png]] Кадр наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківської сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

[[file:LibMainEls_grpGraphR_uk.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>Елемент групи графіків ([[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|ElViewGraph]])</h4>}}
| 1.5 || GPLv2 || * || en, uk, ru
<section end=ElViewGraph />
| [[User:RomanSavochenko|Роман Савоченко]] || 2000 мс
|}
Елемент-віджет, представлений на рисунку 3.1.1, слугує для створення [[#grpGraph|груп графіків]]. Віджет містить інформацію про параметр, режим регулятору, якщо параметр є таким, одиницю виміру аналогового параметру, а також колір, що відповідає параметру тренда. Віджет загалом використовує та представляє представницьку структуру DAQ-шаблонів "[[Special:MyLanguage/Libs/Main#anUnif|Аналоговий сигнал]]" та "[[Special:MyLanguage/Libs/Main#digitBlockUnif|Дискретний блок]]".

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

{{CntHdr|Використання — розробка}}
Хоча даний віджет не призначено для самостійного використання у відриві від [[#grpGraph|групи графіків]], використовувати його можна, наприклад, помістивши на мнемосхему та встановивши зв'язок з параметром джерела даних.

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

Окрім безпосередньо доступних візуальних даних, надається низка елементів контролю:
* "Виділення" — за натиском лівою клавішею миші у області віджету, праворуч з'явиться [[#ElCadr|панель управління параметром]], а вибір даного віджету буде відображено блимаючою рамкою.
* "Приховати/Показати" — за подвійним натиском у області віджету відбувається перемикання показу-приховування графіку даного елементу.
* "Функції контекстного меню" — за посередництвом контекстного меню надається низка функцій:
** "Паспорт" — отримання [[#Passport|паспорту]] параметра, у якому буде представлено всі його властивості.
** "Приховати/Показати" — перемикання показу або приховування графіку даного елементу, аналогічно до подвійного кліку.
** "Показати один" — одиночний показ графіку обраного параметру у його рідній шкалі, шляхом приховування решти елементів у групі.
** "Показати все" — показ всіх графіків параметрів у групі.
** "Обчислення" — виклик [[#graphCalc|діалогу обчислення]] над видимими даними обраного параметру.
** "Обрати" — виклик [[#graphSelPrm|діалогу обрання]] параметру з переліку доступних для обрання — атрибут "Вибір: параметри дозволені для обрання" кадру-власника. Цей пункт доступний тільки у випадку наявності переліку обрання. З діалогу користувач також може очистити параметр, і що для статично перед-встановлених параметрів передбачає повернення до статичного параметру.

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

[[file:at.png]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| name || Ім'я || Рядок (переклад) || Вхідний зв'язок || Parametr|NAME || Ім'я-шифр параметру, для відображення у полі назви.
|-
| dscr || Опис || Текст (переклад) || Вхідний зв'язок || Parameter|DESCR || Ім'я параметру, для розташування до tooltip та statusbar.
|-
| addr || Адреса || Адреса || Вхідний зв'язок || Parameter|var || Адреса до атрибуту значення параметру для побудови графіку.
|-
| color || Колір графіку || Рядок || Немає || || Робочій колір тренду
|-
| colorDef || Типовий колір зі стилю || Рядок || Немає || || Типовий колір тренду на рівні кадру
|-
| colspan="6" | ''Аналогові параметри''
|-
| ed || Одиниця виміру || Рядок (переклад) || Вхідний зв'язок || Parameter|ed ||
|-
| prec || Точність || Цілий || Вхідний зв'язок || Parameter|prec || Кількість знаків після точки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення кінцевого реального значення на екрані.
|-
| log || Логарифмічна шкала || Логічний || Вхідний зв'язок || Parameter|log ||
|-
| max || Максимум || Реальний || Вхідний зв'язок || Parameter|max || Верхня межа значення параметру.
|-
| min || Мінімум || Реальний || Вхідний зв'язок || Parameter|min || Нижня межа значення параметру.
|-
| aMax || Границя верхня аварійна || Реальний || Вхідний зв'язок || Parameter|aMax ||
|-
| aMin || Границя нижня аварійна || Реальний || Вхідний зв'язок || Parameter|aMin ||
|-
| wMax || Границя верхня попереджув. || Реальний || Вхідний зв'язок || Parameter|wMax ||
|-
| wMin || Границя нижня попереджув. || Реальний || Вхідний зв'язок || Parameter|wMin ||
|-
| pModeA || Режим регулятору: автомат || Логічний || Вхідний зв'язок || Parameter|auto || Режим регулятору "Автомат".
|-
| pModeC || Режим регулятору: каскад || Логічний || Вхідний зв'язок || Parameter|casc || Режим регулятору "Каскад".
|-
| 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_uk.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_uk.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_uk.png|center|frame|Рис.3.2a. Кадр "Група контурів" у режимі розробки.]]

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

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

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

[[file:at.png]] Кадр наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківської сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

[[file:LibMainEls_grpCadrR_uk.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_uk.png|center|frame|Рис.3.3a. Кадр "Група оглядових кадрів" у режимі розробки.]]

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

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

[[file:LibMainEls_ViewCadrR_uk.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_uk.png|center|frame|Рис.3.3.1. Віджет "Кадр групи огляду" у режимі розробки та виконання (зліва праворуч).]]

{{CntHdr|Використання — розробка}}
Хоча даний віджет не призначено для самостійного використання, у відриві від [[#ViewCadr|групи огляду]], використовувати його таки можна, наприклад, помістивши на мнемосхему та встановивши зв'язок з параметром джерела даних.

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

У активному режимі елементу можна отримати [[#Passport|паспорт]], натиснувши праву клавішу миші на полі віджету. У паспорті будуть представлені всі властивості параметру. За натиском лівої клавіші миші у області панелей з'явиться [[#ElCadr|панель управління]] параметром, та вибір даного віджету буде відображатися блимаючою рамкою.

[[file:at.png]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| name || Ім'я || Рядок || Вхідний зв'язок || Parameter|NAME || Ім'я параметру (шифр) для відображення у полі назви.
|-
| addr || Адреса || Адреса || Вхідний зв'язок || Parameter|var || Адреса до атрибуту значення параметру для побудови тренду.
|-
| var || Змінна || Реальний || Вхідний зв'язок || Parameter|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_uk.png|center|frame|Рис.3.4a. Кадр "Зведені графіки" у режимі розробки.]]

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

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

[[file:LibMainEls_ResultGraphR_uk.png|center|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_uk.png|center|frame|Рис.3.4.1. Віджет "Кадр зведених графіків" у режимі розробки та виконання (зліва праворуч).]]

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

{{CntHdr|Використання — виконання}}
У режимі виконання, у основному полі елементу, відображається заголовок групи, заголовки та тренди параметрів у визначених конфігурацією або стилем кольорах.

[[file:at.png]] Віджет наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківського віджету/сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

{| 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_uk.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_uk.png|center|frame|Рис.3.5b. Кадр "Панель налаштування регулятору" у режимі виконання.]]

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| SHIFR || Параметр: шифр || Рядок || Вхідний зв'язок || Parameter|SHIFR ||
|-
| NAME || Параметр: шифр || Рядок || Вхідний зв'язок || Parameter|NAME ||
|-
| DESCR || Параметр: опис || Рядок|| Вхідний зв'язок || Parameter|DESCR ||
|-
| max || Параметр: максимум шкали || Реальний || Вхідний зв'язок || Parameter|max ||
|-
| min || Параметр: мінімум шкали || Реальний || Вхідний зв'язок || Parameter|min ||
|-
| ed || Параметр: одиниця виміру || Рядок || Вхідний зв'язок || Parameter|ed ||
|-
| prec || Параметр: точність || Цілий || Вхідний зв'язок || Parameter|prec || Кількість знаків після коми у значенні та завданні параметру ПІД.
|-
| var || Параметр: змінна || Реальний || Вхідний зв'язок || Parameter|var ||
|-
| var_addr || Параметр: адреса змінної || Адреса || Вхідний зв'язок || Parameter|var || Адреса для побудови графіку змінної.
|-
| colspan="6" | ''ПІД-регулятор''
|-
| auto_addr || Параметр: автомат || Адреса || Вхідний зв'язок || Parameter|auto || Адреса для побудови графіку режиму "Автомат".
|-
| sp || Параметр: завдання || Реальний || Вхідний зв'язок || Parameter|sp ||
|-
| sp_addr || Параметр: адреса завдання || Адреса || Вхідний зв'язок || Parameter|sp || Адреса для побудови графіку завдання.
|-
| out || Параметр: вихід || Реальний || Вхідний зв'язок || Parameter|out ||
|-
| out_addr || Параметр: адреса виходу || Адреса || Вхідний зв'язок || Parameter|out || Адреса для побудови графіку аналогового виходу.
|-
| Hdwn || Параметр: нижня границя виходу || Реальний || Повний зв'язок || Parameter|Hdwn || Обмеження значення аналогового виходу по низу.
|-
| Hup || Параметр: верхня границя виходу || Реальний || Повний зв'язок || Parameter|Hup || Обмеження значення аналогового виходу по верху.
|-
| Kp || Параметр: коеф. пропорційності || Реальний || Повний зв'язок || Parameter|Kp ||
|-
| Ki || Параметр: коеф. пропорційності інтегралу || Реальний || Повний зв'язок || Parameter|Ki ||
|-
| Ti || Параметр: час інтегрування || Реальний || Повний зв'язок || Parameter|Ti ||
|-
| Kd || Параметр: коеф. пропорційності похідної || Реальний || Повний зв'язок || Parameter|Kd ||
|-
| Td || Параметр: час диференцювання || Реальний || Повний зв'язок || Parameter|Td ||
|-
| Tzd || Параметр: час затримки похідної частини || Реальний || Повний зв'язок || Parameter|Tzd ||
|-
| Zi || Параметр: зона нечутливості || Реальний || Повний зв'язок || Parameter|Zi ||
|-
| K1 || Параметр: коеф. входу 1 || Реальний || Повний зв'язок || Parameter|K1 ||
|-
| K2 || Параметр: коеф. входу 2 || Реальний || Повний зв'язок || Parameter|K2 ||
|-
| K3 || Параметр: коеф. входу 3 || Реальний || Повний зв'язок || Parameter|K3 ||
|-
| K4 || Параметр: коеф. входу 4 || Реальний || Повний зв'язок || Parameter|K4 ||
|-
| colspan="6" | ''Імпульсний ПІД-регулятор''
|-
| impQdwn_addr || Параметр: адреса імпульсного виходу донизу || Адреса || Вхідний зв'язок || Parameter|impQdwn || Адреса для побудови графіку імпульсного виходу "Вниз".
|-
| impQup_addr || Параметр: адреса імпульсного виходу догори || Адреса || Вхідний зв'язок || Parameter|impQup || Адреса для побудови графіку імпульсного виходу "Вверх".
|-
| KImpRfact || Параметр: рейтинг фактор || Реальний || Повний зв'язок || Parameter|KImpRfact || Асиметрія у генерації ширини імпульсу вверх та вниз.
|-
| TImpMin || Параметр: мінімальний час імпульсу || Цілий || Повний зв'язок || Parameter|TImpMin || Генеруються імпульси починаючи з вказаної ширини.
|-
| TImpPer || Параметр: період імпульсів || Цілий || Повний зв'язок || Parameter|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_uk.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_uk.png|center|frame|Рис.3.6b. Кадр "Порушення — стан" у режимі виконання.]]

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Опис
|-
| messCat || Категорія повідомлень || Рядок || Категорія опрацьовуваних повідомлень, типово "al*:*".
|-
| messLim || Обмеження повідомлень, кількість || Цілий || Максимальна кількість повідомлень у таблиці, типово 1000.
|-
| alArch || Архіватор сигналів, "{ArhMod}.{Arh}" || Рядок || Архіватор з якого брати порушення, порожньо для всіх.
|-
| alarms.active || Активний || Логічний || Вимкнути якщо виключено підтвердження, розширення за отримання фокусу та редагування взагалі — суто відображення.
|-
| hHdrVis || Показувати заголовок: горизонтальний ||Логічний ||
|-
| vHdrVis || Показувати заголовок: вертикальний || Логічний ||
|-
| formDtTm || Формат дати та часу (%Y-%m-%d %H.%M.%S[.%MS,%US]) || Рядок || Формат відображення часу порушення та підтвердження.
|-
| colms || Стовпчики
Перелік поділений ',' з варіантів: atm, qttm, nrmtm, lev, cat, mess, prm, dscr, dscrCust{N}, alrm, cmnt.
| Рядок || Визначити у потрібну послідовність та наповнення полів.
|-
| highLght || Правила підсвітлення
Рядки у формі "{lev}[{slev}]{quitt}{act}:{color}:{font}:{fontColor}".
| Текст || Правила підсвітлення, де:
* ''lev'' — основний рівень повідомлення [0...7];
* ''slev'' — підрівень повідомлення [0...9], опціонально;
* ''quitt'' — ознака підтвердження повідомлення [0|1];
* ''act'' — ознака активності повідомлення [0|1];
* ''color'' — колір фону рядка з повідомленням;
* ''font'' — шрифт тексту рядка з повідомленням;
* ''fontColor'' — колір тексту рядка з повідомленням.
Наприклад:
<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>Звіт ([[Special:MyLanguage/Libs/Main_graphical_elements#alarmsStReport|alarmsStReport]])</h4>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=alarmsStReport />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Елемент-кадр, представлений на рисунку 3.6.1, реалізує діалог відображення звітного документу, побудованого із переліку отриманих порушень [[#alarmsSt|кадру повноформатного представлення історії порушень]].

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

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

[[file:LibMainEls_alarmsStReport_uk.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.7 || GPLv2 || * || en, uk, ru
<section end=userManager />
| [[User:RomanSavochenko|Роман Савоченко]] || -2 мс (вимкнено)
|}
Елемент-кадр, представлений на рисунку 3.7, слугує для надання можливості контролю користувачів з інтерфейсу самого користувача. Тобто, типово ця функція надається програмісту SCADA на рівні [[Special:MyLanguage/Documents/Program_manual#CfgSecurity|конфігурації підсистеми "Безпека"]], але інколи виникає потреба надання такої можливості з інтерфейсу користувача та із низкою обмежень на контрольованих користувачів та їх групи, що цей кадр здійснює та загалом надає функції:
* формування переліку підконтрольних користувачів;
* можливість ознайомлення та зміни інформації користувачів, щодо: ім'я, повного ім'я, опису, паролю та груп;
* додання нових та видалення діючих користувачів;
* можливість редагування власної інформації та пароля непривілейованого користувача.

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

[[file:LibMainEls_userManagerD_uk.png|center|frame|Рис.3.7a. Кадр "Менеджер користувачів" у режимі розробки.]]

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

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

[[file:LibMainEls_userManagerR_uk.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>Склад ([[Special:MyLanguage/Libs/Main_graphical_elements#storeHouse|storeHouse]])</h3>}}
| 2.3 || GPLv2 || * || en, uk
<section end=storeHouse />
| [[User:RomanSavochenko|Роман Савоченко]] || -1 мс (предок)
|}
Елемент-кадр, представлений на рисунку 3.8, слугує для контролю складу зі зберігання-керування речами різних класів-категорій. Початково його розроблено та перевірено на класі "Бібліотека". Кадр передбачає прямий доступ до БД за SQL та наразі підтримує лише MySQL/MariaDB.

Протягом реалізації кадру, вигляд "Таблиця" [[Special:MyLanguage/Modules/VCAEngine|примітиву "FormEl"]] значним чином розширено на обох візуалізаторах, як і інші частини OpenSCADA:
{{#lst:Documents/Release_0.9/Update4/uk|FormElTable}}
::* VCAEngine: Доповнення надсиланням неопрацьованих повідомлень до сторінки, яка відкрила вихідну сторінку.
::* JavaLikeCalc: Реалізація оператору "var" щодо обробки правильної області видимості, тобто визначення нових змінних у функціях із оператором і використання глобальних без нього.

Кадр надає наразі, та надасть у майбутньому, наступні властивості:
* '''Режим редагування класів''': споглядання, створення та редагування класів складу із функцією збереження даних при зміні типу поля.
* '''Режим споглядання та редагування основних даних''':
** споглядання основних даних обраного або фіксованого класу складу у великій таблиці із можливістю сортування та фільтрування до п'ятьма стовпчиками;
** редагування вмісту клітинок таблиці у режимі редагування;
** додання, копіювання та видалення записів-рядків таблиці у режимі редагування;
** генерація звітної документації до обраного елементу, готової до друку та зручної для повного огляду;
** генерація звітної документації до основної таблиці з урахуванням налаштувань фільтру та природним відображенням специфічних полів;
** деталізована панель-форма керування обраним елементом зі специфічними полями.
** швидкий контроль і доступ до даних складних полів через динамічну Панель Керування, засновану на [[#terminator|Термінальному кадрі]].

Класи складів зберігаються у таблиці "classes" із фіксованою структурою таблиці "<u>'''CLASS'''</u>, <u>'''ID'''</u>, '''NAME''', '''TP''' , '''TBL''', '''FILTER'''", де:
* ''CLASS'' [varchar(20)] — ІД класу;
* ''ID'' [varchar(20)] — ІД специфічного поля класу;
* ''NAME'' [text] — локалізована назва специфічного поля класу, де перший рядок для типового значення та наступні рядки формуються у вигляді '''{2СимвольнаМова}:{ЛокалізованийТекст}''';
* ''TP'' [varchar(100)] — тип специфічного поля класу, який прямо відповідає типам БД MySQL і деяким специфічним:
:* "'''file[:{max}[:{storage}[:{MIME}[:{OverViewSz}]]]]'''" — прикріплення файлів із параметрами:
::* ''max'' — максимум файлів дозволених до прикріплення;
::* ''storage'' — сховок файлів на Файловій Системі за визначеним шляхом, і порожнє для збереження прямо у полі БД типу LONGTEXT;
::* ''MIME'' — тип файлів, дозволених до прикріплення-завантаження, де порожньо для будь якого і на кшталт "image/*" лише для зображень;
::* ''OverViewSz'' — увімкнути поле перегляду файлів зображень на формі елементу із визначеним розміром у пікселях.
* ''TBL'' [varchar(100)] — властивості представлення даних специфічного поля у таблиці, має формат '''{вирівнювання}:{ширина}:{позиція}''', де:
:* ''вирівнювання'' — вирівнювання стовпчика, підтримуються значення: "left", "center", "right"; де значення "left" по замовченню для рядків та "center" для інших;
:* ''ширина'' — примусова ширина стовпчика, у відсотках за символу "%" у кінці або у пікселях;
:* ''позиція'' — позиція стовпчика у вигляді рядка, тож ви можете записати це на кшталт "005" для правильного сортування.
* ''FILTER'' [text] — властивості специфічного поля щодо приготування фільтрації та індексування списків для обрання у фільтрі, щодо варіантів: '''index''' і '''list{СимволПоділювача}''', де:
:* ''index'' — значення стовпчика враховується цілком при індексуванні;
:* ''list{СимволПоділювача}'' — значення стовпчика вважається переліком елементів для індексування, поділено символом ''СимволПоділювача''.
: Починаючи із другого рядка ви можете визначити правила підсвітлення у вигляді "'''{ID}:{FLGS}:{color}:{font}'''", де:
:* ''ID'' — індексоване або перелічене значення у клітинці;
:* ''FLGS'' — перелік прапорців [0|1], наразі це лише "Підсвітити [Клітинка|Рядок]";
:* ''color'' — колір тла;
:* ''font'' — шрифт тексту.
* ''PROC'' [text] — процедура обчислення значення клітинки на внутрішній мові [[Special:MyLanguage/Modules/JavaLikeCalc|JavaLikeCalc.JavaScript]] OpenSCADA, стовпчик стає логічним; клітинки логічних стовпців не доступні до редагування вручну; всі клітинки запису-рядка доступні у процедурі за їх ІД, включно із обчислювальною, яку ви маєте визначити якимось значенням; можете також використати цю властивість як тимчасову, тобто встановити процедуру для обчислення і потім її очистити;
: [[file:at.png]] Встановлення тут процедури очищуватиме (встановлюватиме у NULL) всі клітинки стовпця!

Дані складу відповідного класу зберігаються у окремій таблиці із назвою "sh_{CLASS}" та структурою "<u>'''ID'''</u>, '''NAME''', '''DSCR''', '''SP_{ID}1''', ..., '''SP_{ID}N'''", де:
* ''ID'' [INT] — автоматичний індекс таблиці, дозволено до зміни видимості;
* ''NAME'' [varchar(200)] — назва елементу, дозволено до зміни типу;
* ''DSCR'' [text] — опис елементу;
* ''SP_{ID}X'' — специфічне поле класу відповідно до ''ID'' класу таблиці.

Зі спеціальним сенсом у таблиці "classes" зарезервовано та примусово створювано поля "*TITLE" для загальної локалізованої назви складу та "*NAME", "*DSCR" із контролем відповідних фіксованих полей.

[[file:LibMainEls_storeHouseD_uk.png|center|frame|Рис.3.8a. Кадр "Склад" у режимі розробки.]]

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

Для увімкнення звітності ви маєте розташувати [[#alarmsStReport|кадр звітності порушень]] до логічного контейнеру панелей у дереві проєкту.

{{CntHdr|Використання — виконання}}
У режимі виконання ви побачити одну велику таблицю для редагування класів (Рис.3.8b) і представлення даних (Рис.3.8c) із редагуванням даних безпосередньо у таблиці, на панелі керування або у формі редагування елементу (Рис.3.8d).

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

У режимі редагування основних даних класу, користувачі, допущені до редагування, можуть додавати, копіювати, видаляти рядки/записи та редагувати поля.

У режимі редагування класу, користувачі, допущені до редагування, можуть додавати нові та видаляти представлені (після видалення останнього елементу) класи; та додавати, видаляти специфічні поля класу і редагувати властивості цих полів.

Для обмеження доступу користувачів наразі надається лише механізм включення користувачів, дозволених для редагування класу та даних, до групи "ITW".

Для генерації окремого звіту користувач може клацнути характерну іконку у правому верхньому куту.

[[file:at.png]] Кадр наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківської сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

[[file:LibMainEls_storeHouseDataR_uk.png|center|frame|Рис.3.8c. Кадр "Склад" у режимі виконання на представлені даних із панеллю контролю.]]

[[file:LibMainEls_storeHouseDataRf_uk.png|center|frame|Fig.3.8d. Кадр "Склад" у режимі виконання на формі редагування елементу.]]

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Опис
|-
| class || Клас: поточний || Рядок || Примусовий/ініціюючий клас першого відкриття.
|-
| classEditable (Стала) || Клас: редагований || Логічний || Прапорець дозволу редагування класу.
|-
| classFix (Стала) || Клас: фіксований || Рядок || Фіксований клас для якого кадр лише виконується, забороняючи доступ до інших класів.
|-
| dataEditable (Стала) || Дані: редаговане || Логічний || Прапорець дозволу редагування основних даних.
|-
| db || БД: База даних || Рядок || База даних класів та даних у вигляді '''{Тип}.{БД}'''.
|}

{| class="wikitable"
<section begin=dynFrame />
| {{Anch|dynFrame|<h3>Dynamic frame ([[Special:MyLanguage/Libs/Main_graphical_elements#dynFrame|dynFrame]])</h3>}}
| 1.2 || GPLv2 || * || en, uk
<section end=dynFrame />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.9, serves to form frames in runtime whether by the user or automatically, and it is initially created to represent data of the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|initiative connections]].

During the frame implementing there significantly expanded some OpenSCADA parts:
* VCAEngine, Vision, WebVision: allowing of frame's geometry tracing and adjusting-expanding the content to its real size;
* Vision: fixing in processing small scale and unexpected apply events in LineEdit.

The frame provides currently and in future for next features:
* specifying sources as fixed or selectable; also as relinking changed sources of the same type and tracing their appearance/disappearance with automatic placing;
* specifying visual items in a XML-Tree with the possibility to configure all interface here or manually from the running interface;
* providing a hiding table of the sources and the dynamically formed control panel for adding/removing visual items per source with control their parameters: position, geometry, constants;
* providing visual items without sources, as constants-static, and setting attributes directly;
* enabling the archiving locally and remotely for DAQGate.

XML-Tree of the visual elements allowed to place in the root node, placed visual items in the visual elements and sources with constants in the visual items.
<syntaxhighlight lang="XML">
<vEls>
<el id='Main.anShow' wId="aShw" geom="100-1:40-1"
lnkAttrs='pVal-var'
constAttrs='pName-;pPrec-;pErr-;pDscr-;pModeA-;pModeC-;spName;redEVAL'>
<it id='aShw_1' geom="100:40" pos="0:0">
<src id="LogicLev.gen.prm_F3" />
<const id="pName" isLnk="1" lnk="prm:/LogicLev/gen/F3/NAME (+)">Test</const>
</it>
</el>
<el id="Main.TextLab" wId="txtLb" geom="60-1:22-1"
lnkAttrs="st_open;st_close;st_text;com;close;com_text"
constAttrs="digStts-;digComs-;NAME-;err-;DESCR-">
<it id="txtLb_1" geom="100:22" pos="10:10">
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_open" vAttr="st_open" />
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_close" vAttr="st_close" />
</it>
</el>
<el id="originals.Text" wId="txt" geom="100:20" preset="color=red;" resize="1"
constAttrs="*text;*alignment;*font;*color;*orient">
<it id="txt_2" geom="100:20" pos="0:50">
<const id="*text" isLnk="0">Text label</const>
<const id="*color" isLnk="0">blue</const>
</it>
</el>
</vEls>
</syntaxhighlight>

Where:
* ''id'' — identifier;
* ''wId'' — widget identifier base;
* ''geom'' — typical geometry with scale or for concrete visual item;
* ''lnkAttrs'' — list of the generic attributes through ';' for linking as data source in the form "{vis}[-{src}]":
** ''vis'' — ID of the visual attribute;
** ''src'' — ID of the source attribute, it is the same as visual one at missing;
* ''constAttrs'' — list of the additional attributes through ';' for specifying manually in the form "{vis}[-[{src}]]";
** ''src'' — ID of the source attribute, it is the same as visual one at missing and that is a constant at missing even the symbol ''-'', it is spare here and pointed only for its storing for ''lnkAttrs''.
* ''pos'' — position of the visual item;
* ''isLnk'' — the link sign;
* ''lnk'' — link value for restoring;
* ''sAttr'', ''vAttr'' — source and visual attributes of linking.

The default XML-Tree stored in the "visualEls" attribute and can be appended by the user for needed elements or restricted only needed by removing unnecessary ones.

After edition during running the "visualEls" attribute appended and stored in the session for using at next start.

[[file:LibMainEls_dynFrameD.png|center|frame|Fig.3.9a. The "Dynamic 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.

{{CntHdr|Using — runtime}}
In the runtime mode you will see content dependent from the mode:
* at default "Visual elements (visualEls)" and first start you'll see nothing except title, combobox of selection the source and the button of call the sources table;
* at "Visual elements (visualEls)" with preset items and correct sources you'll see those items.

And both of the modes can be configured to show title, combobox of selection the source, the source table and the correspond control panel (Fig.3.9b), where you can add/remove items linked to a source and set parameters for them.

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

[[file:LibMainEls_dynFrameR.png|center|frame|Fig.3.9b. The "Dynamic frame" in the runtime mode.]]

{{CntHdr|Linking and configuring the attributes}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Description
|-
| srcDAQ || Source DAQ
In the format "{type}.{cntr}[;{type}.{cntr}]", where:<br/>
- type: DAQ type, as LogicLev, DAQGate, ...;<br/>
- cntr: controller ID strictly or by RE as "/{RE}/".
| String || Sources for representing on this frame with their selection for not fixed mode.
|-
| srcFIX || Fixed source(s) || Boolean || The fixed sources are appended all to the sources table and without a possibility to select ones by the user.
|-
| titleFIX || Fixed title || String || The fixed title without changing with changing the source.
|-
| visualEls || Visual elements || Text || XML-Tree of the visual elements and their preset items, which are saved in the session after edition in runtime.
|-
| btEdit > en || Enabled || Boolean || Enabling(default)/disabling a button of call the source table for editing.
|-
| srcTitle > en || Enabled || Boolean || Enabling(default)/disabling the source title.
|}

== {{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_uk.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_uk.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]] Кадр наразі підтримує функціювання із дуже великим значенням "Період опрацювання" та це значення наразі встановлено для спадкування від батьківської сторінки/сеансу (значення -1). Це можливе завдяки механізму раннього опрацювання подій та можливості контролю періодичності опрацювання із процедури.

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

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

{| 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_uk.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|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_uk.png|center|frame|Рис.4.4. Діалог "Паспорт" у режимі виконання.]]

{{CntHdr|Використання — розробка}}
Діалог не передбачає спеціальної конфігурації користувачем, він має лише бути розташований у теці панелей дерева проекту [[#RootPgSo|концепції об'єктів сигналізації кореневої сторінки "RootPgSo"]], що передбачатиме його динамічний виклик та відкриття, як зовнішнє діалогове вікно.

Ідентифікатор діалогу, при розміщені, має зберігатися та рядок його виклику, за натиском правої клавіші миші, у атрибуті обробки подій "evProc" первинного віджету набуде вигляду "key_mousePresRight::open:/pg_control/pg_cntrPasp".

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

{{CntHdr|Властивості зв'язування та конфігурації}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Конфігурація !! Конфігураційний шаблон !! Опис
|-
| pName || Ім'я параметру || Адреса || Вхідний зв'язок || Parameter|NAME || Адреса до назви параметру для звернення до параметру цілком та вилучення всіх його властивостей.
|}

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

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

{{CntHdr|Використання — розробка}}
Панель не передбачає спеціальної конфігурації користувачем, вона має лише бути розташована у теці панелей дерева проекту [[#RootPgSo|концепції об'єктів сигналізації кореневої сторінки "RootPgSo"]], що передбачатиме її динамічний виклик та відкриття у контейнері панелей управління кореневої сторінки.

Ідентифікатор панелі, при розміщені, має зберігатися та рядок її виклику, за отриманням фокусу, у атрибуті обробки подій "evProc" первинного віджету набуде вигляду "ws_FocusIn::open:/pg_control/pg_grph_panel".

{{CntHdr|Використання — виконання}}
За допомогою панелі користувач має можливість:
* обрати режим відображення графіків діаграми: "Графік", "Спектр частот", "XY";
* обрати час формування діаграми;
* здійснити навігацію за діаграмою на пів або п'ять розмірів області графіку або встановлення часу генерації діаграми у поточний час та час курсору;
* отримати інформацію про час або частоту у поточному положенні курсору;
* обрати розмір (глибину) формування графіку або встановити час початку, також у час курсору;
* обрати архів, що використовується для побудови графіків, з правами доступу "root:ITW";
* керувати вертикальною та горизонтальною шкалою відображення: збільшення та зменшення масштабу, зсуву шкали нагору та додолу, повернення масштабу до початкового значення;
* перемикати режим масштабування шляхом обрамлення вікном, мишею.

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

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

[[file:LibMainEls_doc_panel_uk.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>|time ||
|-
| bTime || Початок документа || ДатаЧас || Повний зв'язок || <page>|bTime ||
|-
| doc || Документ || Рядок || Повний зв'язок || <page>|doc ||
|-
| colspan="6" | ''Архівні документи''
|-
| n || Розмір архіву || Цілий || Вхідний зв'язок || <page>|n ||
|-
| vCur || Курсор відображення || Цілий || Повний зв'язок || <page>|vCur ||
|-
| aCur || Курсор архіву || Цілий || Вхідний зв'язок || <page>|aCur ||
|-
| aSize || Розмір архіву || Цілий || Вхідний зв'язок || <page>|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_uk.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>|event || Використовується для надсилання повідомлення "dlg_Apply" у випадку підтвердження.
|-
| elMess || Елемент: повідомлення || Рядок || Вхідний зв'язок || <page>|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_uk.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>|event || Використовується для надсилання повідомлення "dlg_Apply" у випадку підтвердження.
|-
| elItems || Елемент: перелік елементів || Текст || Вхідний зв'язок || <page>|items || Джерело переліку елементів у діалозі.
|-
| selValue || Елемент: обране значення || Рядок || Повний зв'язок || <page>|selValue || Джерело обраного елементу у діалозі.
|}

Translations:Libs/Main graphical elements/364/en

2026-05-10T04:50:29Z

FuzzyBot: Importing a new version from external source

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

Translations:Libs/Main graphical elements/355/en

2026-05-10T04:50:28Z

FuzzyBot: Importing a new version from external source

XML-Tree of the visual elements allowed to place in the root node, placed visual items in the visual elements and sources with constants in the visual items.
<syntaxhighlight lang="XML">
<vEls>
<el id='Main.anShow' wId="aShw" geom="100-1:40-1"
lnkAttrs='pVal-var'
constAttrs='pName-;pPrec-;pErr-;pDscr-;pModeA-;pModeC-;spName;redEVAL'>
<it id='aShw_1' geom="100:40" pos="0:0">
<src id="LogicLev.gen.prm_F3" />
<const id="pName" isLnk="1" lnk="prm:/LogicLev/gen/F3/NAME (+)">Test</const>
</it>
</el>
<el id="Main.TextLab" wId="txtLb" geom="60-1:22-1"
lnkAttrs="st_open;st_close;st_text;com;close;com_text"
constAttrs="digStts-;digComs-;NAME-;err-;DESCR-">
<it id="txtLb_1" geom="100:22" pos="10:10">
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_open" vAttr="st_open" />
<src id="LogicLev.gen.prm_BC6close" sAttr="a_st_close" vAttr="st_close" />
</it>
</el>
<el id="originals.Text" wId="txt" geom="100:20" preset="color=red;" resize="1"
constAttrs="*text;*alignment;*font;*color;*orient">
<it id="txt_2" geom="100:20" pos="0:50">
<const id="*text" isLnk="0">Text label</const>
<const id="*color" isLnk="0">blue</const>
</it>
</el>
</vEls>
</syntaxhighlight>

Translations:Libs/Main graphical elements/356/en

2026-05-10T04:50:28Z

FuzzyBot: Importing a new version from external source

Where:
* ''id'' — identifier;
* ''wId'' — widget identifier base;
* ''geom'' — typical geometry with scale or for concrete visual item;
* ''lnkAttrs'' — list of the generic attributes through ';' for linking as data source in the form "{vis}[-{src}]":
** ''vis'' — ID of the visual attribute;
** ''src'' — ID of the source attribute, it is the same as visual one at missing;
* ''constAttrs'' — list of the additional attributes through ';' for specifying manually in the form "{vis}[-[{src}]]";
** ''src'' — ID of the source attribute, it is the same as visual one at missing and that is a constant at missing even the symbol ''-'', it is spare here and pointed only for its storing for ''lnkAttrs''.
* ''pos'' — position of the visual item;
* ''isLnk'' — the link sign;
* ''lnk'' — link value for restoring;
* ''sAttr'', ''vAttr'' — source and visual attributes of linking.

Translations:Libs/Main graphical elements/353/en

2026-05-10T04:50:27Z

FuzzyBot: Importing a new version from external source

The frame provides currently and in future for next features:
* specifying sources as fixed or selectable; also as relinking changed sources of the same type and tracing their appearance/disappearance with automatic placing;
* specifying visual items in a XML-Tree with the possibility to configure all interface here or manually from the running interface;
* providing a hiding table of the sources and the dynamically formed control panel for adding/removing visual items per source with control their parameters: position, geometry, constants;
* providing visual items without sources, as constants-static, and setting attributes directly;
* enabling the archiving locally and remotely for DAQGate.

Translations:Libs/Main graphical elements/351/en

2026-05-10T04:50:23Z

FuzzyBot: Importing a new version from external source

<section end=dynFrame />
| [[User:RomanSavochenko|Roman Savochenko]] || -1 ms (parent)
|}
The element-frame, shown in Figure 3.9, serves to form frames in runtime whether by the user or automatically, and it is initially created to represent data of the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|initiative connections]].

Libs/Main/uk

2026-05-10T04:01:08Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Назва !! Версія !! Ліцензія !! Джерело !! Мови !! Автор !! Опис
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main|Основна бібліотека]]
| 2.3 || GPLv2 || OscadaLibs.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql SQL], [[:File:OscadaLibs.db.gz|GZip]]) > DAQ.tmplb_base || en, uk, ru
<section end=info />
| [[User:RomanSavochenko|Роман Савоченко]]
| Бібліотека основних шаблонів опрацювання DAQ-джерел та похідних сервісів.
* '''Засновано:''' Січень 2006
* '''Спонсоровано:''' залежно від елементу ...
* '''Використано:''' [[Special:MyLanguage/Using|більшість проектів на OpenSCADA]]
* '''[[Special:MyLanguage/Works/To_do|Завдання (To Do)]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

Бібліотеку створено для надання основних шаблонів опрацювання DAQ-джерел та похідних сервісів.

Назви шаблонів та їх параметрів доступні на мовах: Англійська, Українська та mRussian. Їх вихідний код написано у мово(людська)-незалежному режимі з викликом функції перекладу ''tr()'' та переклад цих повідомлень також доступний Англійською, Українською та mRussian.

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

Цей завантажений файл ви надалі можете розмістити у теці проекту станції та створити об'єкт бази даних модуля БД "SQLite", зареєструвавши файл бази даних у конфігурації.

Для DAQ-шаблонів загалом Вам треба створити представницький об'єкт пристрою у [[Special:MyLanguage/Modules/LogicLev|модулі Логічного Рівня]] та обрати відповідний шаблон з бібліотеки шаблонів. Далі, для коректної конфігурації, дотримуйтесь специфіки шаблону у особистому описі.

== Шаблони стандартних структур DAQ-параметрів ==
{| class="wikitable"
<section begin=anUnif />
| {{Anch|anUnif|<h3>Аналоговий сигнал, уніфікований ([[Special:MyLanguage/Libs/Main#anUnif|anUnif]])</h3>}}
| 2.4 || GPLv2 || * || en, uk, ru <section end=anUnif />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainAnUnifOp_uk.png|right|Результат та оперативні налаштування.]]
Загальний, представницький та уніфікований шаблон обробки аналогових вхідних сигналів. Шаблон формує структуру аналогового параметру (складного тегу) який може бути легко підключений до більшості віджетів та кадрів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]] просто вказавши об'єкт параметру.

Представницькою структурою аналогового параметру (складного тегу) є:
* "Змінна ('''var''')" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
* "Помилка ('''err''')" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
** '''1, 2''' — помилки обладнання, коли дані переважно помилкові;
** '''3, 4''' — помилки аварійної границі;
** '''5, 6''' — помилки попереджувальної границі;
** '''7''' — помилка швидкості зміни змінної.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.
* "Шкала: мінімум ('''min''')" та "Шкала: максимум ('''max''')" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
* "Логарифмічна шкала ('''log''')" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
* "Одиниця виміру ('''ed''')" — одиниця виміру змінної.
* "Точність ('''prec''')" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow|Відображення аналогового]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|Відображення аналогового 1]]; [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1s|Відображення аналогового 1, короткий]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Елемент групи графіків]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewCadr|Кадр групи огляду]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraphEl|Кадр зведених графіків]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Паспорт, розширений]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Бібліотека елементів мнемосхем інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#Level|Рівень]]
* [[Special:MyLanguage/Libs/Documents|Бібліотека звітів та документів]]:
** [[Special:MyLanguage/Libs/Documents#docRepInstVals|Звіт миттєвих значень]]
** [[Special:MyLanguage/Libs/Documents#docRepDay|Добовий звіт середніх за годину значень]]
** [[Special:MyLanguage/Libs/Documents#docRepMonth|Місячний звіт середніх за добу значень]]
** [[Special:MyLanguage/Libs/Documents#docRepYear|Річний звіт місячних значень]]
** [[Special:MyLanguage/Libs/Documents#docRep2WorkSh|Звіт двох робочих змін]]

* '''Спонсорування, розширення загального поля "DESCR" використанням для специфічних параметрів порушеньна на 0.1 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' INSERTEC LTDA

{{CntHdr|Функції}}
* Загальне опрацювання аналогового входу щодо:
:* проста корекція-калібрування за формулою "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* масштабування від апаратної границі ['''plcMin'''...'''plcMax'''] у головну границю ['''min'''...'''max'''], враховуючи квадратичну шкалу '''scSqr''';
:: [[File:at.png]] Апаратні границі може бути інвертовано та взагалі вимкнено однаковими значеннями максимуму та мінімуму, коли використовується тільки головна шкала.
:* дозвіл на перевищення границі вхідним значенням на величину '''plcExcess''' відсотків;
:* фільтрування зміни вхідного значення на час '''Tf'''.
* Проста імітація аналогового входу, встановленням '''plcImit''' та підключенням джерела імітації-симуляції до '''plcImitIn'''.
:: [[File:at.png]] Відсутність зв'язка '''plcImitIn''' (EVAL) призводить до генерації випадкового аналогового входу
* Складна передобробка та повна генерація-імітація аналогового входу на внутрішній мові програмування OpenSCADA у конфігураційному ВВ '''inProc''' (із доповненням вбудованими правилами підсвітлення синтаксису), де ви можете оперувати наступними сервісними параметрами:
:* ''in'' [IN|OUT] — той самий сирий аналоговий ВВ;
:* ''var'' [IN] — ВВ кінцевої змінної;
:* ''min'', ''max'' [IN] — ВВ головної шкали;
:* ''plcMin'', ''plcMax'' [IN] — ВВ апаратної шкали;
:* ''plcImit'', ''plcImitIn'' [IN] — ВВ простої імітації;
:* ''levErr'', ''tErr'' [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
:* ''f_frq'' [IN] — частота обчислення, шаблонний ВВ;
:* ''this'' [IN] — посилання на об'єкт параметру, що виконує шаблон;
:* ''ctx'' [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику;
:* ''args'' [IN] — об'єкт аргументів процедури;
:* ''toSave'' [OUT] — примусово зберігати об'єкт параметру при виході.
* Проста підстановка значення '''subVar''' за помилкою (недостовірністю) вхідної змінної (EVAL) у режимах: "немає", "останнє" та "підстановка".
* Опрацювання кінцевої змінної '''var''' на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут '''err'''. Границі аварії можуть мати деякий гістерезис '''HystBnd''', можуть бути затримані на час '''alDelay''' та можуть бути придушені встановленням '''alSup'''. Надаються наступні границі та критерії:
:* відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
:* перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
:* перевищення аварійної границі кінцевою змінною ['''aMin'''...'''aMax'''] — код помилки 3,4 та рівень аварії 4;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* перевищення попереджувальної границі кінцевою змінною ['''wMin'''...'''wMax'''] — код помилки 5,6 та рівень аварії 2;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* велика швидкість зміни '''speed''' кінцевої змінної — код помилки 7 та рівень аварії 2.
* Перевизначення специфічних параметрів у загальному атрибуті '''DESCR''':
:* ''перший рядок'' — як опис повідомлень порушень;
:* поле ''CustomFlds'' — визначення [[Special:MyLanguage/Documents/Program_manual#ArchMess|користувацьких полів]] повідомлень порушень у формі "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''";
:* поле ''CustomAlarms'' — перевизначення стандартних рівнів порушень для повідомлень порушень у формі "'''CustomAlarms: {ConErr};{BrdAlarm};{BrdWarn}'''".

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| in || Вхід || Реальний || Вхід || Не атрибут || Зв'язок || Вхід|var
|-
| inProc || Вхідна процедура обробки || Текст || Вхід || Не атрибут || Константа ||
|-
| var || Змінна || Реальний || Вхід || Тільки читання || Змінна || 0
|-
| ed || Одиниця виміру || Рядок || Вхід || Повний доступ || Змінна ||
|-
| min || Шкала: мінімум || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| max || Шкала: максимум || Реальний || Вхід || Повний доступ || Змінна || 100
|-
| scSqr || Шкала: квадратична || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| subMode || Заміна: режим || Вибір цілих чисел || Вхід || Повний доступ || Змінна || 0<br/>
0;1;2<br/>
немає;останнє;підстановка
|-
| subVar || Заміна: змінна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна ||
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| aMin || Границя нижня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| aMax || Границя верхня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMin || Границя нижня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMax || Границя верхня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| HystBnd || Гистерезис порушення границь || Реальний || Вхід || Повний доступ || Змінна || 1
|-
| speed || Швидкість зміни, %/цикл || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| prec || Точність, знаків || Цілий || Вхід || Повний доступ || Змінна || 2
|-
| log || Логарифмічна шкала || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| Tf || Час фільтру, секунд || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| iAdd || Додаток до входу || Реальний || Вхід || Не атрибут || Константа || 0
|-
| iMult || Множник входу || Реальний || Вхід || Не атрибут || Константа || 1
|-
| plcMin || Мінімум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcMax || Максимум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcExcess || Дозволене перевищення шкали, % || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcImit || Імітація ПЛК || Логічний || Вхід || Не атрибут || Константа || 0
|-
| plcImitIn || Вхід імітації ПЛК || Реальний || Вхід || Не атрибут || Зв'язок || Імітація|var
|-
| this || Об'єкт || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainAnUnifCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Вхід'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" сигналу]].
:* ''Вхідна процедура обробки'' — сформувати для складної передобробки та повної генерації-імітації аналогового входу на внутрішній мові програмування OpenSCADA. Є необов'язковою та має визначатися за складних випадків, наприклад:
::* проста та прозора попередня обробка з приведення відсотків навантаження ДБЖ до потужності, що можна виконати і за допомогою '''iMult''':
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
in = 490*in/100; //the UPS has 480W </syntaxhighlight>
::* реалізація лічильника вхідного сигналу — спожитої електрики ДБЖ:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
//Checking for the data validity
if(ctx.cntr.isEVal()) ctx.cntr = this.var.get();
if(!in.isEVal()) {
pUPS = 33;
if(ctx.cntr.isEVal()) ctx.cntr = (pUPS+in)/(3600*f_frq);
else ctx.cntr += (pUPS+in)/(3600*f_frq);
}

//Checking for the next month reset
month = 0; SYS.localtime(SYS.time(), 0, 0, 0, 0, month);
if(!ctx.month.isEVal() && month != ctx.month) ctx.cntr = 0;
ctx.month = month;

in = ctx.cntr; </syntaxhighlight>
::* генерації розширених порушень — обробка зовнішніх сигналів, пов'язаних з джерелом:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(SYS.DAQ.JavaLikeCalc.lib_aviary.sensorError(gO.prm_generic.PRG_Input_Err_T_room_S.get(),levErr,tErr));
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_max.get()).isEVal() && tVl)
levErr = -4, tErr = "11:above the set limit";
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_min.get()).isEVal() && tVl)
levErr = -4, tErr = "11:below the set limit"; </syntaxhighlight>
:* ''Мінімум та максимум шкали модуля'' — має вказуватися у випадку значного розходження апаратної шкали із загальною, наприклад:
::* вхід сирий та вимірюється значенням струму [4...20]мА, тобто тут треба вказати 4 та 20 мА;
::* попередній випадок де треба просто та прозоро відкалібрувати покази — зразковим приладом задаємо 4мА та 20мА та вказуємо тут реальні виміряні значення "сирого" сигналу.
:* ''Додаток та множник до входу'' — використати для простої лінійної корекції входу, наприклад:
::* калібрування показів, що менш прозоро та ці коефіцієнти мають вираховуватися за формулами:
::: '''iAdd = ((plcMin*precMeasMax)/plcMax - precMeasMin)*(plcMax/(plcMax-plcMin))'''
::: '''iMult = (plcMax - plcMin) / (precMeasMax - precMeasMin)'''
:* ''Дозволене перевищення шкали'' — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.
:* ''Імітація та вхід імітації ПЛК'' — визначити за потреби імітації входу згідно опису у функціях.
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.
:5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативне налаштування та контроль щодо:
:* ''Шкала: мінімум та максимум'' — суворо [[file:at.png]] встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене! За відсутності апаратної границі ця, основна границя, є довільною та дорадчою, хоча вихід значення за неї також супроводжується порушенням.
:* ''Шкала: квадратична'' — встановити якщо апаратна шкала квадратична.
:* ''Час фільтру'' — встановити у час фільтрації для зашумлених сигналів.
:* ''Заміна: режим та змінна'' — встановити у потрібний режим підстановки-заміни значення за недостовірною змінною.
:* ''Придушення порушень'' — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
:* ''Затримка порушень'' — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
:* ''Границя верхня/нижня аварійна/попереджувальна'' — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
:* ''Гистерезис порушення границь'' — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
:* ''Швидкість зміни'' — встановити якщо треба попереджати про швидку зміну значення.
:* ''Назва, Опис, Одиниця виміру, Точність, Логарифмічна шкала'' — встановити за потреби такої інформації при відображені, або як елементи паспорту.

{| class="wikitable"
<section begin=anUnifSt />
| {{Anch|anUnifSt|<h3>Аналоговий сигнал, уніфікований, стани порушень ([[Special:MyLanguage/Libs/Main#anUnifSt|anUnifSt]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=anUnifSt />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Загальний, представницький та уніфікований шаблон обробки аналогових вхідних сигналів, розширений бінарними станами індикації порушень. Шаблон засновано на базовому шаблоні "[[#anUnif|Аналоговий сигнал, уніфікований]]" з відповідною до нього представницькою структурою та деякими відмінностями, характерними до незалежного розвитку та розширення.

Бінарні стани передбачалося для зручного використання у алгоритмах роботи за границями порушення об'єкту параметру, переважно у [[Special:MyLanguage/Modules/BlockCalc|блокових схемах]] загальних алгоритмів керування.

{{CntHdr|Функції}}
Переважно відповідають базовому шаблону "[[#anUnif|Аналоговий сигнал, уніфікований]]" та додатково надаються ознаки порушень границь: "H", "L", "HH", "LL", "EVAL".

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| colspan="7" | ВВ шаблону "[[#anUnif|Аналоговий сигнал, уніфікований]]"
|-
| H || Порушення верхньої попереджув. границі || Логічний || Вихід || Тільки читання || Змінна ||
|-
| L || Порушення нижньої попереджув. границі || Логічний || Вихід || Тільки читання || Змінна ||
|-
| HH || Порушення верхньої аварійної границі || Логічний || Вихід || Тільки читання || Змінна ||
|-
| LL || Порушення нижньої аварійної границі || Логічний ||Вихід || Тільки читання || Змінна ||
|-
| EVAL || Помилка значення || Логічний || Вихід || Тільки читання || Змінна ||
|}

{{CntHdr|Конфігурація та використання}}
Повністю ідентичне базовому "[[#anUnif|Аналоговий сигнал, уніфікований]]" за відмінністю використання ознак порушень границь: "H", "L", "HH", "LL", "EVAL"; на які можна під'єднуватися із зовнішніх обчислень.

{| class="wikitable"
<section begin=manInUnif />
| {{Anch|manInUnif|<h3>Ручний ввід, уніфікований ([[Special:MyLanguage/Libs/Main#manInUnif|manInUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=manInUnif />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainManInUnifOp_uk.png|right|Результат та оперативні налаштування.]]
Загальний, представницький та уніфікований шаблон ручного вводу та сигналу аналогового виходу. Шаблон формує структуру параметру (складного тегу) ручного вводу, який може бути легко підключений до більшості віджетів та кадрів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]] просто вказавши об'єкт параметру, контроль переважно можна здійснювати через панель контролю [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]].

Представницькою структурою параметру (складного тегу) ручного вводу є:
* "Змінна ('''var''')" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
* "Введення змінної ('''varIn''')" — атрибут введення нового інженерного значення, який надалі потрапляє до змінної.
* "Помилка ('''err''')" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
** '''1, 2''' — помилки обладнання, коли дані переважно помилкові;
** '''3, 4''' — помилки аварійної границі;
** '''5, 6''' — помилки попереджувальної границі;
** '''7''' — помилка швидкості зміни змінної.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.
* "Шкала: мінімум ('''min''')" та "Шкала: максимум ('''max''')" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
* "Логарифмічна шкала ('''log''')" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
* "Одиниця виміру ('''ed''')" — одиниця виміру змінної.
* "Точність ('''prec''')" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]]

{{CntHdr|Функції}}
* Загальне опрацювання аналогового входу щодо:
:* проста корекція-калібрування за формулою "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* масштабування від апаратної границі ['''plcMin'''...'''plcMax'''] у головну границю ['''min'''...'''max'''], враховуючи квадратичну шкалу '''scSqr''';
:: [[File:at.png]] Апаратні границі може бути інвертовано та взагалі вимкнено однаковими значеннями максимуму та мінімуму, коли використовується тільки головна шкала.
:* дозвіл на перевищення границі вхідним значенням на величину '''plcExcess''' відсотків;
:* фільтрування зміни вхідного значення на час '''Tf'''.
* Опрацювання кінцевої змінної '''var''' на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут '''err'''. Границі аварії можуть мати деякий гістерезис '''HystBnd''', можуть бути затримані на час '''alDelay''' та можуть бути придушені встановленням '''alSup'''. Надаються наступні границі та критерії:
:* відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
:* перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
:* перевищення аварійної границі кінцевою змінною ['''aMin'''...'''aMax'''] — код помилки 3,4 та рівень аварії 4;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* перевищення попереджувальної границі кінцевою змінною ['''wMin'''...'''wMax'''] — код помилки 5,6 та рівень аварії 2;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* велика швидкість зміни '''speed''' кінцевої змінної — код помилки 7 та рівень аварії 2.
* Зворотне перетворення введеного інженерного значення змінної та запис у вихід.
: [[File:at.png]] За відсутності підключення "Входу/Виходу" запису не здійснюється та відбувається автономна робота.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| inout || Вхід/Вихід || Реальний || Вихід || Не атрибут || Зв'язок || Parameter|var
|-
| var || Змінна || Реальний || Вхід || Тільки читання || Змінна || 0
|-
| varIn || Введення змінної || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| ed || Одиниця виміру || Рядок || Вхід || Повний доступ || Змінна ||
|-
| min || Шкала: мінімум || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| max || Шкала: максимум || Реальний || Вхід || Повний доступ || Змінна || 100
|-
| scSqr || Шкала: квадратична || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| alDelay || Затримка порушень, секунди || Логічний || Вхід || Повний доступ || Змінна ||
|-
| aMin || Границя нижня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| aMax || Границя верхня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMin || Границя нижня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMax || Границя верхня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| HystBnd || Гистерезис порушення границь || Реальний || Вхід || Повний доступ || Змінна || 1
|-
| speed || Швидкість зміни, %/цикл || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| prec || Точність, знаків || Цілий || Вхід || Повний доступ || Змінна || 2
|-
| log || Логарифмічна шкала || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| Tf || Час фільтру, секунд || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| iAdd || Додаток до входу || Реальний || Вхід || Не атрибут || Константа || 0
|-
| iMult || Множник входу || Реальний || Вхід || Не атрибут || Константа || 1
|-
| plcMin || Мінімум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcMax || Максимум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcExcess || Дозволене перевищення шкали, % || Реальний || Вхід || Не атрибут || Константа || 0
|-
| this || Об'єкт || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainManInUnifCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Вхід/Вихід'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" сигналу ВВ]], або не прив'язувати для автономного режиму.
:* ''Мінімум та максимум шкали модуля'' — має вказуватися у випадку значного розходження апаратної шкали із загальною, для прикладу дивіться шаблон "[[#anUnif|Аналоговий сигнал, уніфікований]]".
:* ''Додаток та множник до входу'' — використати для простої лінійної корекції входу, для прикладу дивіться шаблон "[[#anUnif|Аналоговий сигнал, уніфікований]]".
:* ''Дозволене перевищення шкали'' — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий; та він буде доступний до встановлення нових значень.
:5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативне налаштування та контроль щодо:
:* ''Шкала: мінімум та максимум'' — суворо [[file:at.png]] встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене! За відсутності апаратної границі ця, основна границя, є довільною та дорадчою, хоча вихід значення за неї також супроводжується порушенням.
:* ''Шкала: квадратична'' — встановити якщо апаратна шкала квадратична.
:* ''Час фільтру'' — встановити у час фільтрації для зашумлених сигналів.
:* ''Придушення порушень'' — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
:* ''Затримка порушень'' — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
:* ''Границя верхня/нижня аварійна/попереджувальна'' — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
:* ''Гистерезис порушення границь'' — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
:* ''Швидкість зміни'' — встановити якщо треба попереджати про швидку зміну значення.
:* ''Назва, Опис, Одиниця виміру, Точність (знаків), Логарифмічна шкала'' — встановити за потреби такої інформації при відображені, або як елементи паспорту.

{| class="wikitable"
<section begin=digitBlockUnif />
| {{Anch|digitBlockUnif|<h3>Дискретний блок, уніфікований ([[Special:MyLanguage/Libs/Main#digitBlockUnif|digitBlockUnif]])</h3>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=digitBlockUnif />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainDigitBlockUnifOp_uk.png|right|Результат та оперативні налаштування.]]
Загальний, представницький та уніфікований шаблон блоку поєднання дискретних параметрів у пристрій загального контролю. Шаблон формує структуру дискретного параметру-блоку (складного тегу) який може бути легко підключений до більшості віджетів та кадрів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]] просто вказавши об'єкт параметру.

Представницькою структурою дискретного параметру (складного тегу) є об'єкт засувки із характерними двома станами та трьома командами, які у кінцевому представленні можуть мати інше значення та назву:
* "Стан "Відкрито" ('''st_open''')" — стан засувки "Відкрито". Є первинним сигналом стану, який може використовуватися без наступного, коли '''1 (true)''' — "Відкрито", а '''0 (false)''' — "Закрито".
* "Стан "Закрито" ('''st_close''')" — стан засувки "Відкрито".
* "Команда "Відкрити" ('''com''')" — команда засувки "Відкрити". Є первинним сигналом команди, який може використовуватися без наступного, коли '''1 (true)''' — "Відкрити", а '''0 (false)''' — "Закрити".
* "Команда "Закрити" ('''close''')" — команда засувки "Закрити".
* "Команда "Зупинити" ('''stop''')" — команда засувки "Зупинити".

Значні графічні образи представлення структури:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Текстова мітка]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Мітка зображенням]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Елемент групи графіків]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Паспорт, розширений]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Бібліотека елементів мнемосхем інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#El_Alarm|Сигналізація]]
** [[Special:MyLanguage/Libs/Mnemo_elements#discrApps|Дискретні апарати]]
* [[Special:MyLanguage/Libs/Electrical_elements|Бібліотека електричних елементів користувацького інтерфейсу]]:
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Ключ, уніфікований]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Перемикач, уніфікований]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Загальний стан, уніфікований]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Стан області, уніфікований]]

{{CntHdr|Функції}}
* Пряме отримання, за посиланням, двох станів (тільки читання) та трьох команд (читання та запис).
* Можливість утримання команди протягом визначеного часу та зняття їх.
* Можливість перевизначення станів та команд [[Special:MyLanguage/Libs/Main_graphical_elements|відповідним налаштуванням елементів інтерфейсу]], як то ''digStts'', для статусів, та ''digComs'', для команд.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| com || Команда "Відкрити" || Логічний || Вихід || Повний доступ || Зв'язок || Кран|com
|-
| close || Команда "Закрити" || Логічний || Вихід || Повний доступ || Зв'язок || Кран|close
|-
| stop || Команда "Зупинити" || Логічний || Вихід || Повний доступ || Зв'язок || Кран|stop
|-
| st_open || Стан "Відкрито" || Логічний || Вхід || Тільки читання || Зв'язок || Кран|st_open
|-
| st_close || Стан "Закрито" || Логічний || Вхід || Тільки читання || Зв'язок || Кран|st_close
|-
| tCmd || Час утримання команди, секунди || Цілий || Вхід || Не атрибут || Константа || 5
|-
| last_cmd || Остання команда || Цілий || Вихід || Не атрибут || Змінна || 0
|-
| w_tm || Лічильник обробки команди || Реальний || Вихід || Не атрибут || Змінна || 0
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainDigitBlockUnifCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* Всі стани та команди — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" сигналу]].
:* ''Час утримання команди, секунди'' — встановити у потрібне значення утримання або у 0 для вимкнення цієї функції.
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: станів та команд.
:5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативний контроль, видачею команд.

{| class="wikitable"
<section begin=digAlarm />
| {{Anch|digAlarm|<h3>Сигналізація дискретна ([[Special:MyLanguage/Libs/Main#digAlarm|digAlarm]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=digAlarm />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainDigAlarmOp_uk.png|right|Результат та оперативні налаштування.]]
Загальний, представницький шаблон обробки окремого дискретного параметру (складного тегу) із формування сигналізації за визначеним критерієм. Шаблон формує структуру дискретного параметру (складного тегу) який може бути легко підключений до більшості віджетів та кадрів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]] просто вказавши об'єкт параметру.

Шаблон надає окремі поля [[#digitBlockUnif|представницької структури дискретного параметру]] та додає поле помилки:
* "Стан "Відкрито" ('''st_open''')" — стан "Відкрито".
* "Стан "Закрито" ('''st_close''')" — стан "Відкрито".
* "Помилка ('''err''')" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "1:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
** '''1''' — помилки обладнання, коли дані переважно помилкові;
** '''3''' — порушення за визначеної умови.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.

{{CntHdr|Функції}}
* Пряме отримання, за посиланням, первинного стану та формування двох репрезентативних станів з можливістю їх інверсії '''stInv'''.
* Складна передобробка та повна генерація-імітація дискретного входу на внутрішній мові програмування OpenSCADA у конфігураційному ВВ '''inProc''' (із доповненням вбудованими правилами підсвітлення синтаксису), де ви можете оперувати наступними сервісними параметрами:
:* ''in'' [IN|OUT] — той самий сирий дискретний ВВ;
:* ''levErr'', ''tErr'' [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
:* ''f_frq'' [IN] — частота обчислення, шаблонний ВВ;
:* ''this'' [IN] — посилання на об'єкт параметру, що виконує шаблон;
:* ''ctx'' [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику;
:* ''args'' [IN] — об'єкт аргументів процедури.
* Опрацювання дискретного входу '''in''' на предмет формування порушення та відповідного встановлення атрибуту '''err''', за умови "'''{st}:{lev}:{mess}'''", тобто генерація порушення з рівнем ''lev'' та текстом ''mess'' за стану входу ''st'' (0|1). Що може бути затримано на час '''alDelay''' та придушено встановленням '''alSup'''.
* Перевизначення специфічних параметрів у загальному атрибуті '''DESCR''':
:* ''перший рядок'' — як опис повідомлень порушень;
:* поле ''CustomFlds'' — визначення [[Special:MyLanguage/Documents/Program_manual#ArchMess|користувацьких полів]] повідомлень порушень у формі "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''".

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| alrm || Сигнал "{st}:{lev}:{mess}" || Рядок || Вхід || Не атрибут || Константа ||
|-
| stInv || Інверсія стану || Логічний || Вхід || Не атрибут || Константа ||
|-
| in || Вхід || Логічний || Вхід || Тільки читання || Зв'язок || Input|in
|-
| inProc || Вхідна процедура обробки || Текст || Вхід || Не атрибут ||Константа ||
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна ||
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| st_open || Стан "Відкрито" || Логічний || Вхід || Тільки читання ||Змінна ||
|-
| st_close || Стан "Закрито" || Логічний || Вхід || Тільки читання ||Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| this || Об'єкт || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainDigAlarmCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* "Сигнал "{st}:{lev}:{mess}" — визначити критерій формування порушення, залишити порожнім для вимкнення генерації порушень.
:* "Інверсія стану" — встановити для інвертування репрезентативних атрибутів, тобто "st_open" встановити за "in" рівного '''false'''.
:* "Вхід" — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" сигналу]].
:* ''Вхідна процедура обробки'' — сформувати для складної передобробки та повної генерації-імітації дискретного входу на внутрішній мові програмування OpenSCADA. Наприклад:
::* повне створення складного статусу:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
status = gO.prm_generic.PRG_Input_Err_T_Zone1_S.get();
in = gO.prm_generic.SET_CalcFan_UseSensor_T1.get() || !(status == 0 || status == 2 || status == 3); </syntaxhighlight>
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.

{| class="wikitable"
<section begin=codeState />
| {{Anch|codeState|<h3>Стан за кодом ([[Special:MyLanguage/Libs/Main#codeState|codeState]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru <section end=codeState />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainCodeStateOp_uk.png|right|Результат та оперативні налаштування.]]
Варіант [[#digitBlockUnif|загального, представницького та уніфікованого шаблону блоку поєднання дискретних параметрів]], розширений більш ніж двома станами та трьома командами які можна закодувати цілим значенням. Шаблон формує структуру параметру (складного тегу) стану за кодом який може бути легко підключений до більшості віджетів та кадрів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]] просто вказавши об'єкт параметру.

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

Представницькою структурою параметру (складного тегу) стану за кодом є:
* "Стан "Текст" ('''st_text''')" — текстовий опис стану.
* "Команда "Текст" ('''com_text''')" — текст команди.
* "Команди ('''digComs''')" — загальний перелік можливих команд, для формування обрання.
* "Помилка ('''err''')" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "1:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
** '''1''' — помилки обладнання, коли дані переважно помилкові.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.

Значні графічні образи представлення структури:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Текстова мітка]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Мітка зображенням]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]]

{{CntHdr|Функції}}
* Пряме отримання, за посиланням, коду стану та команди (тільки читання), а також встановлення тексту стану згідно до переліку станів ''stats''.
* Опрацювання тексту команди ''com_text'' на предмет пошуку її у загальному переліку команд ''coms'' та видача отриманого коду команди на вихід.
* Формування із загальному переліку команд ''coms'' переліку команд для обрання у ''digComs''.
* Складна обробка та повна генерація-імітація коду стану, а також обробка коду або тексту команди для цільових дій, на внутрішній мові програмування OpenSCADA у конфігураційному ВВ '''inProc''', де ви можете оперувати наступними сервісними параметрами:
:* ''in'' [IN|OUT] — ВВ коду статусу;
:* ''text'' [OUT] — пряме встановлення тексту статусу;
:* ''coms'' [IN] — перелік наявних команд, відповідного ВВ;
:* ''com_text'' [IN|OUT] — текст отриманої команди;
:* ''levErr'', ''tErr'' [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
:* ''f_frq'' [IN] — частота обчислення, шаблонний ВВ;
:* ''this'' [IN] — посилання на об'єкт параметру, що виконує шаблон;
:* ''ctx'' [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику;
:* ''args'' [IN] — об'єкт аргументів процедури.
* Формування порушення та відповідне встановлення атрибуту '''err''', за умови встановлення у процедурі обробки або відсутності зв'язку (''in'' = EVAL). Що може бути затримано на час '''alDelay''' та придушено встановленням '''alSup'''.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| in || Вхід || Цілий || Вхід || Тільки читання || Зв'язок || Signal|in
|-
| out || Вихід || Цілий || Вихід || Тільки читання || Зв'язок || Signal|out
|-
| inProc || Вхідна процедура обробки || Текст || Вхід || Не атрибут ||Константа ||
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна ||
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| st_text || Стан "Текст" || Рядок || Вхід || Тільки читання || Змінна ||
|-
| stats || Стани, рядки "{code}:{State}" || Текст || Вхід || Повний доступ || Змінна ||
|-
| com_text || Команда "Текст" || Рядок || Вхід || Повний доступ ||Змінна ||
|-
| coms || Команди-стани, рядки "{code}:{State}" || Текст || Вхід || Повний доступ || Змінна ||
|-
| digComs || Команди || Текст || Вхід || Тільки читання || Змінна ||
|-
| SHIFR || Код || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| this || Об'єкт || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainCodeStateCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Вхід'' та ''Вихід'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" сигналу]].
:* ''Вхідна процедура обробки'' — сформувати для обробки та повної генерації-імітації входу, та видачі специфічного виходу, на внутрішній мові програмування OpenSCADA. Наприклад:
::* повне створення коду статусу та формування порушення:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get().isEVal()) in = 4;
else {
if(!(tVl=gO.prm_fansControl.PRG_CntrFan_Alarm_ThermalRelay.get()).isEVal() && tVl)
levErr = -4, tErr = "11:alarm";
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get())
in = gO.prm_fansControl.PRG_CntrFan_On_G1.get() ? 1 : 2;
else in = 3;
} </syntaxhighlight>
::* формування тексту часу годинника та виклик синхронізації часу — пряме встановлення тексту статусу та виконання специфічних команд:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
curTm = SYS.time();
text = SYS.strftime(curTm, "%H։%M %d.%m.%Y");
gO = this.cntr().prm_grps;
if(!(tVl=gO.prm_other.PRG_RTC_UNIX.get()).isEVal()) {
text += " ("+(tVl-curTm).toString(10,0,true)+")";
}

if(com_text.length && !com_text.isEVal() && (tVl=coms.match("^([^:]+):"+com_text,"m")).length && tVl[1] == 1) {
gO.prm_other.SET_RTC_New_UNIX.set(curTm);
gO.prm_other.KEY_RTC_set_time.set(true);
} </syntaxhighlight>
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: входу, виходу, стану за кодом-входом, стану помилки; та генерацію порушень, якщо стан помилки ненульовий.
:5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативне налаштування та контроль щодо:
:* ''Стани'' — встановити у перелік відповідності коду стану до його тексту.
:* ''Команди-стани'' — встановити у перелік відповідності коду стану-команди до його тексту.
:* ''Команда "Текст"'' — встановити у текст команди, яку описано у переліку команд, для перетворення у код та видачі.
:* ''Придушення порушень'' — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
:* ''Затримка порушень'' — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.

{| class="wikitable"
<section begin=pidUnif />
| {{Anch|pidUnif|<h3>ПІД сигнал, уніфікований, стани порушень ([[Special:MyLanguage/Libs/Main#pidUnif|pidUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=pidUnif />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainPidUnifOp_uk.png|right|Результат та оперативні налаштування.]]
Загальний, представницький та уніфікований шаблон інтерфейсу до Пропорційного Інтегрального Диференційного (ПІД) регулятору заснованому на аналоговому вхідному сигналі, розширеному бінарними станами індикації порушень. Шаблон формує структуру аналогового ПІД-регулятору, який може бути легко підключений до деяких кадрів та віджетів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]], просто вказавши об'єкт параметру.

* '''Спонсоровано:''' ТОВ "ДІЯ"

Представницькою структурою аналогового ПІД-регулятору є:
* "Змінна ('''var''')" — кінцева змінна параметру — інженерне реальне значення, доступне та придатне до архівації.
* "Помилка ('''err''')" — обов'язковий атрибут будь якого параметру, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Шаблон резервує наступні коди помилок:
** '''1, 2''' — помилки обладнання, коли дані переважно помилкові;
** '''3, 4''' — помилки аварійної границі;
** '''5, 6''' — помилки попереджувальної границі;
** '''7''' — помилка швидкості зміни змінної.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.
* "Завдання ('''sp''')" — завдання для досягнення значенням аналоговим сигналом у автоматичному режимі.
* "Ручний ввід ('''manIn''')" — атрибут введення нового значення виходу, яке надалі потрапляє до виходу у ручному режимі.
* "Вихід ('''out''')" — вихід (сигнал контролю) ПІД-регулятору.
* "Режим: автомат ('''auto''')" — режим "Автомат" ПІД-регулятору.
* "Режим: каскад ('''casc''')" — режим "Каскад" ПІД-регулятору.
* "Шкала: мінімум ('''min''')" та "Шкала: максимум ('''max''')" — головна шкала кінцевої змінної, вихід за яку призводить до помилки апаратної границі. Шкала також використовується як шкала відображення тренду змінної на графіках.
* "Логарифмічна шкала ('''log''')" — ознака відображення тренду змінної на графіках у логарифмічній шкалі.
* "Одиниця виміру ('''ed''')" — одиниця виміру змінної.
* "Точність ('''prec''')" — кількість знаків після крапки, для позитивних значень, та точність (знаків загалом), для негативних, для відображення реальної кінцевої змінної на екрані.

Значні графічні образи представлення структури:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Бібліотека основних елементів інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrRegul|Панель налаштування регулятору]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Елемент кадр]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Паспорт, розширений]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Бібліотека елементів мнемосхем інтерфейсу користувача]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#analogApps|Аналогові апарати]]

{{CntHdr|Функції}}
* Загальне опрацювання аналогового входу щодо:
:* проста корекція-калібрування за формулою "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* масштабування від апаратної границі ['''plcMin'''...'''plcMax'''] у головну границю ['''min'''...'''max'''], враховуючи квадратичну шкалу '''scSqr''';
:* дозвіл на перевищення границі вхідним значенням на величину '''plcExcess''' відсотків;
:* фільтрування зміни вхідного значення на час '''Tf'''.
* Проста імітація аналогового входу, встановленням '''plcImit''' та підключенням джерела імітації-симуляції до '''plcImitIn'''.
* Опрацювання кінцевої змінної '''var''' на предмет порушення деяких границь та критеріїв, генеруючи аварії та відповідно встановлюючи атрибут '''err'''. Границі аварії можуть мати деякий гістерезис '''HystBnd''', можуть бути затримані на час '''alDelay''' та можуть бути придушені встановленням '''alSup'''. Надаються наступні границі та критерії:
:* відсутність даних або підключення до джерела за вхідним значенням EVAL — код помилки 1 та рівень аварії 5;
:* перевищення апаратної границі вхідним значенням — код помилки 1,2 та рівень аварії 5;
:* перевищення аварійної границі кінцевою змінною ['''aMin'''...'''aMax'''] — код помилки 3,4 та рівень аварії 4;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* перевищення попереджувальної границі кінцевою змінною ['''wMin'''...'''wMax'''] — код помилки 5,6 та рівень аварії 2;
:: [[File:at.png]] Вимикається встановленням однакових або інверсних значень границі
:* велика швидкість зміни '''speed''' кінцевої змінної — код помилки 7 та рівень аварії 2.
* Передавання специфічної ПІД інформації, контролю та атрибутів коефіцієнтів до та з ПЛК або іншого джерела даних із регулюванням.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| in || Вхід || Реальний || Вхід || Не атрибут || Зв'язок || Signal|in
|-
| sp || Завдання || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|sp
|-
| var || Змінна || Реальний || Вхід || Тільки читання || Змінна || 0
|-
| manIn || Ручний ввід, % || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|manIn
|-
| out || Вихід, % || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|out
|-
| auto || Режим: автомат || Логічний || Вхід || Повний доступ || Зв'язок || ПІД|auto
|-
| casc || Режим: каскад || Логічний || Вхід || Повний доступ || Зв'язок || ПІД|casc
|-
| ed || Одиниця виміру || Рядок || Вхід || Повний доступ || Змінна ||
|-
| min || Шкала: мінімум || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|min
|-
| max || Шкала: максимум || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|max
|-
| scSqr || Шкала: квадратична || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна || 0
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| aMin || Границя нижня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| aMax || Границя верхня аварійна || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMin || Границя нижня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| wMax || Границя верхня попереджув. || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| HystBnd || Гістерезис порушень границь || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| speed || Швидкість зміни, %/цикл || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| prec || Точність, знаків || Цілий || Вхід || Повний доступ || Змінна || 2
|-
| log || Логарифмічна шкала || Логічний || Вхід || Повний доступ ||Змінна || 0
|-
| H || Порушення верхньої попереджув. границі || Логічний || Вихід ||Тільки читання || Змінна || 0
|-
| L || Порушення нижньої попереджув. границі || Логічний || Вихід ||Тільки читання || Змінна || 0
|-
| HH || Порушення верхньої аварійної границі || Логічний || Вихід ||Тільки читання || Змінна || 0
|-
| LL || Порушення нижньої аварійної границі || Логічний || Вихід || Тільки читання || Змінна || 0
|-
| EVAL || Значення невірогідне || Логічний || Вихід || Тільки читання || Змінна || 0
|-
| Tf || Час фільтру, мілісекунд || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| Kp || Kп || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|Kp
|-
| Ti || Tі, мілісекунд || Цілий || Вхід || Повний доступ || Зв'язок ||ПІД|Ti
|-
| Kd || Кп диференціалу || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|Kd
|-
| Td || Tд, мілісекунд || Цілий || Вхід || Повний доступ || Зв'язок || ПІД|Td
|-
| Tzd || T фільтру диференціалу, мілісекунд || Цілий || Вхід || Повний доступ || Зв'язок || ПІД|Tzd
|-
| Zi || Нечутливість, % || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|Zi
|-
| Hup || Верхня границя виходу, % || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|Hup
|-
| Hdwn || Нижня границя виходу, % || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|Hdwn
|-
| K1 || Коефіцієнт входу 1 || Реальний || Вхід || Повний доступ ||Зв'язок || ПІД|K1
|-
| K2 || Коефіцієнт входу 2 || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|K2
|-
| K3 || Коефіцієнт входу 3 || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|K3
|-
| K4 || Коефіцієнт входу 4 || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|K4
|-
| iAdd || Додаток до входу || Реальний || Вхід || Не атрибут || Константа || 0
|-
| iMult || Множник входу || Реальний || Вхід || Не атрибут || Константа || 1
|-
| plcMin || Мінімум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 1
|-
| plcMax || Максимум шкали модуля || Реальний || Вхід || Не атрибут || Константа || 5
|-
| plcExcess || Дозволене перевищення шкали, % || Реальний || Вхід || Не атрибут || Константа || 0
|-
| plcImit || Імітація ПЛК || Логічний || Вхід || Не атрибут || Константа || 0
|-
| plcImitIn || Вхід імітації ПЛК || Реальний || Вхід || Не атрибут || Зв'язок || Імітація|var
|-
| this || Об'єкт || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна ||0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainPidUnifCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Вхід'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом "сирого" аналогового сигналу]].
:* ''Завдання'', ''Ручний ввід'', ''Вихід'', ''Режим: автомат'', ''Режим: каскад'', ''Шкала: мінімум'', ''Шкала: максимум'', ''Kп'', ''Tі'', ''Кп диференціалу'', ''Tд'', ''T фільтру диференціалу, мілісекунд'', ''Нечутливість'', ''Верхня границя виходу'', ''Нижня границя виходу'', ''Коефіцієнт входу 1'', ''Коефіцієнт входу 2'', ''Коефіцієнт входу 3'', ''Коефіцієнт входу 4'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|зв'язати із джерелом ПІД-регулятору]].
:* ''Додаток та множник до входу'' — використати для простої лінійної корекції входу, для прикладу дивіться шаблон "[[#anUnif|Аналоговий сигнал, уніфікований]]".
:* ''Дозволене перевищення шкали'' — встановити за потреби перевищення значенням загальної шкали та коли ця шкала починає виконувати рекомендавчу функцію, скажемо для початкового відображення історії у цій шкалі.
:* ''Імітація та вхід імітації ПЛК'' — визначити за потреби імітації входу згідно опису у функціях.
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати оперативні дані у вкладці "Атрибути", для: змінної, стану помилки; та генерацію порушень, якщо стан помилки ненульовий. Також отримаємо всі ПІД-специфічні атрибути.
:5. У процесі роботи, через вкладку оперативних даних "Атрибути", окрім отримання результату можна здійснювати оперативне налаштування та контроль щодо:
:* ''Шкала: мінімум та максимум'' — суворо [[file:at.png]] встановити у діапазон зміни даних за наявністю та відповідно до апаратної границі, інакше значення буде викривлене!
:* ''Шкала: квадратична'' — встановити якщо апаратна шкала квадратична.
:* ''Час фільтру'' — встановити у час фільтрації для зашумлених сигналів.
:* ''Придушення порушень'' — встановити за потреби повного придушення порушень параметру — вимкнути їх генерацію взагалі.
:* ''Затримка порушень'' — встановити час затримки генерації порушення, для виключення частої генерації, характерної для непевних джерел даних, що відрізняються короткочасною втратою зв'язку.
:* ''Границя верхня/нижня аварійна/попереджувальна'' — встановити коли треба генерувати порушення за виходом за аварійну/попереджувальну границі.
:* ''Гистерезис порушення границь'' — встановити у гістерезис зняття порушення, тобто зняття порушення відбувається на вказаний відсоток пізніше, щоб запобігти частій генерації за коливанням значення біля границі.
:* ''Швидкість зміни'' — встановити якщо треба попереджати про швидку зміну значення.
:* ''Назва, Опис, Одиниця виміру, Точність, Логарифмічна шкала'' — встановити за потреби такої інформації при відображені, або як елементи паспорту.

{| class="wikitable"
<section begin=pidUnifImp />
| {{Anch|pidUnifImp|<h3>Імпульсний ПІД сигнал, уніфікований, стани порушень ([[Special:MyLanguage/Libs/Main#pidUnifImp|pidUnifImp]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=pidUnifImp />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Загальний, представницький та уніфікований шаблон інтерфейсу до Пропорційного Інтегрального Диференційного (ПІД) регулятору заснованому на аналоговому вхідному сигналі але із ШІМ-виходом, розширеному бінарними станами індикації порушень та переважно схоже на шаблон "[[#pidUnif|ПІД сигнал, уніфікований, стани порушень]]". Шаблон формує структуру імпульсного ПІД-регулятору, який може бути легко підключений до деяких кадрів та віджетів [[Special:MyLanguage/Libs/Main_graphical_elements|бібліотеки основних елементів інтерфейсу користувача]], просто вказавши об'єкт параметру.

* '''Спонсоровано:''' ТОВ "ДІЯ"

Представницька структура імпульсних ПІД-регуляторів переважно еквівалентна шаблону "[[#pidUnif|ПІД сигнал, уніфікований, стани порушень]]" та містить низку атрибутів, специфічних до імпульсного виходу та атрибут визначення роботи цього регулятору у аналоговому режимі, тобто цей шаблон є навіть більш узагальнювальним:
* "Імпульсний вихід у гору ('''impQup''')" та "Імпульсний вихід до низу ('''impQdwn''')" — сигнали ШІМ-виходу.
* "Режим: аналоговий ('''analog''')" — ознака роботи регулятору у режимі аналогового виходу.

{{CntHdr|Функції}}
Переважно те саме що у базового шаблону "[[#pidUnif|ПІД сигнал, уніфікований, стани порушень]]" та додатково надаються імпульсно-специфічні атрибути: "Імпульсний вихід у гору", "Імпульсний вихід до низу", "Режим: аналоговий", "T період імпульсів", "Мінімальна довжина імпульсу", "Рейтинг фактор імпульсів".

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| colspan="7" | ВВ шаблону "[[#anUnif|ПІД сигнал, уніфікований, стани порушень]]"
|-
| impQup || Імпульсний вихід у гору || Логічний || Вхід || Тільки читання || Зв'язок || ПІД|impQupTm
|-
| impQdwn || Імпульсний вихід до низу || Логічний || Вхід || Тільки читання || Зв'язок || ПІД|impQdwnTm
|-
| analog || Режим: аналоговий || Логічний || Вхід || Тільки читання || Зв'язок || ПІД|analog
|-
| TImpPer || T період імпульсів, мілісекунд || Цілий || Вхід || Повний доступ || Зв'язок || ПІД|TImpPer
|-
| TImpMin || Мінімальна довжина імпульсу, мілісекунд || Цілий || Вхід || Повний доступ || Зв'язок || ПІД|TImpMin
|-
| KImpRfact || Рейтинг фактор імпульсів || Реальний || Вхід || Повний доступ || Зв'язок || ПІД|KImpRfact
|}

{{CntHdr|Конфігурація та використання}}
Переважно те саме що у базового шаблону "[[#pidUnif|ПІД сигнал, уніфікований, стани порушень]]" із відмінністю використання імпульсо-специфічного виходу: "Імпульсний вихід у гору", "Імпульсний вихід до низу", "Режим: аналоговий", "T період імпульсів", "Мінімальна довжина імпульсу", "Рейтинг фактор імпульсів".

== {{Anch|ComplexObject|Шаблони комплексних об'єктів}} ==
У окремих випадках, коли деякий об'єкт є лише частиною загальної автоматизованої системи та такий що не потребує глибокої деталізації до рівня сигналів та параметрів (складного тегу) довкола них, включно без потреби архівації, їх зручно уніфікувати у одному представницькому об'єкті джерела даних OpenSCADA із відповідним консолідованим представленням та контролем об'єкту, як набору простих атрибутів із елементами сигналізації. Така консолідація часто відбувається довкола спеціалізованих джерел даних, доступ до даних яких зазвичай й реалізуються окремим протоколом обміну, але без уніфікації передачі цих даних на рівень візуалізації та сигналізації за окремим атрибутом об'єкту.

Загалом, представницькою структурою комплексного об'єкту є:
* "Всі елементи ('''items''')" — спільний атрибут об'єктного типу де атрибути фізичного об'єкту прямо описуються атрибутами об'єктного типу у '''items''' та із визначеними описовими атрибутами у кожному:
** ''id'' — ідентифікатор атрибуту;
** ''descr'' — текстовий опис атрибуту;
** ''wr'' — ознака можливості запису до атрибуту або перелік варіантів значень для їх обрання, через символ ';';
** ''alarm'' — код порушення:
*** 0 — відсутність порушення — "НОРМА";
*** 1 — порушення рівня "ПОПЕРЕДЖЕННЯ";
*** 2 — порушення рівня "АВАРІЯ";
** ''val'' — значення атрибуту;
** ''set'' — значення атрибуту для встановлення атрибутів доступних для запису.
* "Помилка ('''err''')" — обов'язковий атрибут загального статусу порушення за об'єктом цілком, що містить комбінацію коду помилки та короткого опису, на кшталт "2:Немає даних або підключення до джерела". Зарезервовано наступні коди помилок:
** '''1''' — порушення рівня "ПОПЕРЕДЖЕННЯ";
** '''2''' — порушення рівня "АВАРІЯ";
** '''3''' — недостовірність або відсутність даних.
* "Придушення ('''alSup''') та затримка ('''alDelay''') порушень" — загальний контроль порушень щодо придушення та затримки.

Узагальнюючи, такий шаблон (прошарок над об'єктом фізичних джерел даних) доцільно створювати над джерелом сирих даних, яке надає ці дані у вигляді атрибутів та без обробки, та цей шаблон відтак здійснює:
* збірку цих атрибутів сирого джерела до '''items''';
* опрацювання властивостей атрибутів;
* перевірку та передачу команд встановлення значень;
* опрацювання умов порушень як за окремими атрибутами так і загалом за об'єктом, разом з яким ці порушення можуть фіксуватися у [[Special:MyLanguage/Documents/Program_manual#ArchMess|таблиці поточних порушень]], зазвичай [[Special:MyLanguage/Documents/User_API#SYS.DAQ|функцією alarmSet()]].

Окрім шаблонів комплексного об'єкту цей механізм загально-об'єктного контролю може реалізовуватися шаблонами реалізації [[Special:MyLanguage/Documents/DAQ#LogicLev|логічного рівня доступу до даних]], як то у [[Special:MyLanguage/Libs/Devices#IEC60870|IEC60870]].

Для представлення даних механізму загально-об'єктного контролю наразі надається відповідний [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|кадр "Властивості об'єкту"]], який надає ці властивості у вигляді таблиці-переліку із підсвіченням порушень та можливістю зміни обраних та редагованих властивостей-рядків.

{| class="wikitable"
<section begin=UPS />
| {{Anch|UPS|<h3>Джерело Безперебійного Живлення ([[Special:MyLanguage/Libs/Main#UPS|UPS]])</h3>}}
| 2.2 || GPLv2 || * || en, uk, ru <section end=UPS />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainUPSOp_uk.png|right|Результат і оперативні налаштування.]]
Об'єднання даних Джерела Безперебійного Живлення у комплексному об'єкті атрибуту "Всі елементи". Шаблон первинно розроблено для використання із модулем джерела даних "[[Special:MyLanguage/Modules/System|Система]]" у частині "ДБЖ" та представлення цих даних [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|кадром "Властивості об'єкту"]], як комплексний об'єкт із властивостями, сигналізацією за окремими границями та записом.

Надалі шаблон розширено прямою реалізацією ДБЖ або Інверторів Потужності підтримка яких відсутня у [https://networkupstools.org/ NUT] (у основі частини "ДБЖ"), і таким першим пристроєм став [https://www.mustpower.com/product/ep2100-pro-series-dc12v-300-1000w/ Must EP2100 PRO]. І для цього тут також додано користувацьке визначення властивостей пристрою для розташування у якості DAQ-Атрибутів із можливістю перевизначення опису.

* '''Спонсоровано:''' ТОВ "ДІЯ"

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| srcAddr || Адреса вихідного об'єкту
* "System.slow.prm_UPS" - для підключення до [[Special:MyLanguage/Modules/System|DAQ.System]] параметру у частині ДБЖ;
* "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30" - для підключення до послідовного порту Must EP2100 PRO.
| Рядок || Вхід || Не атрибут || Константа ||
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ || Змінна ||
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| items || Всі елементи || Об'єкт || Вихід || Повний доступ || Змінна ||
|-
| defs || Визначення елементів
У формі рядків - "{id}:{toAttr}:{descr}"
| Текст || Вихід || Повний доступ || Змінна ||
|-
| bChL || Низький заряд батареї || Реальний || Вхід || Повний доступ || Змінна || 20
|-
| bChLL || Критичний заряд батареї || Реальний || Вхід || Повний доступ || Змінна || 5
|-
| inVL || Низька вхідна напруга || Реальний || Вхід || Повний доступ || Змінна || 210
|-
| inVH || Висока вхідна напруга || Реальний || Вхід || Повний доступ || Змінна || 250
|-
| inFLL || Дуже низька вхідна частота || Реальний || Вхід || Повний доступ || Змінна || 40
|-
| inFL || Низька вхідна частота || Реальний || Вхід || Повний доступ || Змінна || 45
|-
| inFH || Висока вхідна частота || Реальний || Вхід || Повний доступ || Змінна || 55
|-
| inFHH || Дуже висока вхідна частота || Реальний || Вхід || Повний доступ || Змінна || 60
|-
| loadH || Навантаження високе || Реальний || Вхід || Повний доступ || Змінна || 80
|-
| loadHH || Навантаження дуже високе || Реальний || Вхід || Повний доступ || Змінна || 100
|-
| tH || Висока температура || Реальний || Вхід || Повний доступ || Змінна || 50
|-
| tHH || Температура дуже висока || Реальний || Вхід || Повний доступ || Змінна || 70
|-
| hyst || Гістерезис границь, % || Реальний || Вхід || Повний доступ || Змінна || 5
|-
| this || Об'єкт || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainUPSCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Створити об'єкт контролеру джерела у модулі DAQ.System і встановити його ідентифікатор на кшталт "SYSData".
:2. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Створити об'єкт параметру джерела у попередньо створеному об'єкті контролера і встановити його ідентифікатор на кшталт "UPS".
:3. Створити і запустити [[Special:MyLanguage/Modules/LogicLev|Об'єкт Логічного Контролеру]] або використати будь який наявний з потрібними властивостями планування.
:4. Створити [[Special:MyLanguage/Modules/LogicLev|Об'єкт Логічного Параметру]] і обрати цей шаблон для нього. Ввімкнути параметр.
:5. У вкладці "Конфігурація шаблону" Об'єкту Логічного Параметру маєте встановити:
:* ''Адреса вихідного об'єкту''
::* [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] — у адресу об'єкту вихідного параметру ДБЖ (дивіться крок 1), на кшталт "System.SYSData.prm_UPS";
::* [ Must EP2100 PRO ] — у Послідовну адресу підключення пристрою на кшталт "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30".
:6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) і якщо він не запущений, маємо отримати у атрибуті параметру ''Всі елементи (items)'' цей об'єкт з усіма атрибутами і їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті ''Помилка (err)'', стосовно чого можете налаштувати атрибути границь відповідних порушень. Для адаптації до користувача деяких описів елементів і для розташування деяких у DAQ-Атрибутах, можете відредагувати "Визначення елементів (defs)" щодо них. Зі створених DAQ-Атрибутів можете також контролювати доступні до запису.
:7. У візуальному інтерфейсі розробки модуля [[Special:MyLanguage/Modules/Vision|Vision]] розташуйте кадр "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Властивості об'єкту]]" до будь-якої сторінки і зв'яжіть його із об'єктом цього параметру, створеного на кроці 4.
:8. РЕЗУЛЬТАТ: При виконанні сторінки отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації і можливістю встановлення доступних до запису властивостей.

{| class="wikitable"
<section begin=SNMP />
| {{Anch|SNMP|<h3>Мережеві пристрої за SNMP ([[Special:MyLanguage/Libs/Main#SNMP|SNMP]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=SNMP />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainSNMPOp_uk.png|right|Результат та оперативні налаштування.]]
Об'єднання даних пристрою, доступного за протоколом SNMP, у комплексному об'єкті атрибуту "Всі елементи". Шаблон розроблено для використання із модулем джерела даних "[[Special:MyLanguage/Modules/SNMP|SNMP]]" та представлення цих даних [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|кадром "Властивості об'єкту"]] як комплексний об'єкт із властивостями, сигналізацією за окремими границями та записом. Враховуючи велику специфіку та розмаїття пристроїв доступних за протоколом SNMP, цей шаблон фактично є заготовкою та прикладом створення на його основі шаблону до відповідного пристрою із специфічною до нього обробкою вхідних властивостей, формування порушень та можливістю запису.

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

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| srcAddr || Адреса вихідного об'єкту || Рядок || Вхід || Не атрибут || Константа ||
|-
| manTables || Ручні таблиці || Рядок || Вхід || Не атрибут || Константа ||
|-
| alSup || Придушення порушень || Логічний || Вхід || Повний доступ ||Змінна ||
|-
| alDelay || Затримка порушень, секунди || Реальний || Вхід || Повний доступ || Змінна || 0
|-
| items || Всі елементи || Об'єкт || Вихід || Повний доступ || Змінна ||
|-
| this || Об'єкт || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Ім'я || Рядок (переклад) || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Текст (переклад) || Вхід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|}

[[File:LibsMainSNMPCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити об'єкт контролеру джерела у модулі "[[Special:MyLanguage/Modules/SNMP|SNMP]]" та встановити його Ідентифікатор на кшталт "SYSData".
:2. Створити об'єкт параметру джерела у попередньо створеному об'єкті контролера та встановити його Ідентифікатор на кшталт "DEV".
:3. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:4. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:5. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Адреса вихідного об'єкту'' — у адресу об'єкту параметру вихідного пристрою SNMP (дивіться крок 1), на кшталт "SNMP.SYSData.DEV";
:* ''Ручні таблиці'' — вручну введіть деякі статичні MIB-змінні.
:6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру ''items'' цей об'єкт з усіма атрибутами та їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру ''err'', стосовно чого ви можете налаштувати атрибути границь відповідних порушень.
:7. У візуальному інтерфейсі розробки модуля [[Special:MyLanguage/Modules/Vision|Vision]] розташуйте [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|кадр "Властивості об'єкту"]] до будь-якої сторінки та зв'яжіть його із об'єктом цього параметру, створеного на кроці 4.
:8. РЕЗУЛЬТАТ: При виконанні сторінки ви отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації та можливістю встановлення властивостей доступних до запису.

{| class="wikitable"
<section begin=DiskSMART />
| {{Anch|DiskSMART|<h3>Дисковий SMART ([[Special:MyLanguage/Libs/Main#DiskSMART|DiskSMART]])</h3>}}
| 1.1 || GPLv2 || * || en, uk <section end=DiskSMART />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainDiskSMARTOp_uk.png|right|Результат та оперативні налаштування.]]
Об'єднання даних дискового SMART у комплексному об'єкті атрибуту "Всі елементи". Шаблон розроблено для використання із модулем джерела даних "[[Special:MyLanguage/Modules/System|Система]]" у частині "SMART Диску" та представлення цих даних [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|кадром "Властивості об'єкту"]] як комплексний об'єкт із властивостями і сигналізацією за загальних помилок. Деякі атрибути SMART можуть бути невідомими або помилковими для визначеного диску через їх відсутність у БД дисків, особливо для сучасних SSD, тож шаблоном надається властивість перевизначення назв атрибутів.

* Складна післяобробка і повна генерація-імітація полів SMART із окремими атрибутами на внутрішній мові програмування OpenSCADA у конфігураційному ВВ '''inProc''' (із доповненням вбудованими правилами підсвітлення синтаксису), де ви можете оперувати наступними сервісними параметрами:
:* ''alLev'', ''tErr'' [IN|OUT] — рівень аварії [-79...0] та текст помилки (формат атрибуту "err");
:* ''f_frq'' [IN] — частота обчислення, шаблонний ВВ;
:* ''this'' [IN] — посилання на об'єкт параметру, що виконує шаблон;
:* ''ctx'' [IN] — об'єкт користувацького контексту, що зберігається між циклами виклику;
:* ''args'' [IN] — об'єкт аргументів процедури;
:* ''items'' [IN|OUT] — об'єкт елементів SMART.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| srcAddr || Адреса вихідного об'єкту || Рядок || Вхід || Не атрибут || Константа ||
|-
| inProc || Вхідна процедура обробки || Текст || Вхід || Не атрибут || Константа ||
|-
| items || Всі елементи || Об'єкт || Вихід || Повний доступ || Змінна ||
|-
| defs || Визначення елементів || Текст || Вхід || Повний доступ || Змінна ||
<pre>160:Uncorrectable sectors count when read/write (160)
161:Number of Valid Spare Blocks (161)
162:Uncorrectable Sector Count (162)
163:Number of Initial Invalid Blocks (163)
164:Total Erase Count (164)
165:Block Erase Count (165)
166:Minimum PE Cycles TLC (166)
167:Max Bad Blocks per Die (167)
168:Maximum PE Cycles TLC (168)
168:Max Erase Count of Spec (168)
168:SATA PHY error count (168)
169:Total Bad Blocks (169)
169:Remain Life (169)
170:Grown Bad Blocks (170)
170:Bad Block Count (170)
171:Program Fail Count (171)
172:Erase Fail Count (172)
173:Average PE Cycles TLC (173)
173:Max Erase Count (173)
174:Unexpected Power Loss (174)
184:End-to-End Error (184)
187:Reported Uncorrect (187)
188:Command Timeout (188)
218:CRC Error Count (218)
230:Media Wearout Indicator (230)
231:SSD Life Left (231)
233:NAND GB Written TLC (233)
234:NAND GB Written SLC (234)
241:Host Writes GB (241)
242:Host Reads GiB (242)
244:Temp Throttle Status (244)
245:Flash Write Sector Count (245)
</pre>
|-
| this || Об'єкт || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| SHIFR || Шифр || Рядок || Вхід || Не атрибут || Змінна ||
|-
| NAME || Назва || Рядок || Вхід || Не атрибут || Змінна ||
|-
| DESCR || Опис || Рядок || Вхід || Не атрибут || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|}

[[File:LibsMainDiskSMARTCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити об'єкт контролеру джерела у модулі "[[Special:MyLanguage/Modules/System|Система]]" та встановити його Ідентифікатор на кшталт "SYSData", встановити властивість "Авт. створювати активні джерела даних" у "Всі джерела" і запустити встановленням "Виконується".
:2. Створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:3. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:4. У вкладці "Конфігурація шаблону" об'єкту логічного параметру ви маєте встановити:
:* ''Адреса вихідного об'єкту'' — у адресу об'єкту вихідного параметру диску SMART на кшталт "System.SYSData.DiskSMARTsda".
:* ''Вхідна процедура обробки'' — сформувати для складної передобробки і повної генерації-імітації SMART полів із окремими атрибутами на внутрішній мові програмування OpenSCADA.
:5. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру ''items'' цей об'єкт з усіма атрибутами та їх властивостями. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру ''err''.
:6. У візуальному інтерфейсі розробки модуля [[Special:MyLanguage/Modules/Vision|Vision]] розташуйте кадр "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Властивості об'єкту]]" до будь якої сторінки та зв'яжіть його із об'єктом цього параметру, створеного на кроці 3.
:7. РЕЗУЛЬТАТ: При виконанні сторінки ви отримаєте таблицю з даними об'єкту, повідомленням про порушення у заголовку та об'єкті сигналізації і можливістю перевизначити назви атрибутів SMART.

== Сервіси ==
{| class="wikitable"
<section begin=ntf />
| {{Anch|ntf|<h3>Сповіщувач за SMS, EMail-SMTP ([[Special:MyLanguage/Libs/Main#ntf|ntf]])</h3>}} || 1.0 || GPLv2 || * => [[Special:MyLanguage/Modules/UserProtocol|UserProtocol]] || en, uk, ru <section end=ntf />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainNtfOp_uk.png|right|Результат та оперативні налаштування.]]
Комплексний шаблон сповіщення містить частини диспетчеру та вихідний користувацький протокол сповіщення за EMail(SMTP) та SMS.

* '''Загальна працемісткість:''' > 1.05 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}
* '''Спонсорування, ініціативної імплементації частини SMS-надсилання на 0.2 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' [[Special:MyLanguage/Using/HouseSpirit|Олег Сидашов]]
* '''Спонсорування, уніфікації, додання SMTP та контролеру сповіщення на 0.65 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}:''' ТОВ "СВІТоВИР АВТоМАТИК"

'''ДИСПЕТЧЕР''' може виконуватися для вказаних повідомлень буферу повідомлень OpenSCADA та застосовується на [[Special:MyLanguage/Documents/DAQ#LogicLev|Логічному рівні]] або об'єкті контролеру [[Special:MyLanguage/Modules/JavaLikeCalc|модуля JavaLikeCalc]].

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| io || UserPrt: Вихідний ВВ || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| tr || UserPrt: Транспорт || Об'єкт || Вхід || Не атрибут || Змінна ||
|-
| tmOut || Максимальний таймаут сповіщення, секунд || Цілий || Вхід || Не атрибут || Константа || 5
|-
| messLev || Рівень сповіщень, негативний для порушень || Цілий || Вхід || Не атрибут || Константа || 1
|-
| messCat || Категорія сповіщень, шаблон або регулярний вираз || Рядок || Вхід || Не атрибут || Константа || al*:*
|-
| messCatExcl || Категорія виключення повідомлень, у регулярному виразі || Рядок || Вхід || Не атрибут || Константа ||
|-
| emailState || Поточний стан сповіщення Ел.поштою || Рядок || Вихід || Тільки читання || Змінна ||
|-
| emailTrAddr || Вихідний транспорт SMTP підключень, порожньо для вимкнення || Рядок || Вхід || Не атрибут || Константа || Sockets.out_SMTP
|-
| emailAuth || Автентифікація, порожньо для вимкнення || Рядок || Вхід || Не атрибут || Константа || user:pass
|-
| emailSender || Відправник || Рядок || Вхід || Не атрибут || Константа || noreply@oscada.org
|-
| emailReceiver || Адреса призначення одержувача || Рядок || Вхід || Не атрибут || Константа || test@oscada.org
|-
| emailTopic || Тема Ел.пошти || Рядок || Вхід || Не атрибут || Константа || Повідомлення
|-
| emailMess || Повідомлення Ел.пошти || Рядок || Вхід || Не атрибут || Константа ||
|-
| SMSState || Поточний стан повідомлення SMS || Рядок || Вихід || Тільки читання || Змінна ||
|-
| SMSTrAddr || Послідовний транспорт SMS, порожньо для вимкнення || Рядок || Вхід || Не атрибут || Константа || Serial.out_SMS
|-
| SMSPin || Пін-код SMS, порожньо для вимкнення || Рядок || Вхід || Не атрибут || Константа || 1111
|-
| SMSTel || Адреса одержувача SMS, номер телефону || Рядок || Вхід || Не атрибут || Константа || +380XXXXXXXXX
|-
| SMSTextMd || SMS у текстовому режимі, інакше PDU || Логічний || Вхід || Не атрибут || Константа || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainNtfCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити параметр у об'єкті контролеру [[Special:MyLanguage/Documents/DAQ#LogicLev|Логічного рівня]] або об'єкт контролеру у [[Special:MyLanguage/Modules/JavaLikeCalc|модулі DAQ.JavaLikeCalc]].
:2. Створити вихідний транспорт типу "[[Special:MyLanguage/Modules/Serial|Послідовний]]" та встановити його Ідентифікатор на кшталт "SMS", один транспорт підходить для багатьох одержувачів.
:3. Встановити властиву адресу, тільки для [[Special:MyLanguage/Modules/Serial|Послідовного]] пристрою. Швидкість, формат асинхронних даних та таймаути послідовного порту будуть налаштовані функцією.
:4. Створити вихідний транспорт типу "[[Special:MyLanguage/Modules/Sockets|Сокети]]" або "[[Special:MyLanguage/Modules/SSL|SSL]]" та встановити його Ідентифікатор на кшталт "SMTP", один транспорт підходить для багатьох одержувачів.
:5. Встановити властиву адресу, для Сокетів(25) або SSL(465). Таймаути транспорту будуть налаштовані функцією.
:6. У вкладці "Конфігурація шаблону" ви маєте встановити:
:* Максимальний таймаут сповіщення, секунд.
:* Рівень повідомлень, негативний для порушень.
:* Категорія повідомлень, шаблон або регулярний вираз.
:* Категорія виключення повідомлень, у регулярному виразі
:* Вихідний транспорт SMTP підключень, порожньо для вимкнення.
:* Автентифікація, порожньо для вимкнення.
:* Відправник.
:* Адреса призначення одержувача.
:* Тема Ел.пошти.
:* Повідомлення Ел.пошти.
:* Послідовний транспорт SMS, порожньо для вимкнення.
:* Пін-код SMS, порожньо для вимкнення.
:* Адреса одержувача SMS, номер телефону.
:* SMS у текстовому режимі, інакше PDU.
:7. РЕЗУЛЬТАТ: Надсилання вказаних сповіщень як SMS або EMail(SMTP).

'''"SMS" ЧАСТИНА ВИХІДНОГО КОРИСТУВАЦЬКОГО ПРОТОКОЛУ''' надає операції із SMS за допомогою GSM-модему, підключеного як послідовний пристрій. Наразі підтримується лише відправка SMS сповіщень на номер віддаленого мобільного телефону або GSM-модему. Для надсилання підтримується: вимкнення ЛУНИ, перевірка та встановлення PIN, надсилання у PDU та текстовому режимі.<br/>

{{CntHdr|Структура XML-запиту вихідного користувацького протоколу}}
'''<cmd pin="1111" tel="+380XXXXXXXXX" text="{0|1}" err="1:Error">{SMSText}</cmd>'''
:''cmd'' — команда, наразі наявне лише "send";
:''pin'' — PIN-код для доступу до SIM-карти;
:''tel'' — номер телефону одержувача (віддалений номер телефону або GSM-модем);
:''text{0,1}'' — SMS у текстовому режимі, лише ASCII;
:''SMSText'' — текст повідомлення;
:''err'' — встановлюється у результат запиту.

{{CntHdr|Конфігурація та використання}}
:1. Створити вихідний транспорт типу "[[Special:MyLanguage/Modules/Serial|Послідовний]]" та встановити його Ідентифікатор на кшталт "SMS", один транспорт підходить для багатьох одержувачів.
:2. Встановити властиву адресу. Швидкість, формат асинхронних даних та таймаути послідовного порту будуть налаштовані функцією.
:3. Створити потрібний [[Special:MyLanguage/Modules/UserProtocol|об'єкт користувацького протоколу]] заснованого на шаблонах, із Ідентифікатором на кшталт "SMS".
:4. Розмістити деякі команди запиту безпосередньо у наявній або новій внутрішній процедурі OpenSCADA на кшталт:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send"); req.setAttr("ProtIt","SMS").setAttr("pin","1111").setAttr("tel","+380XXXXXXXXX").setText("Notify message");
SYS.Transport.Serial.out_SMS.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. РЕЗУЛЬТАТ: У змінній ''rez'' ви отримаєте "OK" якщо не виникло жодної помилки та повідомлення вдало надіслано одержувачу.

'''"SMTP" ЧАСТИНА ВИХІДНОГО КОРИСТУВАЦЬКОГО ПРОТОКОЛУ''' надає операції із SMTP-сервером щодо доставки електронної пошти відправленням через TCP-Сокет або SSL. Наразі підтримуються: TCP, SSL, AUTH, кодування теми у UTF-8.<br/>

{{CntHdr|Структура XML-запиту вихідного користувацького протоколу}}
'''<send auth="{user}:{pass}" from="{FromAddr}" to="{ToAddr}" topic="{My Topic}" err="1:Error">{MessageText}</send>'''
:''topic'' — тема повідомлення;
:''from'' — адреса відправника;
:''to'' — адреса призначення отримувача;
:''auth'' — користувач та пароль отримувача;
:''MessageText'' — текст повідомлення;
:''err'' — встановлюється у результат запиту.

{{CntHdr|Конфігурація та використання}}
:1. Створити вихідний транспорт типу "[[Special:MyLanguage/Modules/Sockets|Сокети]]" або "[[Special:MyLanguage/Modules/SSL|SSL]]" та встановити його Ідентифікатор на кшталт "SMTP", один транспорт підходить для багатьох одержувачів.
:2. Встановити властиву адресу, для Сокетів(25) або SSL(465). Таймаути транспорту будуть налаштовані функцією.
:3. Створити потрібний [[Special:MyLanguage/Modules/UserProtocol|об'єкт користувацького протоколу]] заснованого на шаблонах, із Ідентифікатором на кшталт "SMTP".
:4. Розмістити деякі команди запиту безпосередньо у наявній або новій внутрішній процедурі OpenSCADA на кшталт:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send");
req.setAttr("ProtIt","SMTP").setAttr("from","noreply@oscada.org").setAttr("to","oscada@oscada.org").setAttr("topic","My topic").setText("My message");
SYS.Transport.Sockets.out_SMTP.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. РЕЗУЛЬТАТ: У змінній ''rez'' ви отримаєте "OK" якщо не виникло жодної помилки та повідомлення вдало надіслано одержувачу.

{| class="wikitable"
<section begin=initRemCntr />
| {{Anch|initRemCntr|<h3>Контроль віддалених ініціативних підключень ([[Special:MyLanguage/Libs/Main#initRemCntr|initRemCntr]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=initRemCntr />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainInitRemCntrOp_uk.png|right|Результат та оперативні налаштування.]]
Шаблон опрацювання вхідних ініціативних підключень розширює попередній шаблон [[#initConAssociateTrs|опрацювання ініціативних підключень щодо асоційованих вихідних транспортів]] повним представлення даних віддалених хостів OpenSCADA на деякому агрегувальному сервері, чим завершуючи [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|концепцію збору даних у пасивному режимі та ініціативного підключення]].

The template does in whole:
* detecting a new connection from remote host, which has no ID;
* sending an acquaintance direct request to the established connection for getting KEY of the host, when it was already connected early, and for getting information about the host for creating ID of the host;
* setting ID for the connection;
* creating a record in the [[Special:MyLanguage/Documents/Program_manual#Transports|OpenSCADA hosts table]] for the connection and sending all followed requests already through the host;
* creating on the remote host a representative [[Special:MyLanguage/Modules/LogicLev|Logical Controller]];
* creating on the remote host a representative [[Special:MyLanguage/Modules/System|DAQ.System Controller Object]] in the automatic mode, at missing any other there;
* processing the present DAQ.System Controller Objects to link the Logical Level parameters to them and creating some processing logical parameters, with updating for all sources at any reconnection and checking for removing ones without sources already;
* writing the generated key by a line "'''SrcKey: {KEY}'''" to description of the Logical Controller as a sign of finalizing the initialization;
* creating a Controller Object in [[Special:MyLanguage/Modules/DAQGate|DAQ.DAQGate]] with connection to the remote Logical Controller and syncing its per 10 minutes for appending new sources and removing missing ones.

ІД віддаленого хосту формується у вигляді "'''{HostDomain}{StatName}{RandKey}'''" із обмеженням у 20ть символів, де:
* ''HostDomain'' — мережеве ім'я-домен хосту;
* ''StatName'' — ім'я станції проєкту OpenSCADA;
* ''RandKey'' — випадковий ключ у дві шістнадцяткові цифри.

Модель даних представницького Логічного Контролеру може містити як згенеровані посилання із параметрами обробки, так і користувацькі параметри, якщо користувач вирішить опублікцівати додаткові дані. Згенеровані із DAQ.System елементи наразі представляють джерела:
* "CPU", "MEM", "sensors", "Power", "uptime" => посилання у контейнері параметрів "Система (SYS)";
* "fs", "hddstat", "hddsmart" => посилання у контейнері параметрів "Диск (DISK)" із однією обробкою для "hddsmart" за шаблоном [[Special:MyLanguage/Libs/Main#DiskSMART|base.DiskSMART]];
* "netstat" => посилання у контейнері параметрів "Мережа (NET)";
* "ups" => посилання у корені із однією обробкою за шаблоном [[Special:MyLanguage/Libs/Main#UPS|base.UPS]].

Агреговані дані у [[Special:MyLanguage/Modules/DAQGate|DAQ.GAQGate]] можуть бути підняті на гору, або використані у похідних DAQ об'єктах, або прямо на користувацьких кадрах, або у майбутньому на Динамічному Кадрі, який заплановано до реалізації; та без жодних додаткових дій ви отримаєте сповіщення про порушення на хостах.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| inTransport || Вхідний транспорт || Рядок || Вхід || Не атрибут || Константа || Sockets.InitRemCntr
|-
| conTm || Час підключення, мс || Цілий || Вхід || Не атрибут || Константа || 5000
|-
| accessTm || Час доступу, години
Використовується для повтору створення представницьких об'єктів недоступних хостів і для видалення старих підключень.<br/>
Нуль або негативне для вимкнення контролю!
| Цілий || Вхід || Не атрибут || Константа || 24
|-
| cntrUser || Доступ: користувач || Рядок || Вхід || Не атрибут || Константа || root
|-
| cntrPass || Доступ: пароль || Рядок || Вхід || Не атрибут || Константа || openscada
|-
| cntrObj || Об'єкт контролю у DAQ.LogicLev і DAQ.System || Рядок || Вхід || Не атрибут || Константа || RemCntr
|-
| prcTr || Опрацьовані підключення || Текст || Вихід || Тільки читання || Змінна ||
|-
| this || Об'єкт || Об'єкт || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|}

[[File:LibsMainInitRemCntrCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити вхідний транспорт прийняття ініціативних підключень у модулі "[[Special:MyLanguage/Modules/Sockets#InTr|Сокети]]" або "[[Special:MyLanguage/Modules/Sockets#InTr|SSL]]" із назвою на кшталт "Sockets.InitRemCntr".
:2. Для попередньо створеного транспорту встановити потрібну адресу відкриття вхідного сокету і перевести його у режим створення асоційованих вихідних транспортів, залишивши поле протоколу порожнім.
:3. Для цього шаблону створити і запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:4. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] і обрати цей шаблон для нього. Ввімкнути параметр.
:5. У вкладці "Конфігурація шаблону" об'єкту логічного параметру маєте встановити:
:* ''Вхідний транспорт'' — у значення ідентифікатору вхідного транспорту, створеного у пункті 1, на кшталт "Sockets.InitRemCntr";
:* ''Час підключення'' — час підключення до ініціативних хостів після якого закривати підключення;
:* ''Час доступу'' — використовується для повтору створення представницьких об'єктів недоступних хостів і для видалення старих підключень; нуль або негативне для вимкнення контролю;
:* ''Доступ: користувач і пароль'' — користувач і пароль віддаленого хосту із правами створення там Логічного Контролеру і Об'єкту Контролеру DAQ.System, тобто користувач мусить бути включеним до групи "DAQ";
:* ''Об'єкт контролю у DAQ.LogicLev і DAQ.System'' — у ІД контрольованого-створюваного Об'єкту Контролеру на віддаленому хості.
:6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати перевірку визначеного вхідного транспорту на предмет ініціативних підключень і їх ініціалізацію у описаний вище спосіб, та із зауваженням опрацьованих підключень у атрибуті "Опрацьовані підключення".

{| class="wikitable"
<section begin=initConAssociateTrs />
| {{Anch|initConAssociateTrs|<h3>Опрацювання ініціативних підключень щодо асоційованих вихідних транспортів ([[Special:MyLanguage/Libs/Main#initConAssociateTrs|initConAssociateTrs]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=initConAssociateTrs />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainInitConsAssignTrsOp_uk.png|right|Результат та оперативні налаштування.]]
Шаблон служби опрацювання вхідних ініціативних підключень створено для надання останньої ланки реалізації та підтримки [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|концепції збору даних у пасивному режимі та ініціативного підключення]], а саме — контролю асоційованих транспортів створюваних вхідним транспортом за кожного підключення.

[[file:at.png]] Після реалізації цього контролю разом із новою функцією загального-уніфікованого підключення вихідного транспорту [[Special:MyLanguage/Documents/User_API#SYSTransport|outAt()]] цей шаблон став застарілим для джерел адаптованих до використання нового механізму, але ви все ще можете використовувати шаблон для неадаптованих джерел.

Функцію створення вихідних асоційованих транспортів за підключенням на вхідний наразі підтримує лише [[Special:MyLanguage/Modules/Sockets|модуль транспортів "Сокети"]] та для TCP-сокетів.

* '''Загальна працемісткість:''' 0.9 {{CtxDetails|ЛД|людино-днів, 1ЛД — 10 годин}}
* '''Спонсоровано, загальну працемісткість:''' Еліор Турабоєв, ТОВ BLUE STAR GROUP

Контроль асоційованих транспортів передбачає:
* отримання переліку асоційованих транспортів функцією вхідного транспорту ''assignTrsList()'';
* читання із нових транспортів (відкритих) ідентифікаційної інформації яка наразі репрезентує тільки ідентифікатор об'єкту джерела;
** пошук за отриманим ідентифікатором об'єкта джерела та призначення йому адреси цього транспорту;
** реєстрацію у атрибуті об'єктного типу "prcTr".
* перевірка діючих транспортів на предмет їх закриття (від'єднання), щодо чого здійснюється дереєстрація у атрибуті об'єктного типу "prcTr" та встановлення об'єкту джерела порожнього значення; вимкнені вихідні асоціативні транспорти повторно використовуються вхідним за отриманням нового підключення після чого він вмикається.

Шаблон може керувати контейнерами об'єктів джерел даних, побудованих як у вигляді DAQ-об'єктів контролерів, так і параметрів логічного рівня, що репрезентують джерело даних та мають поле визначення адреси транспорту та що загалом визначається конфігураційним полем "srcObjPath" із форматом '''{CntrAddr}:{TrCntrFldAddr}''', де:
* ''CntrAddr'' — адреса контейнеру, наприклад: "ModBus" — для DAQ-об'єктів контролерів, "LogicLev.CntrPLC" — для параметрів логічного рівня;
* ''TrCntrFldAddr'' — адреса поля контролю транспорту у об'єкті джерела, наприклад — "%2fcntr%2fcfg%2fADDR" для "ModBus"; що може бути отримано у конфігураторі за історією наведення на поля контролю у рядку статусу.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| inTransport || Вхідний транспорт || Рядок || Вхід || Не атрибут || Постійна || InitiateCons
|-
| outTrTm || Таймаути вихідних транспортів || Рядок || Вхід || Не атрибут || Постійна || 10:0.1
|-
| srcObjPath || Шлях об'єкту джерела || Рядок || Вхід || Не атрибут || Постійна || ModBus:%2fcntr%2fcfg%2fADDR
|-
| prcTr || Опрацьовані транспорти || Об'єкт || Вихід || Тільки читання || Змінна ||
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|}

[[File:LibsMainInitConsAssignTrsCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Створити вхідний транспорт прийняття ініціативних підключень у [[Special:MyLanguage/Modules/Sockets#InTr|модулі "Сокети"]] із назвою на кшталт "InitiateCons".
:2. Для попередньо створеного транспорту встановити потрібну адресу відкриття вхідного сокету і перевести його у режим створення асоційованих вихідних транспортів, залишивши поле протоколу порожнім.
:3. Передбачити контейнер джерел даних до яких асоціативні транспорти мають під'єднуватися, який може бути або DAQ-модулем (як то "DAQ.ModBus"), або логічним контролером (як то "DAQ.LogicLev.Sources"), чи параметром у ньому (як то "DAQ.LogicLev.PLC.Sources"), із вмістом параметрів логічного рівня, що представляють джерело даних.
:4. Для цього шаблону створити і запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:5. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] і обрати цей шаблон для нього. Ввімкнути параметр.
:6. У вкладці "Конфігурація шаблону" об'єкту логічного параметру маєте встановити:
:* ''Вхідний транспорт'' — у значення ідентифікатору вхідного транспорту, створеного у пункті 1, на кшталт "InitiateCons;
:* ''Таймаути вихідних транспортів'' — збільшити першу цифру для дуже повільних підключень та типове є нормальним для більшості ситуацій;
:* ''Шлях об'єктів джерела'' — встановити згідно до пункту 3, для першої частини, та у шлях до контрольного поля, для другої частини, наприклад, та типово для "ModBus", це — "ModBus:%2fcntr%2fcfg%2fADDR".
:6. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру ''prcTr'' інформацію щодо вдало опрацьованих, а відтак і вдало пов'язаних із транспортом, джерелах даних. У випадку деяких порушень отримаємо відповідну інформацію у атрибуті параметру ''err''. Інформація про відсутність представницького об'єкту для отриманого ідентифікатору поміщається у протоколі порушень.

{| class="wikitable"
<section begin=weather />
| {{Anch|weather|<h3>Погода ([[Special:MyLanguage/Libs/Main#weather|weather]])</h3>}}
| 1.0 || GPLv2 || * || en, uk <section end=weather />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
[[File:LibsMainWeatherOp_uk.png|right|Результат та оперативні налаштування.]]
Шаблон отримання даних погоди з різних погодних служб у Інтернет і первинно лише [https://openweathermap.org/ Open Weather].

Погодні дані діляться на поточні і прогноз із їх розміщенням у відповідних об'єктах, де поточні атрибути розташовуються прямо у корені та прогноз на день (об'єкт "day") і час (об'єкт "time") всередині відповідного дня згідно до поточної часової зони. Ці дані отримуються за відповідним розкладом незалежно для поточних і прогнозу, та типово поточні запитуються щогодинно, а прогноз один раз на день. Дані можуть бути доступні користувачу як прямо, так і посередництвом спеціально-створеного віджету [[Special:MyLanguage/Libs/Main_graphical_elements#weather|основної бібліотеки]].

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| schedCur || Планування за CRON оновлення поточних даних || Рядок || Вхід || Не атрибут || Константа || 0 8-20 * * *
|-
| schedFC || Планування за CRON оновлення прогнозованих даних || Рядок || Вхід || Не атрибут || Константа || 0 8 * * *
|-
| city || ІД Міста || Рядок || Вхід || Повний доступ || Змінна || 709932
|-
| current || Поточне || Об'єкт || Вхід || Тільки читання || Змінна ||
|-
| forecast || Прогноз || Об'єкт || Вхід || Тільки читання || Змінна ||
|-
| this || Параметр || Об'єкт || Вхід || Не атрибут || Змінна || 0
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainWeatherCfg_uk.png|right|Конфігурація.]]
{{CntHdr|Конфігурація та використання}}
:1. Для цього шаблону створити та запустити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного контролеру]] або використати будь який наявний з потрібними властивостями планування.
:2. Створити [[Special:MyLanguage/Modules/LogicLev|об'єкт логічного параметру]] та обрати цей шаблон для нього. Ввімкнути параметр.
:3. У вкладці "Конфігурація шаблону" об'єкту логічного параметру треба встановити:
:* ''Планування за CRON оновлення поточних даних'' — у значення необхідного планування для отримання поточних даних у [[Special:MyLanguage/Documents/User_API#CRON|форматі CRON]], за порожнього отримання здійснюватиметься із періодом виконання об'єкту контролеру;
:* ''Планування за CRON оновлення прогнозованих даних'' — у значення необхідного планування для отримання прогнозованих даних у [[Special:MyLanguage/Documents/User_API#CRON|форматі CRON]], за порожнього отримання здійснюватиметься із періодом виконання об'єкту контролеру.
:4. РЕЗУЛЬТАТ: Запустивши об'єкт контролеру (де створено цей параметр) та якщо він не був запущений, маємо отримати у атрибуті параметру ''Поточне (current)'' і ''Прогноз (forecast)'' та після встановлення кода вашого міста у відповідному атрибуті. Код міста ви можете отримати із [https://openweathermap.org/ офіційного сайту] у адресі (URL) після пошуку вашого міста у формі сайту.

== [[Special:MyLanguage/Modules/WebUser|Для WebUser]] ==
{| class="wikitable"
<section begin=fileServerHTTP />
| {{Anch|fileServerHTTP|<h3>WebUser: HTTP Файловий Сервер ([[Special:MyLanguage/Libs/Main#fileServerHTTP|fileServerHTTP]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=fileServerHTTP />
| [[User:RomanSavochenko|Роман Савоченко]]
|}
Шаблон для реалізації Файлового Серверу HTTP безпосередньо в OpenSCADA, який корисний за відсутності повнофункціонального для функцій обслуговування файлових запитів із OpenSCADA Web-інтерфейсів.

Наразі реалізовано лише запити файлів HTTP запитом GET. Також реалізуються шматки і запити Часток Контенту за одним діапазоном зі змушуванням до цього режиму за певного налаштованого розміру файлу.

{{CntHdr|ВВ шаблону}}
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Тип !! Режим !! Атрибут !! Конфігурація !! Значення
|-
| rez || Результат || Рядок || Вхід || Не атрибут || Змінна || 200 OK
|-
| HTTPreq || HTTP запит || Рядок || Вхід || Не атрибут || Змінна ||
|-
| url || URL || Рядок || Вхід || Не атрибут || Змінна ||
|-
| sender || Відправник || Рядок || Вхід || Не атрибут || Змінна ||
|-
| page || WWW-сторінка || Рядок || Вихід || Не атрибут || Змінна ||
|-
| HTTPvars || HTTP змінні || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| baseD || Базовий каталог || Рядок || Вхід || Не атрибут || Константа || /data/share_res/local/Lib/
|-
| fSzSolidLim || Обмеження на розмір файлу для читання цілком, інакше вмикається вміст частками || Реальний || Вхід || Не атрибут || Константа || 10e6
|-
| tr || Транспорт || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| prt || Протокол || Об'єкт || Вихід || Не атрибут || Змінна ||
|-
| f_start || Прапорець запуску функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_frq || Частота обчислення функції, Гц || Реальний || Вхід || Не атрибут || Змінна || 1000
|-
| f_stop || Прапорець зупинки функції || Логічний || Вхід || Не атрибут || Змінна || 0
|-
| f_err || Помилка функції || Рядок || Вхід || Не атрибут || Змінна || 0
|}

[[File:LibsMainFileServerHTTPCfg.png|right|Конфігурація.]]
{{CntHdr|Конфігурація і використання}}
:1. Створити сторінку у модулі [[Special:MyLanguage/Modules/WebUser|UI.WebUser]] із певним доцільним ідентифікатором ''PageId''.
:2. У вкладці "Процедура" необхідно встановити:
:* Базовий каталог від якого сторінка буде шукати файли.
:* Обмеження на розмір файлу для читання цілком, інакше вмикається вміст частками.
:3. РЕЗУЛЬТАТ: Відкриття URL "<nowiki>http://{OpenSCADAHost}/WebUser/{PageId}/{MyFile}</nowiki>" у Web Оглядачі відкриє та надішле вам файл на ФС "{baseD}/{MyFile}".

Libs/Main/en

2026-05-10T04:01:06Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Name !! Version !! License !! Source !! Languages !! Author !! Description
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main|Main library]]
| 2.3 || GPLv2 || OscadaLibs.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql SQL], [[:File:OscadaLibs.db.gz|GZip]]) > DAQ.tmplb_base || en, uk, ru
<section end=info />
| [[User:RomanSavochenko|Roman Savochenko]]
| Library of the main templates of the DAQ-sources processing and related services.
* '''Founded:''' January 2006
* '''Sponsored by:''' depending on the item ...
* '''Used by:''' [[Special:MyLanguage/Using|most projects on OpenSCADA]]
* '''[[Special:MyLanguage/Works/To_do|To Do]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

The library was created to provide main templates of the DAQ-sources processing and related services.

The template's names and their parameters are available in languages: English, Ukrainian and mRussian. Their source code wrote in the human-language independent mode with calls for the translations by the function ''tr()'' and the message's translation also allowed for English, Ukrainian and mRussian.

For connection the library to a project of the OpenSCADA station you can obtain the database file as:
* supplied with a ready and proper package of the Linux distribution like to "openscada-libdb-main", "openscada-LibDB.Main";
* directly taken for most actual one from [http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql the subversion repository] and converted to the DB SQLite file in the way:
<syntaxhighlight lang="BASH" style="margin-left: 15px">
wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql
sqlite3 -init OscadaLibs.sql OscadaLibs.db .exit
</syntaxhighlight>
* downloaded for [[:File:OscadaLibs.db.gz|the one attached here]].

This obtained file next you can place into the project directory of the station and create the database object for the DB module "SQLite", registering the database file in the configuration.

For the DAQ-templates at generic you need create a device representing object into [[Special:MyLanguage/Modules/LogicLev|the Logical Level module]] and select proper template from the templates library. Next, to correct configuration, follow to specific of the template into the individual description.

== Templates of standard structures of the DAQ-parameters ==
{| class="wikitable"
<section begin=anUnif />
| {{Anch|anUnif|<h3>Analog signal, unified ([[Special:MyLanguage/Libs/Main#anUnif|anUnif]])</h3>}}
| 2.4 || GPLv2 || * || en, uk, ru <section end=anUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainAnUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of analog input signals processing. The template forms a structure of analog parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The representative structure of analog parameters (complex tags) is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow|Analog show]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|Analog show 1]]; [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1s|Analog show 1, short]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Graphics group element]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewCadr|Frame of the group of overview]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraphEl|Frame of the result graphics]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#Level|Level]]
* [[Special:MyLanguage/Libs/Documents|Reports' and documents' library]]:
** [[Special:MyLanguage/Libs/Documents#docRepInstVals|Instantaneous values report]]
** [[Special:MyLanguage/Libs/Documents#docRepDay|Day report of the hour-averaged values]]
** [[Special:MyLanguage/Libs/Documents#docRepMonth|Month report of the day-averaged values]]
** [[Special:MyLanguage/Libs/Documents#docRepYear|Year report of the month values]]
** [[Special:MyLanguage/Libs/Documents#docRep2WorkSh|Report of two working shifts]]

* '''Sponsored by, for expanding the common field DESCR using in the specific alarm parameters on 0.1 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' INSERTEC LTDA

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:: [[File:at.png]] The hardware borders can be inverted ones and disabled in whole for equal values of the maximum and minimum, when the main border only used.
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Simple imitation of the analog input, setting '''plcImit''' and linking the imitation-simulation source in '''plcImitIn'''.
:: [[File:at.png]] Missing the link '''plcImitIn''' (EVAL) causes to generating random analog input
* Complex preprocessing and complete generation-imitation of the analog input on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''in'' [IN|OUT] — the same raw analog input IO;
:* ''var'' [IN] — the end variable IO;
:* ''min'', ''max'' [IN] — the main border IOs;
:* ''plcMin'', ''plcMax'' [IN] — the hardware border IOs;
:* ''plcImit'', ''plcImitIn'' [IN] — IOs of the simple imitation;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure;
:* ''toSave'' [OUT] — to force save the parameter object at exit.
* Simple substitution for the variable '''subVar''' at the error (not valid) input variable (EVAL) in the modes: "no", "last" and "substitute".
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Specific parameters redefinition in the common attribute '''DESCR''':
:* ''the first line'' — as description of the alarm messages;
:* the field ''CustomFlds'' — specifying of [[Special:MyLanguage/Documents/Program_manual#ArchMess|the custom fields]] of the alarm messages in the form "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''";
:* the field ''CustomAlarms'' — redefinition of the standard alarm levels of the alarm messages in the form "'''CustomAlarms: {ConErr};{BrdAlarm};{BrdWarn}'''".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Real || Input || Not attribute || Link || Input|var
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Variable || 0
|-
| max || Scale: maximum || Real || Input || Full access || Variable || 100
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| subMode || Substitute: mode || Integer numbers selection || Input || Full access || Variable || 0<br/>
0;1;2<br/>
no;last;substitute<br/>
|-
| subVar || Substitute: variable || Real || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 1
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| Tf || Filter time, seconds || Real || Input || Full access || Variable || 0
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| plcImit || PLC imitation || Boolean || Input || Not attribute || Constant || 0
|-
| plcImitIn || PLC imitation input || Real || Input || Not attribute || Link || Imitation|var
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainAnUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the analog input on the internal programming language of OpenSCADA. It is optional and should be defined in complex cases, for example:
::* simple and transparent preprocessing to bring the percentage of UPS load to power that can be done with '''iMult''' also:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
in = 490*in/100; //the UPS has 480W </syntaxhighlight>
::* implementing of the input signal counter — consumed electricity of the UPS:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
//Checking for the data validity
if(ctx.cntr.isEVal()) ctx.cntr = this.var.get();
if(!in.isEVal()) {
pUPS = 33;
if(ctx.cntr.isEVal()) ctx.cntr = (pUPS+in)/(3600*f_frq);
else ctx.cntr += (pUPS+in)/(3600*f_frq);
}

//Checking for the next month reset
month = 0; SYS.localtime(SYS.time(), 0, 0, 0, 0, month);
if(!ctx.month.isEVal() && month != ctx.month) ctx.cntr = 0;
ctx.month = month;

in = ctx.cntr; </syntaxhighlight>
::* generating of the extended violations — processing for the external signals related to the source:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(SYS.DAQ.JavaLikeCalc.lib_aviary.sensorError(gO.prm_generic.PRG_Input_Err_T_room_S.get(),levErr,tErr));
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_max.get()).isEVal() && tVl)
levErr = -4, tErr = "11:above the set limit";
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_min.get()).isEVal() && tVl)
levErr = -4, tErr = "11:below the set limit"; </syntaxhighlight>
:* ''Minimum and maximum of the module scale'' — must be set at the case of significant difference the hardware and the generic scales, for example:
::* the input is raw and measured in value of the current [4...20]mA, here it is necessary to specify 4 and 20 mA;
::* the previous case where it is necessary to simply and transparently calibrate the end value — with a precision device set 4mA and 20mA and indicate here the real measured values of the "raw" signal.
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example:
::* calibration for the end value, which is less transparent and these coefficients should be calculated according to the formulas:
::: '''iAdd = ((plcMin*precMeasMax)/plcMax - precMeasMin)*(plcMax/(plcMax-plcMin))'''
::: '''iMult = (plcMax - plcMin) / (precMeasMax - precMeasMin)'''
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:* ''PLC imitation and the imitation input'' — define at the need to simulate the input as required in the functions.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted! In the absence of the hardware border, this, the main border, is arbitrary and advisory, although exceeding of the border by the value will be also accompanied by a violation.
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Substitute: mode and variable'' — set the desired substitution mode at invalidity the variable.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=anUnifSt />
| {{Anch|anUnifSt|<h3>Analog signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#anUnifSt|anUnifSt]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=anUnifSt />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
Common, representative and unified template of analog input signals processing, extended by binary states of indication the violations. The template grounded on the base template "[[#anUnif|Analog signal, unified]]" with its representative structure and some differences characteristic to independent development and expansion.

Binary states were provided for the convenient use of algorithms of operation at the borders of violations of the parameter object, preferably in [[Special:MyLanguage/Modules/BlockCalc|the block diagrams]] of general control algorithms.

{{CntHdr|Functions}}
Mostly the same as the basic template "[[#anUnif|Analog signal, unified]]" and the borderline signs are additionally provided: "H", "L", "HH", "LL", "EVAL".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| colspan="7" | Template IOs of "[[#anUnif|Analog signal, unified]]"
|-
| H || Border up warning violation || Boolean || Output || Read only || Variable ||
|-
| L || Border down warning violation || Boolean || Output || Read only || Variable ||
|-
| HH || Border up alarm violation || Boolean || Output || Read only || Variable ||
|-
| LL || Border down alarm violation || Boolean || Output || Read only || Variable ||
|-
| EVAL || Error value || Boolean || Output || Read only || Variable ||
|}

{{CntHdr|Configuring and using}}
Completely identical to "[[#anUnif|Analog signal, unified]]]" with the difference of using the borderline signs: "H", "L", "HH", "LL", "EVAL"; which can be connected to external computing.

{| class="wikitable"
<section begin=manInUnif />
| {{Anch|manInUnif|<h3>Manual input, unified ([[Special:MyLanguage/Libs/Main#manInUnif|manInUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=manInUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainManInUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of a manual input and an analog output signal. The template forms a structure of parameter (complex tag) of the manual input what can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object, the control mostly can be performed through the [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]] control panel.

The representative structure of the parameter (complex tag) of the manual input is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Variable input ('''varIn''')" — attribute for entering a new engineering value, which in the next falls into the variable.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:: [[File:at.png]] The hardware borders can be inverted ones and disabled in whole for equal values of the maximum and minimum, when the main border only used.
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Reverse conversion of the engineered variable value and writing to the output.
: [[File:at.png]] In the absence of the "Input/Output" connection, the writing is not performed and there is the stand-alone operation.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inout || Input/Output || Real || Output || Not attribute|| Link || Parameter|var
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| varIn || Variable input || Real || Input || Full access || Variable || 0
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Variable || 0
|-
| max || Scale: maximum || Real || Input || Full access || Variable || 100
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable ||
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 1
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| Tf || Filter time, seconds || Real || Input || Full access || Variable || 0
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainManInUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input/Output'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" IO signal]], or do not link for the stand-alone mode.
:* ''Minimum and maximum of the module scale'' — must be set at the case of significant difference the hardware and the generic scales, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero; and it will be allowed to set new values.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted! In the absence of the hardware border, this, the main border, is arbitrary and advisory, although exceeding of the border by the value will be also accompanied by a violation.
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=digitBlockUnif />
| {{Anch|digitBlockUnif|<h3>Discrete block, unified ([[Special:MyLanguage/Libs/Main#digitBlockUnif|digitBlockUnif]])</h3>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=digitBlockUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDigitBlockUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of the block for union of Discrete parameters for the common control device. The template forms a structure of discrete parameter-block (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The representative structure of discrete parameters (complex tags) is a latch object with two characteristic states and three commands, which in the final representation may have a different meaning and name:
* "State "Opened" ('''st_open''')" — the state "Opened" of the latch. Is the primary status signal that can be used without the next one, when '''1 (true)''' is "Opened", and '''0 (false)''' is 'Closed'.
* "State "Closed" ('''st_close''')" — the state "Closed".
* "Command "Open" ('''com''')" — the command "Open" of the latch. Is the primary command signal that can be used without the next one, when '''1 (true)''' is "Open", and '''0 (false)''' is 'Close'.
* "Command "Close" ('''close''')" — the command "Close" of the latch.
* "Command "Stop" ('''stop''')" — the command "Stop" of the latch.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Text label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Image label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Graphics group element]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#El_Alarm|Alarming]]
** [[Special:MyLanguage/Libs/Mnemo_elements#discrApps|Discrete apparatus]]
* [[Special:MyLanguage/Libs/Electrical_elements|Electrical elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Key, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Switch, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|General state, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Area state, unified]]

{{CntHdr|Functions}}
* Direct obtaining, by link, of the two states (read only) and three commands (reading and writing).
* Possibility of holding the commands for a certain time and removing them.
* Ability to redefine the states and commands by [[Special:MyLanguage/Libs/Main_graphical_elements|the appropriate settings of the interface elements]], such as ''digStts'', for statuses, and ''digComs'', for commands.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| com || Command "Open" || Boolean || Output || Full access || Link || Crane|com
|-
| close || Command "Close" || Boolean || Output || Full access || Link || Crane|close
|-
| stop || Command "Stop" || Boolean || Output || Full access || Link || Crane|stop
|-
| st_open || State "Opened" || Boolean || Input || Read only || Link || Crane|st_open
|-
| st_close || State "Closed" || Boolean || Input || Read only || Link || Crane|st_close
|-
| tCmd || Time to hold the command, seconds || Integer || Input || Not attribute || Constant || 5
|-
| last_cmd || Last command || Integer || Output || Not attribute || Variable || 0
|-
| w_tm || Process command counter || Real || Output || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainDigitBlockUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* All the states and commands — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Time to hold the command, seconds'' — set the desired hold value or 0 to disable this feature.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: states and commands.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative control, performing the commands:

{| class="wikitable"
<section begin=digAlarm />
| {{Anch|digAlarm|<h3>Alarm discrete ([[Special:MyLanguage/Libs/Main#digAlarm|digAlarm]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=digAlarm />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDigAlarmOp.png|right|Result and the operative setup.]]
Common, representative and unified template of separate discrete parameter (complex tag) processing with formation of signaling by the defined criterion. The template forms a structure of discrete parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The template provides some fields of [[#digitBlockUnif|the representative structure of the discrete parameters]] and adds the error field:
* "State "Opened" ('''st_open''')" — the state "Opened".
* "State "Closed" ('''st_close''')" — the state "Closed".
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — hardware errors, when the data mostly wrong;
** '''3''' — violation of the specified condition.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

{{CntHdr|Functions}}
* Direct obtaining, by link, of the initial state and formation of two representative states with the possibility of their inversion '''stInv'''.
* Complex preprocessing and complete generation-imitation of the discrete input on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''in'' [IN|OUT] — the same raw discrete input IO;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure.
* Processing of the discrete input '''in''' for the purpose of creating a violation and correspondingly setting the attribute '''err''', at the condition "'''{st}:{lev}:{mess}'''", that is violation generation of the level ''lev'' and the text ''mess'' for the input status ''st'' (0|1). What can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''.
* Specific parameters redefinition in the common attribute '''DESCR''':
:* ''the first line'' — as description of the alarm messages;
:* the field ''CustomFlds'' — specifying of [[Special:MyLanguage/Documents/Program_manual#ArchMess|the custom fields]] of the alarm messages in the form "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| alrm || Alarm "{st}:{lev}:{mess}" || String || Input || Not attribute || Constant ||
|-
| stInv || State inversion || Boolean || Input || Not attribute || Constant ||
|-
| in || Input || Boolean || Input || Read only || Link || Input|in
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| st_open || State "Opened" || Boolean || Input || Read only || Variable ||
|-
| st_close || State "Closed" || Boolean || Input || Read only || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainDigAlarmCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* "Alarm "{st}:{lev}:{mess}" — define the criterion for the violation formation, leave blank to disable the violations generation.
:* "State inversion" — set to invert the representative attributes, that is, "st_open" set for "in" equal to '''false'''.
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the discrete input on the internal programming language of OpenSCADA. For example:
::* complete creation for a complex status:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
status = gO.prm_generic.PRG_Input_Err_T_Zone1_S.get();
in = gO.prm_generic.SET_CalcFan_UseSensor_T1.get() || !(status == 0 || status == 2 || status == 3); </syntaxhighlight>
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero.

{| class="wikitable"
<section begin=codeState />
| {{Anch|codeState|<h3>Code state ([[Special:MyLanguage/Libs/Main#codeState|codeState]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru <section end=codeState />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainCodeStateOp.png|right|Result and the operative setup.]]
A variant of [[#digitBlockUnif|the common, representative and unified template of the block for union of Discrete parameters]], expanded by more than two states and three commands that can be encoded by an integer value. The template forms a structure of parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' Vinnica Poultry Farm

The representative structure of the parameter (complex tag) of the code state is:
* "State "Text" ('''st_text''')" — text description of the state.
* "Command "Text" ('''com_text''')" — text of the command.
* "Commands ('''digComs''')" — common list of the allowed commands, to form the selecting.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — hardware errors, when the data mostly wrong.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Text label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Image label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]

{{CntHdr|Functions}}
* Direct receiving, by link, the status code and the command (read only), as well as setting the status text according to the list of states ''stats''.
* Working out the text of the command ''com_text'' to find it in the general list ''coms'' of commands and issuing the received command code to the output.
* Generating from the general list ''coms'' of commands the list of commands to be selected in ''digComs''.
* Complex processing and complete generation-imitation of the code state, as well as processing the code or the command text for targeted actions, on the internal programming language of OpenSCADA into the configuration IO '''inProc''', where you can operate next service parameters:
:* ''in'' [IN|OUT] — IO of the code state;
:* ''text'' [OUT] — direct text status setting;
:* ''coms'' [IN] — list of available commands, of the corresponded IO;
:* ''com_text'' [IN|OUT] — text of the received command;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of the calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure.
* Formation of the violation and the corresponding setting of the attribute '''err''', provided at setting in the processing procedure or lack of the communication (''in'' = EVAL). What can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Integer || Input || Read only || Link || Signal|in
|-
| out || Output || Integer || Output || Read only || Link || Signal|out
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| st_text || State "Text" || String || Input || Read only || Variable ||
|-
| stats || States, rows "{code}:{State}" || Text || Input || Full access || Variable ||
|-
| com_text || Command "Text" || String || Input || Full access || Variable ||
|-
| coms || Commands-states, rows "{code}:{State}" || Text || Input || Full access || Variable ||
|-
| digComs || Commands || Text || Input || Read only || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainCodeStateCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' and ''Output'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the processing and complete generation-imitation of the input, and issuing of the specific output, on the internal programming language of OpenSCADA. For example:
::* complete creation for the state code and alarms forming:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get().isEVal()) in = 4;
else {
if(!(tVl=gO.prm_fansControl.PRG_CntrFan_Alarm_ThermalRelay.get()).isEVal() && tVl)
levErr = -4, tErr = "11:alarm";
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get())
in = gO.prm_fansControl.PRG_CntrFan_On_G1.get() ? 1 : 2;
else in = 3;
} </syntaxhighlight>
::* forming the clock time text and issuing the time synchronization — direct status text setting and issuing for specific commands:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
curTm = SYS.time();
text = SYS.strftime(curTm, "%H։%M %d.%m.%Y");
gO = this.cntr().prm_grps;
if(!(tVl=gO.prm_other.PRG_RTC_UNIX.get()).isEVal()) {
text += " ("+(tVl-curTm).toString(10,0,true)+")";
}

if(com_text.length && !com_text.isEVal() && (tVl=coms.match("^([^:]+):"+com_text,"m")).length && tVl[1] == 1) {
gO.prm_other.SET_RTC_New_UNIX.set(curTm);
gO.prm_other.KEY_RTC_set_time.set(true);
} </syntaxhighlight>
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: input, output, code-input state, error status; and the generation of violations if the state of the error is nonzero.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative control, performing the commands:
:* ''States'' — set to list of accordance with its status code to text.
:* ''Commands-states'' — set to list of accordance with its status-command code to text.
:* ''Command "Text"'' — set in the command text, which is described in the command list, for the code conversion and issuance.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.

{| class="wikitable"
<section begin=pidUnif />
| {{Anch|pidUnif|<h3>PID signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#pidUnif|pidUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=pidUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainPidUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of an interface to the Proportional Integral Differential (PID) regulator based on the common analog input signal, extended by binary states of indication the violations. The template forms a structure of the analog PID-regulator which can be easily connected to some cadres and widgets of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' DIYA Ltd

The representative structure of the analog PID-regulators is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Setpoint ('''sp''')" — setpoint for the analog signal value achievement in the automatic mode.
* "Manual input ('''manIn''')" — attribute for entering a new output value, which in the next falls into the output at the manual mode.
* "Output ('''out''')" — output (control signal) of the PID-regulator.
* "Mode: automate ('''auto''')" — the PID-regulator mode "Automatic".
* "Mode: cascade ('''casc''')" — the PID-regulator mode "Cascade".
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrRegul|Regulator's control panel]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#analogApps|Analog apparatus]]

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Simple imitation of the analog input, setting '''plcImit''' and linking the imitation-simulation source in '''plcImitIn'''.
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Transmission of the PID-specific information, control and coefficient attributes to and from the PLC or other data source with the regulation.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Real || Input || Not attribute || Link || Signal|in
|-
| sp || Setpoint || Real || Input || Full access || Link || PID|sp
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| manIn || Manual input, % || Real || Input || Full access || Link || PID|manIn
|-
| out || Output, % || Real || Input || Full access || Link || PID|out
|-
| auto || Mode: automate || Boolean || Input || Full access || Link || PID|auto
|-
| casc || Mode: cascade || Boolean || Input || Full access || Link || PID|casc
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Link || PID|min
|-
| max || Scale: maximum || Real || Input || Full access || Link || PID|max
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable || 0
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 0
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| H || Border up warning violation || Boolean || Output || Read only || Variable || 0
|-
| L || Border down warning violation || Boolean || Output || Read only || Variable || 0
|-
| HH || Border up alarm violation || Boolean || Output || Read only || Variable || 0
|-
| LL || Border down alarm violation || Boolean || Output || Read only || Variable || 0
|-
| EVAL || Value is error || Boolean || Output || Read only || Variable || 0
|-
| Tf || Filter time, milliseconds || Real || Input || Full access || Variable || 0
|-
| Kp || Gain || Real || Input || Full access || Link || PID|Kp
|-
| Ti || Ti, milliseconds || Integer || Input || Full access || Link || PID|Ti
|-
| Kd || Gain differential || Real || Input || Full access || Link || PID|Kd
|-
| Td || Td, milliseconds || Integer || Input || Full access || Link || PID|Td
|-
| Tzd || T differential lag, milliseconds || Integer || Input || Full access || Link || PID|Tzd
|-
| Zi || Insensitivity, % || Real || Input || Full access || Link || PID|Zi
|-
| Hup || Upper output border, % || Real || Input || Full access || Link || PID|Hup
|-
| Hdwn || Lower output border, % || Real || Input || Full access || Link || PID|Hdwn
|-
| K1 || Coefficient of input 1 || Real || Input || Full access || Link || PID|K1
|-
| K2 || Coefficient of input 2 || Real || Input || Full access || Link || PID|K2
|-
| K3 || Coefficient of input 3 || Real || Input || Full access || Link || PID|K3
|-
| K4 || Coefficient of input 4 || Real || Input || Full access || Link || PID|K4
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 1
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 5
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| plcImit || PLC imitation || Boolean || Input || Not attribute || Constant || 0
|-
| plcImitIn || PLC imitation input || Real || Input || Not attribute || Link || Imitation|var
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainPidUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" analog signal]].
:* ''Setpoint'', ''Manual input'', ''Output'', ''Mode: automate'', ''Mode: cascade'', ''Scale: minimum'', ''Scale: maximum'', ''Gain'', ''Ti'', ''Gain differential'', ''Td'', ''T differential lag'', ''Insensitivity'', ''Upper output border'', ''Lower output border'', ''Coefficient of input 1'', ''Coefficient of input 2'', ''Coefficient of input 3'', ''Coefficient of input 4'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the PID-regulator]].
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:* ''PLC imitation and the imitation input'' — define at the need to simulate the input as required in the functions.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero. Also we will get all the PID-specific attributes.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted!
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=pidUnifImp />
| {{Anch|pidUnifImp|<h3>Impulse PID signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#pidUnifImp|pidUnifImp]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=pidUnifImp />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
Common, representative and unified template of an interface to the Proportional Integral Differential (PID) regulator based on the common analog input signal but with the PWM-output, extended by binary states of indication the violations and mostly like to the template "[[#pidUnif|PID signal, unified, violation statuses]]". The template forms a structure of the impulse PID-regulator which can be easily connected to some cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' DIYA Ltd

The representative structure of the impulse PID-regulators is mostly equal to the template "[[#pidUnif|PID signal, unified, violation statuses]]" and contains a number of attributes specific to the pulse output and the attribute of determining the operation of this regulator in the analog mode, that is, this template is even more generalizable:
* "Impulse output up ('''impQup''')" and "Impulse output down ('''impQdwn''')" — signals of the PWM-output.
* "Mode: analog ('''analog''')" — a sign of working the regulator in the analog output mode.

{{CntHdr|Functions}}
Mostly the same as the basic template "[[#pidUnif|PID signal, unified, violation statuses]]" and the impulse-specific attributes are additionally provided: "Impulse output up", "Impulse output down", "Mode: analog", "T impulses period", "T minimal impulse", "Impulse rate factor".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| colspan="7" | Template IOs of "[[#pidUnif|PID signal, unified, violation statuses]]"
|-
| impQup || Impulse output up || Boolean || Input || Read only || Link || PID|impQupTm
|-
| impQdwn || Impulse output down || Boolean || Input || Read only || Link || PID|impQdwnTm
|-
| analog || Mode: analog || Boolean || Input || Read only || Link || PID|analog
|-
| TImpPer || T impulses period, milliseconds || Integer || Input || Full access || Link || PID|TImpPer
|-
| TImpMin || T minimal impulse, milliseconds || Integer || Input || Full access || Link || PID|TImpMin
|-
| KImpRfact || Impulse rate factor || Real || Input || Full access || Link || PID|KImpRfact
|}

{{CntHdr|Configuring and using}}
Mostly the same as the basic template "[[#pidUnif|PID signal, unified, violation statuses]]" with the difference of using the impulse specific output: "Impulse output up", "Impulse output down", "Mode: analog", "T impulses period", "T minimal impulse", "Impulse rate factor".

== {{Anch|ComplexObject|Templates of the complex objects}} ==
In some cases where an object is only a part of a common automated system and does not require deep detailing to the level of signals and parameters (complex tag) around them, including without the need for archiving, it is convenient to unify them in one representative object of the data source OpenSCADA with appropriate consolidated view and object control as a set of simple attributes with violation elements. Such consolidation often occurs around specialised data sources, whose access to data is usually implemented through a separate exchanging protocol, but without unifying the transmission of this data to the level of visualisation and signalling by a separate attribute of the object.

In general, the representative structure of a complex object is:
* "All items ('''items''')" — common object-type attribute where the attributes of a physical object are directly described by object-type attributes in '''items''' and with defined descriptive attributes in each
** ''id'' — attribute identifier;
** ''descr'' — text description of the attribute;
** ''wr'' — a sign of the possibility of writing or a list of value variants to their selection, through the symbol ';';
** ''alarm'' — violation code:
*** 0 — no violation — "NORM";
*** 1 — violation level "WARNING";
*** 2 — violation level "ALARM";
** ''val'' — attribute value;
** ''set'' — attribute value to set the attributes accessible to write.
* "Error ('''err''')" — obligatory attribute of common violation status of the object in general, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — violation level "WARNING";
** '''2''' — violation level "ALARM";
** '''3''' — unreliability or lack of data.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

Generally, it is advisable to create such template (a layer above the physical data source object) above a raw data source that provides this data in attributes and without processing, and this template therefore performs:
* collection of these attributes of the raw source into '''items''';
* processing of properties of the attributes;
* control and transmitting of commands of the values setting;
* processing of the violation conditions at single attributes and at the object in whole, together with which these violations can be fixed in [[Special:MyLanguage/Documents/Program_manual#ArchMess|the table of actual violations]], typically by the [[Special:MyLanguage/Documents/User_API#SYS.DAQ|alarmSet() function]].

In addition to complex object templates, this object-control mechanism can be implemented by templates for implementing [[Special:MyLanguage/Documents/DAQ#LogicLev|the logical level of data access]], such as in [[Special:MyLanguage/Libs/Devices#IEC60870|IEC60870]].

To represent the data of the object-control mechanism, there currently provided the appropriate [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties frame]], which provides these properties as a table-list with illumination of the violations and the possibility to change the selected and accessible to edit row-properties.

{| class="wikitable"
<section begin=UPS />
| {{Anch|UPS|<h3>Uninterruptible Power Supply ([[Special:MyLanguage/Libs/Main#UPS|UPS]])</h3>}}
| 2.2 || GPLv2 || * || en, uk, ru <section end=UPS />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainUPSOp.png|right|Result and the operative setup.]]
Data combination of the Uninterruptible Power Supply in a complex object of the attribute "All items". The template initially designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/System|System]]" in the part "UPS" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties, signalling at single borders and writing.

Next the template was expanded by direct implementing UPS or Power Inverters which support is missing in [https://networkupstools.org/ NUT] (in ground of the part "UPS"), and such the first device became [https://www.mustpower.com/product/ep2100-pro-series-dc12v-300-1000w/ Must EP2100 PRO]. And for that there also was appended of custom definition the device's properties to place as DAQ-Attributes with the possibility of the description redefinition.

* '''Sponsored by:''' DIYA Ltd

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address
* "System.slow.prm_UPS" - for connecting to the [[Special:MyLanguage/Modules/System|DAQ.System]] parameter in the UPS part;
* "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30" - for connecting to serial port of the Must EP2100 PRO.
| String || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| defs || Elements definition
In form of lines - "{id}:{toAttr}:{descr}"
| Text || Output || Full access || Variable ||
|-
| bChL || Battery charge low || Real || Input || Full access || Variable || 20
|-
| bChLL || Battery charge critical || Real || Input || Full access || Variable || 5
|-
| inVL || Input voltage low || Real || Input || Full access || Variable || 210
|-
| inVH || Input voltage high || Real || Input || Full access || Variable || 250
|-
| inFLL || Input frequency too low || Real || Input || Full access || Variable || 40
|-
| inFL || Input frequency low || Real || Input || Full access || Variable || 45
|-
| inFH || Input frequency high || Real || Input || Full access || Variable || 55
|-
| inFHH || Input frequency too high || Real || Input || Full access || Variable || 60
|-
| loadH || Load high || Real || Input || Full access || Variable || 80
|-
| loadHH || Load too high || Real || Input || Full access || Variable || 100
|-
| tH || Temperature high || Real || Input || Full access || Variable || 50
|-
| tHH || Temperature too high || Real || Input || Full access || Variable || 70
|-
| hyst || Hysteresis of borders, % || Real || Input || Full access || Variable || 5
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainUPSCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Create a source controller object in the module DAQ.System and set its identifier like to "SYSData".
:2. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Create a source parameter object in the previous controller object and set its identifier like to "UPS".
:3. Create and start a [[Special:MyLanguage/Modules/LogicLev|Logical Controller Object]] or use any presented with the need scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|Logical Parameter Object]] and select the template for it. Enable the parameter.
:5. In the tab "Template configuration" of the Logical Parameter Object you need to set:
:* ''Source object's address'':
::* [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] — to address of the source UPS parameter object (see to step 1) like to "System.SYSData.prm_UPS";
::* [ Must EP2100 PRO ] — to Serial address of connecting the device like to "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30".
:6. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''All items (items)'' this object with all the attributes and their properties. In the case of some violations, we will get the corresponding information in the attribute ''Error (err)'', for which you can adjust the attributes of the boundaries of the corresponding violations. To customize some item's description and to place some in DAQ-Attributes, you can edit "Elements definition (defs)" for ones. From the created DAQ-Attributes you can also control writable ones.
:7. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link its to the parameter object, created in step 4.
:8. RESULT: In the runtime of the page you'll get a table with data of the object, notifications about violations in the header and the possibility to set of writable properties.

{| class="wikitable"
<section begin=SNMP />
| {{Anch|SNMP|<h3>Network devices by SNMP ([[Special:MyLanguage/Libs/Main#SNMP|SNMP]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=SNMP />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainSNMPOp.png|right|Result and the operative setup.]]
Data combination of a device, accessible by the protocol SNMP, in a complex object of the attribute "All items". The template designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/SNMP|SNMP]]" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties, signalling at single borders and writing. Considering the great specificity and variety of SNMP-accessible devices, this template is actually a billet and an example of creating a template based on it to a corresponding device with a specific to it processing of input properties, forming of violations and write capability.

* '''Sponsored by:''' PAC HARTRON

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address || String || Input || Not attribute || Constant ||
|-
| manTables || Manual tables || String || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainSNMPCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a source controller object in the module "[[Special:MyLanguage/Modules/SNMP|SNMP]]" and set its identifier like to "SYSData".
:2. Create a source parameter object in the previous controller object and set its identifier like to "DEV".
:3. Create and start a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any presented one with the need scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select the template for it. Enable the parameter.
:5. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Source object's address'' — to address of the source SNMP device parameter object (see to step 1) like to "SNMP.SYSData.DEV".
:* ''Manual tables'' — enter manually some static MIB-variables.
:6. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''items'' this object with all the attributes and their properties. In case of some violations, we will get the corresponding information in the attribute of the parameter ''err'', for which you can adjust the attributes of the boundaries of the corresponding violations.
:7. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link it to the parameter object, created in step 4.
:8. RESULT: In runtime of the page you get a table with data of the object, notifications about violations in the header and the possibility to set of writable properties.

{| class="wikitable"
<section begin=DiskSMART />
| {{Anch|DiskSMART|<h3>Disk SMART ([[Special:MyLanguage/Libs/Main#DiskSMART|DiskSMART]])</h3>}}
| 1.1 || GPLv2 || * || en, uk <section end=DiskSMART />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDiskSMARTOp.png|right|Result and the operative setup.]]
Data combination of the disk SMART in a complex object of the attribute "All items". The template designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/System|System]]" in the part "Disk SMART" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties and signalling at common errors. Some SMART attributes can be unknown or wrong for specified disk due to their missing in the disks DB, especially for modern SSD, so the template provides a feature to redefine names the attributes.

Complex postprocessing and complete generation-imitation of the SMART fields with separate attributes on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''alLev'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure;
:* ''items'' [IN|OUT] — object of items of the SMART.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address || String || Input || Not attribute || Constant ||
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| defs || Item definitions || Text || Input || Full access || Variable ||
<pre>161:Number of Valid Spare Blocks (161)
162:Uncorrectable Sector Count (162)
163:Number of Initial Invalid Blocks (163)
164:Total Erase Count (164)
165:Block Erase Count (165)
166:Minimum PE Cycles TLC (166)
167:Max Bad Blocks per Die (167)
168:Maximum PE Cycles TLC (168)
168:Max Erase Count of Spec (168)
168:SATA PHY error count (168)
169:Total Bad Blocks (169)
169:Remain Life (169)
170:Grown Bad Blocks (170)
170:Bad Block Count (170)
171:Program Fail Count (171)
172:Erase Fail Count (172)
173:Average PE Cycles TLC (173)
173:Max Erase Count (173)
174:Unexpected Power Loss (174)
184:End-to-End Error (184)
187:Reported Uncorrect (187)
188:Command Timeout (188)
218:CRC Error Count (218)
230:Media Wearout Indicator (230)
231:SSD Life Left (231)
233:NAND GB Written TLC (233)
234:NAND GB Written SLC (234)
241:Host Writes GB (241)
242:Host Reads GiB (242)
244:Temp Throttle Status (244)
245:Flash Write Sector Count (245)</pre>
|-
| this || The object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String || Input || Not attribute || Variable ||
|-
| DESCR || Description || String || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainDiskSMARTCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a source controller object in the module "[[Special:MyLanguage/Modules/System|System]]" and set its identifier like to "SYSData", set the property "Auto create active data sources" to "All sources" and start by setting "Running".
:2. Create and start a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any presented one with the need scheduling properties.
:3. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select the template for it. Enable the parameter.
:4. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Source object's address'' — to address of the source disk SMART parameter object like to "System.SYSData.DiskSMARTsda".
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the SMART fields with separate attributes on the internal programming language of OpenSCADA.
:5. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''items'' this object with all the attributes and their properties. In case of some violations, we will get the corresponding information in the attribute of the parameter ''err''.
:6. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link it to the parameter object, created in step 3.
:7. RESULT: In runtime of the page you get a table with data of the object, notifications about violations in the header and the possibility to redefine names of the SMART attributes.

== Services ==
{| class="wikitable"
<section begin=ntf />
| {{Anch|ntf|<h3>Notificator by SMS, EMail-SMTP ([[Special:MyLanguage/Libs/Main#ntf|ntf]])</h3>}} || 1.0 || GPLv2 || * => [[Special:MyLanguage/Modules/UserProtocol|UserProtocol]] || en, uk, ru <section end=ntf />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainNtfOp.png|right|Result and the operative setup.]]
The complex template of the notification contains of parts of the dispatcher and the output user protocol of notification by EMail(SMTP) and SMS.

* '''Total complexity:''' > 1.05 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for initial implementation the SMS-send part on 0.2 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' [[Special:MyLanguage/Using/HouseSpirit|Oleg Sidashov]]
* '''Sponsored by, for unification, appending SMTP and the notification controller on 0.65 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' SVItoVYR Ltd

'''THE DISPATCHER''' can be performed for pointed messages of the message buffer of OpenSCADA and applied on [[Special:MyLanguage/Documents/DAQ#LogicLev|the Logical level]] or the controller object of [[Special:MyLanguage/Modules/JavaLikeCalc|the module JavaLikeCalc]].

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| io || UserPrt: Output IO || Object || Input || Not attribute || Variable ||
|-
| tr || UserPrt: Transport || Object || Input || Not attribute || Variable ||
|-
| tmOut || Maximum notification timeout, seconds || Integer || Input || Not attribute || Constant || 5
|-
| messLev || Messages level, negative for alarms || Integer || Input || Not attribute || Constant || 1
|-
| messCat || Messages category, template or regular expression || String || Input || Not attribute || Constant || al*:*
|-
| messCatExcl || Message exclusion category, in regular expression || String || Input || Not attribute || Constant ||
|-
| emailState || Email notification current state || String || Output || Read only || Variable ||
|-
| emailTrAddr || Output transport for SMTP connection, empty for disable || String || Input || Not attribute || Constant || Sockets.out_SMTP
|-
| emailAuth || Auth, empty for disable || String || Input || Not attribute || Constant || user:pass
|-
| emailSender || Sender || String || Input || Not attribute || Constant || noreply@oscada.org
|-
| emailReceiver || Destination receiver address || String || Input || Not attribute || Constant || test@oscada.org
|-
| emailTopic || EMail topic || String || Input || Not attribute || Constant || Notification
|-
| emailMess || EMail message || String || Input || Not attribute || Constant ||
|-
| SMSState || SMS notification current state || String || Output || Read only || Variable ||
|-
| SMSTrAddr || SMS serial transport, empty for disable || String || Input || Not attribute || Constant || Serial.out_SMS
|-
| SMSPin || SMS-pin, empty for disable || String || Input || Not attribute || Constant || 1111
|-
| SMSTel || SMS destination receiver, tel. number || String || Input || Not attribute || Constant || +380XXXXXXXXX
|-
| SMSTextMd || SMS in the text mode, else PDU || Boolean || Input || Not attribute || Constant || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainNtfCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a parameter in a controller object of [[Special:MyLanguage/Documents/DAQ#LogicLev|the Logical Level]] or a controller object in [[Special:MyLanguage/Modules/JavaLikeCalc|the module DAQ.JavaLikeCalc]].
:2. Create an output transport of the type "[[Special:MyLanguage/Modules/Serial|Serial]]" and set its Identifier like to "SMS", one transport suitable for more receivers.
:3. Set for proper address, only for the [[Special:MyLanguage/Modules/Serial|Serial]] device. The serial port speed, asynchronous data format and timeouts will adjusted by the function.
:4. Create an output transport of the type "[[Special:MyLanguage/Modules/Sockets|Sockets]]" or "[[Special:MyLanguage/Modules/SSL|SSL]]" and set its Identifier like to "SMTP", one transport suitable for more receivers.
:5. Set-up for proper address, for Sockets(25) or SSL(465). The transport timeouts will be adjusted by the function.
:6. In the tab "Template configuration" you need to set:
:* Maximum notification timeout, seconds.
:* Messages level, negative for alarms.
:* Messages category, template or regular expression.
:* Message exclusion category, in regular expression.
:* Output transport for SMTP connection, empty for disable.
:* Auth, empty for disable.
:* Sender.
:* Destination receiver address.
:* EMail topic.
:* EMail message.
:* SMS serial transport, empty for disable.
:* SMS-pin, empty for disable.
:* SMS destination receiver, tel. number.
:* SMS in the text mode, else PDU.
:7. RESULT: Sending for the pointed messages at SMS or EMail(SMTP).

'''THE OUTPUT USER PROTOCOL PART "SMS"''' provides operations with SMS by a GSM-modem connected as serial device. For now, there supported only sending SMS messages to a number of remote cell phone or GSM-modem. For sending there are supported: ECHO disable, PIN check and set, sending in PDU and the Text mode.<br/>

{{CntHdr|Output user protocol's XML-request structure}}
'''<cmd pin="1111" tel="+380XXXXXXXXX" text="{0|1}" err="1:Error">{SMSText}</cmd>'''
:''cmd'' — command, for now only "send" allowed;
:''pin'' — PIN-code to the SIM-card access;
:''tel'' — telephone number of the receiver (remote cell phone or GSM-modem);
:''text{0,1}'' — SMS in the text mode, only ASCII;
:''SMSText'' — the message text;
:''err'' — sets for the request result.

{{CntHdr|Configuring and using}}
:1. Create an output transport of the type "[[Special:MyLanguage/Modules/Serial|Serial]]" and set its Identifier like to "SMS", one transport suitable for more receivers.
:2. Set for proper address. The serial port speed, asynchronous data format and timeouts will adjusted by the function.
:3. Create of need [[Special:MyLanguage/Modules/UserProtocol|user protocol object]] based on the templates, with Identifier like to "SMS".
:4. Place some requesting commands directly into presented or a new internal OpenSCADA-procedure like to:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send"); req.setAttr("ProtIt","SMS").setAttr("pin","1111").setAttr("tel","+380XXXXXXXXX").setText("Notify message");
SYS.Transport.Serial.out_SMS.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. RESULT: In the variable ''rez'' you will get "OK" if no errors occur and the message successfully transmitted to the receiver.

'''THE OUTPUT USER PROTOCOL PART "SMTP"''' provides operations with a SMTP-server for delivering EMails by their sending through TCP-Socket or SSL. For now, there are supported: TCP, SSL, AUTH, topic encoding for UTF-8.<br/>

{{CntHdr|Output user protocol's XML request structure}}
'''<send auth="{user}:{pass}" from="{FromAddr}" to="{ToAddr}" topic="{My Topic}" err="1:Error">{MessageText}</send>'''
:''topic'' — topic of the message;
:''from'' — sender address;
:''to'' — destination address of the receiver;
:''auth'' — authenticate user and password;
:''MessageText'' — text of the message;
:''err'' — sets for the request result.

{{CntHdr|Configuring and using}}
:1. Create an output transport of the type "[[Special:MyLanguage/Modules/Sockets|Sockets]]" or "[[Special:MyLanguage/Modules/SSL|SSL]]" and set its Identifier like to "SMTP", one transport suitable for more receivers.
:2. Set-up for proper address, for Sockets(25) or SSL(465). The transport timeouts will be adjusted by the function.
:3. Create of need [[Special:MyLanguage/Modules/UserProtocol|user protocol object]] based on the templates, with Identifier like to "SMTP".
:4. Place some requesting commands directly into allowed or a new internal OpenSCADA procedure like to:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send");
req.setAttr("ProtIt","SMTP").setAttr("from","noreply@oscada.org").setAttr("to","oscada@oscada.org").setAttr("topic","My topic").setText("My message");
SYS.Transport.Sockets.out_SMTP.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. RESULT: In the variable ''rez'' you will get "OK" if no errors occur and the message successfully transmitted to the receiver.

{| class="wikitable"
<section begin=initRemCntr />
| {{Anch|initRemCntr|<h3>Control the remote initiative connections ([[Special:MyLanguage/Libs/Main#initRemCntr|initRemCntr]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=initRemCntr />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainInitRemCntrOp.png|right|Result and the operative setup.]]
The template of processing input initiative connections expands early one template [[#initConAssociateTrs|initiative connections processing for the associated output transports]] by complete representing data of the remote OpenSCADA hosts on some aggregation server and with a possibility of control the remote hosts through the server, that is finishing the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|conception of data acquisition in the passive mode and the initiative connection]].

The template does in whole:
* detecting a new connection from remote host, which has no ID;
* sending an acquaintance direct request to the established connection for getting KEY of the host, when it was already connected early, and for getting information about the host for creating ID of the host;
* setting ID for the connection;
* creating a record in the [[Special:MyLanguage/Documents/Program_manual#Transports|OpenSCADA hosts table]] for the connection and sending all followed requests already through the host;
* creating on the remote host a representative [[Special:MyLanguage/Modules/LogicLev|Logical Controller]];
* creating on the remote host a representative [[Special:MyLanguage/Modules/System|DAQ.System Controller Object]] in the automatic mode, at missing any other there;
* processing the present DAQ.System Controller Objects to link the Logical Level parameters to them and creating some processing logical parameters, with updating for all sources at any reconnection and checking for removing ones without sources already;
* writing the generated key by a line "'''SrcKey: {KEY}'''" to description of the Logical Controller as a sign of finalizing the initialization;
* creating a Controller Object in [[Special:MyLanguage/Modules/DAQGate|DAQ.DAQGate]] with connection to the remote Logical Controller and syncing its per 10 minutes for appending new sources and removing missing ones.

ID of the remote host is formed in the view "'''{HostDomain}{StatName}{RandKey}'''" and with limiting to 20 symbols, where:
* ''HostDomain'' — network host name-domain;
* ''StatName'' — station name of the OpenSCADA project;
* ''RandKey'' — random key in two HEX-digits.

Data model of the representative Logical Controller can contain both the generated links with processing parameters, and custom parameters, when the user is decided to publish some extra data. The generated items from DAQ.System are represents sources currently:
* "CPU", "MEM", "sensors", "Power", "uptime" => links in the "System (SYS)" container parameter;
* "fs", "hddstat", "hddsmart" => links in the "Disk (DISK)" container parameter with a processing one for "hddsmart" by the template [[Special:MyLanguage/Libs/Main#DiskSMART|base.DiskSMART]];
* "netstat" => links in the "Network (NET)" container parameter;
* "ups" => links in the root with a processing one by the template [[Special:MyLanguage/Libs/Main#UPS|base.UPS]].

The aggregated data in [[Special:MyLanguage/Modules/DAQGate|DAQ.GAQGate]] can be lifted to up, or used in derivative DAQ objects, or whether directly on custom frames, or in future on a Dynamic Frame, which scheduled to implement; and without any additional action you will get notification about violations on the hosts.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inTransport || Input transport || String || Input || Not attribute || Constant || Sockets.InitRemCntr
|-
| conTm || Connection time, ms || Integer || Input || Not attribute || Constant || 5000
|-
| accessTm || Timeout of accessing, hours
Used for repeating to create representative objects of not accessed hosts and for removing old connections.<br/>
Zero or negative value for disabling the control!
| Integer || Input || Not attribute || Constant || 24
|-
| cntrUser || Access: user || String || Input || Not attribute || Constant || root
|-
| cntrPass || Access: password || String || Input || Not attribute || Constant || openscada
|-
| cntrObj || Control object in DAQ.LogicLev and DAQ.System || String || Input || Not attribute || Constant || RemCntr
|-
| prcTr || Processed connections || Text || Output || Read only || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainInitRemCntrCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create an input transport of receiving the initiative connections of the module "[[Special:MyLanguage/Modules/Sockets#InTr|Sockets]]" or "[[Special:MyLanguage/Modules/SSL#InTr|SSL]]" with the name like to "Sockets.InitRemCntr".
:2. Set the previously created transport to the need address of opening the input socket and move it to the mode of creating the associative output transports, leaving the protocol field in empty.
:3. For this template create and run a logical controller object or use any available with the required scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:5. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input transport'' — to value of the identifier of the input transport, created in the item 1, like to "Sockets.InitRemCntr";
:* ''Connection time'' — timeout of connection to the initiative hosts after that to close the connection;
:* ''Timeout of accessing'' — used for repeating to create representative objects of not accessed hosts and for removing old connections; zero or negative value for disabling the control;
:* ''Access: user and password'' — user and password of the remote host with permition of creation there Logical Controller and DAQ.System Controller Object, that is the user must be included to the "DAQ" group;
:* ''Control object in DAQ.LogicLev and DAQ.System'' — to ID of managed-created Controller Objects on the remote hosts.
:6. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get checking the specifying input transport for initiative connections and their initialisation in described above way and with notification processed connection in the attribute "Processed connections".

{| class="wikitable"
<section begin=initConAssociateTrs />
| {{Anch|initConAssociateTrs|<h3>Initiative connections processing for the associated output transports ([[Special:MyLanguage/Libs/Main#initConAssociateTrs|initConAssociateTrs]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=initConAssociateTrs />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainInitConsAssignTrsOp.png|right|Result and the operative setup.]]
The template of processing input initiative connections was created to provide the last link of implementation and support for [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|conception of data acquisition in the passive mode and the initiative connection]], that is — the control of associative connections, created by the input transport at each connection.

[[file:at.png]] After implementation this control together the new common-unified output transport connection function [[Special:MyLanguage/Documents/User_API#SYSTransport|outAt()]] that template became deprecated for sources adapted to use the new mechanism, but you still can use the template for not adapted sources.

The function of creation associated output transports at connections is currently only supported by [[Special:MyLanguage/Modules/Sockets|the module "Sockets"]] and for TCP-sockets.

* '''Total complexity:''' 0.9 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for whole complexity:''' Elyor Turaboev, BLUE STAR GROUP Ltd

The control of associated transport means:
* obtaining a list of the associated transports, by the function ''assignTrsList()'' of the input transports;
* reading from new transports (opened) of identification information, which currently represents only the source object identifier;
** search, by the received identifier, the source object and assigning to it of this transport;
** registering in the attribute "prcTr" of the object type.
* checking of existing transports for their closure (detachment), for which performed the deregistration in the attribute "prcTr" of the object type and the establishment of the source object in the empty value; disconnected output associated transports are reused by the input one upon receiving a new connection then it is switched on.

The template can control the containers of data source objects, constructed both as DAQ-objects of the controllers and logical level parameters, what representing the data source and having a transport address definition field, and what generally defined by the configuration field "srcObjPath" of the format '''{CntrAddr}:{TrCntrFldAddr}''', where:
* ''CntrAddr'' — container address, for example: "ModBus" — for DAQ-objects of the controllers, "LogicLev.CntrPLC" — for logical level parameters;
* ''TrCntrFldAddr'' — address of the transport control field in the source object, for example — "%2fcntr%2fcfg%2fADDR" for "ModBus"; what can be obtained in a configurator at the history of pointing on the control field in the status line.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inTransport || Input transport || String || Input || Not attribute || Constant || InitiateCons
|-
| outTrTm || Output transport timeouts || String || Input || Not attribute || Constant || 10:0.1
|-
| srcObjPath || Source object path || String || Input || Not attribute || Constant || ModBus:%2fcntr%2fcfg%2fADDR
|-
| prcTr || Processed transports || Object || Output || Read only || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainInitConsAssignTrsCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create an input transport of receiving the initiative connections of [[Special:MyLanguage/Modules/Sockets#InTr|the module "Sockets"]] with the name like to "InitiateCons".
:2. Set the previously created transport to the need address of opening the input socket and move it to the mode of creating the associative output transports, leaving the protocol field in empty.
:3. Provide a container of the data sources to which associative transports must be connected, which can be either a DAQ-module (such as "DAQ.ModBus"), or a logical controller (such as "DAQ.LogicLev.Sources"), or a parameter in it (such as "DAQ.LogicLev.PLC.Sources"), with logical level parameters representing the data source.
:4. For this template create and run a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any available with the required scheduling properties.
:5. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:6. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input transport'' — to value of the identifier of the input transport, created in the item 1, like to "InitiateCons";
:* ''Output transport timeouts'' — increase the first digit for very slow connections and typical is normal in most situations
:* ''Source objects path'' — set according to the item 3, for the first part, and to the control field path, for the second part, for example, and typically for for "ModBus", is — "ModBus:%2fcntr%2fcfg%2fADDR".
:6. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get, in the attribute ''prcTr'' of the parameter for information about the processed and therefore successfully transport-linked data sources. In case of some violations, we will get the corresponding information in the attribute ''err'' of the parameter. The absence of a representative object for the received identifier is placed in the protocol of messages.

{| class="wikitable"
<section begin=weather />
| {{Anch|weather|<h3>Weather ([[Special:MyLanguage/Libs/Main#weather|weather]])</h3>}}
| 1.0 || GPLv2 || * || en, uk <section end=weather />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainWeatherOp.png|right|Result and the operative setup.]]
The template of acquiring weather data from different weather services in Internet and initially it is only [https://openweathermap.org/ Open Weather].

The weather data divided on current and forecast with their placing in corresponded objects, where current attributes placed directly in the root and forecast days (the "day" object) and times (the "time" object) inwardly corresponded day according to the current timezone. These data acquired at specified schedule independently for current and forecast, and by default the current ones are performed per hour when forecast ones per day. The data can be accessible by user both as directly and through a specially created widget of the [[Special:MyLanguage/Libs/Main_graphical_elements#weather|main library]].

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| schedCur || Scheduling at CRON of current update || String || Input || Not attribute || Constant || 0 8-20 * * *
|-
| schedFC || Scheduling at CRON of forecast update || String || Input || Not attribute || Constant || 0 8 * * *
|-
| city || City ID || String || Input || Full access || Variable || 709932
|-
| current || Current || Object || Input || Read only || Variable ||
|-
| forecast || Forecast || Object || Input || Read only || Variable ||
|-
| this || Parameter || Object || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|}

[[File:LibsMainWeatherCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. For this template create and run a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any available with the required scheduling properties.
:2. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:3. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Scheduling at CRON of current update'' — to value of need scheduling for current data acquiring in the [[Special:MyLanguage/Documents/User_API#CRON|CRON format]], at empty the acquiring will be performed with period of execution the controller object;
:* ''Scheduling at CRON of forecast update'' — to value of need scheduling for forecast data acquiring in the [[Special:MyLanguage/Documents/User_API#CRON|CRON format]], at empty the acquiring will be performed with period of execution the controller object.
:4. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get the weather data in the attribute ''Current (current)'' and ''Forecast (forecast)'' and after setting your city code in the corresponded attribute. City code you can obtain from the [https://openweathermap.org/ official site] in the URL after searching your city in the site form.

== [[Special:MyLanguage/Modules/WebUser|For WebUser]] ==
{| class="wikitable"
<section begin=fileServerHTTP />
| {{Anch|fileServerHTTP|<h3>WebUser: HTTP File Server ([[Special:MyLanguage/Libs/Main#fileServerHTTP|fileServerHTTP]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=fileServerHTTP />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The template for implementing a HTTP File Server directly in OpenSCADA, which is suitable one at missing a full-featured one for functions of servicing file requests from OpenSCADA Web-interfaces.

Currently there implemented only requesting files by the GET request of HTTP. There are supported also chunks and the Partial Content requests in single range and with forcing to this mode at some configured file size.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| rez || Result || String || Input || Not attribute || Variable || 200 OK
|-
| HTTPreq || HTTP request || String || Input || Not attribute || Variable ||
|-
| url || URL || String || Input || Not attribute || Variable ||
|-
| sender || Sender || String || Input || Not attribute || Variable ||
|-
| page || WWW-page || String || Output || Not attribute || Variable ||
|-
| HTTPvars || HTTP variables || Object || Output || Not attribute || Variable ||
|-
| baseD || Base directory || String || Input || Not attribute || Constant || /data/share_res/local/Lib/
|-
| fSzSolidLim || File size limit for solid reading, else enables the partial content || Real || Input || Not attribute || Constant || 10e6
|-
| tr || Transport || Object || Output || Not attribute || Variable ||
|-
| prt || Protocol || Object || Output || Not attribute || Variable ||
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz Real || Input || Not attribute || Variable || 1000
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|}

[[File:LibsMainFileServerHTTPCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a page in the [[Special:MyLanguage/Modules/WebUser|UI.WebUser]] module with some reasonable ''PageId''.
:2. In the tab "Procedure" you need to set:
:* Base directory from which the page'll search files.
:* File size limit for solid reading, else enables the partial content.
:3. RESULT: Opening URL "<nowiki>http://{OpenSCADAHost}/WebUser/{PageId}/{MyFile}</nowiki>" in a WebBrowser will open and send you file on FS "{baseD}/{MyFile}".

Libs/Main/ru

2026-05-10T04:01:04Z

FuzzyBot: Updating to match new version of source page

<languages/>
{| class="wikitable"
|-
! Название !! Версия !! Лицензия !! Источник !! Языки !! Автор !! Описание
|-
<section begin=info />
| [[Special:MyLanguage/Libs/Main|Основная библиотека]]
| 2.3 || GPLv2 || OscadaLibs.db ([http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql SQL], [[:File:OscadaLibs.db.gz|GZip]]) > DAQ.tmplb_base || en, uk, ru
<section end=info />
| [[User:RomanSavochenko|Роман Савоченко]]
| Библиотека основных шаблонов обработки DAQ-источников и производных сервисов.
* '''Основано:''' Январь 2006
* '''Спонсировано:''' зависимо от элемента ...
* '''Использовано:''' [[Special:MyLanguage/Using|большинство проектов на OpenSCADA]]
* '''[[Special:MyLanguage/Works/To_do|Задачи (To Do)]]:'''
<section begin=ToDo />
<section end=ToDo />
|}

Библиотека создана для предоставления основных шаблонов обработки DAQ-источников и производных сервисов.

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

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

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

Для DAQ-шаблонов, в целом, вам нужно создать представительский объект устройства в [[Special:MyLanguage/Modules/LogicLev|модуле Логического Уровня]] и выбрать соответствующий шаблон из библиотеки шаблонов. Далее, для корректной конфигурации, придерживайтесь специфики шаблона в персональном описании.

== Templates of standard structures of the DAQ-parameters ==
{| class="wikitable"
<section begin=anUnif />
| {{Anch|anUnif|<h3>Analog signal, unified ([[Special:MyLanguage/Libs/Main#anUnif|anUnif]])</h3>}}
| 2.4 || GPLv2 || * || en, uk, ru <section end=anUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainAnUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of analog input signals processing. The template forms a structure of analog parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The representative structure of analog parameters (complex tags) is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow|Analog show]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1|Analog show 1]]; [[Special:MyLanguage/Libs/Main_graphical_elements#anShow1s|Analog show 1, short]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Graphics group element]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewCadr|Frame of the group of overview]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ResultGraphEl|Frame of the result graphics]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#Level|Level]]
* [[Special:MyLanguage/Libs/Documents|Reports' and documents' library]]:
** [[Special:MyLanguage/Libs/Documents#docRepInstVals|Instantaneous values report]]
** [[Special:MyLanguage/Libs/Documents#docRepDay|Day report of the hour-averaged values]]
** [[Special:MyLanguage/Libs/Documents#docRepMonth|Month report of the day-averaged values]]
** [[Special:MyLanguage/Libs/Documents#docRepYear|Year report of the month values]]
** [[Special:MyLanguage/Libs/Documents#docRep2WorkSh|Report of two working shifts]]

* '''Sponsored by, for expanding the common field DESCR using in the specific alarm parameters on 0.1 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' INSERTEC LTDA

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:: [[File:at.png]] The hardware borders can be inverted ones and disabled in whole for equal values of the maximum and minimum, when the main border only used.
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Simple imitation of the analog input, setting '''plcImit''' and linking the imitation-simulation source in '''plcImitIn'''.
:: [[File:at.png]] Missing the link '''plcImitIn''' (EVAL) causes to generating random analog input
* Complex preprocessing and complete generation-imitation of the analog input on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''in'' [IN|OUT] — the same raw analog input IO;
:* ''var'' [IN] — the end variable IO;
:* ''min'', ''max'' [IN] — the main border IOs;
:* ''plcMin'', ''plcMax'' [IN] — the hardware border IOs;
:* ''plcImit'', ''plcImitIn'' [IN] — IOs of the simple imitation;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure;
:* ''toSave'' [OUT] — to force save the parameter object at exit.
* Simple substitution for the variable '''subVar''' at the error (not valid) input variable (EVAL) in the modes: "no", "last" and "substitute".
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Specific parameters redefinition in the common attribute '''DESCR''':
:* ''the first line'' — as description of the alarm messages;
:* the field ''CustomFlds'' — specifying of [[Special:MyLanguage/Documents/Program_manual#ArchMess|the custom fields]] of the alarm messages in the form "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''";
:* the field ''CustomAlarms'' — redefinition of the standard alarm levels of the alarm messages in the form "'''CustomAlarms: {ConErr};{BrdAlarm};{BrdWarn}'''".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Real || Input || Not attribute || Link || Input|var
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Variable || 0
|-
| max || Scale: maximum || Real || Input || Full access || Variable || 100
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| subMode || Substitute: mode || Integer numbers selection || Input || Full access || Variable || 0<br/>
0;1;2<br/>
no;last;substitute<br/>
|-
| subVar || Substitute: variable || Real || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 1
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| Tf || Filter time, seconds || Real || Input || Full access || Variable || 0
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| plcImit || PLC imitation || Boolean || Input || Not attribute || Constant || 0
|-
| plcImitIn || PLC imitation input || Real || Input || Not attribute || Link || Imitation|var
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainAnUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the analog input on the internal programming language of OpenSCADA. It is optional and should be defined in complex cases, for example:
::* simple and transparent preprocessing to bring the percentage of UPS load to power that can be done with '''iMult''' also:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
in = 490*in/100; //the UPS has 480W </syntaxhighlight>
::* implementing of the input signal counter — consumed electricity of the UPS:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
//Checking for the data validity
if(ctx.cntr.isEVal()) ctx.cntr = this.var.get();
if(!in.isEVal()) {
pUPS = 33;
if(ctx.cntr.isEVal()) ctx.cntr = (pUPS+in)/(3600*f_frq);
else ctx.cntr += (pUPS+in)/(3600*f_frq);
}

//Checking for the next month reset
month = 0; SYS.localtime(SYS.time(), 0, 0, 0, 0, month);
if(!ctx.month.isEVal() && month != ctx.month) ctx.cntr = 0;
ctx.month = month;

in = ctx.cntr; </syntaxhighlight>
::* generating of the extended violations — processing for the external signals related to the source:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(SYS.DAQ.JavaLikeCalc.lib_aviary.sensorError(gO.prm_generic.PRG_Input_Err_T_room_S.get(),levErr,tErr));
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_max.get()).isEVal() && tVl)
levErr = -4, tErr = "11:above the set limit";
else if(!(tVl=gO.prm_alarms.PRG_Alarm_T_min.get()).isEVal() && tVl)
levErr = -4, tErr = "11:below the set limit"; </syntaxhighlight>
:* ''Minimum and maximum of the module scale'' — must be set at the case of significant difference the hardware and the generic scales, for example:
::* the input is raw and measured in value of the current [4...20]mA, here it is necessary to specify 4 and 20 mA;
::* the previous case where it is necessary to simply and transparently calibrate the end value — with a precision device set 4mA and 20mA and indicate here the real measured values of the "raw" signal.
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example:
::* calibration for the end value, which is less transparent and these coefficients should be calculated according to the formulas:
::: '''iAdd = ((plcMin*precMeasMax)/plcMax - precMeasMin)*(plcMax/(plcMax-plcMin))'''
::: '''iMult = (plcMax - plcMin) / (precMeasMax - precMeasMin)'''
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:* ''PLC imitation and the imitation input'' — define at the need to simulate the input as required in the functions.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted! In the absence of the hardware border, this, the main border, is arbitrary and advisory, although exceeding of the border by the value will be also accompanied by a violation.
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Substitute: mode and variable'' — set the desired substitution mode at invalidity the variable.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=anUnifSt />
| {{Anch|anUnifSt|<h3>Analog signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#anUnifSt|anUnifSt]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=anUnifSt />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
Common, representative and unified template of analog input signals processing, extended by binary states of indication the violations. The template grounded on the base template "[[#anUnif|Analog signal, unified]]" with its representative structure and some differences characteristic to independent development and expansion.

Binary states were provided for the convenient use of algorithms of operation at the borders of violations of the parameter object, preferably in [[Special:MyLanguage/Modules/BlockCalc|the block diagrams]] of general control algorithms.

{{CntHdr|Functions}}
Mostly the same as the basic template "[[#anUnif|Analog signal, unified]]" and the borderline signs are additionally provided: "H", "L", "HH", "LL", "EVAL".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| colspan="7" | Template IOs of "[[#anUnif|Analog signal, unified]]"
|-
| H || Border up warning violation || Boolean || Output || Read only || Variable ||
|-
| L || Border down warning violation || Boolean || Output || Read only || Variable ||
|-
| HH || Border up alarm violation || Boolean || Output || Read only || Variable ||
|-
| LL || Border down alarm violation || Boolean || Output || Read only || Variable ||
|-
| EVAL || Error value || Boolean || Output || Read only || Variable ||
|}

{{CntHdr|Configuring and using}}
Completely identical to "[[#anUnif|Analog signal, unified]]]" with the difference of using the borderline signs: "H", "L", "HH", "LL", "EVAL"; which can be connected to external computing.

{| class="wikitable"
<section begin=manInUnif />
| {{Anch|manInUnif|<h3>Manual input, unified ([[Special:MyLanguage/Libs/Main#manInUnif|manInUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=manInUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainManInUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of a manual input and an analog output signal. The template forms a structure of parameter (complex tag) of the manual input what can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object, the control mostly can be performed through the [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]] control panel.

The representative structure of the parameter (complex tag) of the manual input is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Variable input ('''varIn''')" — attribute for entering a new engineering value, which in the next falls into the variable.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:: [[File:at.png]] The hardware borders can be inverted ones and disabled in whole for equal values of the maximum and minimum, when the main border only used.
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Reverse conversion of the engineered variable value and writing to the output.
: [[File:at.png]] In the absence of the "Input/Output" connection, the writing is not performed and there is the stand-alone operation.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inout || Input/Output || Real || Output || Not attribute|| Link || Parameter|var
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| varIn || Variable input || Real || Input || Full access || Variable || 0
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Variable || 0
|-
| max || Scale: maximum || Real || Input || Full access || Variable || 100
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable ||
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 1
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| Tf || Filter time, seconds || Real || Input || Full access || Variable || 0
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 0
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainManInUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input/Output'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" IO signal]], or do not link for the stand-alone mode.
:* ''Minimum and maximum of the module scale'' — must be set at the case of significant difference the hardware and the generic scales, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero; and it will be allowed to set new values.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted! In the absence of the hardware border, this, the main border, is arbitrary and advisory, although exceeding of the border by the value will be also accompanied by a violation.
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=digitBlockUnif />
| {{Anch|digitBlockUnif|<h3>Discrete block, unified ([[Special:MyLanguage/Libs/Main#digitBlockUnif|digitBlockUnif]])</h3>}} || 1.0 || GPLv2 || * || en, uk, ru <section end=digitBlockUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDigitBlockUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of the block for union of Discrete parameters for the common control device. The template forms a structure of discrete parameter-block (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The representative structure of discrete parameters (complex tags) is a latch object with two characteristic states and three commands, which in the final representation may have a different meaning and name:
* "State "Opened" ('''st_open''')" — the state "Opened" of the latch. Is the primary status signal that can be used without the next one, when '''1 (true)''' is "Opened", and '''0 (false)''' is 'Closed'.
* "State "Closed" ('''st_close''')" — the state "Closed".
* "Command "Open" ('''com''')" — the command "Open" of the latch. Is the primary command signal that can be used without the next one, when '''1 (true)''' is "Open", and '''0 (false)''' is 'Close'.
* "Command "Close" ('''close''')" — the command "Close" of the latch.
* "Command "Stop" ('''stop''')" — the command "Stop" of the latch.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Text label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Image label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElViewGraph|Graphics group element]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#El_Alarm|Alarming]]
** [[Special:MyLanguage/Libs/Mnemo_elements#discrApps|Discrete apparatus]]
* [[Special:MyLanguage/Libs/Electrical_elements|Electrical elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Key, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Switch, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|General state, unified]]
** [[Special:MyLanguage/Libs/Electrical_elements#ActualActive|Area state, unified]]

{{CntHdr|Functions}}
* Direct obtaining, by link, of the two states (read only) and three commands (reading and writing).
* Possibility of holding the commands for a certain time and removing them.
* Ability to redefine the states and commands by [[Special:MyLanguage/Libs/Main_graphical_elements|the appropriate settings of the interface elements]], such as ''digStts'', for statuses, and ''digComs'', for commands.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| com || Command "Open" || Boolean || Output || Full access || Link || Crane|com
|-
| close || Command "Close" || Boolean || Output || Full access || Link || Crane|close
|-
| stop || Command "Stop" || Boolean || Output || Full access || Link || Crane|stop
|-
| st_open || State "Opened" || Boolean || Input || Read only || Link || Crane|st_open
|-
| st_close || State "Closed" || Boolean || Input || Read only || Link || Crane|st_close
|-
| tCmd || Time to hold the command, seconds || Integer || Input || Not attribute || Constant || 5
|-
| last_cmd || Last command || Integer || Output || Not attribute || Variable || 0
|-
| w_tm || Process command counter || Real || Output || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainDigitBlockUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* All the states and commands — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Time to hold the command, seconds'' — set the desired hold value or 0 to disable this feature.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: states and commands.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative control, performing the commands:

{| class="wikitable"
<section begin=digAlarm />
| {{Anch|digAlarm|<h3>Alarm discrete ([[Special:MyLanguage/Libs/Main#digAlarm|digAlarm]])</h3>}}
| 1.3 || GPLv2 || * || en, uk, ru <section end=digAlarm />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDigAlarmOp.png|right|Result and the operative setup.]]
Common, representative and unified template of separate discrete parameter (complex tag) processing with formation of signaling by the defined criterion. The template forms a structure of discrete parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

The template provides some fields of [[#digitBlockUnif|the representative structure of the discrete parameters]] and adds the error field:
* "State "Opened" ('''st_open''')" — the state "Opened".
* "State "Closed" ('''st_close''')" — the state "Closed".
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — hardware errors, when the data mostly wrong;
** '''3''' — violation of the specified condition.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

{{CntHdr|Functions}}
* Direct obtaining, by link, of the initial state and formation of two representative states with the possibility of their inversion '''stInv'''.
* Complex preprocessing and complete generation-imitation of the discrete input on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''in'' [IN|OUT] — the same raw discrete input IO;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure.
* Processing of the discrete input '''in''' for the purpose of creating a violation and correspondingly setting the attribute '''err''', at the condition "'''{st}:{lev}:{mess}'''", that is violation generation of the level ''lev'' and the text ''mess'' for the input status ''st'' (0|1). What can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''.
* Specific parameters redefinition in the common attribute '''DESCR''':
:* ''the first line'' — as description of the alarm messages;
:* the field ''CustomFlds'' — specifying of [[Special:MyLanguage/Documents/Program_manual#ArchMess|the custom fields]] of the alarm messages in the form "'''CustomFlds: {CustFld0} => {CustFld1} => ... => {CustFldN}'''".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| alrm || Alarm "{st}:{lev}:{mess}" || String || Input || Not attribute || Constant ||
|-
| stInv || State inversion || Boolean || Input || Not attribute || Constant ||
|-
| in || Input || Boolean || Input || Read only || Link || Input|in
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| st_open || State "Opened" || Boolean || Input || Read only || Variable ||
|-
| st_close || State "Closed" || Boolean || Input || Read only || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainDigAlarmCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* "Alarm "{st}:{lev}:{mess}" — define the criterion for the violation formation, leave blank to disable the violations generation.
:* "State inversion" — set to invert the representative attributes, that is, "st_open" set for "in" equal to '''false'''.
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the discrete input on the internal programming language of OpenSCADA. For example:
::* complete creation for a complex status:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
status = gO.prm_generic.PRG_Input_Err_T_Zone1_S.get();
in = gO.prm_generic.SET_CalcFan_UseSensor_T1.get() || !(status == 0 || status == 2 || status == 3); </syntaxhighlight>
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero.

{| class="wikitable"
<section begin=codeState />
| {{Anch|codeState|<h3>Code state ([[Special:MyLanguage/Libs/Main#codeState|codeState]])</h3>}}
| 1.4 || GPLv2 || * || en, uk, ru <section end=codeState />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainCodeStateOp.png|right|Result and the operative setup.]]
A variant of [[#digitBlockUnif|the common, representative and unified template of the block for union of Discrete parameters]], expanded by more than two states and three commands that can be encoded by an integer value. The template forms a structure of parameter (complex tag) which can be easily connected to most widgets and cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' Vinnica Poultry Farm

The representative structure of the parameter (complex tag) of the code state is:
* "State "Text" ('''st_text''')" — text description of the state.
* "Command "Text" ('''com_text''')" — text of the command.
* "Commands ('''digComs''')" — common list of the allowed commands, to form the selecting.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — hardware errors, when the data mostly wrong.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#TextLab|Text label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ImgLab|Image label]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]

{{CntHdr|Functions}}
* Direct receiving, by link, the status code and the command (read only), as well as setting the status text according to the list of states ''stats''.
* Working out the text of the command ''com_text'' to find it in the general list ''coms'' of commands and issuing the received command code to the output.
* Generating from the general list ''coms'' of commands the list of commands to be selected in ''digComs''.
* Complex processing and complete generation-imitation of the code state, as well as processing the code or the command text for targeted actions, on the internal programming language of OpenSCADA into the configuration IO '''inProc''', where you can operate next service parameters:
:* ''in'' [IN|OUT] — IO of the code state;
:* ''text'' [OUT] — direct text status setting;
:* ''coms'' [IN] — list of available commands, of the corresponded IO;
:* ''com_text'' [IN|OUT] — text of the received command;
:* ''levErr'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of the calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure.
* Formation of the violation and the corresponding setting of the attribute '''err''', provided at setting in the processing procedure or lack of the communication (''in'' = EVAL). What can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Integer || Input || Read only || Link || Signal|in
|-
| out || Output || Integer || Output || Read only || Link || Signal|out
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| st_text || State "Text" || String || Input || Read only || Variable ||
|-
| stats || States, rows "{code}:{State}" || Text || Input || Full access || Variable ||
|-
| com_text || Command "Text" || String || Input || Full access || Variable ||
|-
| coms || Commands-states, rows "{code}:{State}" || Text || Input || Full access || Variable ||
|-
| digComs || Commands || Text || Input || Read only || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainCodeStateCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' and ''Output'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" signal]].
:* ''Input processing procedure'' — form for the processing and complete generation-imitation of the input, and issuing of the specific output, on the internal programming language of OpenSCADA. For example:
::* complete creation for the state code and alarms forming:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
gO = this.cntr().prm_grps;
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get().isEVal()) in = 4;
else {
if(!(tVl=gO.prm_fansControl.PRG_CntrFan_Alarm_ThermalRelay.get()).isEVal() && tVl)
levErr = -4, tErr = "11:alarm";
if(gO.prm_fansControl.PRG_CntrFan_AutoMode_G1.get())
in = gO.prm_fansControl.PRG_CntrFan_On_G1.get() ? 1 : 2;
else in = 3;
} </syntaxhighlight>
::* forming the clock time text and issuing the time synchronization — direct status text setting and issuing for specific commands:
<syntaxhighlight lang="JavaScript" style="margin-left: 40pt">
curTm = SYS.time();
text = SYS.strftime(curTm, "%H։%M %d.%m.%Y");
gO = this.cntr().prm_grps;
if(!(tVl=gO.prm_other.PRG_RTC_UNIX.get()).isEVal()) {
text += " ("+(tVl-curTm).toString(10,0,true)+")";
}

if(com_text.length && !com_text.isEVal() && (tVl=coms.match("^([^:]+):"+com_text,"m")).length && tVl[1] == 1) {
gO.prm_other.SET_RTC_New_UNIX.set(curTm);
gO.prm_other.KEY_RTC_set_time.set(true);
} </syntaxhighlight>
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: input, output, code-input state, error status; and the generation of violations if the state of the error is nonzero.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative control, performing the commands:
:* ''States'' — set to list of accordance with its status code to text.
:* ''Commands-states'' — set to list of accordance with its status-command code to text.
:* ''Command "Text"'' — set in the command text, which is described in the command list, for the code conversion and issuance.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.

{| class="wikitable"
<section begin=pidUnif />
| {{Anch|pidUnif|<h3>PID signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#pidUnif|pidUnif]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=pidUnif />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainPidUnifOp.png|right|Result and the operative setup.]]
Common, representative and unified template of an interface to the Proportional Integral Differential (PID) regulator based on the common analog input signal, extended by binary states of indication the violations. The template forms a structure of the analog PID-regulator which can be easily connected to some cadres and widgets of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' DIYA Ltd

The representative structure of the analog PID-regulators is:
* "Variable ('''var''')" — end variable of the parameter — engineeric real value, allowed and suitable for archiving.
* "Error ('''err''')" — obligatory attribute of any parameter, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1, 2''' — hardware errors, when the data mostly wrong;
** '''3, 4''' — alarm border errors;
** '''5, 6''' — warning border errors;
** '''7''' — the speed error of the variable changing.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.
* "Setpoint ('''sp''')" — setpoint for the analog signal value achievement in the automatic mode.
* "Manual input ('''manIn''')" — attribute for entering a new output value, which in the next falls into the output at the manual mode.
* "Output ('''out''')" — output (control signal) of the PID-regulator.
* "Mode: automate ('''auto''')" — the PID-regulator mode "Automatic".
* "Mode: cascade ('''casc''')" — the PID-regulator mode "Cascade".
* "Scale: minimum ('''min''')" and "Scale: maximum ('''max''')" — main scale of the end variable, the output of which causes a hardware border error. The scale is also used as a scale of the variable trend display on the graphs.
* "Logarithmic scale ('''log''')" — the scale sign of the variable trend display on the graphs in the logarithmic scale.
* "Dimension ('''ed''')" — dimension (unit of measurement) of the variable.
* "Precision ('''prec''')" — number signs after the dot, for positive values, and precision (signs in whole), for negative ones, to display the real end variable on the screen.

Significant graphical shapes representing the structure:
* [[Special:MyLanguage/Libs/Main_graphical_elements|Main elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrRegul|Regulator's control panel]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#ElCadr|Element cadre]]
** [[Special:MyLanguage/Libs/Main_graphical_elements#cntrPaspExt|Passport, extended]]
* [[Special:MyLanguage/Libs/Mnemo_elements|Mnemonic elements library of the user interface]]:
** [[Special:MyLanguage/Libs/Mnemo_elements#analogApps|Analog apparatus]]

{{CntHdr|Functions}}
* Generic processing of the raw analog input for:
:* simple correction-calibration at the formula "'''in''' = '''iMult'''*('''in'''+'''iAdd''')";
:* scaling from the hardware border ['''plcMin'''...'''plcMax'''] to the main border ['''min'''...'''max'''], applying the square scale '''scSqr''';
:* permission to exceed the border for the input value on the value of '''plcExcess''' percent;
:* filtering the input value changing in the time '''Tf'''.
* Simple imitation of the analog input, setting '''plcImit''' and linking the imitation-simulation source in '''plcImitIn'''.
* Processing the result variable '''var''' for violation some borders and criteria, generating the alarms and proper setting the attribute '''err'''. The alarm borders can have some hysteresis '''HystBnd''', can be delayed on the time '''alDelay''' and can be suppressed setting '''alSup'''. Next borders and criteria are provided:
:* missing for data or connection with source at the EVAL input value — error code 1 and alarm level 5;
:* exceeding the input value of the hardware border — error code 1,2 and alarm level 5;
:* exceeding the end variable of the alarm border ['''aMin'''...'''aMax'''] — error code 3,4 and alarm level 4;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* exceeding the end variable of the warning border ['''wMin'''...'''wMax'''] — error code 5,6 and alarm level 2;
:: [[File:at.png]] Disabled at setting for equal or inverted values of the border
:* big motion '''speed''' of the end variable — error code 7 and alarm level 2.
* Transmission of the PID-specific information, control and coefficient attributes to and from the PLC or other data source with the regulation.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| in || Input || Real || Input || Not attribute || Link || Signal|in
|-
| sp || Setpoint || Real || Input || Full access || Link || PID|sp
|-
| var || Variable || Real || Input || Read only || Variable || 0
|-
| manIn || Manual input, % || Real || Input || Full access || Link || PID|manIn
|-
| out || Output, % || Real || Input || Full access || Link || PID|out
|-
| auto || Mode: automate || Boolean || Input || Full access || Link || PID|auto
|-
| casc || Mode: cascade || Boolean || Input || Full access || Link || PID|casc
|-
| ed || Dimension || String || Input || Full access || Variable ||
|-
| min || Scale: minimum || Real || Input || Full access || Link || PID|min
|-
| max || Scale: maximum || Real || Input || Full access || Link || PID|max
|-
| scSqr || Scale: square || Boolean || Input || Full access || Variable || 0
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable || 0
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| aMin || Border down alarm || Real || Input || Full access || Variable || 0
|-
| aMax || Border up alarm || Real || Input || Full access || Variable || 0
|-
| wMin || Border down warning || Real || Input || Full access || Variable || 0
|-
| wMax || Border up warning || Real || Input || Full access || Variable || 0
|-
| HystBnd || Hysteresis of borders violation || Real || Input || Full access || Variable || 0
|-
| speed || Motion speed, %/cycle || Real || Input || Full access || Variable || 0
|-
| prec || Precision, signs || Integer || Input || Full access || Variable || 2
|-
| log || Logarithmic scale || Boolean || Input || Full access || Variable || 0
|-
| H || Border up warning violation || Boolean || Output || Read only || Variable || 0
|-
| L || Border down warning violation || Boolean || Output || Read only || Variable || 0
|-
| HH || Border up alarm violation || Boolean || Output || Read only || Variable || 0
|-
| LL || Border down alarm violation || Boolean || Output || Read only || Variable || 0
|-
| EVAL || Value is error || Boolean || Output || Read only || Variable || 0
|-
| Tf || Filter time, milliseconds || Real || Input || Full access || Variable || 0
|-
| Kp || Gain || Real || Input || Full access || Link || PID|Kp
|-
| Ti || Ti, milliseconds || Integer || Input || Full access || Link || PID|Ti
|-
| Kd || Gain differential || Real || Input || Full access || Link || PID|Kd
|-
| Td || Td, milliseconds || Integer || Input || Full access || Link || PID|Td
|-
| Tzd || T differential lag, milliseconds || Integer || Input || Full access || Link || PID|Tzd
|-
| Zi || Insensitivity, % || Real || Input || Full access || Link || PID|Zi
|-
| Hup || Upper output border, % || Real || Input || Full access || Link || PID|Hup
|-
| Hdwn || Lower output border, % || Real || Input || Full access || Link || PID|Hdwn
|-
| K1 || Coefficient of input 1 || Real || Input || Full access || Link || PID|K1
|-
| K2 || Coefficient of input 2 || Real || Input || Full access || Link || PID|K2
|-
| K3 || Coefficient of input 3 || Real || Input || Full access || Link || PID|K3
|-
| K4 || Coefficient of input 4 || Real || Input || Full access || Link || PID|K4
|-
| iAdd || Input addition || Real || Input || Not attribute || Constant || 0
|-
| iMult || Input multiplication || Real || Input || Not attribute || Constant || 1
|-
| plcMin || Minimum module scale || Real || Input || Not attribute || Constant || 1
|-
| plcMax || Maximum module scale || Real || Input || Not attribute || Constant || 5
|-
| plcExcess || Allowed scale exceeding, % || Real || Input || Not attribute || Constant || 0
|-
| plcImit || PLC imitation || Boolean || Input || Not attribute || Constant || 0
|-
| plcImitIn || PLC imitation input || Real || Input || Not attribute || Link || Imitation|var
|-
| this || Object || Object || Output || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainPidUnifCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create and start [[Special:MyLanguage/Modules/LogicLev|a logical controller object]] or use any presented one with the need scheduling properties.
:2. Create [[Special:MyLanguage/Modules/LogicLev|a logical parameter object]] and select this template for it. Enable the parameter.
:3. Into the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the "raw" analog signal]].
:* ''Setpoint'', ''Manual input'', ''Output'', ''Mode: automate'', ''Mode: cascade'', ''Scale: minimum'', ''Scale: maximum'', ''Gain'', ''Ti'', ''Gain differential'', ''Td'', ''T differential lag'', ''Insensitivity'', ''Upper output border'', ''Lower output border'', ''Coefficient of input 1'', ''Coefficient of input 2'', ''Coefficient of input 3'', ''Coefficient of input 4'' — [[Special:MyLanguage/Documents/DAQ#LogicLevLnks|link to a source of the PID-regulator]].
:* ''Input addition and multiplication'' — use for easy and linear correction of the input, for example see the template "[[#anUnif|Analog signal, unified]]".
:* ''Allowed scale exceeding'' — set if necessary to exceed the value of the main border, and when this scale starts to perform the recommendation function, say for the initial display of the trend on this scale.
:* ''PLC imitation and the imitation input'' — define at the need to simulate the input as required in the functions.
:4. RESULT: Launching the controller object (where this parameter is created) and if it has not been started, we must get the operational data in the tab "Attributes" for: variable, error status; and the generation of violations if the state of the error is nonzero. Also we will get all the PID-specific attributes.
:5. In the process of the working, through the tab "Attributes" of operational data, in addition to obtaining the result, it is possible to perform operative setup and control on:
:* ''Scale: minimum and maximum'' — strictly [[file:at.png]] set to the range of data changes by availability and according to the hardware border, otherwise the value will be distorted!
:* ''Scale: square'' — set if the hardware border is square one.
:* ''Filter time'' — set the filtering time for noisy signals.
:* ''Violations suppress'' — set at the need of the parameter violations complete suppression — to disable their generation in whole.
:* ''Violations delay'' — set the delay time for the generation of the violations, to exclude frequent generation, characteristic to uncertain sources of data, characterized by short-term loss of communication.
:* ''Border up/down alarm/warning'' — set when it is necessary to generate violations at the exceeding of the alarm/warning borders.
:* ''Hysteresis of borders violation'' — set the hysteresis of removing the violation, that is, removal of the violations occurs at the specified percentage later, in order to prevent the frequent generation by fluctuating the value near the border.
:* ''Motion speed'' — set if it is necessary to warn about fast change of value.
:* ''Name, Description, Dimension, Precision, Logarithmic scale'' — set this information as need when displayed, or as an element of the passport.

{| class="wikitable"
<section begin=pidUnifImp />
| {{Anch|pidUnifImp|<h3>Impulse PID signal, unified, violation statuses ([[Special:MyLanguage/Libs/Main#pidUnifImp|pidUnifImp]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=pidUnifImp />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
Common, representative and unified template of an interface to the Proportional Integral Differential (PID) regulator based on the common analog input signal but with the PWM-output, extended by binary states of indication the violations and mostly like to the template "[[#pidUnif|PID signal, unified, violation statuses]]". The template forms a structure of the impulse PID-regulator which can be easily connected to some cadres of [[Special:MyLanguage/Libs/Main_graphical_elements|the main elements library of the user interface]] just pointing the parameter object.

* '''Sponsored by:''' DIYA Ltd

The representative structure of the impulse PID-regulators is mostly equal to the template "[[#pidUnif|PID signal, unified, violation statuses]]" and contains a number of attributes specific to the pulse output and the attribute of determining the operation of this regulator in the analog mode, that is, this template is even more generalizable:
* "Impulse output up ('''impQup''')" and "Impulse output down ('''impQdwn''')" — signals of the PWM-output.
* "Mode: analog ('''analog''')" — a sign of working the regulator in the analog output mode.

{{CntHdr|Functions}}
Mostly the same as the basic template "[[#pidUnif|PID signal, unified, violation statuses]]" and the impulse-specific attributes are additionally provided: "Impulse output up", "Impulse output down", "Mode: analog", "T impulses period", "T minimal impulse", "Impulse rate factor".

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| colspan="7" | Template IOs of "[[#pidUnif|PID signal, unified, violation statuses]]"
|-
| impQup || Impulse output up || Boolean || Input || Read only || Link || PID|impQupTm
|-
| impQdwn || Impulse output down || Boolean || Input || Read only || Link || PID|impQdwnTm
|-
| analog || Mode: analog || Boolean || Input || Read only || Link || PID|analog
|-
| TImpPer || T impulses period, milliseconds || Integer || Input || Full access || Link || PID|TImpPer
|-
| TImpMin || T minimal impulse, milliseconds || Integer || Input || Full access || Link || PID|TImpMin
|-
| KImpRfact || Impulse rate factor || Real || Input || Full access || Link || PID|KImpRfact
|}

{{CntHdr|Configuring and using}}
Mostly the same as the basic template "[[#pidUnif|PID signal, unified, violation statuses]]" with the difference of using the impulse specific output: "Impulse output up", "Impulse output down", "Mode: analog", "T impulses period", "T minimal impulse", "Impulse rate factor".

== {{Anch|ComplexObject|Templates of the complex objects}} ==
In some cases where an object is only a part of a common automated system and does not require deep detailing to the level of signals and parameters (complex tag) around them, including without the need for archiving, it is convenient to unify them in one representative object of the data source OpenSCADA with appropriate consolidated view and object control as a set of simple attributes with violation elements. Such consolidation often occurs around specialised data sources, whose access to data is usually implemented through a separate exchanging protocol, but without unifying the transmission of this data to the level of visualisation and signalling by a separate attribute of the object.

In general, the representative structure of a complex object is:
* "All items ('''items''')" — common object-type attribute where the attributes of a physical object are directly described by object-type attributes in '''items''' and with defined descriptive attributes in each
** ''id'' — attribute identifier;
** ''descr'' — text description of the attribute;
** ''wr'' — a sign of the possibility of writing or a list of value variants to their selection, through the symbol ';';
** ''alarm'' — violation code:
*** 0 — no violation — "NORM";
*** 1 — violation level "WARNING";
*** 2 — violation level "ALARM";
** ''val'' — attribute value;
** ''set'' — attribute value to set the attributes accessible to write.
* "Error ('''err''')" — obligatory attribute of common violation status of the object in general, consist of the combination of the error code and short text description, like to "2:No data or connection with source". The template reserves next error codes:
** '''1''' — violation level "WARNING";
** '''2''' — violation level "ALARM";
** '''3''' — unreliability or lack of data.
* "Violations suppress ('''alSup''') and delay ('''alDelay''')" — violations generic control for suppressing and delaying.

Generally, it is advisable to create such template (a layer above the physical data source object) above a raw data source that provides this data in attributes and without processing, and this template therefore performs:
* collection of these attributes of the raw source into '''items''';
* processing of properties of the attributes;
* control and transmitting of commands of the values setting;
* processing of the violation conditions at single attributes and at the object in whole, together with which these violations can be fixed in [[Special:MyLanguage/Documents/Program_manual#ArchMess|the table of actual violations]], typically by the [[Special:MyLanguage/Documents/User_API#SYS.DAQ|alarmSet() function]].

In addition to complex object templates, this object-control mechanism can be implemented by templates for implementing [[Special:MyLanguage/Documents/DAQ#LogicLev|the logical level of data access]], such as in [[Special:MyLanguage/Libs/Devices#IEC60870|IEC60870]].

To represent the data of the object-control mechanism, there currently provided the appropriate [[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties frame]], which provides these properties as a table-list with illumination of the violations and the possibility to change the selected and accessible to edit row-properties.

{| class="wikitable"
<section begin=UPS />
| {{Anch|UPS|<h3>Uninterruptible Power Supply ([[Special:MyLanguage/Libs/Main#UPS|UPS]])</h3>}}
| 2.2 || GPLv2 || * || en, uk, ru <section end=UPS />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainUPSOp.png|right|Result and the operative setup.]]
Data combination of the Uninterruptible Power Supply in a complex object of the attribute "All items". The template initially designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/System|System]]" in the part "UPS" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties, signalling at single borders and writing.

Next the template was expanded by direct implementing UPS or Power Inverters which support is missing in [https://networkupstools.org/ NUT] (in ground of the part "UPS"), and such the first device became [https://www.mustpower.com/product/ep2100-pro-series-dc12v-300-1000w/ Must EP2100 PRO]. And for that there also was appended of custom definition the device's properties to place as DAQ-Attributes with the possibility of the description redefinition.

* '''Sponsored by:''' DIYA Ltd

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address
* "System.slow.prm_UPS" - for connecting to the [[Special:MyLanguage/Modules/System|DAQ.System]] parameter in the UPS part;
* "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30" - for connecting to serial port of the Must EP2100 PRO.
| String || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| defs || Elements definition
In form of lines - "{id}:{toAttr}:{descr}"
| Text || Output || Full access || Variable ||
|-
| bChL || Battery charge low || Real || Input || Full access || Variable || 20
|-
| bChLL || Battery charge critical || Real || Input || Full access || Variable || 5
|-
| inVL || Input voltage low || Real || Input || Full access || Variable || 210
|-
| inVH || Input voltage high || Real || Input || Full access || Variable || 250
|-
| inFLL || Input frequency too low || Real || Input || Full access || Variable || 40
|-
| inFL || Input frequency low || Real || Input || Full access || Variable || 45
|-
| inFH || Input frequency high || Real || Input || Full access || Variable || 55
|-
| inFHH || Input frequency too high || Real || Input || Full access || Variable || 60
|-
| loadH || Load high || Real || Input || Full access || Variable || 80
|-
| loadHH || Load too high || Real || Input || Full access || Variable || 100
|-
| tH || Temperature high || Real || Input || Full access || Variable || 50
|-
| tHH || Temperature too high || Real || Input || Full access || Variable || 70
|-
| hyst || Hysteresis of borders, % || Real || Input || Full access || Variable || 5
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainUPSCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Create a source controller object in the module DAQ.System and set its identifier like to "SYSData".
:2. [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] Create a source parameter object in the previous controller object and set its identifier like to "UPS".
:3. Create and start a [[Special:MyLanguage/Modules/LogicLev|Logical Controller Object]] or use any presented with the need scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|Logical Parameter Object]] and select the template for it. Enable the parameter.
:5. In the tab "Template configuration" of the Logical Parameter Object you need to set:
:* ''Source object's address'':
::* [ [[Special:MyLanguage/Modules/System|DAQ.System]] ] — to address of the source UPS parameter object (see to step 1) like to "System.SYSData.prm_UPS";
::* [ Must EP2100 PRO ] — to Serial address of connecting the device like to "Serial.ep21:/dev/ttyUSB0:9600:8N1||500:30".
:6. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''All items (items)'' this object with all the attributes and their properties. In the case of some violations, we will get the corresponding information in the attribute ''Error (err)'', for which you can adjust the attributes of the boundaries of the corresponding violations. To customize some item's description and to place some in DAQ-Attributes, you can edit "Elements definition (defs)" for ones. From the created DAQ-Attributes you can also control writable ones.
:7. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link its to the parameter object, created in step 4.
:8. RESULT: In the runtime of the page you'll get a table with data of the object, notifications about violations in the header and the possibility to set of writable properties.

{| class="wikitable"
<section begin=SNMP />
| {{Anch|SNMP|<h3>Network devices by SNMP ([[Special:MyLanguage/Libs/Main#SNMP|SNMP]])</h3>}}
| 1.1 || GPLv2 || * || en, uk, ru <section end=SNMP />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainSNMPOp.png|right|Result and the operative setup.]]
Data combination of a device, accessible by the protocol SNMP, in a complex object of the attribute "All items". The template designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/SNMP|SNMP]]" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties, signalling at single borders and writing. Considering the great specificity and variety of SNMP-accessible devices, this template is actually a billet and an example of creating a template based on it to a corresponding device with a specific to it processing of input properties, forming of violations and write capability.

* '''Sponsored by:''' PAC HARTRON

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address || String || Input || Not attribute || Constant ||
|-
| manTables || Manual tables || String || Input || Not attribute || Constant ||
|-
| alSup || Violations suppress || Boolean || Input || Full access || Variable ||
|-
| alDelay || Violations delay, seconds || Real || Input || Full access || Variable || 0
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String (translate) || Input || Not attribute || Variable ||
|-
| DESCR || Description || Text (translate) || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainSNMPCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a source controller object in the module "[[Special:MyLanguage/Modules/SNMP|SNMP]]" and set its identifier like to "SYSData".
:2. Create a source parameter object in the previous controller object and set its identifier like to "DEV".
:3. Create and start a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any presented one with the need scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select the template for it. Enable the parameter.
:5. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Source object's address'' — to address of the source SNMP device parameter object (see to step 1) like to "SNMP.SYSData.DEV".
:* ''Manual tables'' — enter manually some static MIB-variables.
:6. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''items'' this object with all the attributes and their properties. In case of some violations, we will get the corresponding information in the attribute of the parameter ''err'', for which you can adjust the attributes of the boundaries of the corresponding violations.
:7. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link it to the parameter object, created in step 4.
:8. RESULT: In runtime of the page you get a table with data of the object, notifications about violations in the header and the possibility to set of writable properties.

{| class="wikitable"
<section begin=DiskSMART />
| {{Anch|DiskSMART|<h3>Disk SMART ([[Special:MyLanguage/Libs/Main#DiskSMART|DiskSMART]])</h3>}}
| 1.1 || GPLv2 || * || en, uk <section end=DiskSMART />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainDiskSMARTOp.png|right|Result and the operative setup.]]
Data combination of the disk SMART in a complex object of the attribute "All items". The template designed to use together with the DAQ-module "[[Special:MyLanguage/Modules/System|System]]" in the part "Disk SMART" and to represent this data by the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" as a complex object with properties and signalling at common errors. Some SMART attributes can be unknown or wrong for specified disk due to their missing in the disks DB, especially for modern SSD, so the template provides a feature to redefine names the attributes.

Complex postprocessing and complete generation-imitation of the SMART fields with separate attributes on the internal programming language of OpenSCADA into the configuration IO '''inProc''' (with appending the builtin syntax highlight rules), where you can operate next service parameters:
:* ''alLev'', ''tErr'' [IN|OUT] — alarm level [-79...0] and text of the error (the attribute "err" format);
:* ''f_frq'' [IN] — frequency of calculation, the template IO;
:* ''this'' [IN] — reference to the parameter object, what executing the template;
:* ''ctx'' [IN] — object of the user context, what saved between the execution cycles;
:* ''args'' [IN] — object of arguments of the procedure;
:* ''items'' [IN|OUT] — object of items of the SMART.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Parameter !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| srcAddr || Source object's address || String || Input || Not attribute || Constant ||
|-
| inProc || Input processing procedure || Text || Input || Not attribute || Constant ||
|-
| items || All items || Object || Output || Full access || Variable ||
|-
| defs || Item definitions || Text || Input || Full access || Variable ||
<pre>161:Number of Valid Spare Blocks (161)
162:Uncorrectable Sector Count (162)
163:Number of Initial Invalid Blocks (163)
164:Total Erase Count (164)
165:Block Erase Count (165)
166:Minimum PE Cycles TLC (166)
167:Max Bad Blocks per Die (167)
168:Maximum PE Cycles TLC (168)
168:Max Erase Count of Spec (168)
168:SATA PHY error count (168)
169:Total Bad Blocks (169)
169:Remain Life (169)
170:Grown Bad Blocks (170)
170:Bad Block Count (170)
171:Program Fail Count (171)
172:Erase Fail Count (172)
173:Average PE Cycles TLC (173)
173:Max Erase Count (173)
174:Unexpected Power Loss (174)
184:End-to-End Error (184)
187:Reported Uncorrect (187)
188:Command Timeout (188)
218:CRC Error Count (218)
230:Media Wearout Indicator (230)
231:SSD Life Left (231)
233:NAND GB Written TLC (233)
234:NAND GB Written SLC (234)
241:Host Writes GB (241)
242:Host Reads GiB (242)
244:Temp Throttle Status (244)
245:Flash Write Sector Count (245)</pre>
|-
| this || The object || Object || Input || Not attribute || Variable ||
|-
| SHIFR || Code || String || Input || Not attribute || Variable ||
|-
| NAME || Name || String || Input || Not attribute || Variable ||
|-
| DESCR || Description || String || Input || Not attribute || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainDiskSMARTCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a source controller object in the module "[[Special:MyLanguage/Modules/System|System]]" and set its identifier like to "SYSData", set the property "Auto create active data sources" to "All sources" and start by setting "Running".
:2. Create and start a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any presented one with the need scheduling properties.
:3. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select the template for it. Enable the parameter.
:4. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Source object's address'' — to address of the source disk SMART parameter object like to "System.SYSData.DiskSMARTsda".
:* ''Input processing procedure'' — form for the complex preprocessing and complete generation of the SMART fields with separate attributes on the internal programming language of OpenSCADA.
:5. RESULT: When running the controller object (where this parameter was created) and if it was not started, we must obtain in the parameter attribute ''items'' this object with all the attributes and their properties. In case of some violations, we will get the corresponding information in the attribute of the parameter ''err''.
:6. In the visual interfaces developing of the module [[Special:MyLanguage/Modules/Vision|Vision]] place the frame "[[Special:MyLanguage/Libs/Main_graphical_elements#objProps|Object properties]]" to any page and link it to the parameter object, created in step 3.
:7. RESULT: In runtime of the page you get a table with data of the object, notifications about violations in the header and the possibility to redefine names of the SMART attributes.

== Services ==
{| class="wikitable"
<section begin=ntf />
| {{Anch|ntf|<h3>Notificator by SMS, EMail-SMTP ([[Special:MyLanguage/Libs/Main#ntf|ntf]])</h3>}} || 1.0 || GPLv2 || * => [[Special:MyLanguage/Modules/UserProtocol|UserProtocol]] || en, uk, ru <section end=ntf />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainNtfOp.png|right|Result and the operative setup.]]
The complex template of the notification contains of parts of the dispatcher and the output user protocol of notification by EMail(SMTP) and SMS.

* '''Total complexity:''' > 1.05 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for initial implementation the SMS-send part on 0.2 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' [[Special:MyLanguage/Using/HouseSpirit|Oleg Sidashov]]
* '''Sponsored by, for unification, appending SMTP and the notification controller on 0.65 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}:''' SVItoVYR Ltd

'''THE DISPATCHER''' can be performed for pointed messages of the message buffer of OpenSCADA and applied on [[Special:MyLanguage/Documents/DAQ#LogicLev|the Logical level]] or the controller object of [[Special:MyLanguage/Modules/JavaLikeCalc|the module JavaLikeCalc]].

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| io || UserPrt: Output IO || Object || Input || Not attribute || Variable ||
|-
| tr || UserPrt: Transport || Object || Input || Not attribute || Variable ||
|-
| tmOut || Maximum notification timeout, seconds || Integer || Input || Not attribute || Constant || 5
|-
| messLev || Messages level, negative for alarms || Integer || Input || Not attribute || Constant || 1
|-
| messCat || Messages category, template or regular expression || String || Input || Not attribute || Constant || al*:*
|-
| messCatExcl || Message exclusion category, in regular expression || String || Input || Not attribute || Constant ||
|-
| emailState || Email notification current state || String || Output || Read only || Variable ||
|-
| emailTrAddr || Output transport for SMTP connection, empty for disable || String || Input || Not attribute || Constant || Sockets.out_SMTP
|-
| emailAuth || Auth, empty for disable || String || Input || Not attribute || Constant || user:pass
|-
| emailSender || Sender || String || Input || Not attribute || Constant || noreply@oscada.org
|-
| emailReceiver || Destination receiver address || String || Input || Not attribute || Constant || test@oscada.org
|-
| emailTopic || EMail topic || String || Input || Not attribute || Constant || Notification
|-
| emailMess || EMail message || String || Input || Not attribute || Constant ||
|-
| SMSState || SMS notification current state || String || Output || Read only || Variable ||
|-
| SMSTrAddr || SMS serial transport, empty for disable || String || Input || Not attribute || Constant || Serial.out_SMS
|-
| SMSPin || SMS-pin, empty for disable || String || Input || Not attribute || Constant || 1111
|-
| SMSTel || SMS destination receiver, tel. number || String || Input || Not attribute || Constant || +380XXXXXXXXX
|-
| SMSTextMd || SMS in the text mode, else PDU || Boolean || Input || Not attribute || Constant || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainNtfCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a parameter in a controller object of [[Special:MyLanguage/Documents/DAQ#LogicLev|the Logical Level]] or a controller object in [[Special:MyLanguage/Modules/JavaLikeCalc|the module DAQ.JavaLikeCalc]].
:2. Create an output transport of the type "[[Special:MyLanguage/Modules/Serial|Serial]]" and set its Identifier like to "SMS", one transport suitable for more receivers.
:3. Set for proper address, only for the [[Special:MyLanguage/Modules/Serial|Serial]] device. The serial port speed, asynchronous data format and timeouts will adjusted by the function.
:4. Create an output transport of the type "[[Special:MyLanguage/Modules/Sockets|Sockets]]" or "[[Special:MyLanguage/Modules/SSL|SSL]]" and set its Identifier like to "SMTP", one transport suitable for more receivers.
:5. Set-up for proper address, for Sockets(25) or SSL(465). The transport timeouts will be adjusted by the function.
:6. In the tab "Template configuration" you need to set:
:* Maximum notification timeout, seconds.
:* Messages level, negative for alarms.
:* Messages category, template or regular expression.
:* Message exclusion category, in regular expression.
:* Output transport for SMTP connection, empty for disable.
:* Auth, empty for disable.
:* Sender.
:* Destination receiver address.
:* EMail topic.
:* EMail message.
:* SMS serial transport, empty for disable.
:* SMS-pin, empty for disable.
:* SMS destination receiver, tel. number.
:* SMS in the text mode, else PDU.
:7. RESULT: Sending for the pointed messages at SMS or EMail(SMTP).

'''THE OUTPUT USER PROTOCOL PART "SMS"''' provides operations with SMS by a GSM-modem connected as serial device. For now, there supported only sending SMS messages to a number of remote cell phone or GSM-modem. For sending there are supported: ECHO disable, PIN check and set, sending in PDU and the Text mode.<br/>

{{CntHdr|Output user protocol's XML-request structure}}
'''<cmd pin="1111" tel="+380XXXXXXXXX" text="{0|1}" err="1:Error">{SMSText}</cmd>'''
:''cmd'' — command, for now only "send" allowed;
:''pin'' — PIN-code to the SIM-card access;
:''tel'' — telephone number of the receiver (remote cell phone or GSM-modem);
:''text{0,1}'' — SMS in the text mode, only ASCII;
:''SMSText'' — the message text;
:''err'' — sets for the request result.

{{CntHdr|Configuring and using}}
:1. Create an output transport of the type "[[Special:MyLanguage/Modules/Serial|Serial]]" and set its Identifier like to "SMS", one transport suitable for more receivers.
:2. Set for proper address. The serial port speed, asynchronous data format and timeouts will adjusted by the function.
:3. Create of need [[Special:MyLanguage/Modules/UserProtocol|user protocol object]] based on the templates, with Identifier like to "SMS".
:4. Place some requesting commands directly into presented or a new internal OpenSCADA-procedure like to:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send"); req.setAttr("ProtIt","SMS").setAttr("pin","1111").setAttr("tel","+380XXXXXXXXX").setText("Notify message");
SYS.Transport.Serial.out_SMS.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. RESULT: In the variable ''rez'' you will get "OK" if no errors occur and the message successfully transmitted to the receiver.

'''THE OUTPUT USER PROTOCOL PART "SMTP"''' provides operations with a SMTP-server for delivering EMails by their sending through TCP-Socket or SSL. For now, there are supported: TCP, SSL, AUTH, topic encoding for UTF-8.<br/>

{{CntHdr|Output user protocol's XML request structure}}
'''<send auth="{user}:{pass}" from="{FromAddr}" to="{ToAddr}" topic="{My Topic}" err="1:Error">{MessageText}</send>'''
:''topic'' — topic of the message;
:''from'' — sender address;
:''to'' — destination address of the receiver;
:''auth'' — authenticate user and password;
:''MessageText'' — text of the message;
:''err'' — sets for the request result.

{{CntHdr|Configuring and using}}
:1. Create an output transport of the type "[[Special:MyLanguage/Modules/Sockets|Sockets]]" or "[[Special:MyLanguage/Modules/SSL|SSL]]" and set its Identifier like to "SMTP", one transport suitable for more receivers.
:2. Set-up for proper address, for Sockets(25) or SSL(465). The transport timeouts will be adjusted by the function.
:3. Create of need [[Special:MyLanguage/Modules/UserProtocol|user protocol object]] based on the templates, with Identifier like to "SMTP".
:4. Place some requesting commands directly into allowed or a new internal OpenSCADA procedure like to:
<syntaxhighlight lang="JavaScript" style="margin-left: 30pt">
req = SYS.XMLNode("send");
req.setAttr("ProtIt","SMTP").setAttr("from","noreply@oscada.org").setAttr("to","oscada@oscada.org").setAttr("topic","My topic").setText("My message");
SYS.Transport.Sockets.out_SMTP.messIO(req, "UserProtocol");
rez = req.attr("err").toInt() ? req.attr("err") : "OK";
</syntaxhighlight>
:5. RESULT: In the variable ''rez'' you will get "OK" if no errors occur and the message successfully transmitted to the receiver.

{| class="wikitable"
<section begin=initRemCntr />
| {{Anch|initRemCntr|<h3>Control the remote initiative connections ([[Special:MyLanguage/Libs/Main#initRemCntr|initRemCntr]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=initRemCntr />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainInitRemCntrOp.png|right|Result and the operative setup.]]
The template of processing input initiative connections expands early one template [[#initConAssociateTrs|initiative connections processing for the associated output transports]] by complete representing data of the remote OpenSCADA hosts on some aggregation server and with a possibility of control the remote hosts through the server, that is finishing the [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|conception of data acquisition in the passive mode and the initiative connection]].

The template does in whole:
* detecting a new connection from remote host, which has no ID;
* sending an acquaintance direct request to the established connection for getting KEY of the host, when it was already connected early, and for getting information about the host for creating ID of the host;
* setting ID for the connection;
* creating a record in the [[Special:MyLanguage/Documents/Program_manual#Transports|OpenSCADA hosts table]] for the connection and sending all followed requests already through the host;
* creating on the remote host a representative [[Special:MyLanguage/Modules/LogicLev|Logical Controller]];
* creating on the remote host a representative [[Special:MyLanguage/Modules/System|DAQ.System Controller Object]] in the automatic mode, at missing any other there;
* processing the present DAQ.System Controller Objects to link the Logical Level parameters to them and creating some processing logical parameters, with updating for all sources at any reconnection and checking for removing ones without sources already;
* writing the generated key by a line "'''SrcKey: {KEY}'''" to description of the Logical Controller as a sign of finalizing the initialization;
* creating a Controller Object in [[Special:MyLanguage/Modules/DAQGate|DAQ.DAQGate]] with connection to the remote Logical Controller and syncing its per 10 minutes for appending new sources and removing missing ones.

ID of the remote host is formed in the view "'''{HostDomain}{StatName}{RandKey}'''" and with limiting to 20 symbols, where:
* ''HostDomain'' — network host name-domain;
* ''StatName'' — station name of the OpenSCADA project;
* ''RandKey'' — random key in two HEX-digits.

Data model of the representative Logical Controller can contain both the generated links with processing parameters, and custom parameters, when the user is decided to publish some extra data. The generated items from DAQ.System are represents sources currently:
* "CPU", "MEM", "sensors", "Power", "uptime" => links in the "System (SYS)" container parameter;
* "fs", "hddstat", "hddsmart" => links in the "Disk (DISK)" container parameter with a processing one for "hddsmart" by the template [[Special:MyLanguage/Libs/Main#DiskSMART|base.DiskSMART]];
* "netstat" => links in the "Network (NET)" container parameter;
* "ups" => links in the root with a processing one by the template [[Special:MyLanguage/Libs/Main#UPS|base.UPS]].

The aggregated data in [[Special:MyLanguage/Modules/DAQGate|DAQ.GAQGate]] can be lifted to up, or used in derivative DAQ objects, or whether directly on custom frames, or in future on a Dynamic Frame, which scheduled to implement; and without any additional action you will get notification about violations on the hosts.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inTransport || Input transport || String || Input || Not attribute || Constant || Sockets.InitRemCntr
|-
| conTm || Connection time, ms || Integer || Input || Not attribute || Constant || 5000
|-
| accessTm || Timeout of accessing, hours
Used for repeating to create representative objects of not accessed hosts and for removing old connections.<br/>
Zero or negative value for disabling the control!
| Integer || Input || Not attribute || Constant || 24
|-
| cntrUser || Access: user || String || Input || Not attribute || Constant || root
|-
| cntrPass || Access: password || String || Input || Not attribute || Constant || openscada
|-
| cntrObj || Control object in DAQ.LogicLev and DAQ.System || String || Input || Not attribute || Constant || RemCntr
|-
| prcTr || Processed connections || Text || Output || Read only || Variable ||
|-
| this || Object || Object || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|}

[[File:LibsMainInitRemCntrCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create an input transport of receiving the initiative connections of the module "[[Special:MyLanguage/Modules/Sockets#InTr|Sockets]]" or "[[Special:MyLanguage/Modules/SSL#InTr|SSL]]" with the name like to "Sockets.InitRemCntr".
:2. Set the previously created transport to the need address of opening the input socket and move it to the mode of creating the associative output transports, leaving the protocol field in empty.
:3. For this template create and run a logical controller object or use any available with the required scheduling properties.
:4. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:5. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input transport'' — to value of the identifier of the input transport, created in the item 1, like to "Sockets.InitRemCntr";
:* ''Connection time'' — timeout of connection to the initiative hosts after that to close the connection;
:* ''Timeout of accessing'' — used for repeating to create representative objects of not accessed hosts and for removing old connections; zero or negative value for disabling the control;
:* ''Access: user and password'' — user and password of the remote host with permition of creation there Logical Controller and DAQ.System Controller Object, that is the user must be included to the "DAQ" group;
:* ''Control object in DAQ.LogicLev and DAQ.System'' — to ID of managed-created Controller Objects on the remote hosts.
:6. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get checking the specifying input transport for initiative connections and their initialisation in described above way and with notification processed connection in the attribute "Processed connections".

{| class="wikitable"
<section begin=initConAssociateTrs />
| {{Anch|initConAssociateTrs|<h3>Initiative connections processing for the associated output transports ([[Special:MyLanguage/Libs/Main#initConAssociateTrs|initConAssociateTrs]])</h3>}}
| 1.2 || GPLv2 || * || en, uk, ru <section end=initConAssociateTrs />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainInitConsAssignTrsOp.png|right|Result and the operative setup.]]
The template of processing input initiative connections was created to provide the last link of implementation and support for [[Special:MyLanguage/Documents/DAQ#PassiveAndInitiative|conception of data acquisition in the passive mode and the initiative connection]], that is — the control of associative connections, created by the input transport at each connection.

[[file:at.png]] After implementation this control together the new common-unified output transport connection function [[Special:MyLanguage/Documents/User_API#SYSTransport|outAt()]] that template became deprecated for sources adapted to use the new mechanism, but you still can use the template for not adapted sources.

The function of creation associated output transports at connections is currently only supported by [[Special:MyLanguage/Modules/Sockets|the module "Sockets"]] and for TCP-sockets.

* '''Total complexity:''' 0.9 {{CtxDetails|HD|human-days, 1 HD — 10 hours}}
* '''Sponsored by, for whole complexity:''' Elyor Turaboev, BLUE STAR GROUP Ltd

The control of associated transport means:
* obtaining a list of the associated transports, by the function ''assignTrsList()'' of the input transports;
* reading from new transports (opened) of identification information, which currently represents only the source object identifier;
** search, by the received identifier, the source object and assigning to it of this transport;
** registering in the attribute "prcTr" of the object type.
* checking of existing transports for their closure (detachment), for which performed the deregistration in the attribute "prcTr" of the object type and the establishment of the source object in the empty value; disconnected output associated transports are reused by the input one upon receiving a new connection then it is switched on.

The template can control the containers of data source objects, constructed both as DAQ-objects of the controllers and logical level parameters, what representing the data source and having a transport address definition field, and what generally defined by the configuration field "srcObjPath" of the format '''{CntrAddr}:{TrCntrFldAddr}''', where:
* ''CntrAddr'' — container address, for example: "ModBus" — for DAQ-objects of the controllers, "LogicLev.CntrPLC" — for logical level parameters;
* ''TrCntrFldAddr'' — address of the transport control field in the source object, for example — "%2fcntr%2fcfg%2fADDR" for "ModBus"; what can be obtained in a configurator at the history of pointing on the control field in the status line.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| inTransport || Input transport || String || Input || Not attribute || Constant || InitiateCons
|-
| outTrTm || Output transport timeouts || String || Input || Not attribute || Constant || 10:0.1
|-
| srcObjPath || Source object path || String || Input || Not attribute || Constant || ModBus:%2fcntr%2fcfg%2fADDR
|-
| prcTr || Processed transports || Object || Output || Read only || Variable ||
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|}

[[File:LibsMainInitConsAssignTrsCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create an input transport of receiving the initiative connections of [[Special:MyLanguage/Modules/Sockets#InTr|the module "Sockets"]] with the name like to "InitiateCons".
:2. Set the previously created transport to the need address of opening the input socket and move it to the mode of creating the associative output transports, leaving the protocol field in empty.
:3. Provide a container of the data sources to which associative transports must be connected, which can be either a DAQ-module (such as "DAQ.ModBus"), or a logical controller (such as "DAQ.LogicLev.Sources"), or a parameter in it (such as "DAQ.LogicLev.PLC.Sources"), with logical level parameters representing the data source.
:4. For this template create and run a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any available with the required scheduling properties.
:5. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:6. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Input transport'' — to value of the identifier of the input transport, created in the item 1, like to "InitiateCons";
:* ''Output transport timeouts'' — increase the first digit for very slow connections and typical is normal in most situations
:* ''Source objects path'' — set according to the item 3, for the first part, and to the control field path, for the second part, for example, and typically for for "ModBus", is — "ModBus:%2fcntr%2fcfg%2fADDR".
:6. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get, in the attribute ''prcTr'' of the parameter for information about the processed and therefore successfully transport-linked data sources. In case of some violations, we will get the corresponding information in the attribute ''err'' of the parameter. The absence of a representative object for the received identifier is placed in the protocol of messages.

{| class="wikitable"
<section begin=weather />
| {{Anch|weather|<h3>Weather ([[Special:MyLanguage/Libs/Main#weather|weather]])</h3>}}
| 1.0 || GPLv2 || * || en, uk <section end=weather />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
[[File:LibsMainWeatherOp.png|right|Result and the operative setup.]]
The template of acquiring weather data from different weather services in Internet and initially it is only [https://openweathermap.org/ Open Weather].

The weather data divided on current and forecast with their placing in corresponded objects, where current attributes placed directly in the root and forecast days (the "day" object) and times (the "time" object) inwardly corresponded day according to the current timezone. These data acquired at specified schedule independently for current and forecast, and by default the current ones are performed per hour when forecast ones per day. The data can be accessible by user both as directly and through a specially created widget of the [[Special:MyLanguage/Libs/Main_graphical_elements#weather|main library]].

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| schedCur || Scheduling at CRON of current update || String || Input || Not attribute || Constant || 0 8-20 * * *
|-
| schedFC || Scheduling at CRON of forecast update || String || Input || Not attribute || Constant || 0 8 * * *
|-
| city || City ID || String || Input || Full access || Variable || 709932
|-
| current || Current || Object || Input || Read only || Variable ||
|-
| forecast || Forecast || Object || Input || Read only || Variable ||
|-
| this || Parameter || Object || Input || Not attribute || Variable || 0
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz || Real || Input || Not attribute || Variable || 1000
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|}

[[File:LibsMainWeatherCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. For this template create and run a [[Special:MyLanguage/Modules/LogicLev|logical controller object]] or use any available with the required scheduling properties.
:2. Create a [[Special:MyLanguage/Modules/LogicLev|logical parameter object]] and select this template for it. Enable the parameter.
:3. In the tab "Template configuration" of the logical parameter object you need to set:
:* ''Scheduling at CRON of current update'' — to value of need scheduling for current data acquiring in the [[Special:MyLanguage/Documents/User_API#CRON|CRON format]], at empty the acquiring will be performed with period of execution the controller object;
:* ''Scheduling at CRON of forecast update'' — to value of need scheduling for forecast data acquiring in the [[Special:MyLanguage/Documents/User_API#CRON|CRON format]], at empty the acquiring will be performed with period of execution the controller object.
:4. RESULT: Starting the controller object (where this parameter was created) and when it was not started, we should get the weather data in the attribute ''Current (current)'' and ''Forecast (forecast)'' and after setting your city code in the corresponded attribute. City code you can obtain from the [https://openweathermap.org/ official site] in the URL after searching your city in the site form.

== [[Special:MyLanguage/Modules/WebUser|For WebUser]] ==
{| class="wikitable"
<section begin=fileServerHTTP />
| {{Anch|fileServerHTTP|<h3>WebUser: HTTP File Server ([[Special:MyLanguage/Libs/Main#fileServerHTTP|fileServerHTTP]])</h3>}}
| 1.2 || GPLv2 || * || en, uk <section end=fileServerHTTP />
| [[User:RomanSavochenko|Roman Savochenko]]
|}
The template for implementing a HTTP File Server directly in OpenSCADA, which is suitable one at missing a full-featured one for functions of servicing file requests from OpenSCADA Web-interfaces.

Currently there implemented only requesting files by the GET request of HTTP. There are supported also chunks and the Partial Content requests in single range and with forcing to this mode at some configured file size.

{{CntHdr|Template IOs}}
{| class="wikitable"
|-
! Identifier !! Name !! Type !! Mode !! Attribute !! Configuration !! Value
|-
| rez || Result || String || Input || Not attribute || Variable || 200 OK
|-
| HTTPreq || HTTP request || String || Input || Not attribute || Variable ||
|-
| url || URL || String || Input || Not attribute || Variable ||
|-
| sender || Sender || String || Input || Not attribute || Variable ||
|-
| page || WWW-page || String || Output || Not attribute || Variable ||
|-
| HTTPvars || HTTP variables || Object || Output || Not attribute || Variable ||
|-
| baseD || Base directory || String || Input || Not attribute || Constant || /data/share_res/local/Lib/
|-
| fSzSolidLim || File size limit for solid reading, else enables the partial content || Real || Input || Not attribute || Constant || 10e6
|-
| tr || Transport || Object || Output || Not attribute || Variable ||
|-
| prt || Protocol || Object || Output || Not attribute || Variable ||
|-
| f_start || Function start flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_frq || Frequency of calculation of the function, Hz Real || Input || Not attribute || Variable || 1000
|-
| f_stop || Function stop flag || Boolean || Input || Not attribute || Variable || 0
|-
| f_err || Function error || String || Input || Not attribute || Variable || 0
|}

[[File:LibsMainFileServerHTTPCfg.png|right|Configuration.]]
{{CntHdr|Configuring and using}}
:1. Create a page in the [[Special:MyLanguage/Modules/WebUser|UI.WebUser]] module with some reasonable ''PageId''.
:2. In the tab "Procedure" you need to set:
:* Base directory from which the page'll search files.
:* File size limit for solid reading, else enables the partial content.
:3. RESULT: Opening URL "<nowiki>http://{OpenSCADAHost}/WebUser/{PageId}/{MyFile}</nowiki>" in a WebBrowser will open and send you file on FS "{baseD}/{MyFile}".