OpenSCADAWiki: Doc/VCA Engine
 
English (1 Kb) English
Ukrainian (1 Kb) Українська

 (2 Kb) Страница заморожена, актуальная тут.

Модуль "VCAEngine" подсистемы "Пользовательские интерфейсы"

Модуль: VCAEngine
Имя: Движок среды визуализации и управления
Тип: Пользовательские интерфейсы
Источник: ui_VCAEngine.so
Версия: 4.1
Автор: Роман Савоченко
Описание: Основной движок среды визуализации и управления.
Лицензия: GPL

Contents

Введение

Модуль VCAEngine предоставляет движок среды визуализации и управления (СВУ) в систему OpenSCADA. Сам модуль не реализует визуализации СВУ, а содержит данные в соответствии с идеологией "Модель/данные – Интерфейс". Визуализация данных этого модуля выполняется модулями визуализации СВУ, например, модулем Vision и WebVision.

Среда визуализации и управления (СВУ) является неотъемлемой составляющей SCADA системы. Она применяется на клиентских станциях с целью доступного предоставления информации об объекте управления и выдачи управляющих воздействий на объект. В различных практических ситуациях и условиях могут применяться СВУ, построенные на различных принципах визуализации. Например, это могут быть библиотеки виджетов Qt, GTK+, wxWidgets или гипертекстовые механизмы на основе технологий HTML, XHTML, XML, CSS и JavaScript или сторонние приложения визуализации, реализованные на различных языках программирования Java, Python и т.д. Любой из этих принципов имеет свои преимущества и недостатки, комбинация которых может стать непреодолимым препятствием в возможности использования СВУ в том или ином практическом случае. Например, технологии вроде библиотеки Qt позволяют создавать высокореактивные СВУ, что несомненно важно для станций оператора управления технологическим процессом (ТП). Однако, необходимость инсталляции данного клиентского ПО в отдельных случаях может сделать использование его невозможным. С другой стороны, Web-технологии не требуют инсталляции на клиентские системы и являются предельно многоплатформенными (достаточно создать ссылку на Web-сервер в любом Web-браузере), что наиболее важно для различных инженерных и административных станций, но реактивность и надёжность таких интерфейсов ниже, что практически исключает их использования на станциях оператора ТП.

Система OpenSCADA имеет предельно гибкую архитектуру, которая позволяет создавать внешние интерфейсы, в том числе и пользовательские, на любой основе и на любой вкус. Например, среда конфигурации системы OpenSCADA доступна как на Qt библиотеке, так и на Web-основе.

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

1. Назначение

Данный модуль движка(модели данных) СВУ предназначен для формирования логической структуры СВУ и исполнения сеансов отдельных экземпляров проектов СВУ. Также модуль предоставляет все необходимые данные конечным визуализаторам СВУ как посредством локальных механизмов взаимодействия OpenSCADA, так и посредством интерфейса управления OpenSCADA для удалённого доступа.

Финальная версия этого модуля СВУ обеспечит:

2. Конфигурация и формирование интерфейсов СВУ

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

Хотя визуальных механизмов формирования СВУ модулем не предоставляется, для управления логической структурой предоставляется механизм, реализованный на основе интерфейса управления OpenSCADA, а значит доступный для использования в любом конфигураторе системы OpenSCADA. Диалоги этого интерфейса рассмотрены далее в контексте рассмотрения архитектуры модуля и его данных.

3. Архитектура


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


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


Кадры и пользовательские элементы размещаются в библиотеках виджетов. Из элементов этих библиотек формируются проекты интерфейсов конечной визуализации СВУ. На основе же этих проектов формируются сеансы визуализации.


Описанная структура СВУ приведена на рисунке.


Структура СВУ (252 Kb)

Данная архитектура СВУ позволяет реализовать поддержку трёх уровней сложности процесса разработки интерфейсов управления:


3.1. Кадры и элементы отображения (виджеты)

Кадр это окно, непосредственно предоставляющее информацию пользователю в графической и/или текстовой форме. Группа взаимосвязанных кадров формирует цельный пользовательский интерфейс ВУ.


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


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


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


Производные кадры/виджеты могут содержать другие виджеты(вложенные), которые могут быть склеены(связаны) логикой один с другим с помощью одного из языков пользовательского программирования, доступного в системе OpenSCADA.


Пример структуры производного виджета. (176 Кб)

Виджет является элементом, посредством которого обеспечивается:


Настройка и связывание виджетов производится посредством их свойств. Родительский виджет и виджеты содержащиеся в нем могут дополняться пользовательскими свойствами. В последствии пользовательские и статические атрибуты связываются со свойствами вложенных виджетов посредством внутренней логики. Для отображения динамики (т.е. текущих и архивных данных) свойства виджетов динамизируются, т.е связываются с атрибутами параметров OpenSCADA или свойствами других виджетов. Использование для связывания вложенных виджетов внутренней логикой доступных языков пользовательского программирования системы OpenSCADA снимает вопрос реализации сложной логики визуализации, обеспечивая тем самым высокую гибкость. Практически можно создавать полностью динамизированные кадры со сложными взаимосвязями на уровне пользователя.


3.2. Проект

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


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


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


Пример иерархического представления компонентов проекта классического интерфейса ВУ технологического процесса с описанием выражений стандартных вызовов приведен на рисунке.


Иерархическое представления компонентов проекта классического интерфейса ВУ технологического процесса. (40 Кб)

Предусмотрены следующие специальные свойства страниц:


На комбинациях указанных специальных свойств страниц реализованы следующие их типы:


На стороне визуализации (RunTime), на следующих атрибутах базового элемента "Box", построена логика, регулирующая каким образом открывать страницы:


Логика определения способа открытия страниц работает следующим образом:


3.3. Сеанс исполнения проекта

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


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


Карта «использующего» наследования компонентов концепции/движка (225 Кб)

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


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


Объекты сеанса проекта наследуются от абстрактного объекта "Widget" и используют соответствующие объекты проекта. Так, сеанс ("Session") использует проект ("Project") и формирует развёрнутое дерево на основе него. Страница проекта "Page" прямо используется страницей сессии "SessPage". Остальные объекты ("SessWdg") разворачиваются в соответствии с иерархией элементов страницы.


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


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


Сеансы, на уровне интерфейса управления OpenSCADA, поддерживают многоязычность, которая зависит от значения общих атрибутов "lang" и далее "user", и которые визуализатор может устанавливать в соответствии со своим языком. Эта функция включается динамическим переводом сообщений OpenSCADA.


3.4. Стили

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


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


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


Для реализации этой возможности, при создании кадров, необходимо для свойств цвета, шрифта и других установить параметр "Конфигурация" (таблицы во вкладке "Обработка") в значение "Из стиля". А в параметре "Конфигурационный шаблон" указать идентификатор поля стиля. Далее это поле автоматически появится в менеджере стилей и его можно будет там менять. Менеджер стилей доступен на странице конфигурации проекта во вкладке "Стили". На этой вкладке можно создавать новые стили, удалять старые, изменять поля стиля и удалять ненужные.


Вкладка "Стили" страницы конфигурации проекта. (82 Кб)
Рисунок. Вкладка "Стили" страницы конфигурации проекта.

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


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


3.5. События, их обработка и карты событий

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


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


Активная карта событий указывается в профиле каждого пользователя или устанавливается по умолчанию (в планах).


В целом предусмотрены четыре типа событий:


Само событие представляет недостаточно информации, особенно если его обработка происходит на уровнях выше. Для однозначной идентификации события и его источника, событие в целом записывается следующим образом: "ws_BtPress:/curtime". Где:

ws_BtPress — событие;
/curtime — путь к дочернему элементу, сгенерировавшего событие.

В таблице 3.5 приведён перечень стандартных событий, поддержка которых должна быть обеспечена в визуализаторах СВУ.


Таблица 3.5. Стандартные события

Id Описание
Клавиатурные события: key_[pres|rels][Ctrl|Alt|Shift]{Key}
*SC#3b Скан-код клавиши.
*#2cd5 Код неименованной клавиши.
*Esc "Esc".
*BackSpace Удаления предыдущего символа — "<-".
*Return, *Enter Ввод — "Enter".
*Insert Вставка — "Insert".
*Delete Удаление — "Delete".
*Pause Пауза — "Pause".
*Print Печать экрана — "Print Screen".
*Home Дом — "Home".
*End Конец — "End".
*Left Влево — "<-".
*Up Вверх — '^'.
*Right Вправо — "->".
*Down Вниз — '\/'.
*PageUp Страницы вверх — "PageUp".
*PageDown Страницы вниз — "PageDown".
*F1 ... *F35 Функциональная клавиша от "F1" до "F35".
*Space Пробел — ' '.
*Apostrophe Апостроф — '`'.
*Asterisk Звёздочка на дополнительном поле клавиатуры — '*'.
*Plus Плюс на дополнительном поле клавиатуры — '+'.
*Comma Запятая — ','.
*Minus Минус — '-'.
*Period Точка — '.'.
*Slash Наклонная черта — '\'.
*0 ... *9 Цифра от '0' до '9'.
*Semicolon Точка с запятой — ';'.
*Equal Равно — '='.
*A ... *Z Клавиши букв латинского алфавита от 'A' до 'Z'.
*BracketLeft Левая квадратная скобка — '['.
*BackSlash Обратная наклонная линия — '/'.
*BracketRight Правая квадратная скобка — ']'.
*QuoteLeft Левая кавычка — '''.
События клавиатурного фокуса.
ws_FocusIn Фокус получен виджетом.
ws_FocusOut Фокус утерян виджетом.
Мышиные события:
key_mouse[Pres|Rels][Left|Right|Midle] Нажата/отпущена кнопка мыши.
key_mouseDblClick Двойное нажатие левой кнопки мыши.
События квитирования на стороне визуализатора.
ws_alarmLev Квитирование всех нарушений всеми способами и типами уведомления.
ws_alarmNtf{N} Квитирование всех нарушений уведомления типа {N} (0...7).
События примитива элементарной фигуры ElFigure:
ws_Fig[Left|Right|Midle|DblClick] Активация фигур (заливок) клавишей мыши.
ws_Fig{N}[Left|Right|Midle|DblClick] Активация фигуры (заливки) N клавишей мыши.
События примитива элементов формы FormEl:
ws_LnAccept Установлено новое значение в строке ввода.
ws_TxtAccept Изменено значение редактора текста.
ws_ChkChange Состояние флажка изменено.
ws_BtPress Кнопка нажата.
ws_BtRelease Кнопка отпущена.
ws_BtToggleChange Изменена вдавленность кнопки.
ws_BtMenu={Item} Выбор элемента меню по кнопке Item.
ws_BtLoad Выбранный файл загружен.
ws_CombChange Изменено значение поля выбора.
ws_ListChange Изменен текущий элемент списка.
ws_TreeChange Изменен текущий элемент дерева.
ws_TableChangeSel Изменён выбор элемента таблицы.
ws_TableEdit_{colN}_{rowN} Отредактирована ячейка таблицы ({colN}:{rowN}).
ws_SliderChange Изменение положения слайдера.
События примитива медиа-контента Media:
ws_MapAct{N}[Left|Right|Midle] Активирована медиа-область с номером N клавишей мыши.
ws_MediaFinished Окончание проигрывания Медиа-потока.

События являются основным механизмом уведомления и активно используются для осуществления взаимодействия с пользователем. Для обработки событий предусмотрены два механизма:


Механизм "Сценарии управления открытием страниц" основан на базовом атрибуте виджета "evProc", в котором может описываться переключение, открытие, замещение и навигация по страницам. Сценарий этого атрибута записывается в виде списка команд с синтаксисом: "{event}:{evSrc}:{com}:{prm}". Где:


Реализованы следующие команды:


Специальные символы шаблона расшифровываются следующим образом:


Для большего и правильного понимания работы механизма шаблонов выбора страницы приведём несколько реальных примеров:


В качестве примера приведём сценарий обеспечения работы главной страницы интерфейса пользователя:

ws_BtPress:/prev:prev:/pg_so/*/*/$
ws_BtPress:/next:next:/pg_so/*/*/$
ws_BtPress:/go_mn:open:/pg_so/*/mn/*
ws_BtPress:/go_graph:open:/pg_so/*/ggraph/*
ws_BtPress:/go_cadr:open:/pg_so/*/gcadr/*
ws_BtPress:/go_view:open:/pg_so/*/gview/*
ws_BtPress:/go_doc:open:/pg_so/*/doc/*
ws_BtPress:/go_resg:open:/pg_so/rg/rg/*
ws_BtPress:/so1:open:/pg_so/1/*/*
ws_BtPress:/so2:open:/pg_so/2/*/*
ws_BtPress:/so3:open:/pg_so/3/*/*
ws_BtPress:/so4:open:/pg_so/4/*/*
ws_BtPress:/so5:open:/pg_so/5/*/*
ws_BtPress:/so6:open:/pg_so/6/*/*
ws_BtPress:/so7:open:/pg_so/7/*/*
ws_BtPress:/so8:open:/pg_so/8/*/*
ws_BtPress:/so9:open:/pg_so/9/*/*
ws_BtPress:*:open:/pg_control/pg_terminator


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


Содержимым атрибута "event" является списком событий формата "{event}:{evSrc}", с событием в отдельной строке. Приведём пример процедуры обработки событий на Java-подобном языке пользовательского программирования OpenSCADA:


3.6. Сигнализация

Важным элементом любого интерфейса визуализации является уведомление пользователя про нарушения — сигнализация. Для упрощения восприятия, а также в виду тесной связности визуализации и уведомления (как правило уведомление дополняет визуализацию) решено интегрировать интерфейс уведомления в интерфейс визуализации. Для этого во всех виджетах предусматриваются два дополнительных атрибута (уровня сеанса): "alarm" и "alarmSt". Атрибут "alarm" используется для формирования сигнала виджетом в соответствии с его логикой, а атрибут "alarmSt" используется для контроля за фактом сигнализации ветви дерева сеанса проекта.


Атрибут "alarm" является строкой и имеет следующий формат: "{lev}|{categ}|{message}|{type}|{tp_arg}"
Где:


Атрибут "alarmSt" является целым числом, которое отражает максимальный уровень сигнала и факт квитирования ветви дерева сеанса проекта. Формат числа имеет следующий вид:


Формирование сигнала и получение его визуализатором.
Формирование сигнала производится самим виджетом путём установки собственного атрибута "alarm" нужным образом, и в соответствии с ним автоматически устанавливается атрибут "alarmSt" текущего и вышестоящих виджетов. Визуализаторы получают уведомление о сигнале с помощью стандартного механизма уведомления об изменении атрибутов виджетов.


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


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


Квитирование
Квитирование — процесс принятия нарушения(й) с уведомлением к сведению, отключение уведомления и принятие мер по устранению нарушения(й). В контексте экрана пользовательского интерфейса квитирование предполагает только отключение уведомления.


Квитирование производится путём указания корня ветви виджетов и типов уведомления. Это позволяет реализовать квитирование на стороне визуализатора как по группам, например, по объектам сигнализации, так и индивидуально по объектам. При этом можно независимо квитировать разные типы сигнализаций. Установка квитирования производится простой модификацией атрибута "alarmSt".


Пример скрипта для работы с сигналами приведён ниже:


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


Для осуществления такой возможности внешние способы уведомления и соответствующие им типы уведомления свободно описываются для сервера визуализации и самого визуализатора. На стороне сервера визуализации описывается формирование/получение ресурса уведомления и само уведомление. На стороне визуализатора описывается уведомление согласно ресурсам сервера визуализации.


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



Флаги:


Переменные обмена:


Примеры и комментарии к работе типовых способов уведомлений:


3.7. Управление правами

Для разделения доступа к интерфейсу ВУ и его составляющим каждый виджет содержит информацию о владельце, его группе и правах доступа. Права доступа записываются, как принято в системе OpenSCADA, в виде триады: "{пользователь}{группы}{остальные}", где каждый элемент состоит из трёх признаков доступа. Перечень групп записывается через символ ','. Для элементов СВУ принята следующая их интерпретация:


В режиме разработки используется простая схема доступа "root.UI:RWRWR_", что означает — все пользователи могут открывать и просматривать библиотеки, их компоненты и проекты; а редактировать могут все пользователи группы "UI" (пользовательские интерфейсы).


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


3.8. Связывание с динамикой

Для предоставления актуальных данных в интерфейс визуализации должны использоваться данные подсистемы "Сбор данных (DAQ)". Природа этих данных следующая:

  1. параметры, содержащие некоторое количество атрибутов;
  2. атрибуты параметра могут предоставлять данные пяти типов: Логический, Целый, Вещественный, Строковый и Объект;
  3. атрибуты параметра могут иметь историю (архив);
  4. атрибуты параметра могут быть на чтение, запись и с полным доступом.

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


В соответствии с пунктом 2 связи обеспечивают прозрачное преобразование типов и не требуют специальной конфигурации.


Для удовлетворения возможности доступа к архивам, в соответствии с пунктом 3, связи выполняют проверку типа атрибута и, в случае подключения к "Адресу", в значение помещается адрес связи.


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


Вкладка "Обработка" страницы конфигурации виджета. (147 Кб)
Рисунок. Вкладка "Обработка" страницы конфигурации виджета.

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


Если в колонке "Обработка" стоит true, то в вычислительной процедуре становится доступной переменная {идентификатор виджета}_{идентификатор строки}, например cw_value.


Колонка "Конфигурация" позволяет указать тип связи для атрибута виджета:


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


Установка связей может быть нескольких типов, который определяется префиксом:


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


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


Вкладка "Связи" страницы конфигурации виджета c групповым назначением атрибутов путём указания только параметра. (78 Кб)
Рисунок. Вкладка "Связи" страницы конфигурации виджета c групповым назначением атрибутов путём указания только параметра.

Вкладка "Связи" страницы конфигурации виджета c индивидуальным назначением атрибутов. (81 Кб)
Рисунок. Вкладка "Связи" страницы конфигурации виджета c индивидуальным назначением атрибутов.

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


Вкладка "Связи" страницы конфигурации контейнера виджетов, включающего виджеты со связями. (139 Кб)
Рисунок. Вкладка "Связи" страницы конфигурации контейнера виджетов, включающего виджеты со связями.

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


Рассмотрим пример, когда имеется кадр общего назначения "Панель контроля графиком" и множество "Графиков" на разных кадрах. "Панель контроля графиком" имеет связи с шаблонами:


При этом каждый виджет "График" имеет атрибуты tSek, tSize, trcPer и valArch. В случае вызова сигнала открытия "Панели контроля графиком" из любого виджета "График" происходит связывания атрибутов "Панели контроля графиком" в соответствии атрибуту, указанному в шаблоне, с атрибутом виджета "График". Как результат, все изменения на "Панели контроля графиком" будут отражаться на графике посредством связи.


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


Для наглядного изображения этого механизма приведена таблица.


Таблица. Механизм динамической линковки.

Атрибуты "Панели контроля графиком" (шаблон динамической связи) Атрибуты "Графика" Атрибуты внешнего "Параметра" Результирующая связь или значение связующегося атрибута
tSek (<page>|tSek) tSek - "График".tSek
tSize (<page>|tSize) tSize - "График".tSize
trcPer (<page>|trcPer) trcPer - "График".trcPer
valArch (<page>|valArch) valArch - "График".valArch
var (<page>|var) var var "Параметр".var
ed (<page>|ed) - ed "Параметр".ed
max (<page>|max) - - EVAL
min (<page>|min) - - EVAL

3.9. Примитивы виджетов

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


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


Таблица. Библиотека примитивов виджетов (базовых элементов отображения)

Id Наименование Функция
ElFigure Элементарные графические фигуры

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

  • Линия.
  • Дуга.
  • Кривая безье.
  • Заливка замкнутого пространства.

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

FormEl Элементы формы

Включает поддержку стандартных компонентов формы:

  • Редактирование строки.
  • Редактирование текста.
  • Флажок.
  • Кнопка.
  • Выбор из списка.
  • Список.
  • Дерево.
  • Таблица.
  • Слайдер.
  • Строка прокрутки.
Text Текст Элемент текста(метки). Характеризуется типом шрифта, цветом, ориентацией и выравниванием.
Media Медиа Элемент отображения растровых и векторных изображений различных форматов, проигрывания анимированных изображений, проигрывание аудио фрагментов и просмотр видео-фрагментов.
Diagram Диаграмма Элемент диаграммы с поддержкой возможности отображения нескольких потоков трендов, частотного спектра, XY диаграмм реального времени, ... .
Protocol Протокол Элемент протокола, визуализатора системных сообщений с поддержкой несколько режимов работы.
Document Документ Элемент формирования отчётов, журналов и другой документации на основе доступных в системе данных.
Box Контейнер Содержит механизм размещения-включения других виджетов с целью формирования новых, более сложных, виджетов и страниц конечной визуализации.
Function, в планах Функция API объектной модели OpenSCADA Невизуальный, на стороне исполнения, виджет, позволяющий включать вычислительные функции объектной модели OpenSCADA в СВУ.

Таблица. Общий набор свойств/атрибутов в виджете

Id Имя Номер Значение
id Id - Идентификатор элемента. Атрибут только для чтения, призванный предоставить информацию об идентификаторе элемента.
path Путь - Путь к этому виджету. Атрибут только для чтения и предоставления исчерпывающей информации об расположения элемента.
parent Родитель - Путь к родительскому виджету. Атрибут только для чтения и предоставления информации о расположении предка, от которого унаследован виджет.
owner Владелец - Владелец и группа виджета в форме "{владелец}:{группа}", по умолчанию "root:UI".
perm Доступ -

Права доступа к виджету в форме "{польз.}{группа}{другие}" плюс флаг наследования, включающий наследование владельца и его прав от вышестоящего виджета.
Где "польз.", "группа" и "другие" это:

  • "__" — нет доступа;
  • "R_" — только на чтение;
  • "RW" — чтение и запись.

По умолчанию 01000(наследование).

root Корень 1 Идентификатор виджета-примитива (базового элемента), который лежит в основе образа визуализации виджета.
name Имя - Имя элемента. Модифицируемое имя элемента.
dscr Описание - Описание элемента. Текстовое поле для прикрепления к виджету краткого описания.
en Включен 5 Состояние элемента — "Включен". Отключенный элемент не отображается при исполнении.
active Активный 6 Состояние элемента — "Активный". Активный элементы может получать фокус при исполнении, а значит получать клавиатурные и иные события с последующей их обработкой.
geomX Геометрия:x 7 Геометрия, координата 'x' положения элемента.
geomY Геометрия:y 8 Геометрия, координата 'y' положения элемента.
geomW Геометрия:ширина 9 Геометрия, ширина элемента.
geomH Геометрия:высота 10 Геометрия, высота элемента.
geomXsc Геометрия:x масштаб 13 Масштаб элемента по горизонтали.
geomYsc Геометрия:y масштаб 14 Масштаб элемента по вертикали.
geomZ Геометрия:z 11 Геометрия, координата 'z' (уровень) элемента на странице. Также определяет порядок передачи фокуса между активными элементами.
geomMargin Геометрия:отступ 12 Геометрия, поля элемента.
tipTool Помощь:подсказка 15 Текст краткой помощи или подсказки по данному элементу. Обычно реализуется как всплывающая подсказка при удержании курсора мыши над элементом.
tipStatus Помощь:состояние 16 Текст информации о состоянии элемента или руководства к действию над элементом. Обычно реализуется в виде сообщения в строке статуса при удержании курсора мыши над элементом.
* Модификация из сеанса данного атрибута корневой страницы осуществляет запись сообщения в строку статуса окна визуализации сеанса.
contextMenu Контекстное меню 17

Контекстное меню в форме списка строк: "{ItName}:{Signal}".
Где:

  • "ItName" — имя элемента;
  • "Signal" — имя сигнала, формирующее сигнал: "usr_{Signal}".
evProc Обработка событий -

Атрибут для хранения сценария обработки событий непосредственного управления пользовательским интерфейсом. Сценарий представляет собой список команд интерфейсу визуализации, генерируемых при поступлении события (атрибут event). Прямая обработка событий для управления страницами в форме: "{event}:{evSrc}:{com}:{prm}". Где:

  • "event" — ожидаемое событие;
  • "evSrc" — источник события;
  • "com" — команда сеанса (open, next, prev);
  • "prm" — параметр команды, где используется:
    • pg_so — прямое имя желаемой страницы с префиксом;
    • 1 — имя новой страницы в общем пути, без префикса;
    • * — имя страницы берётся из имени предыдущей страницы;
    • $ — указывает на место относительно которого открывается страница.

Примеры:

  • ws_BtPress:/prev:prev:/pg_so/*/*/$
  • ws_BtPress:/next:next:/pg_so/*/*/$
  • ws_BtPress:/go_mn:open:/pg_so/*/mn/*
  • ws_BtPress:/go_graph:open:/pg_so/*/ggraph
Дополнительные атрибуты для элементов, помещённых в проект в роли страницы.
pgOpen Страница:открыта - Признак "Страница открыта".
* Модификация из сеанса осуществляет немедленное открытие/закрытие данной страницы.
pgNoOpenProc Страница:обрабатывать закрытой - Признак "Исполнять страницу даже если она закрыта".
pgOpenSrc Страница:источник открытия 3 Полный адрес страницы, открывшей данную.
* Запись/очистка адреса виджета — (инициатора открытия) осуществляет немедленное открытие/закрытие страницы. В случае записи адреса и выполнения других условий осуществляется динамическое связывание текущего виджета с инициатором.
pgGrp Страница:группа 4 Группа страницы.
Дополнительные атрибуты режима исполнения — сеанса.
event Обработка событий - Специальный атрибут для сбора событий виджета в списке, разделённом новой строкой. Доступ к атрибуту защищён захватом ресурса с целью избежания потери событий. Атрибут всегда доступен в скрипте виджета.
load Загрузка -1 Виртуальная команда групповой загрузки данных.
focus Фокус -2 Специальный атрибут индикации факта получения фокуса активным виджетом. Атрибут этого виджета и вложенных виджетов доступен в скрипте виджета.
perm Доступ -3 Виртуальный атрибут прав активного пользователя на просмотр и контроль над виджетом.

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

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

Элементарные графические фигуры (ElFigure)

Примитив является основой для отрисовки элементарных графических фигур со всевозможной комбинацией их в одном объекте. Учитывая широкий спектр всевозможных фигур, которые должен поддерживать примитив, и в тоже время являться достаточно простым в использовании и, по возможности, в реализации, решено было ограничить перечень базовых фигур, используемых для построения результирующих графических объектов до таких фигур: линия, дуга, кривая Безье и заливка замкнутых контуров. Основываясь уже на этих базовых фигурах, можно строить производные фигуры, комбинируя базовые. В рамках примитива существует возможность задания прозрачности цвета в диапазоне [0...255], где '0' — полная прозрачность.


Таблица. Набор дополнительных свойств/атрибутов в примитиве "ElFigure"

Id Имя Номер Значение
lineWdth Линия:ширина 20 Ширина линии.
lineClr Линия:цвет 21

Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 — полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
lineStyle Линия:стиль 22 Стиль линии (сплошная, пунктир, точечная).
bordWdth Граница:ширина 23 Ширина бордюра линии. Нулевая ширина указывает на отсутствие бордюра.
bordClr Граница:цвет 24 Цвет бордюра (детали в атрибуте 21).
fillColor Заполнение:цвет 25 Цвет заливки (детали в атрибуте 21).
fillImg Заполнение:изображение 26

Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
orient Угол поворота 28 Угол поворота содержимого виджета.
elLst Список элементов 27

Список графических примитивов в формате:

  • Линия, форма записи в списке, для статических и динамических параметров (могут смешиваться):
    "line:({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
    "line:{p1}:{p2}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
  • Дуга, форма записи в списке, для статических и динамических параметров (могут смешиваться):
    "arc:({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
    "arc:{p1}:{p2}:{p3}:{p4}:{p5}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
    Пример дуги с назначением точек (8 Kb)
    p1, p2 — начальная и конечная точки эллиптической дуги соответственно;
    p3 — центр дуги;
    p4 — первый радиус;
    p5 — второй радиус.
  • Кривая Безье, форма записи в списке, для статических и динамических параметров (могут смешиваться):
    "bezier:({x}|{y}):({x}|{y}):({x}|{y}):({x}|{y})[:{width}[:{color}[:{bord_w}[:{bord_clr}[:{line_stl}]]]]]"
    "bezier:{p1}:{p2}:{p3}:{p4}[:w{n}[:c{n}[:w{n}[:c{n}[:s{n}]]]]]"
  • Заливка, форма записи в списке, для статических и динамических параметров (могут смешиваться):
    "fill:({x}|{y}):({x}|{y}):...:({x}|{y})[:{fill_clr}[:{fill_img}]]"
    "fill:{p1}:{p2}:...:{pN}[:c{n}[:i{n}]]"

Где:

x, y — прямая точка (x,y), координаты в пикселах с плавающей точкой;
p1 ... pN — динамическая точка 1...N;
width, bord_w — прямая ширина линии и бордюра в пикселах с плавающей точкой;
w{n} — динамическая ширина 'n';
color, bord_clr, fill_clr — прямой цвет линии, бордюра и заполнения в виде имени или 32-битного кода с альфа: {имя}[-{AAA}], #RRGGBB-AAA;
c{n} — динамический цвет 'n';
line_stl — прямой стиль линии: 0-Сплошная, 1-Пунктирная, 2-Точечная;
s{n} — динамический стиль 'n';
fill_img — прямое изображение заполнения в формате "[{src}%3A]{name}", где:
"src" — источник изображения:
file — непосредственно из локального файла по пути;
res — из таблицы mime-ресурсов БД.
"name" — путь файла или идентификатор mime-ресурса.
i{n} — динамическое изображение заполнения 'n'.

Например:

  • line:(50|25):(90.5|25):2:yellow:3:green:2
  • arc:(25|50):(25|50):1:4:(25|50)::#000000-0
  • fill:(25|50):(25|50):c2:i2
  • fill:(50|25):(90.5|25):(90|50):(50|50):#d3d3d3:h_31
Атрибуты для каждой точки из списка графических фигур elLst
p{n}x Точка {n}:x 30+n*6 Координата 'x' точки n.
p{n}y Точка {n}:y 30+n*6+1 Координата 'y' точки n.
w{n} Ширина {n} 30+n*6+2 Ширина n.
с{n} Цвет {n} 30+n*6+3 Цвет n (детали в атрибуте 21).
i{n} Изображение {n} 30+n*6+4 Изображение n (детали в атрибуте 26).
s{n} Стиль {n} 30+n*6+5 Стиль n.

Элементы формы (FormEl)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "FormEl"

Id Имя Номер Значение
elType Тип элемента 20 Тип элемента: "Строка редактирования", "Редактор текста", "Флажок", "Кнопка", "Выбор из списка", "Список", "Дерево", "Таблица", "Слайдер", "Полоса прокрутки". От значения типа зависит перечень дополнительных атрибутов.
Строка редактирования:
value Значение 21 Содержимое строки.
view Вид 22 Вид строки редактирования: "Текст", "Комбобокс", "Целое", "Вещественное", "Время", "Дата", "Дата и время".
cfg Конфигурация 23

Конфигурация строки. Формат значения данного поля для различных видов строки:

Текст — конфигурация форматированного ввода по шаблону с параметрами:
A — Необходим ASCII алфавитный символ. A-Z, a-z.
a — Разрешён но не необходим ASCII алфавитный символ.
N — Необходим ASCII алфавитно-цифровой символ. A-Z, a-z, 0-9.
n — Разрешён но не необходим ASCII алфавитно-цифровой символ.
X — Необходим любой символ.
x — Разрешён но не необходим любой символ.
9 — ASCII цифра необходима. 0-9.
0 — ASCII цифра разрешёна но не необходима.
D — ASCII цифра необходима. 1-9.
d — ASCII цифра разрешёна но не необходима (1-9).
# — ASCII цифра или знаки плюс/минус разрешёны но не необходимы.
H — Необходим символ шестнадцатиричного числа. A-F, a-f, 0-9.
h — Разрешён но не необходим символ шестнадцатиричного числа.
B — Необходим бинарный символ. 0-1.
b — Разрешён но не необходим бинарный символ.
> — Все следующие алфавитные символы в верхнем регистре.
< — Все следующие алфавитные символы в нижнем регистре.
! — Выключение преобразования регистра.
\\ — Используйте в разделителях для экранирования специальных символов, которые перечислены.

Комбобокс — список значений редактируемого комбо-бокса по строкам.
Целое — значение целого числа в форме: "{Минимум}:{Максимум}:{ШагИзменения}:{Префикс}:{Суффикс}".
Вещественное — значение вещественного числа в форме: "{Минимум}:{Максимум}:{ШагИзменения}:{Префикс}:{Суффикс}:{ЗнаковПослеТочки}".
Время, Дата, Дата и время — формировать дату по шаблону с параметрами:

d — номер дня (1-31);
dd — номер дня (01-31);
ddd — сокращённое наименование дня ("Mon" ... "Sun");
dddd — полное наименование дня ("Monday" ... "Sunday");
M — номер месяца (1-12);
MM — номер месяца (01-12);
MMM — сокращённое имя месяца ("Jan" ... "Dec");
MMMM — полное имя месяца ("January" ... "December");
yy — последние две цифры года;
yyyy — год полностью;
h — час (0-23);
hh — час (00-23);
m — минуты (0-59);
mm — минуты (00-59);
s — секунды (0-59);
ss — секунды (00-59);
AP,ap — отображать AM/PM или am/pm.
confirm Подтверждать 24 Включение режима подтверждения.
font Шрифт 25

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселах;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.
Редактор текста:
value Значение 21 Содержимое редактора.
wordWrap Перенос слов 22 Автоматический перенос текста по словам.
confirm Подтверждать 24 Включение режима подтверждения.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Флажок:
name Имя 26 Имя/метка флажка.
value Значение 21 Значение флажка.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Кнопка:
name Имя 26 Имя, надпись на кнопке. Допустимы символы '\n' для возможности ввода многострочных надписей.
value Значение 21

Значение, отличается для разных режимов:

  • "Стандарт" — параметры повтора событий при удержании "{задержка}-{интервал}", время миллисекундах;
  • "Переключатель" — значение переключателя;
  • "Меню" — список адресов элементов меню вида "/grp1/grp2/item1";
  • "Загрузка" — строка описания "{ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчанию}" и содержимое загруженного файла. Шаблон файлов в виде "Изображение (*.png *.xpm *.jpg);;CSV-файл (*.csv)".
  • "Сохранение" — строка описания "{ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчанию}" и содержимое сохраняемого файла. Шаблон файлов как и выше.
img Изображение 22

Изображение на кнопке. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
color Цвет 23

Цвет кнопки. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255].

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
colorText Цвет:текст 27 Цвет текста. (детали выше)
mode Режим 24

Режим работы кнопки:

  • "Стандарт" — обычная кнопка с возможностью повтора событий при удержании (параметры в "value");
  • "Переключатель" — кнопка с фиксацией (значение в "value");
  • "Меню" — открытие меню по нажатию (перечень элементов в "value");
  • "Загрузка" — организация пользовательской загрузки небольших файлов через интерфейс визуализации; при нажатии кнопки в этом режиме открывается диалог выбора файла для загрузки, а содержимое выбранного файла загружается в атрибут "value";
  • "Сохранение" — организация пользовательского сохранения небольших файлов через интерфейс визуализации; при записи содержимого файла в атрибут "value" пользователю будет открыт диалог выбора/указания файла для сохранения, после выбора содержимое атрибута "value" сохранится в файл, а "value" очистится.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Список:
value Значение 21 Текущее значение списка.
items Элементы 22 Перечень элементов списка.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
mult Множественный выбор 23 Разрешать выбор множества элементов списка.
Выбор из списка, Дерево:
value Значение 21 Текущее значение списка.
items Элементы 22 Перечень элементов списка или иерархических элементов дерева в виде пути "/{КАТ}/{КАТ}/{ЭЛЕМ}".
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Таблица:
set Значение установки 23 Значение редактирования ячейки таблицы с адресом в событии "ws_TableEdit_{colN}_{rowN}".
value Значение 21

Адрес выбранного элемента. Изменение сопровождается сигналом "ws_TableChangeSel". Формат адреса зависит от режима выбора таблицы:

  • "Ячейка" — адрес ячейки в формате "{row}:{col}".
  • "Строка", "Колонка" — номер строки-колонки или содержимое ячейки ключа строки-колонки, указанной атрибутом "keyID".
items Элементы 22

Структура и содержимое таблицы в виде XML:

Теги:

"tbl" — Таблица, свойства таблицы в целом:
  • "sel" — режим выбора-выделения элементов таблицы: "row" — по строкам, "col" — по колонкам, "cell" — ячейками (по умолчанию);
  • "keyID" — номер ключевой строки-колонки, для получения значения выбора;
  • "colsWdthFit" — подстраивать размер колонок (размер которых не фиксирован) под заполнение всей ширины таблицы;
  • "hHdrVis", "vHdrVis" — установка видимости горизонтального, вертикального заголовков;
  • "sortEn" — включение прямой сортировки по колонкам.

"h" — Строка заголовков, возможные атрибуты у тегов ячеек заголовка, для колонки в целом:

  • "width" — ширина колонки, в пикселах или процентах (10%);
  • "edit" — возможность редактирования (0 или 1) ячеек колонки, по умолчанию — нет (0);
  • "color" — цвет колонки в целом в виде имени цвета или его кода;
  • "colorText" — цвет текста колонки в целом в виде имени цвета или его кода;
  • "font" — шрифт текста колонки в целом в виде типовой строки OpenSCADA;
  • "sort" — сортировка по данной колонке [0 — по убыванию; 1 — по возрастанию].

"r" — Строка значений, возможные атрибуты:

  • "color" — цвет строки в целом в виде имени цвета или его кода;
  • "colorText" — цвет текста строки в целом в виде имени цвета или его кода;
  • "font" — шрифт текста строки в целом в виде типовой строки OpenSCADA.

"s", "i", "r", "b" — ячейки типов данных "Строка", "Целое", "Вещественное" и "Логическое". Возможные атрибуты:

  • "color" — цвет фона ячейки;
  • "colorText" — цвет текста ячейки в виде имени цвета или его кода;
  • "font" — шрифт текста ячейки в виде типовой строки OpenSCADA;
  • "img" — изображение ячейки в форме "[{src}:]{name}", детали выше;
  • "edit" — возможность редактирования (0 или 1) ячейки колонки, по умолчанию — нет (0).
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Слайдер и полоса прокрутки:
value Значение 21 Положение слайдера.
cfg Конфигурация 22

Конфигурация слайдера в формате: "{ВертОриент}:{Минимум}:{Максимум}:{ОдинШаг}:{СтрШаг}".
Где:

  • "ВертОриент" — признак вертикальной ориентации (0 или 1), по умолчанию ориентация горизонтальная;
  • "Минимум" — минимальное значение;
  • "Максимум" — максимальное значение;
  • "ОдинШаг" — размер одного шага;
  • "СтрШаг" — размер страничного шага.

Элемент текста (Text)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "Text"

Id Имя Номер Значение
backColor Фон:цвет 20

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
backImg Фон:изображение 21

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
bordWidth Граница:ширина 22 Ширина бордюра.
bordColor Граница:цвет 23 Цвет бордюра (детальнее в атрибуте 20).
bordStyle Граница:стиль 24 Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий".
font Шрифт 25

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселах;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.
color Цвет 26 Цвет текста (детальнее в атрибуте 20).
orient Угол поворота 27 Ориентация текста, поворот на угол.
wordWrap Перенос слов 28 Автоматический перенос текста по словам.
alignment Выравнивание 29 Выравнивание текста: "Вверху слева", "Вверху справа", "Вверху по центру", "Вверху по ширине", "Внизу слева", "Внизу справа", "Внизу по центру", "Внизу по ширине", "По центру слева", "По центру справа", "По середине", "По центру по ширине".
text Текст 30 Значение текста. Используйте "%{x}" для помещения значения аргумента "x" (от 1).
numbArg Количество аргументов 40 Количество аргументов.
Атрибуты аргументов
arg{x}val Аргумент {x}:значение 50+10*x Значение аргумента x.
arg{x}tp Аргумент {x}:тип 50+10*x+1 Тип аргумента x: "Целый", "Вещественный", "Строка".
arg{x}cfg Аргумент {x}:конфигурация 50+10*x+2

Конфигурация аргумента x:

  • "Строка": {len} — ширина строки;
  • "Вещественный": {wdth};{form};{prec} — ширина значения, форма значения ('g', 'e', 'f') и точность;
  • "Целый": {len} — ширина значения.

Элемент отображения медиа-материалов (Media)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "Media"

Id Имя Номер Значение
backColor Фон:цвет 20

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
backImg Фон:изображение 21

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
bordWidth Граница:ширина 22 Ширина бордюра.
bordColor Граница:цвет 23 Цвет бордюра (детальнее в атрибуте 20).
bordStyle Граница:стиль 24 Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий".
src Источник 25

Имя источника медиа в форме "[{src}:]{name}", где:

  • "src" — источник:
    • file — прямо из локального (визуализатор и движок) файла по пути;
    • res — из таблицы mime ресурсов БД;
    • stream — URL потока проигрывания видео или аудио.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:workMedia" — из таблицы mime ресурсов БД для идентификатора "workMedia";
  • "workMedia" — как и предыдущий;
  • "file:/var/tmp/workMedia.mng" — из локального файла по пути "/var/tmp/workMedia.mng";
  • "stream:http://localhost.localhost:5050" — проигрывание видео или аудио из URL.
type Тип 27

Тип медиа, вариант:

  • "Изображение" — растровое или векторное(может не поддерживаться) изображение, вроде: PNG, JPEG, GIF, SVG;
  • "Анимация" — простое анимированное изображение, вроде: GIF, MNG;
  • "Полное видео" — полное видео, аудио или поток, вроде: OGG, OGM, AVI, MKV, MPG, MP3, MP4.
areas Области карты 28 Количество активных областей.
Атрибуты изображения (Image)
fit Заполнять виджет 26 Признак "Согласовать содержимое с размером виджета".
Атрибуты видеоролика (Movie)
fit Заполнять виджет 26 Признак "Согласовать содержимое с размером виджета".
speed Скорость проигрывания 29 Скорость проигрывания, в процентах от оригинальной скорости. Если значение меньше 1%, то проигрывание прекращается.
Атрибуты полноформатного видео (Full video)
play Играть 29 Видео/аудио - "Играть".
roll Завор. проигр. 30 Повтороение проигрывания по завершению.
pause Пауза 31 Приостановить проигрование.
size Размер 32 Общий размер видео (в миллисекундах).
seek Положение 33 Позиция проигрывания видео (в миллисекундах).
volume Громкость 34 Громкость звука [0...100].
Активные области
area{x}shp Область {x}:образ 40+3*x Вид области x: "Квадрат", "Полилиния", "Окружность".
area{x}coord Область {x}:координаты 40+3*x+1 Координаты области x, через запятую идут координаты: "x1,y1,x2,y2,xN,yN"
area{x}title Область {x}:заголовок 40+3*x+2 Заголовок области x.

Элемент построения диаграмм/трендов (Diagram)

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


Для всех типов диаграмм возможно, в качестве источника данных, указание:


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


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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "Diagram"

Id Имя Номер Значение
backColor Фон:цвет 20

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
backImg Фон:изображение 21

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
bordWidth Граница:ширина 22 Ширина бордюра.
bordColor Граница:цвет 23 Цвет бордюра (детальнее в атрибуте 20).
bordStyle Граница:стиль 24 Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий".
trcPer Период слежения (с) 25 Режим и периодичность слежения.
type Тип 26 Тип диаграммы: "Trend", "Спектр", "XY".
Атрибуты, общие для всех типов
tSek Время:сек 27 Текущее время, секунд.
tUSek Время:микросек 28 Текущее время, микросекунды.
tSize Размер, сек 29 Размер тренда, секунды.
curSek Курсор:сек 30 Положение курсора, секунды.
curUSek Курсор:микросек 31 Положение курсора, микросекунды.
curColor Курсор:цвет 32 Цвет курсора.
sclColor Шкала:цвет 33 Цвет шкалы/решетки (детальнее в атрибуте 20).
sclHor Шкала:горизонтальная 34 Режим горизонтальной шкалы/решетки: "Не рисовать", "Решетка", "Маркеры", "Решетка и маркеры", "Решетка (лог)", "Маркеры (лог)", "Решетка и маркеры (лог)".
sclHorScl Шкала:гориз. масштаб (%) 44 Горизонтальный масштаб графика в процентах, исключительно для типа "XY".
sclHorSclOff Шкала:смещ. гориз. масштаба (%) 45 Смещение горизонтального маштаба в процентах, исключительно для типа "XY".
sclVer Шкала:вертикальная 35 Режим вертикальной шкалы/решетки: "Не рисовать", "Решетка", "Маркеры", "Решетка и маркеры", "Решетка (лог)", "Маркеры (лог)", "Решетка и маркеры (лог)".
sclVerScl Шкала:верт. масштаб (%) 40 Вертикальный масштаб графика в процентах.
sclVerSclOff Шкала:смещ. верт. масштаба (%) 41 Смещение вертикального маштаба в процентах.
sclMarkColor Шкала:Маркеры:цвет 36 Цвет маркеров шкалы/решетки (детальнее в атрибуте 20).
sclMarkFont Шкала:Маркеры:шрифт 37

Шрифт маркеров шкалы/решетки. Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселах;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.
valArch Архиватор значений 38 Архиватор значений в форме "{МодульАрхивов}.{IdАрхиватора}".
valsForPix Значений на пиксел 42 Количество значений на пиксел. Увеличить для расширения точности экспорта на больших интервалах времени.
parNum Количество параметров 39 Количество параметров, отображаемых на одном тренде.
Атрибуты типа: "График"
sclHorPer Шкала:размер гор. решетки, сек 43 Фиксированный период решётки горизонтальной шкалы, отключает автоматическое вычисление периода решётки. Активируется если количество периодов на общий размер более двух и размер одного периода не менее 15 пикселов.
Индивидуальные атрибуты параметров тренда/графика/XY
prm{X}addr Параметр {X} :адрес 50+10*{X}

Полный адрес к атрибуту параметра X DAQ или архиву.
Также поддерживается прямая установка данных по префиксу:

  • "data:{XMLNodeData}" — отрисовка из прямо установленных данных;
  • "line:{значение}" — отрисовка горизонтальной линии по значению, не имеет смысла для типа "XY".

Пример:

  • "/DAQ/System/AutoDA/MemInfo/use" — адрес к атрибуту "use" параметра "MemInfo" контроллера "AutoDA" DAQ модуля "System";
  • "/Archive/va_CPULoad_load" — адрес к архиву "CPULoad_load";
  • "data:<d s="1" aprox="1" tm="1369465209" tm_grnd="1369465200" per="1">
0 3.14
1 3.141
5 3.1415</d>" — 10 секунд данных с периодом 1 секунда от "25.05.2013 10:00:00"; возможно "tm" и "tm_grnd" не указывать в результате чего будут подставлены значения диапазона диаграммы, также установкой атрибута "s" можно указать на время в секундах; "aprox" — аппроксимировать переход от одной точки к другой вместо подстановки предыдущего значения во все точки периодичности (обычно от упаковки);
  • "line:3.14159265" — горизонтальная линия по значению "3.14159265".
prm{X}bordL Параметр {X}:граница отображ.:нижняя 50+10*{X}+1 Нижняя граница значений параметра X.
prm{X}bordU Параметр {X}:граница отображ.:верхняя 50+10*{X}+2 Верхняя граница значений параметра X.
prm{X}color Параметр {X}:цвет 50+10*{X}+3 Цвет отображения тренда параметра X (детальнее в атрибуте 20).
prm{X}width Параметр {X}:ширина 50+10*{X}+6 Ширина линии тренда параметра X, в пикселах.
prm{X}scl Параметр {X}:шкала 50+10*{X}+5 Режим отдельной вертикальной шкалы параметра X: "Глобально", "Маркеры", "Решетка и маркеры", "Маркеры (лог)", "Решетка и маркеры (лог)".
prm{X}val Параметр {X}:значение 50+10*{X}+4 Значение параметра X под курсором, или на текущее время для типа "XY".
prm{X}prop Параметр {X}:свойства 50+10*{X}+7 Свойства реального архива в виде "{BegArh}:{EndArh}:{DataPeriod}", где "BegArh", "EndArh", "DataPeriod" — начало, конец и период данных архива в секундах, в реальном представлении, вплоть до микросекунд (1e-6).

Элемент построения протоколов, на основе архивов сообщений (Protocol)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "Protocol"

Id Имя Номер Значение
backColor Фон:цвет 20

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
backImg Фон:изображение 21

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
font Шрифт 22

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселах;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.
headVis Заголовок видим 23 Заголовок таблицы видим или нет.
time Время, сек 24 Текущее время, секунд.
tSize Размер, сек 25 Размер запроса, секунды. Установите значение в '0' для получения всех нарушений, для "lev" < 0.
trcPer Период слежения (с) 26 Режим и периодичность слежения.
arch Архиватор 27 Архиватор сообщений в форме "{МодульАрхивов}.{IdАрхиватора}".
tmpl Шаблон 28

Шаблон категории или регулярное выражение "/{re}/". Для шаблона зарезервированы символы:

  • '*' — множество любых, группа символов;
  • '?' — любой, один символ;
  • '\\' — используйте для экранирования специальных символов.
lev Уровень 29 Уровень сообщений. Установите значение < 0 для получения текущих нарушений.
viewOrd Порядок отображения 30 Порядок отображения: "По времени", "По уровню", "По категории", "По сообщению", "По времени (обратно)", "По уровню (обратно)", "По категории (обратно)", "По сообщению (обратно)".
col Показать колонки 31

Список видимых и порядок колонок, разделённый символом ';'. Предусматриваются колонки:

  • "pos" — номер строки;
  • "tm" — дата и время сообщения;
  • "utm" — микросекундная часть времени сообщения;
  • "lev" — уровень сообщения;
  • "cat" — категория сообщения;
  • "mess" — текст сообщения.
itProp Свойства элемента 32 Количество свойств элементов.
Индивидуальные атрибуты свойств элементов
it{X}lev Элемент {X}:уровень 40+5*{X} Критерий: уровень элемента X, более или равно указанному.
it{X}tmpl Элемент {X}:шаблон 40+5*{X}+1 Критерий: шаблон категории элемента X (детальнее в атрибуте 28).
it{X}fnt Элемент {X}:шрифт 40+5*{X}+2 Шрифт элемента X (детальнее в атрибуте 22).
it{X}сolor Элемент {X}:цвет 40+5*{X}+3 Цвет элемента X (детальнее в атрибуте 20).

Элемент формирования отчётной документации (Document)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве "Document"

Id Имя Номер Значение
style CSS 20 Правила CSS в строках, вида "body { background-color:#818181; }".
tmpl Шаблон 21 Шаблон документа в XHTML, начинается с тега "body" и включает процедурные вставки:
doc Документ 22 Финальный документ в XHTML, начинается с тега "body".
font Шрифт 26

Базовый шрифт текста документа. Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселах;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселов и усиленный.
bTime Время:начало 24 Время начала документа, секунд.
time Время:текущее 23 Время генерации документа, секунд. Записать время для генерации документа от этой точки или нуля для перегенерации.
n Размер архива 25 Количество документов или глубина архива.
Атрибуты включеного режима архивирования
aCur - Позиция текущего документа в архиве. Запись значения <0 производит архивацию текущего документа.
vCur - Текущий визуализируемый документ архива. Запись значения -1 — выбор следующего документа, -2 — выбор предыдущего документа.
aDoc документ - Текущий документ архива в XHTML, начинается с тега "body".
aSize - Реальный размер архива документа.

Возможности примитива "Документ":


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


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


На рис. 3.8.7.a изображена структурная схема виджета примитива "Документ". Согласно этой структуре "Документ" содержит: XHTML-шаблон, результирующие документы и скрипт обработки данных. Источником данных для скрипта и результирующих документов являются атрибуты виджета.


Структурная схема примитива «Документ». (42 Кб)
Рис.3.8.7.a Структурная схема примитива "Документ".

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


Генерация документа всегда производится в момент установки атрибута времени time относительно установленного начального времени документа в атрибуте bTime. При выключенном архиве результирующий документ помещается непосредственно в атрибут doc. При включенном архиве результирующий документ помещается в ячейку под курсором, атрибут aCur, а так-же в doc если значение курсора архива aCur и курсора визуализируемого документа vCur совпадают. Атрибуты архивных курсоров предусматривают несколько командных значений:


Как было указано выше динамика шаблона документа определяется вставками исполняемых инструкций вида "<?dp {procedure} ?>". В процедурах могут использоваться одноимённые атрибуты виджета и функции пользовательского интерфейса программирования OpenSCADA. Кроме атрибутов виджета зарезервированы специальные атрибуты (табл. 3.8.7.a).


Таблица 3.8.7.a. Специальные и зарезервированные элементы шаблона.

Имя Назначение
Атрибуты
rez Атрибут результата исполнения процедуры, содержимое которого помещается в дерево документа.
lTime Время последнего формирования. Если документ формируется впервые то <lTime> равен <bTime>.
rTime Содержит время для перебираемых значений в секундах, определяется внутри тегов с атрибутом "docRept".
rTimeU Содержит время для перебираемых значений в микросекундах, определяется внутри тегов с атрибутом "docRept".
rPer Содержит периодичность перебора значений (атрибут "docRept").
mTime, mTimeU, mLev, mCat, mVal Определяются внутри тегов с атрибутом "docAMess" при разборе сообщений архива сообщений:
mTime — время сообщения;
mTimeU — время сообщения, микросекунды;
mLev — уровень сообщения;
mCat — категория сообщения;
mVal — значение сообщения.
Специальные теги
Специальные атрибуты стандартных тегов
body.docProcLang Язык исполняемых процедур документа. По умолчанию это "JavaLikeCalc.JavaScript".
*.docRept="1s" Тег с указанным атрибутом при формировании размножается путём смещения времени в атрибуте "rTime" на значение указанное в данном атрибуте.
*.docAMess="1:PLC*" Указывает на необходимость размножения тега с атрибутом сообщения из архива сообщений за указанный интервал времени, в соответствии с уровнем "1" и шаблоном запроса "PLC*" по категории сообщения. В шаблоне запроса могут указываться регулярные выражения в виде "/{re}/". Для данного тега, в процессе размножения, определяются атрибуты: "mTime", "mTimeU", "mLev", "mCat" и "mVal".
*.docAMessArchs="ArchMod0.Archivator0[;ArchModN.ArchivatorN]" Дополняет атрибут "*.docAMess" перечнем архиваторов для чтения сообщений.
*.docRevers="1" Указывает на инвертирование порядка размножения, последний сверху.
*.docAppend="1" Признак необходимости добавления результата выполнения процедуры в тег процедуры. Иначе результат исполнения заменяет содержимое тега.
body.docTime Время формирования документа. Используется для установки атрибута lTime при следующем формировании документа. Не устанавливается пользователем!
table.export="1" Включение возможности экспорта содержимого указанной таблицы в CSV-файл и другие табличные форматы.

Контейнер (Box)

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


Таблица. Набор дополнительных свойств/атрибутов в примитиве Box

Id Имя Номер Значение
pgOpenSrc Страница:источник открытия 3 Полный адрес страницы, которая включена внутрь данного контейнера.
pgGrp Страница:группа 4 Группа контейнера страниц.
backColor Фон:цвет 20

Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или числовое представление из трёх шестнадцатеричных чисел цвета "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 - полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
backImg Фон:изображение 21

Фоновое изображение. Имя изображения в форме "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы mime ресурсов БД.
  • "name" — путь файла или идентификатор mime-ресурса.

Примеры:

  • "res:backLogo" — из таблицы mime ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
bordWidth Граница:ширина 22 Ширина бордюра.
bordColor Граница:цвет 23 Цвет бордюра (детальнее в атрибуте 20).
bordStyle Граница:стиль 24 Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий".

3.10. Использование БД для хранения библиотек виджетов и проектов

Хранение данных виджетов, библиотек виджетов и проектов реализовано в БД, доступных системе OpenSCADA. БД организована по принадлежности данных к библиотеке-проекту. Т.е. отдельная библиотека-проект хранится в отдельной группе таблиц одной или разных БД. Перечень библиотек виджетов хранится в индексной таблице библиотек с именем "VCALibs", со структурой "Libs", а перечень проектов в индексной таблице "VCAPrjs", со структурой "Projs". Экземпляр этих таблиц создаётся в каждой БД, где хранятся данные этого модуля с перечнем библиотек, содержащихся в конкретно взятой БД. В состав таблиц, принадлежащих библиотеке виджетов и проектов, входят следующие:


Проекции (структуры) основных таблиц таковы:


3.11. API пользовательского программирования и сервисные интерфейсы OpenSCADA

API пользовательского программирования

API пользовательского программирования движка визуализации представлено непосредственно объектами OpenSCADA, формирующие пользовательский интерфейс, а именно "Сеансом" и "Виджетами/страницами". Для пользователя эти объекты предоставляют набор функций управления:

Объект "Сеанс" ( this.ownerSess() )


Объект "Виджет" (this)




Объект "Виджет", примитива "Документ" (this)


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


Список виджетов (WdgList)
Описание: Возвращает список виджетов в контейнере виджетов или список дочерних виджетов. Если установлено pg, то возвращается список страниц для проектов и сеансов.
Параметры:

ID Имя Тип Режим По умолчанию
list Список Строка Возврат
addr Адрес Строка Вход
pg Страницы Bool Вход 0

Присутствие узла (NodePresent)
Описание: Проверка на присутствие узла, включая виджеты, атрибуты и другие.
Параметры:

ID Имя Тип Режим По умолчанию
rez Результат Bool Возврат
addr Адрес Строка Вход

Список атрибутов (AttrList)
Описание: Возвращает список атрибутов виджета. Если установлен noUser тогда возвращаются только не пользовательские атрибуты.
Параметры:

ID Имя Тип Режим По умолчанию
list Список Строка Возврат
addr Адрес Строка Вход
noUser Без пользовательских Bool Вход 1

Запрос атрибута (AttrGet)
Описание: Запрос значения атрибута виджета. Запрос может осуществляться как указанием полного адреса атрибута в addr, так и отдельно адреса виджета в addr, а идентификатора атрибута в attr.
Параметры:

ID Имя Тип Режим По умолчанию
val Значение Строка Возврат
addr Адрес Строка Вход
attr Атрибут Bool Вход

Установка атрибута (AttrSet)
Описание: Установка значения атрибута виджета. Установка может осуществляться как указанием полного адреса атрибута в addr, так и отдельно адреса виджета в addr, а идентификатора атрибута в attr.
Параметры:

ID Имя Тип Режим По умолчанию
addr Адрес Строка Вход
val Значение Строка Вход
attr Атрибут Bool Вход

Пользователь сеанса (SesUser)
Описание: Возвращает пользователя сеанса по пути к виджету сеанса.
Параметры:

ID Имя Тип Режим По умолчанию
user Пользователь Строка Возврат
addr Адрес Строка Вход

Сервисные интерфейсы OpenSCADA

Сервисные интерфейсы это интерфейсы доступа к системе OpenSCADA посредством интерфейса управления OpenSCADA из внешних систем. Данный механизм положен в основу всех механизмов обмена внутри OpenSCADA, реализованных посредством слабых связей и стандартного протокола обмена OpenSCADA.

Доступ к значениям атрибутов элементов визуализации (виджеты)

С целью предоставления унифицированного, группового и сравнительно быстрого доступа к значениям атрибутов визуальных элементов предусмотрена сервисная функция визуального элемента "/serv/attr" и команды получения/установки значений атрибутов: <get path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/> и <set path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/>.


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

Id Имя Значение
Команда запроса визуальных атрибутов виджета: <get path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/>
tm Время/счётчик изменений Установка времени/счётчика изменений для запроса только изменившихся атрибутов.
<el id="{attr}" p="{a_id}">{val}</el> Формирование дочерних элементов с результатами атрибутов В дочернем элементе указываются: строковых идентификатор attr атрибута, индекс a_id атрибута и его значение val.
Команда установки визуальных атрибутов виджета: <set path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/>
<el id="{attr}">{val}</el> Установка атрибутов В дочерних элементах указывается идентификатор атрибута attr и его значение val.
Команда активации-создания специфичного для визуализатора атрибута: <activate path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr/{attrId}" aNm="{Name}" aTp="{Type} aFlg="{Flags}"/>
attrId Идентификатор атрибута
aNm Имя атрибута
aTp Тип атрибута
aFlg Флаги атрибута
Групповой доступ к значениям атрибутов элементов визуализации (виджетам)

С целью оптимизации трафика сетевого взаимодействия путём исключения мелких запросов, а использования одного, но большого запроса предусмотрен групповой запрос значений атрибутов визуальных элементов. Группировка данного запроса подразумевает запрос атрибутов всей ветви виджета, включая и вложенные элементы. Для данного запроса предусмотрена сервисная команда "/serv/attrBr". Запрос данной сервисной команды эквивалентен сервисной команде "/serv/attr" и выглядит следующим образом:
<get path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattrBr"/>

tm — Время/счётчик изменений. Установка времени/счётчика изменений для запроса только изменившихся атрибутов.

Результат:

<el id="{attr}" p="{a_id}">{val}</el> — элементы с результатами атрибутов. В элементе указываются: строковый идентификатор attr атрибута, индекс a_id атрибута и его значение val.
<w id="{wid}" lnkPath="{lnk_path}">{childs+attrs}</w> — элементы с дочерними виджетами и их атрибутами. В элементе указываются идентификатор дочернего виджета wid и путь виджета на который ссылается данный виджет если он является ссылкой lnk_path.
Доступ к страницам сеанса

С целью унификации и оптимизации доступа к страницам предусмотрена сервисная функция сеанса "/serv/pg" и команды запроса перечня открытых страниц <openlist path="/UI/VCAEngine/ses_{Session}/%2fserv%2fpg"/>; открытия страницы <open path="/UI/VCAEngine/ses_{Session}/%2fserv%2fpg"/>; и закрытия страницы <close path="/UI/VCAEngine/ses_{Session}/%2fserv%2fpg"/>.


Результатом запроса перечня открытых страниц являются дочерние элементы <el>{OpPage}</el>, содержащие полный путь открытой страницы. Кроме перечня открытых страниц запрос возвращает значение текущего счётчика вычисления сеанса в атрибуте tm. Если данный атрибут устанавливается при запросе, то для каждой открытой страницы возвращается список изменённых с момента указанного значения счётчика виджетов открытой страницы.

Управление сигнализацией

Для предоставления механизма глобального контроля за сигнализацией сеанса предусмотрена сервисная функция сеанса "/serv/alarm" и команды запроса статуса сигналов <get path="/UI/VCAEngine/ses_{Session}/%2fserv%2falarm"/>; и квитирование сигналов <quittance path="/UI/VCAEngine/ses_{Session}/%2fserv%2falarm"/>.


Запрос статуса сигналов возвращает обобщённое состояние сигналов, а так-же ресурс уведомления, если атрибут "mode" равен "resource". Результатом запроса ресурса уведомления обычно является звуковой файл, для воспроизведения, в это-же время обеспечивается отслеживание последовательности сигнализации и квитирования отдельных ресурсов сообщений.


Запрос на квитирование выполняет квитирование указанного виджета, атрибут wdg, в соответствии с шаблоном, атрибут tmpl.

Манипуляция сеансами проектов

Для предоставления унифицированного механизма манипуляции сеансами визуализаторам СВУ в модуле движка СВУ (VCAEngine) предусмотрена сервисная функция "/serv/sess" и команды запроса перечня открытых сеансов, подключения/создания нового сеанса и отключения/удаления сеанса: <list path="/UI/VCAEngine/%2fserv%2fsess"/>, <connect path="/UI/VCAEngine/%2fserv%2fsess"/> и <disconnect path="/UI/VCAEngine/%2fserv%2fsess"/> соответственно.


Таблица. Атрибуты команд механизма манипуляции сеансами

Id Имя Значение
Команда запроса перечня открытых сеансов для проекта: <list path="/UI/VCAEngine/%2fserv%2fsess"/>
prj Указание проекта Указывает проект, для которого возвращать перечень открытых сеансов.
<el>{Session}</el> Контроль перечня сеансов В дочерних элементах указываются сеансы, открытые для запрошенного проекта.
Команда подключения/открытия сеанса: <connect path="/UI/VCAEngine/%2fserv%2fsess"/>
sess Установка и контроль имени сеанса Если атрибут определён, то производится подключение к существующему сеансу, иначе создание нового сеанса. В случае открытия нового сеанса в данный атрибут помещается его имя.
prj Установка имени проекта Используется для открытия нового сеанса для указанного проекта и если атрибут sess не указан.
Команда отключения/закрытия сеанса: <disconnect path="/UI/VCAEngine/%2fserv%2fsess"/>
sess Установка имени сеанса Указывает имя сеанса от которого выполняется отключение или закрытие. Сеансы, не являющиеся фоновыми и к которым ни один из визуализаторов не подключен, автоматически закрываются.
Групповой запрос дерева библиотек виджетов

С целью оптимизации производительности локального и особенно сетевого взаимодействия предусмотрена сервисная функция "/serv/wlbBr" и команда запроса дерева библиотек виджетов: <get path="/UI/VCAEngine/%2fserv%2fwlbBr"/>. Результатом запроса является дерево с элементами библиотек виджетов, теги wlb. Внутри тегов библиотек виджетов содержаться тег иконки ico и теги виджетов библиотеки w. Теги виджетов, в свою очередь, содержат тег иконки и теги дочерних виджетов cw.


4. Конфигурация модуля посредством интерфейса управления OpenSCADA

Посредством интерфейса управления OpenSCADA компоненты, которые его используют, можно конфигурировать из любого конфигуратора системы OpenSCADA. Данным модулем предоставляется интерфейс для доступа ко всем объектам данных СВУ. Главная вкладка конфигурационной страницы модуля предоставляет доступ к библиотекам виджетов и проектам (рис. 4.1). Вкладка "Сеансы" предоставляет доступ и открытым сеансам проектов (рис. 4.2).

Главная конфигурационная страница модуля. (101 Kb)
Рис.4.1 Главная конфигурационная страница модуля.


Вкладка "Сеансы" конфигурационной страницы модуля. (98 Kb)
Рис.4.2 Вкладка "Сеансы" конфигурационной страницы модуля.


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

Конфигурация контейнеров виджетов, в лице библиотек виджетов и проектов выполняется посредством страниц на рис. 4.3 (для проекта) и рис.4.5 (для библиотеки виджетов). Библиотека виджетов содержит виджеты, а проект — страницы. Оба типа контейнера содержат вкладку конфигурации Mime-данных, используемых виджетами (рис.4.6). Страница проекта также содержит вкладку "Диагностика" (рис.4.4) для отладки и контроля за исполнением страницы в сеансах.

Страница конфигурации проектов. (118 Kb)
Рис.4.3 Страница конфигурации проектов.


С помощью этой страницы можно установить:

Вкладка "Диагностика" проекта. (136 Kb)
Рис.4.4 Вкладка "Диагностика" проекта.


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

Страница конфигурации библиотек виджетов. (90 Kb)
Рис.4.5 Страница конфигурации библиотек виджетов.


С помощью этой страницы можно установить:

Вкладка конфигурации mime-данных контейнера. (96 Kb)
Рис.4.6 Вкладка конфигурации mime-данных контейнера.


Конфигурация сеанса проекта значительно отличается от конфигурации проекта (рис. 4.7), однако также содержит страницы проекта.

Страница конфигурации сеансов проектов. (120 Kb)
Рис.4.7 Страница конфигурации сеансов проектов.


С помощью этой страницы можно установить:

Страницы конфигурации визуальных элементов, расположенных в разных контейнерах, могут сильно отличаться, однако, это отличие заключается в наличии или отсутствии отдельных вкладок. Главная вкладка визуальных элементов фактически везде одинакова, отличаясь на одно конфигурационное поле и три в сеансе (рис. 4.8). У страниц присутствуют вкладки дочерних страниц и вложенных виджетов. У контейнерных виджетов содержится вкладка вложенных виджетов. Все визуальные элементы содержат вкладку атрибутов (рис. 4.9), кроме логических контейнеров проектов. Элементы, на уровне которых можно формировать пользовательскую процедуру и определять связи, содержат вкладки "Обработка" (рис. 4.10) и "Связи" (рис.4.11).

Главная вкладка конфигурации визуальных элементов. (132 Kb)
Рис.4.8 Главная вкладка конфигурации визуальных элементов.


С помощью этой страницы можно установить:

Вкладка атрибутов визуальных элементов. (112 Kb)
Рис.4.9 Вкладка атрибутов визуальных элементов.


Вкладка обработки визуальных элементов. (137 Kb)
Рис.4.10 Вкладка обработки визуальных элементов.


Вкладка связей визуальных элементов. (104 Kb)
Рис.4.11 Вкладка связей визуальных элементов.