Модуль | Имя | Версия | Лицензия | Источник | Языки | Платформы | Тип | Автор |
---|---|---|---|---|---|---|---|---|
VCAEngine | Движок Среды Визуализации и Управления | 7.8 | GPL2 | ui_VCAEngine.so | en,uk,ru,de | x86,x86_64,ARM | UI | Роман Савоченко |
Описание | ||||||||
Общий движок среды визуализации и управления.
|
Модуль предоставляет в OpenSCADA движок среды визуализации и управления (СВУ). Сам модуль не реализует визуализации СВУ, а содержит данные в соответствии с концепцией "Модель/данные – Интерфейс". Визуализация данных этого модуля выполняется модулями визуализации СВУ, например, модулем Vision и WebVision.
Среда визуализации и управления (СВУ) является неотъемлемой составляющей SCADA системы. Она применяется на клиентских станциях с целью доступного предоставления информации об объекте управления и выдачи управляющих воздействий на объект. В различных практических ситуациях и условиях могут применяться СВУ, построенные на различных принципах визуализации. Например, это могут быть библиотеки виджетов Qt, GTK+, wxWidgets или гипертекстовые механизмы на основе технологий HTML, XHTML, XML, CSS и JavaScript или сторонние приложения визуализации, реализованные на различных языках программирования Java, Python и т.д. Любой из этих принципов имеет свои преимущества и недостатки, комбинация которых может стать непреодолимым препятствием в возможности использования СВУ в том или ином практическом случае. Например, технологии вроде библиотеки Qt позволяют создавать высокопроизводительные СВУ, что несомненно важно для станций оператора управления технологическим процессом (ТП). Однако, необходимость инсталляции данного клиентского ПО может сделать его использование невозможным в отдельных ситуациях. С другой стороны, Web-технологии не требуют инсталляции на клиентские системы и являются предельно многоплатформенными (достаточно указать ссылку на Web-сервер в любом Web-браузере), что наиболее важно для различных инженерных и административных станций. С другой стороны, производительность и надёжность таких интерфейсов ниже, что практически исключает их использование на станциях оператора ТП.
OpenSCADA имеет предельно гибкую архитектуру, которая позволяет создавать внешние интерфейсы, в том числе и пользовательские, на любой основе и вкус. Например, среда конфигурации OpenSCADA доступна как на Qt-библиотеке, так и на Web-основе.
В тоже время, независимое создание реализаций СВУ на различной основе может повлечь за собой невозможность использования данных конфигурации одной СВУ в другой. Что неудобно и ограничено с пользовательской стороны, а также накладно в плане реализации и последующей поддержки.
С целью избежания этих проблем, а также создания в кратчайшие сроки полного спектра различных типов СВУ, основан проект создания концепции СВУ. Результатом этого проекта стал данный модуль движка(модели данных) СВУ, а также модули непосредственной визуализации Vision и WebVision.
Contents
- 1 Назначение
- 2 Конфигурация и формирование интерфейсов СВУ
- 3 Архитектура
- 3.1 Кадры и элементы отображения (виджеты)
- 3.2 Проект
- 3.3 Сеанс исполнения проекта
- 3.4 Стили
- 3.5 События, их обработка и карты событий
- 3.6 Сигнализация
- 3.7 Управление правами
- 3.8 Связывание с динамикой
- 3.9 Примитивы виджетов
- 3.9.1 Элементарная графическая фигура (ElFigure)
- 3.9.2 Элемент формы (FormEl)
- 3.9.3 Элемент текста (Text)
- 3.9.4 Элемент отображения медиа-материалов (Media)
- 3.9.5 Элемент построения диаграмм (Diagram)
- 3.9.6 Элемент построения протоколов на основе архивов сообщений (Protocol)
- 3.9.7 Элемент формирования отчётной документации (Document)
- 3.9.8 Контейнер (Box)
- 3.10 Использование БД для хранения библиотек виджетов и проектов
- 3.11 API пользовательского программирования и сервисные интерфейсы OpenSCADA
- 3.11.1 API пользовательского программирования
- 3.11.2 Сервисные интерфейсы OpenSCADA
- 3.11.2.1 Доступ к значениям атрибутов элементов визуализации (виджеты)
- 3.11.2.2 Групповой доступ к значениям атрибутов элементов визуализации (виджетам)
- 3.11.2.3 Доступ к страницам сеанса
- 3.11.2.4 Управление сигнализацией
- 3.11.2.5 Манипуляция сеансами проектов
- 3.11.2.6 Групповой запрос дерева библиотек виджетов
- 4 Конфигурация модуля посредством интерфейса управления OpenSCADA
1 Назначение
Данный модуль движка(модели данных) СВУ предназначен для формирования логической структуры СВУ и исполнения сеансов отдельных экземпляров проектов СВУ. Также, модуль предоставляет конечным визуализаторам СВУ все необходимые данные, как посредством локальных механизмов взаимодействия OpenSCADA, так и интерфейса управления OpenSCADA, для удалённого доступа.
Финальная версия этого модуля СВУ обеспечит:
Перечислим возможности, которые сможет и обеспечивает СВУ, построенная на основе данного проекта:
- три уровня сложности в формировании интерфейса визуализации, позволяющие органично осваивать и применять инструментарий по принципу — от простого к сложному:
- формирование из шаблонных кадров, путём назначения динамики и без графической конфигурации;
- графическое формирование новых кадров, путём использования готовых элементов визуализации из библиотеки — мнемосхемы;
- формирование, в библиотеке, новых: кадров, шаблонных кадров и элементов отображения.
- построение интерфейсов визуализации практически любой сложности (ограниченную "дискретностью" функций примитивов), начиная от простых интерфейсов мониторинга и, заканчивая полноценными иерархическими интерфейсами, используемыми в SCADA системах;
- предоставление различных способов формирования и конфигурации пользовательского интерфейса, основанных на различных интерфейсах графического представления (Qt, Web, ...), или-же посредством стандартного интерфейса управления OpenSCADA;
- построение и коррекция интерфейса, установка и смена динамики в процессе исполнения;
- построение, на уровне пользователя, новых шаблонных кадров и формирование специализированных, под область применения, библиотек кадров (например, включение кадров параметров, графиков и других элементов с увязкой их друг с другом), согласно идее вторичного использования, накопления и совершенствования;
- построение новых пользовательских элементов визуализации и формирование специализированных, под область применения, библиотек кадров, согласно идее вторичного использования, накопления и совершенствования;
- описание логики новых шаблонных кадров и пользовательских элементов визуализации как простыми связями, так и лаконичным, полноценным языком пользовательского программирования;
- возможность включение, в пользовательские элементы визуализации, функций (или кадров вычисления функций) объектной модели OpenSCADA, практически связывая представление с алгоритмом вычисления; например, визуализируя библиотеку моделей аппаратов ТП, для последующего визуального построения моделей ТП;
- разделение данных пользовательских интерфейсов и интерфейсов представления этих данных, позволяющее строить интерфейс пользователя в одной среде, а исполнять во многих других (Qt, Web, ...);
- возможность подключения к исполняющемуся интерфейсу для наблюдения и коррекции действий; например, при обучении операторов и контроля за его действиями в реальном времени;
- визуальное построение различных схем с наложением логических связей и последующим централизованным исполнением в фоне — визуальное построение и исполнение математических моделей, логических схем, релейных схем и иного;
- предоставление, в OpenSCADA, функций объектного API; может использоваться для управления свойствами интерфейса визуализации из пользовательских процедур;
- построение серверов для: кадров, элементов визуализации и проектов интерфейсов визуализации; с возможностью обслуживания множественных клиентских соединений;
- простая организация клиентских станций на различной основе (Qt, Web, ...), с подключением к центральному серверу;
- полноценный механизм разделения полномочий между пользователями, позволяющий создавать и исполнять проекты с различными правами доступа к его компонентам;
- гибкое формирование правил сигнализаций и уведомления, с учётом и поддержкой различных способов уведомления;
- поддержка пользовательского формирования палитры и шрифтовых предпочтений интерфейса визуализации, в стилях;
- поддержка пользовательского формирования карт событий под различное оборудование управления и пользовательские предпочтения;
- поддержка профилей пользователей, позволяющая определять различные свойства интерфейса визуализации (цветовая гамма, шрифтовые особенности, предпочтительные карты событий);
- гибкое хранение и распространение библиотек виджетов, кадров и проектов интерфейсов визуализации в БД, поддерживаемых OpenSCADA; практически, пользователю нужно только зарегистрировать полученную БД с данными.
2 Конфигурация и формирование интерфейсов СВУ
Сам модуль не содержит механизмов визуального формирования интерфейсов СВУ, такие инструменты могут предоставляться модулями конечной визуализации СВУ, например, он предоставляется модулем Vision.
Хотя визуальных механизмов формирования СВУ модулем не предоставляется, для управления логической структурой предоставляется механизм, реализованный на основе интерфейса управления OpenSCADA, а значит, доступный для использования в любом конфигураторе OpenSCADA. Диалоги этого интерфейса рассмотрены далее, в контексте рассмотрения архитектуры модуля и его данных.
3 Архитектура
СВУ, в целом, может работать в двух режимах — разработки и исполнения. В режиме разработки формируется интерфейс СВУ и его компоненты, определяются механизмы взаимодействия. В режиме исполнения выполняется формирование интерфейса СВУ и производится взаимодействие с конечным пользователем, на основе разработанных СВУ.
Интерфейс СВУ формируется из кадров, каждый из которых, в свою очередь, формируется из элементов примитивов или пользовательских элементов интерфейса. При этом, пользовательские элементы интерфейса также формируются из примитивов или других пользовательских элементов. Таким образом обеспечивается иерархичность и повторное использования уже разработанных компонентов.
Кадры и пользовательские элементы размещаются в библиотеках виджетов. Из элементов этих библиотек формируются проекты интерфейсов конечной визуализации СВУ. На основе-же этих проектов формируются сеансы визуализации.
Описанная структура СВУ приведена на рисунке.
Данная архитектура СВУ позволяет реализовать поддержку трёх уровней сложности у процесса разработки интерфейсов управления:
- Формирования интерфейса визуализации и управления (ВУ) с помощью библиотеки шаблонных кадров, путём помещения шаблонов кадров в проект и назначения динамики.
- В дополнении к первому уровню производится формирование собственных кадров на основе библиотеки производных и базовых виджетов. Возможно как прямое назначение динамики в виджете, так и последующее её назначение в проекте.
- В дополнении ко второму уровню производится самостоятельное формирование производных виджетов, новых шаблонных кадров, а также кадров с использованием механизма описания логики взаимодействия и обработки событий на языке пользовательского программирования OpenSCADA.
3.1 Кадры и элементы отображения (виджеты)
Кадр это окно, непосредственно предоставляющее информацию пользователю в графической и/или текстовой форме. Группа взаимосвязанных кадров формирует цельный пользовательский интерфейс ВУ.
Содержимое кадра формируется из элементов отображения (виджетов). Виджеты могут быть базовыми примитивами (различные элементарные фигуры, текст, тренд и т.д.) и производными, сформированные из базовых или других производных виджетов. Все виджеты группируются по библиотекам. В процессе работы, пользователь может формировать собственные библиотеки производных виджетов.
Собственно сам кадр также является виджетом, который используется в роли конечного элемента визуализации. А это значит, что библиотеки виджетов могут хранить и заготовки кадров, и шаблоны результирующих страниц пользовательского интерфейса.
Кадры и виджеты являются пассивными элементами, которые обычно не содержат связей с динамикой и другими кадрами, а только предоставляют информацию о свойствах и характере динамики(конфигурации), подключаемой к свойствам. Активированные кадры, содержащие ссылки на динамику и активные связи, формируют пользовательский интерфейс и хранятся в проектах. В некоторых случаях возможно прямое назначение динамики в заготовках кадров.
Производные кадры/виджеты могут содержать вложенные виджеты, которые могут быть склеены-связаны один с другим логикой, с помощью языка пользовательского программирования OpenSCADA.
Виджет является элементом, посредством которого обеспечивается:
- визуализация оперативной и архивной информации ведения ТП;
- сигнализация про нарушения ведения ТП;
- переключение между кадрами ТП;
- управление технологическим оборудованием и параметрами ведения ТП.
Настройка и связывание виджетов производится посредством их свойств. Родительский виджет, и виджеты содержащиеся в нем, могут дополняться пользовательскими свойствами. В последствии, пользовательские и статические атрибуты связываются со свойствами вложенных виджетов, посредством внутренней логики. Для отображения динамики (текущих и архивных данных) свойства виджетов динамизируются, т.е связываются с атрибутами параметров OpenSCADA или свойствами других виджетов. Использование, для связывания вложенных виджетов внутренней логикой, языка пользовательского программирования OpenSCADA снимает вопрос реализации сложной логики визуализации, обеспечивая тем самым высокую гибкость. Практически, можно создавать полностью динамизированные кадры со сложными взаимосвязями на уровне пользователя.
3.2 Проект
Непосредственная конфигурация, и свойства конечного интерфейса визуализации, содержатся в проекте интерфейса визуализации СВУ, которых может быть создано множество.
Каждый проект включает страницы из библиотек кадров-виджетов. В ряде режимов, сама страница может включать в себя вложенные страницы как независимые от родительской, так и с использованием родительского в роли шаблона. Шаблонные страницы-виджеты позволяют предельно упростить процесс создания однотипных кадров простого мониторинга, инженером АСУ ТП или пользователем OpenSCADA. Примером таких однотипных кадров могут быть: группы контуров, группы графиков, протоколы и различные сводные таблицы. Мнемосхемы технологических процессов редко подпадают под такую схему и формируются в отдельной странице-виджете.
Страница, как и виджет на котором она основана, предоставляет возможность привязки динамики к описанным в ней свойствам — связи, которые могут быть установлены динамикой или константами. Кроме того, связывание непосредственно на уровне страницы проекта является предпочтительным, чем осуществление этого на уровне виджетов библиотек.
Пример иерархического представления компонентов проекта классического интерфейса ВУ технологического процесса, с описанием выражений стандартных вызовов, приведен на рисунке.
Предусмотрены следующие специальные свойства страниц:
- Контейнер — страница является контейнером вложенных страниц.
- Шаблон — страница является шаблоном вложенных страниц.
- Пусто — пустая и неактивная страница. Это свойство используется совместно со свойством Контейнер, для организации логических контейнеров страниц.
- Связь — связь на другую страницу ка контейнер под-страниц, которые будут использоваться на стороне исполнения проектов (сеансов) без их отдельного создания.
На комбинациях вышеуказанных специальных свойств страниц реализованы следующие их типы:
- Стандарт — стандартная страница (не установлено ни одно из свойств), является полноценной конечной страницей.
- Контейнер — полноценная страница со свойством контейнера (Контейнер).
- Логический контейнер — логический контейнер, фактически сам не являющийся страницей (Контейнер|Пусто), выполняет роль промежуточного и группирующего элемента в дереве страниц.
- Шаблон — страница-шаблон (Шаблон). Чистая шаблонная страница, используется для описания общих свойств и доопределения их во вложенных страницах, в частном порядке.
- Контейнер и шаблон — страница шаблон и контейнер (Шаблон|Контейнер), совмещает функции шаблона и контейнера.
- Связь — связь на другую страницу. Связи могут быть использованы на полностью динамических и высоко тиражируемых страницах, для оптимизации использования памяти. Для разделения открытия связанных страниц Вы должны использовать атрибут "path". Функция uiCmd() пользовательского API должна использоваться для управления страницами этого типа вместо прямой записи в атрибуты страниц "pgOpen" и "pgOpenSrc".
На стороне визуализации (RunTime) построена логика, регулирующая каким образом открывать страницы, на основе следующих атрибутов базового элемента "Box":
- pgOpen — признак "Страница открыта";
- pgNoOpenProc — признак "Исполнять страницу даже если она не открыта";
- pgOpenSrc — содержит адрес виджета, или страницы, открывшей текущую страницу; в случае вложенного контейнерного виджета здесь содержится адрес включаемой страницы; для открытия страницы из скрипта достаточно здесь указать адрес виджета-источника открытия, но для страниц типа "Связь" Вы должны отдавать предпочтение использованию функции uiCmd() пользовательского API, для управления страницами;
- pgGrp — группа страниц, используется для связки контейнеров страниц со страницами, согласно общей группы. ПУСТАЯ и "main" группа предусматривает использование этой страницы как Корневую-основную страницу, т.е. такая будет заменять другие Корневые-главные страницы; группа "fl" предназначена для использования во внешних окнах, которые предусмотрены для многоразового одновременного открытия и которые не должны отслеживаться на дубликаты; остальные предусмотрено для включения в контейнеры-боксы или одноразового одновременного открытия, т.е. они принудительно проверяются на дубликаты, когда последнее открывается, а предыдущие закрываются.
Логика определения способа открытия страниц работает следующим образом:
- если страница имеет группу "main" или совпадает с группой страницы в главном окне или нет страницы на главном окне, то открывать страницу в главном окне;
- если страница имеет группу, которая совпадает с группой одного из контейнеров текущей страницы, то открыть в этом контейнере;
- если источник открытия страницы совпадает с текущей страницей, то открыть в виде дополнительного окна над текущей страницей;
- передать вызов на запрос открытия дополнительным окнам, с обработкой у каждого по первым трем пунктам;
- если никто из родственных окон не открыл новую страницу то открыть её как родственное окно главного окна.
3.3 Сеанс исполнения проекта
Сеанс проекта это развёрнутое дерево проекта непосредственного его исполнения, включающего отдельную задачу иерархического исполнения процедур виджетов. Для каждого проекта может быть открыто множество сеансов. Формирование конечного интерфейса визуализации осуществляется визуализаторами, исходя из данных сеанса проекта, после создания сеанса по запросу.
Между виджетами, на различных уровнях иерархии, в конечном счёте выстраиваются достаточно сложные наследственные связи, которые определяются возможностью использования одних виджетов другими, начиная с библиотечного виджета и заканчивая виджетом сеанса. Для разъяснения этих особенностей взаимодействия, на рисунке изображена исчерпывающая карта "использующего" наследования.
На уровне сеансов, виджет содержит объект значений процедуры обсчёта. Этот объект инициируется и используется в случае наличия самой процедуры вычисления. В момент инициализации создаётся перечень параметров процедуры и выполняется её компиляция с этими параметрами, в модуле, реализующем выбранный язык программирования и с названием результирующей процедуры в виде закодированного полного имени виджета. Скомпилированная функция подключается к объекту значений процедуры обсчёта, а далее выполняется её вычисление с периодом сеанса.
Вычисление и обработка виджета выполняется в следующей последовательности:
- выбираются события, доступные на момент вычисления, из атрибута "event" виджета;
- события загружаются в параметр "event" объекта вычисления;
- в объект вычисления загружаются значения по входным связям;
- в объект вычисления загружаются значения специальных переменных (f_frq, f_start и f_stop);
- в объект вычисления загружаются значения выбранных параметров виджета;
- вычисление;
- выгрузка значений объекта вычисления в выбранные параметры виджета;
- выгрузка событий из параметра "event" объекта вычисления;
- обработка событий и передача необработанных на уровень выше.
Объекты сеанса наследуются от абстрактного объекта "Widget" и используют соответствующие объекты проекта. Так, сеанс "Session" использует проект "Project" и формирует на основе него развёрнутое дерево. Страница проекта "Page" прямо используется страницей сеанса "SessPage". Остальные объекты "SessWdg" разворачиваются в соответствии с иерархией элементов страницы.
В дополнение к стандартным свойствам абстрактного виджета "Widget", элементы страницы и сами страницы сеанса получают свойства: хранения объекта значений вычислительной процедуры, обсчёта процедур и механизм обработки событий. Страницы сеанса, в дополнение ко всему, содержат контейнер следующих по иерархии страниц. Сеанс, в целом, вычисляется с указанной периодичностью и в последовательности:
- "Страница верхнего уровня" -> "Страница нижнего уровня"
- "Виджет нижнего уровня" -> "Виджет верхнего уровня"
Такая политика позволяет обходить страницы в соответствии с их иерархией, а событиям в виджетах "всплывать" на верх за одну итерацию.
Сеансы поддерживают многоязычность на уровне интерфейса управления OpenSCADA, которая зависит от значения общих атрибутов "lang" и "user", и которые визуализатор может устанавливать в соответствии со своим языком. Эта функция включается динамическим переводом сообщений OpenSCADA.
3.4 Стили
Известно, что человек может иметь индивидуальные особенности восприятия графической информации. Если эти особенности не учитывать то можно получить неприятие и отторжение пользователя к интерфейсу ВУ. Такое неприятие и отторжение может привести к фатальным ошибкам при управлении ТП, а также травмировать человека постоянной работой с интерфейсом. В SCADA системах приняты соглашения, которые регламентируют требования по созданию унифицированного интерфейса ВУ, нормально воспринимаемого большинством людей. При этом, практически отсутствует учёт особенностей людей с некоторыми отклонениями.
С целью учесть это обстоятельство, и предоставить возможность централизованно и просто изменять визуальные свойства интерфейса, проектом реализуется менеджер стилей интерфейса визуализации.
Пользователем может быть создано множество стилей, каждый из которых будет хранить цветовые, шрифтовые и другие свойства элементов кадра. Простая смена стиля позволит быстро преобразить интерфейс ВУ, а возможность назначения индивидуального стиля для пользователя позволит учесть его особенности.
Для реализации этой возможности, при создании кадров, необходимо для свойств цвета, шрифта и других установить параметр "Конфигурация" (таблицы во вкладке "Обработка") в значение "Из стиля". А в параметре "Конфигурационный шаблон" указать идентификатор поля стиля. Далее, это поле автоматически появится в менеджере стилей и его можно будет там менять. Менеджер стилей доступен на странице конфигурации проекта во вкладке "Стили". На этой вкладке можно стили создавать, удалять и изменять, удалять их поля.
В целом, стили доступны начиная с уровня проектов. На уровне библиотек виджетов можно только определять поля стилей у виджетов. На уровне проекта, при выборе стиля, включается работа со стилями, что предполагает доступ к полям стилей вместо непосредственных значений атрибутов. Фактически, это означает, что при чтении или записи атрибута виджета, указанные операции будут осуществляться над соответствующим полем выбранного стиля.
При запуске проекта на исполнения будет использован установленный в проекте стиль. В последствии, пользователь может выбрать стиль из перечня доступных. Выбранный пользователем стиль будет сохранён и использован при следующем запуске проекта.
3.5 События, их обработка и карты событий
Учитывая спектр задач, для которых может использоваться OpenSCADA, нужно предусмотреть механизм управления интерактивными пользовательскими событиями. Это связано с тем, что при решении отдельных задач встраиваемых систем, устройства ввода и управления могут значительно отличатся. Впрочем, достаточно взглянуть на обычную офисную клавиатуру и клавиатуру ноутбука, чтобы снять любые сомнения о необходимости менеджера событий.
Менеджер событий должен работать используя карты событий. Карта событий — это список именованных событий с указанием его происхождения. Происхождением события может быть клавиатура, манипулятор мыши, джойстик и т.д. При возникновении события менеджер событий ищет его в активной карте и сопоставляет с именем события. Сопоставленное имя события помещается в очередь на обработку. Виджеты, в этом случае, должны обрабатывать полученную очередь событий.
Активная карта событий указывается в профиле каждого пользователя или устанавливается по умолчанию, в планах.
В целом, предусмотрены четыре типа событий:
- события образов-примитивов СВУ (префикс: ws_), например, событие нажатия экранной кнопки — "ws_BtPress";
- клавишные события (префикс: key_) — все события от клавиатуры и мыши в виде "key_presAlt1";
- пользовательские события (префикс: usr_), генерируются пользователем в процедурах обсчёта виджетов;
- мапированные события (префикс: map_) — события, полученные из карты событий, в планах.
Само событие представляет недостаточно информации, особенно если его обработка происходит на уровнях выше. Для однозначной идентификации события и его источника, событие, в целом, записывается следующим образом: "ws_BtPress:/curtime". Где:
- ws_BtPress — событие;
- /curtime — путь к дочернему элементу, сгенерировавшее событие.
В таблице 3.5 приведён перечень стандартных событий, поддержка которых должна быть обеспечена в визуализаторах СВУ.
Таблица 3.5. Стандартные события
Идентификатор | Описание |
---|---|
Клавиатурные события: key_[pres|rels][Ctrl|Alt|Shift]{Key} | |
*SC#3b | Скан-код клавиши. |
*#2cd5 | Код неименованной клавиши. |
*Esc | "Esc". |
*BackSpace | Удаление предыдущего символа — "<-". |
*Return, *Enter | Ввод — "Enter". |
*Insert | Вставка — "Insert". |
*Delete | Удаление — "Delete". |
*Pause | Пауза — "Pause". |
Печать экрана — "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}". Где:
- event — ожидаемое событие;
- evSrc — путь вложенного виджета-источника события;
- com — команда сеанса;
- prm — параметр команды.
Реализованы следующие команды:
- open — открытие страницы; открываемая страница указывается в параметре prm как прямо, так и в виде шаблона, например — /pg_so/1/*/*;
- next — открытие следующей страницы; открываемая страница указывается в параметре prm, в виде шаблона, например: /pg_so/*/*/$;
- prev — открытие предыдущей страницы; открываемая страница указывается в параметре prm, в виде шаблона, например: /pg_so/*/*/$.
Специальные символы шаблона расшифровываются следующим образом:
- pg_so — прямое имя требуемой-статической страницы (с префиксом), требует обязательного соответствия и используется для идентификации предыдущей открытой страницы;
- 1 — имя и место новой страницы в общем пути (без префикса);
- * — страница берётся из имени предыдущей открытой страницы или подставляется первая доступная страница, если предыдущая открытая отсутствует;
- $ — указывает на место открытой страницы, относительно которой необходимо искать следующую или предыдущую.
Для правильного понимания работы механизма шаблонов, при выборе страницы, приведём несколько реальных примеров:
- Переключение объекта сигнализации:
- Исходно: /pg_so/pg_1/pg_mn/pg_1
- Команда: open:/pg_so/2/*/*
- Результат: /pg_so/pg_2/pg_mn/pg_1
- Переключение вида отображения:
- Исходно: /pg_so/pg_1/pg_mn/pg_1
- Команда: open:/pg_so/*/gkadr/*
- Результат: /pg_so/pg_1/pg_gkadr/pg_1
- Следующая/предыдущая страница вида отображения:
- Исходно: /pg_so/pg_1/pg_mn/pg_1
- Команда: next:/pg_so/*/*/$
- Результат: /pg_so/pg_1/pg_mn/pg_2
В качестве примера, приведём сценарий обеспечения работы главной страницы интерфейса пользователя:
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:
for(ev_rez = "", off = 0; (sval=event.parse(0,"\n",off)).length; ) { if(sval == "ws_BtPress:/cvt_light") alarmSt = 0x1000001; else if(sval == "ws_BtPress:/cvt_alarm") alarmSt = 0x1000002; else if(sval == "ws_BtPress:/cvt_sound") alarmSt = 0x1000004; else ev_rez += sval+"\n"; } event = ev_rez;
3.6 Сигнализация
Важным элементом любого интерфейса визуализации является уведомление пользователя про нарушения — сигнализация. Для упрощения восприятия, а также в виду тесной связи визуализации и уведомления (как правило, уведомление дополняет визуализацию) решено интегрировать интерфейс уведомления в интерфейс визуализации. Для этого, во всех виджетах, предусматриваются два дополнительных атрибута уровня сеанса: "alarm" и "alarmSt". Атрибут "alarm" используется для формирования сигнала виджетом в соответствии с его логикой, а атрибут "alarmSt" используется для контроля за фактом сигнализации ветви дерева сеанса.
Атрибут "alarm" является строкой, которая имеет следующий формат: "{lev}|{categ}|{message}|{type}|{tp_arg}"
Где:
- lev — уровень сигнализации: число от 0 до 255;
- categ — категория сигнала: параметр подсистемы сбора, объект, путь или комбинация;
- message — сообщение сигнализации;
- type — типы уведомления, указываются в виде целого числа (0...7), содержащего флаги способов уведомлений; типовые способы уведомления:
- 1 — визуальная;
- 2 — гудок, часто производится через PC-speaker;
- 4 — звуковой сигнал из файла звука или синтез речи; если в tp_arg указано имя ресурса звукового файла, то воспроизводится именно он, иначе выполняется синтез речи из текста, указанного в message.
- tp_arg — аргумент типа; часто используется для прямого указания ресурса звукового сигнала — файл звукового формата, при осуществлении звуковой сигнализации.
Атрибут "alarmSt" является целым числом, которое отражает максимальный уровень сигнала и факт квитирования ветви дерева сеанса. Формат числа имеет следующий вид:
- первый байт (0...255) характеризует уровень сигнала ветви;
- второй байт указывает тип уведомления, также как и в атрибуте "alarm";
- третий байт указывает тип несквитированного уведомления, также как и в атрибуте "alarm";
- четвёртый байт имеет специальное значение, определяемое отдельными битами:
- бит 0 — указывает, установкой, на факт квитирования уведомлений в первом байте;
- бит 1 — указывает, при установке его и бита 0, на возврат квитирования — включение уведомления.
Формирование сигнала и получение его визуализатором.
Формирование сигнала производится самим виджетом, путём установки собственного атрибута "alarm" нужным образом и, в соответствии с ним, автоматически устанавливается атрибут "alarmSt" текущего и вышестоящих виджетов. Визуализаторы получают уведомление о сигнале с помощью стандартного механизма уведомления об изменении атрибутов виджетов.
Учитывая то, что обработка условий сигнализации осуществляется в виджетах, страницы, содержащие объекты сигнализации, должны исполняться в фоне, независимо от открытости их в данный момент. Это осуществляется путём установки флага исполнения страницы в фоне.
Хотя механизм сигнализации и построен в среде визуализации, возможность формирования невизуальных элементов сигнализации остаётся, например, путём создания страницы, которая никогда не будет открываться.
Квитация
Квитация (от quietance) — процесс подтверждения факта того, что оперативный персонал обратил внимание на нарушение в работе ТП. Обычно этот процесс подразумевает принятие мер оператором для устранения нарушения и нажатие соответствующей кнопки прекращения сигнализации.
Квитация производится путём указания корня ветви виджетов и типов уведомления, что позволяет реализовать квитацию на стороне визуализатора как по группам, например, по объектам сигнализации, так и индивидуально по объектам источника. При этом можно независимо квитировать разные типы сигнализаций. Установка квитации производится простой модификацией атрибута "alarmSt".
Пример скрипта, для работы с сигналами, приведён ниже:
//Выделение факта наличия сигнализаций разных способов-типов уведомления cvt_light_en = alarmSt&0x100; cvt_alarm_en = alarmSt&0x200; cvt_sound_en = alarmSt&0x400; //Выделение факта наличия несквитированных сигнализаций разных способов уведомления cvt_light_active = alarmSt&0x10000; cvt_alarm_active = alarmSt&0x20000; cvt_sound_active = alarmSt&0x40000; //Обработка событий кнопок квитации и квитация разных способов уведомлений for(ev_rez = "", off = 0; (sval=event.parse(0,"\n",off)).length; ) { if(sval == "ws_BtPress:/cvt_light") alarmSt = 0x1000001; else if(sval == "ws_BtPress:/cvt_alarm") alarmSt = 0x1000002; else if(sval == "ws_BtPress:/cvt_sound") alarmSt = 0x1000004; else ev_rez += sval + "\n"; } event = ev_rez;
Внешние методы уведомления
Основным и типовым способом уведомления является дисплейная световая сигнализация аварийными цветами и их динамикой у элементов визуализации, которая присутствует всегда и не требует специфической конфигурации. Однако, часто нужны уведомления внешнего типа, например: внешней лампой, бузером PC или "ревуном", произвольным звуком, синтезированной речью и т.д.
Для осуществления такой возможности, внешние способы уведомления, и соответствующие им типы уведомления, свободно описываются для сервера визуализации и самого визуализатора. На стороне сервера визуализации описывается формирование/получение ресурса уведомления и само уведомление. На стороне визуализатора описывается уведомление согласно ресурсам сервера визуализации.
Описание правил и сценариев внешних уведомлений осуществляется с помощью пользовательских атрибутов текстового типа для страниц проекта визуализации, которые применяются при открытии этих страниц. Т.е. потенциально, для каждой открываемой страницы можно описать собственные правила уведомления, хотя, обычно достаточно и описываются общие правила уведомления на главной странице проекта — странице, которая открывается один раз и не закрывается при работе:
- Для сервера/движка визуализации, атрибутом "notify{N}" в формате:
//flags=notifyServ[{DL}][|resource[|queue[|qMergeMess]]]; //resStatic={ResourceFile} if(doRes) { Текст команды формирования ресурса. } if(doNtf) { Текст команды уведомления. }
- Для визуализатора, атрибутом "notifyVis[Vision|WebVision]{N}" в формате:
//flags=notify[{DL}][|resource[|queue[|quietanceRet]]]; //name={Имя уведомителя} //ico={Имя иконки} { Текст команды уведомления для любого или конкретного визуализатора. }
Флаги:
- notify[{DL}], notifyServ[{DL}] — включает уведомление c повтором через время DL, если указано; для DL = 0 повтор производится сразу.
- resource — запрашивать-формировать (принудительно) ресурс уведомления у сервера визуализации, может быть звуковым файлом, текстом или другими данными формирования уведомления; но на данное время уведомители в основном ожидают аудио.
- queue — ресурсы уведомления определяются не только по глобальному признаку нарушения и квитации, а и согласно приоритетной очереди источников уведомления-ресурсов. Очередь формируется на стороне сервера визуализации, а для визуализаторов указывается необходимость работы с ней при запросе ресурсов.
- qMergeMess — объединять уведомления в очереди по равенству сообщения.
- quietanceRet — возможность отзыва-возврата квитации визуализатора, т.е. по сути — обратного включения уведомления.
Наличие поля "resStatic" включает получение ресурса непосредственно из таблицы ресурсов или файла, указывается в способ подобный примитиву "Медиа".
Переменные обмена:
- en[0,1] — уведомление включить (1) или выключить (0);
- doNtf[0,1] — вызов сценария уведомления;
- doRes[0,1] — вызов сценария формирования ресурса;
- res — содержимое или имя файла с содержимым ресурса, для внешних сценариев;
- resTp — тип ресурса, вроде "audio/ogg"; является возвратом и помещается в стандартный выход (для Shell) для doRes;
- mess — сообщение-параметры формирования ресурса и уведомления;
- lang — язык текущего пользователя или системы;
- prcID — уникальный идентификатор процедуры (вроде "ses_AGLKS_ntf2"), в основном для безопасного создания временных файлов.
Примеры и комментарии к работе типовых способов уведомлений:
- Бузер на стороне визуализатора или сервера визуализации:
- alarm = "10|Prm||0x02"
- notifyVisVision1 | notify1 =
//flags=notify|notifyServ|notifyServ if(en) SYS.system("beep -f 1000 -l 1000000 &", true); else if((beepPID=SYS.system("pidof beep")).toInt()) SYS.system("kill "+beepPID);
- notifyVisVision1 | notify1 =
#!/bin/sh #flags=notify|notifyServ if test $en = 1; then beep -f 1000 -l 1000000 & else beepPID=$(pidof beep) if test "x$beepPID" != "x"; then kill $beepPID; fi fi
- Повторяющееся проигрывание готового звукового файла, одного общего, на стороне визуализатора или сервера визуализации:
- alarm = "10|Prm||0x04"
- notify2 | notifyVisVision2 =
//flags=notify2|notifyServ2 if(en) SYS.system("play -q alarm.ogg");
- notify2 | notifyVisVision2 =
#!/bin/sh #flags=notify2|notifyServ2 if test $en = 1; then play -q alarm.ogg; fi
- Проигрывание индивидуального, для источника, звукового файла, на стороне визуализатора:
- alarm = "10|Prm||0x04|res:al_prm1"
- notify2 =
//flags=queue
- notifyVisVision2 =
//flags=notify2|queue if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
- notifyVisVision2 =
#!/bin/sh #flags=notify2|queue if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
- Синтез речи индивидуального сообщения, для источника, на стороне визуализатора:
- alarm = "10|Prm|Текстовое сообщение синтеза речи|0x04"
- notify2 =
//flags=queue
- notifyVisVision2 =
//flags=notify2|queue if(doNtf && en && mess.length) { SYS.fileWrite("tmpForSpeech", mess); SYS.system("festival --tts tmpForSpeech"); SYS.fileRemove("tmpForSpeech"); }
- notifyVisVision2 =
#!/bin/sh #flags=notify2|queue if test $doNtf = 1 -a $en = 1 -a "x" != "x$mess"; then echo $mess > tmpForSpeech festival --tts tmpForSpeech rm tmpForSpeech fi
- Подготовка звукового файла, одного общего, и его проигрывание на стороне визуализатора или сервера визуализации:
- alarm = "10|Prm||0x04"
- notify2 =
//flags=notify2|notifyServ2|resource if(doRes) res = SYS.fileRead("alarm.ogg"); //Вставить сюда другой метод генерации if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
- notify2 =
#!/bin/sh #flags=notify2|notifyServ2|resource if test $doRes = 1; then cp -f alarm.ogg $res; fi #Вставить сюда другой метод генерации if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
- notifyVisVision2 =
//flags=notify2|resource if(en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
- notifyVisVision2 =
#!/bin/sh #flags=notify2|resource if test $en = 1 -a -s $res; then play -q $res; fi
- Подготовка индивидуального, для источника уведомления, звукового файла через синтез речи, на стороне визуализатора или сервера визуализации:
- alarm = "10|Prm|Текстовое сообщение синтеза речи|0x04"
- notify2 =
//flags=notify2|notifyServ2|queue if(doRes && mess.length) { SYS.fileWrite("tmpText", mess); SYS.system("text2wave tmpText -o tmpWAV"); res = SYS.fileRead("tmpWAV"); SYS.fileRemove("tmpText"); SYS.fileRemove("tmpWAV"); } if(doNtf && en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
- notify2 =
#!/bin/sh #flags=notify2|notifyServ2|queue if test $doRes = 1 -a "x" != "x$mess"; then echo $mess > tmpText text2wave tmpText -o $res rm tmpText fi if test $doNtf = 1 -a $en = 1 -a -s $res; then play -q $res; fi
- notifyVisVision2 =
//flags=notify2|queue if(en && res.length) { SYS.fileWrite("tmpPlay", res); SYS.system("play -q tmpPlay"); SYS.fileRemove("tmpPlay"); }
- notifyVisVision2 =
#!/bin/sh #flags=notify2|queue if test $en = 1 -a -s $res; then play -q $res; fi
3.7 Управление правами
Для разделения доступа к интерфейсу ВУ и его составляющим, каждый виджет содержит информацию о владельце, его групах и правах доступа. Права доступа записываются в виде триады: "{пользователь}{группа[,группа1,группаN]}{остальные}", где каждый элемент состоит из двух признаков доступа, для которых принята следующая интерпретация:
- r — право на просмотр виджета;
- w — право на контроль над виджетом.
В режиме разработки используется простая схема доступа "root:UI|RWRWR_", что означает — все пользователи могут открывать и просматривать библиотеки, их компоненты и проекты; а редактировать могут все пользователи группы "UI" (пользовательские интерфейсы).
В режиме исполнения работают права, описанные в компонентах интерфейса, которые предусматривают возможность наследования владельца и прав, сверху вниз. Причём, по умолчанию, наследование включено в каждом виджете, а значит — они получат владельца и права проекта. В тоже время, прямая установка прав составного виджета распространит их на все компоненты этого виджета.
3.8 Связывание с динамикой
Для предоставления в интерфейс визуализации актуальных данных, должны использоваться данные подсистемы "Сбор данных (DAQ)". Природа этих данных следующая:
- параметры, содержащие некоторое количество атрибутов;
- атрибуты параметра могут предоставлять данные пяти базовых типов: Логический, Целый, Вещественный, Строковый и Объект;
которые дополнено СВУ модификаторами: "Выбирается"; вариантами Строки: "Текст", "Перевод", "Цвет", "Изображение", "Шрифт", "Адрес"; вариантами Целого: "ДатаВремя". - атрибуты параметра могут иметь архив (историю);
- атрибуты параметра могут быть на чтение, запись и с полным доступом.
Учитывая первый пункт, нужно обеспечить возможность группового назначения ссылки. Для этого используем концепцию логического уровня.
В соответствии с пунктом 2, связи обеспечивают прозрачное преобразование типов и не требуют специальной конфигурации.
Для удовлетворения возможности доступа к архивам, в соответствии с пунктом 3, связи выполняют проверку типа атрибута и, в случае подключения к "Адресу", в значение помещается адрес связи.
В терминах СВУ, динамические связи и конфигурация динамики являются одним процессом, для описания конфигурации которого предусматривается вкладка "Обработка" виджетов. Вкладка содержит таблицу конфигурации свойств атрибутов и текст процедуры вычисления виджета.
Кроме полей конфигурации атрибутов, в таблице предусматривается колонка "Обработка", для избирательного использования атрибутов в вычислительной процедуре виджета, и колонки "Конфигурация", "Конфигурационный шаблон" для описания конфигурации связей.
Если в колонке "Обработка" стоит true, то в вычислительной процедуре становится доступной переменная {идентификатор виджета}_{идентификатор атрибута}, например cw_value.
Колонка "Конфигурация" позволяет указать тип связи атрибута виджета:
- Постоянная — во вкладке связей виджета появляется поле указания постоянной, например, особого цвета или заголовка шаблонных кадров.
- Входная связь — связь с динамикой только для чтения.
- Выходная связь — связь с динамикой только для записи.
- Полная связь — полная связь с динамикой, чтение и запись.
- Из стиля — брать значение из стиля проекта.
Колонка "Конфигурационный шаблон" позволяет связать группы динамических атрибутов. Например, это могут быть разные типы параметров подсистемы "DAQ" и другие виджеты интерфейса. При корректном формировании этого поля работает механизм автоматического назначения атрибутов, при указании только параметра подсистемы "DAQ" или виджета интерфейса, что упрощает и ускоряет процесс конфигурации. Значение этой колонки имеет следующий формат:
- Для постоянной: прямое значение атрибута.
- Для связи: "{параметр}|{идентификатор}", где:
- параметр — группа атрибутов;
- идентификатор — идентификатор атрибута; именно значение в этом поле сопоставляется с атрибутами параметров DAQ после указания групповой связи, при автоматическом связывании;
- Для стиля: идентификатор-имя поля стиля.
Установка связей может быть нескольких типов, который определяется префиксом:
- val: — Прямая загрузка значения через механизм связей. Например, связь "val:100" загружает значение 100 в атрибут виджета. Часто используется в случае отсутствия конечной точки связи, с целью прямой установки значения.
- prm: — Связь на атрибут параметра или параметр, в целом, для группы атрибутов подсистемы "Сбор данных". Например, связь "prm:/LogicLev/experiment/Pi/var" осуществляет доступ атрибута виджета к атрибуту параметра подсистемы "Сбор данных". Знак "(+)", в конце адреса, указывает на успешную линковку и присутствие целевого объекта. Для атрибутов объектного типа допустим иерархический доступ к конкретному свойству объекта, путём указания его пути через символ '#', например: "prm:/LogicLev/experiment/Pi/var#pr1/pr2".
- wdg: — Связь на атрибут другого виджета или виджет, в целом, для группы атрибутов. Например, связь "wdg:/ses_AGLKS/pg_so/pg_1/pg_ggraph/pg_1/a_bordColor" осуществляет доступ атрибута одного виджета к атрибуту другого. Поддерживаются как абсолютные, так и относительные пути связей. Точкой отсчёта адреса абсолютной связи выступает объект корня модуля "VCAEngine", а значит — первым элементом абсолютного адреса является идентификатор сеанса или проекта. Первый элемент, на стороне сеанса, опускается, поэтому связи, установленные в проекте, там работают. Относительные связи берут отсчёт от виджета, где связь указана. Специальным элементом относительной связи является элемент вышестоящего узла "..".
- arh: — Особый тип связи, доступный только для отдельного атрибута типа "Адрес", который позволяет подключиться прямо к архиву значений ("arh:CPU_load"). Может быть полезен для указания архива в качестве источника данных примитива "Диаграмма".
Обработка связей происходит с периодичностью вычисления виджета, в порядке:
- получение данных входных связей;
- выполнение вычисления процедуры виджета;
- передача значений по выходным связям.
Период вычисления виджета в значении по умолчанию "-1" означает цепное использование значения периода владельца виджета до первого положительного значения, или периода вычисления проекта.
На рисунке представлена вкладка связей с групповым назначением атрибутов, путём указания только параметра. На следующем рисунке представлено индивидуальное назначение атрибутов.
При размещении виджета в контейнер виджетов все связи исходного виджета добавляются в список результирующих связей контейнера виджетов, однако, только на глубину в один уровень вложения.
Из вышесказанного видно, что связи устанавливаются пользователем в процессе конфигурации интерфейса. Однако, для предоставления возможности создания кадров общего назначения с функцией предоставления детализированных данных разных источников одного типа, необходим механизм динамической установки связей. Такой механизм предусматривается:
- резервированием ключевого идентификатора "<page>" для группы атрибутов связей у кадров общего назначения;
- динамическим назначением связей с идентификатором "<page>", в процессе открытия кадра общего назначения сигналом от другого виджета.
Рассмотрим пример, когда имеется кадр общего назначения "Панель контроля графиком" и множество "Графиков" на разных кадрах. "Панель контроля графиком" имеет связи с шаблонами:
- tSek -> "<page>|tSek"
- tSize -> "<page>|tSize"
- trcPer -> "<page>|trcPer"
- valArch -> "<page>|valArch"
При этом, каждый виджет "График" имеет атрибуты "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 Примитивы виджетов
Любой вновь создаваемый виджет основывается на одном из нескольких примитивов — конечном элементе визуализации, путём установки родственной связи как прямо на примитив, так и посредством нескольких промежуточных пользовательских виджетов. Каждый из примитивов содержит механизм модели данных. Экземпляр виджета хранит значения свойств собственной конфигурации примитива.
В задачи интерфейса визуализации входит поддержка и работа с моделью данных примитивов виджетов. Примитивы виджетов должны быть тщательно проработаны и унифицированы, с целью охватить как можно больше возможностей в как можно меньшем количестве слабо связанных друг с другом, по назначению, примитивов.
Таблица. Библиотека примитивов виджетов — базовые элементы отображения
Идентификатор | Наименование | Функция |
---|---|---|
ElFigure | Элементарная графическая фигура |
Примитив является основой отрисовки элементарных графических фигур со всевозможной комбинацией их в одном объекте. Предусматривается поддержка следующих элементарных фигур:
Для всех фигур, содержащихся в виджете, устанавливаются единые свойства толщины, цвета и т.д., также, предусматривается возможность указания вышеперечисленных атрибутов для каждой фигуры отдельно и их динамизация. |
FormEl | Элемент формы |
Включает поддержку стандартных компонентов формы:
|
Text | Текст | Элемент текста-метка. Характеризуется типом шрифта, цветом, ориентацией и выравниванием. Предусматривается поддержка аргументов. |
Media | Медиа | Элемент отображения растровых и векторных изображений различных форматов, проигрывания анимированных изображений, проигрывание аудио-фрагментов и просмотр видео-фрагментов. |
Diagram | Диаграмма | Элемент диаграммы с поддержкой возможности отображения нескольких потоков в реальном времени для: трендов (временных графиков), частотного спектра, XY диаграмм. |
Protocol | Протокол | Элемент протокола — визуализатор сообщений программы, с поддержкой нескольких режимов работы. |
Document | Документ | Элемент формирования отчётов, журналов и другой документации на основе доступных данных. |
Box | Контейнер | Содержит механизм размещения-включения других виджетов для формирования новых, более сложных, виджетов и страниц конечной визуализации. |
Function, в планах | Функция API объектной модели OpenSCADA | Невизуальный виджет, на стороне исполнения, позволяющий включать вычислительные функции объектной модели OpenSCADA в СВУ. |
Таблица. Общий набор свойств/атрибутов виджета
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
id | Идентификатор | - | Идентификатор элемента. Атрибут только для чтения, призванный предоставить информацию об идентификаторе элемента. |
path | Путь | - | Путь к этому виджету. Атрибут только для чтения и предоставления исчерпывающей информации о расположения элемента. |
parent | Родитель | - | Путь к родительскому виджету. Атрибут только для чтения и предоставления информации о расположении предка от которого унаследован виджет. |
owner | Владелец | - | Владелец и группы виджета, в виде "{владелец}:{группа[,группа2,группаN]}", по умолчанию "root:UI". |
perm | Доступ | - |
Права доступа к виджету, в виде "{пользователь}{группы}{другие}" плюс флаг наследования, включающий наследование владельца и его прав от вышестоящего виджета.
По умолчанию 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}".
|
evProc | Обработка событий | - |
Атрибут хранения сценария обработки событий непосредственного управления пользовательским интерфейсом. Сценарий представляет собой список команд интерфейсу визуализации, генерируемых при поступлении события (атрибут event). Прямая обработка событий для управления страницами в виде: "{event}:{evSrc}:{com}:{prm}". Где:
Примеры:
|
Дополнительные атрибуты элементов, помещённых в проект в роли страницы. | |||
pgOpen | Страница: открыта | - |
Признак "Страница открыта".
|
pgNoOpenProc | Страница: обрабатывать закрытой | - | Признак "Исполнять страницу даже если она закрыта". |
pgOpenSrc | Страница: источник открытия | 3 |
Полный адрес страницы, открывшей данную.
|
pgGrp | Страница: группа | 4 | Группа страницы. ПУСТАЯ и "main" группа предусматривает использование этой страницы как Корневую-основную страницу, т.е. такая будет заменять другие Корневые-главные страницы; группа "fl" предназначена для использования во внешних окнах, которые предусмотрены для многоразового одновременного открытия и которые не должны отслеживаться на дубликаты; остальные предусмотрено для включения в контейнеры-боксы или одноразового одновременного открытия, т.е. они принудительно проверяются на дубликаты, когда последнее открывается, а предыдущие закрываются. |
Дополнительные атрибуты режима исполнения — сеанса. (Виртуальные атрибуты не доступны в процедуре виджета) | |||
event | События | - | Специальный атрибут сбора событий виджета в списке, разделённом новой строкой. Доступ к атрибуту защищён критической секцией для избежания потери событий. Атрибут всегда доступен в процедуре виджета. |
load | Загрузка | -1 | Виртуальная команда групповой загрузки данных. |
focus | Фокус | -2 | Специальный атрибут индикации факта получения фокуса, активным виджетом. Атрибут этого виджета и вложенных виджетов доступен в процедурах виджета. |
perm | Доступ | -3 | Виртуальный атрибут прав активного пользователя на просмотр и контроль над виджетом. |
- * — Специальная функция атрибута виджета, выполняемая в сеансе проекта при пользовательской модификации.
Движок среды визуализации предусматривает активацию атрибутов, специфичных для визуализатора. Процесс активации осуществляется при открытии сеанса визуализации проекта и предусматривает, в этом проекте: создание специфичного атрибута с указанными свойствами, если он отсутствует, и активацию отслеживания его модификации движком среды визуализации, как для атрибутов формирования образов примитивов. Для непосредственного определения такого атрибута можно также использовать префикс идентификатора атрибута "vs_", что быстрее и исключает стадию активации. С перечнем специфичных для визуализатора атрибутов можно ознакомиться в документации соответствующего визуализатора.
3.9.1 Элементарная графическая фигура (ElFigure)
Примитив является основой в отрисовке элементарных графических фигур со всевозможной их комбинацией в одном объекте. Учитывая широкий спектр всевозможных фигур, которые должен поддерживать примитив, и, в тоже время, являться достаточно простым в использовании и, по возможности, в реализации, было решено ограничить перечень базовых фигур, используемых для построения результирующих графических объектов, до таких: линия, дуга, кривая Безье и заливка замкнутых контуров. Основываясь уже на этих базовых фигурах, можно строить производные фигуры, комбинируя базовые. В рамках примитива существует возможность задания прозрачности цвета в диапазоне [0...255], где '0' — полная прозрачность.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элементарная фигура (ElFigure)"
3.9.2 Элемент формы (FormEl)
Примитив, предназначенный для предоставления, в распоряжение пользователя, стандартных элементов формы. Общий перечень атрибутов зависит от типа элемента.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент формы (FormEl)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
elType | Тип элемента | 20 | Тип элемента, от значения которого зависит перечень дополнительных атрибутов:
|
Строка редактирования: | |||
value | Значение | 21 | Содержимое строки. |
view | Вид | 22 | Вид строки редактирования:
|
cfg | Конфигурация | 23 |
Конфигурация строки. Формат значения данного поля для различных видов строки:
|
confirm | Подтверждать | 24 | Включение режима подтверждения. |
font | Шрифт | 25 |
Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:
Примеры:
|
Редактор текста: | |||
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 |
Значение, отличается для разных режимов:
|
img | Изображение | 22 |
Изображение на кнопке. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
color | Цвет | 23 |
Цвет кнопки. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
colorText | Цвет: текст | 27 | Цвет текста (детали выше). |
mode | Режим | 24 |
Режим работы кнопки:
|
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". Формат адреса зависит от режима выбора таблицы:
|
items | Элементы | 22 |
Структура и содержимое таблицы в виде XML: <tbl> <h><s>{Заголовок1}</s><s>{Заголовок2}</s></h> <r><s>{Ряд1Колонка1Строка}</s><i>{Ряд1Колонка2Целое}</i></r> <r><b>{Ряд2Колонка1Логическое}</b><r>{Ряд2Колонка2Вещественное}</r></r> </tbl> Теги:
|
font | Шрифт | 25 | Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше). |
Слайдер и полоса прокрутки: | |||
value | Значение | 21 | Положение слайдера. |
cfg | Конфигурация | 22 |
Конфигурация слайдера в формате: "{ВертОриент}:{Минимум}:{Максимум}:{ОдинШаг}:{СтрШаг}".
|
3.9.3 Элемент текста (Text)
Данный примитив предназначен для вывода простого и HTML текста, используемого в роли меток и различных подписей. С целью создания декоративных оформлений, примитив поддерживает обвод текста рамкой.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент текста (Text)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
backColor | Фон: цвет | 20 |
Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
backImg | Фон: изображение | 21 |
Фоновое изображение. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
bordWidth | Граница: ширина | 22 | Ширина бордюра. |
bordColor | Граница: цвет | 23 | Цвет бордюра (детальнее в атрибуте 20). |
bordStyle | Граница: стиль | 24 | Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий". |
font | Шрифт | 25 |
Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:
Примеры:
|
color | Цвет | 26 | Цвет текста (детальнее в атрибуте 20). |
orient | Угол поворота | 27 | Ориентация текста, угол поворота. |
wordWrap | Перенос слов | 28 | Автоматический перенос текста по словам. |
alignment | Выравнивание | 29 | Выравнивание текста: "Вверху слева", "Вверху справа", "Вверху по центру", "Вверху по ширине", "Внизу слева", "Внизу справа", "Внизу по центру", "Внизу по ширине", "По центру слева", "По центру справа", "По середине", "По центру по ширине". |
inHtml | В HTML | 31 | Отображение и поддержка содержимого аргумента text в HTML. |
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:
|
3.9.4 Элемент отображения медиа-материалов (Media)
Данный примитив предназначен для проигрывания различных медиа-материалов, начиная от простых изображений и заканчивая полноценными аудио и видео потоками.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент отображения медиа-материалов (Media)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
backColor | Фон: цвет | 20 |
Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
backImg | Фон: изображение | 21 |
Фоновое изображение. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
bordWidth | Граница: ширина | 22 | Ширина бордюра. |
bordColor | Граница: цвет | 23 | Цвет бордюра (детальнее в атрибуте 20). |
bordStyle | Граница: стиль | 24 | Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий". |
src | Источник | 25 |
Имя источника медиа в виде "[{src}:]{name}", где:
Примеры:
|
type | Тип | 27 |
Тип медиа:
|
areas | Области карты | 28 | Количество активных областей. |
Атрибуты изображения (Image) | |||
fit | Заполнять виджет | 26 | Признак "Согласовать содержимое с размером виджета". |
Атрибуты анимации-видеоролика (Animation) | |||
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. |
3.9.5 Элемент построения диаграмм (Diagram)
Данный примитив предназначен для построения различных диаграмм во времени, включая графики-тренды отображения текущего процесса и архивных данных. Реализованы следующие типы диаграмм:
- "График-тренд" — строит график значений параметра во времени.
- "Спектр" — строит частотный спектр из значений параметров. Окно данных частотного спектра формируется исходя из размера виджета по горизонтали, в пикселях, и доступных данных параметров, наложенных на сетку горизонтального размера. В связи с этим, минимальная выделяемая частота определяется значением атрибута "tSize" — "1/tSize", а максимальная, половинной шириной графика в пикселях умноженной на минимальную частоту "width/(2*tSize)".
- "XY" — строит двумерный график значений параметров, парами на график, где чётные по оси Y (0,2,4...) и нечётные по оси X (1,3,5...). Указанный временной диапазон данных используется в получении значений параметров оси X и Y, с последующим изображением.
Для всех типов диаграмм возможно указание, в качестве источника данных:
- параметра подсистемы "Сбор Данных";
- архива значений;
- прямого блока данных пользователя.
Поддерживается режим слеживания за текущими значениями и значениями с архива, а также, возможно построение графиков параметров, не имеющих архива значений, путём накопления текущих значений в буфере диаграммы и только на момент активного отображения этой диаграммы.
Процесс доступа к архивным данным оптимизирован путём ведения промежуточного буфера отображения, а также, упаковки трафика данных при запросе, путем приведения данных к качеству достаточного для отображения.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент построения диаграмм (Diagram)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
backColor | Фон: цвет | 20 |
Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
backImg | Фон: изображение | 21 |
Фоновое изображение. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
bordWidth | Граница: ширина | 22 | Ширина бордюра. |
bordColor | Граница: цвет | 23 | Цвет бордюра (детальнее в атрибуте 20). |
bordStyle | Граница: стиль | 24 | Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий". |
trcPer | Период слежения, секунд | 25 | Режим и периодичность слежения. |
type | Тип | 26 | Тип диаграммы: "График", "Спектр", "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}", где:
Примеры:
|
valArch | Архиватор значений | 38 | Архиватор значений в виде "{МодульАрхивов}.{IdАрхиватора}". |
valsForPix | Значений на пиксель | 42 | Количество значений на пиксель. Увеличить для расширения точности экспорта на больших интервалах времени. |
parNum | Количество параметров | 39 | Количество параметров, отображаемых на одном тренде. |
Атрибуты типа: "График" | |||
sclHorPer | Шкала: размер гор. решетки, секунды | 43 | Фиксированный период решётки горизонтальной шкалы — отключает автоматическое вычисление периода решётки. Активируется если количество периодов на общий размер более двух и размер одного периода не менее 15 пикселей. |
Индивидуальные атрибуты параметров | |||
prm{X}addr | Параметр {X}: адрес | 50+10*{X} |
Полный адрес к атрибуту параметра X DAQ или архиву.
Пример:
|
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). |
3.9.6 Элемент построения протоколов на основе архивов сообщений (Protocol)
Данный примитив предназначен для визуализации данных архива сообщений путём формирования протоколов с различными способами визуализации, начиная от статического сканирующего просмотра и заканчивая динамическим слеживанием.
Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент построения протоколов на основе архивов сообщений (Protocol)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
backColor | Фон: цвет | 20 |
Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
backImg | Фон: изображение | 21 |
Фоновое изображение. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
font | Шрифт | 22 |
Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:
Примеры:
|
headVis | Заголовок видим | 23 | Видимость заголовка таблицы. |
time | Время, секунды | 24 | Текущее время, секунды. |
tSize | Размер, секунды | 25 | Размер запроса данных, секунды. Установить значение в '0' для получения всех нарушений, для "lev" < 0. |
trcPer | Период слежения, секунды | 26 | Режим и периодичность слежения. |
arch | Архиватор | 27 | Архиватор сообщений в виде "{МодульАрхивов}.{IdАрхиватора}". |
tmpl | Шаблон | 28 |
Шаблон категории или регулярное выражение "/{re}/". Для шаблона зарезервированы символы:
|
lev | Уровень | 29 | Уровень сообщений. Установите значение < 0 для получения текущих нарушений. |
viewOrd | Порядок отображения | 30 | Порядок отображения: "По времени", "По уровню", "По категории", "По сообщению", "По времени (обратно)", "По уровню (обратно)", "По категории (обратно)", "По сообщению (обратно)". |
col | Показать колонки | 31 |
Список видимых и порядок колонок, разделённый символом ';'. Предусматриваются колонки:
|
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). |
3.9.7 Элемент формирования отчётной документации (Document)
Примитив предназначен для формирования отчётной, оперативной и иной документации на основе шаблонов документов.
Таблица. Набор дополнительных свойств/атрибутов примитиве "Элемент формирования отчётной документации (Document)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
style | CSS | 20 | Правила CSS в строках, вида "body { background-color:#818181; }". |
tmpl | Шаблон | 21 |
Шаблон документа в XHTML, начиная с тега "body" и включая процедурные вставки: <body docProcLang="JavaLikeCalc.JavaScript"> <h1>Значение<?dp return wCod+1.314;?></h1> </body> |
doc | Документ | 22 | Финальный документ в XHTML, начинается с тега "body". |
font | Шрифт | 26 |
Базовый шрифт текста документа. Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:
Примеры:
|
bTime | Время: начало | 24 | Время начала документа, секунды. |
time | Время: текущее | 23 | Время генерации документа, секунды. Записать время для генерации документа от этой точки или нуль для перегенерации. |
process | В процессе | 27 | Признак процесса формирования документа отдельным потоком. |
n | Размер архива | 25 | Количество документов или глубина архива. |
Атрибуты включеного режима архивирования | |||
aCur | Архив: курсор: текущий | - | Позиция текущего документа в архиве. Запись значения <0 производит архивацию текущего документа. |
vCur | Архив: курсор: вид | - |
Текущий визуализируемый документ архива. Запись значения:
|
aDoc | Архив: текущий документ | - | Текущий документ архива в XHTML, начинается с тега "body". |
aSize | Архив: размер | - | Реальный размер архива документа. |
Возможности примитива "Документ":
- Гибкое формирование структуры документа на основе языка гипертекстовой разметки, что предоставляет поддержку широких возможностей форматирования документов.
- Формирование документов по команде или расписанию, что необходимо для формирования отчётной документации в архив, с последующим просмотром архива.
- Формирование документов в режиме реального времени, для предоставления их полностью динамически и на основе архивов за указанное время.
- Использование атрибутов виджета для передачи в документ значений и адресов на архивы, что позволяет использовать виджет документа как шаблон, при формировании отчётов с другими входными данными.
В основе любого документа лежит XHTML-шаблон. XHTML-шаблон это тег "body" WEB-страницы, содержащий статику документа в стандарте XHTML 1.0 и элементы исполняемых инструкций на языке пользовательского программирования OpenSCADA, в виде <?dp {procedure} ?>. Результирующий документ формируется путём исполнения процедур и вставки их результата в документ.
Источником значений исполняемых инструкций являются атрибуты виджета этого примитива, а также все механизмы языка пользовательского программирования OpenSCADA. Атрибуты могут добавляться пользователем и линковаться на реальные атрибуты параметров или-же являться автономными, значения которых будут формироваться в процедуре виджета. В случае со слинкованными атрибутами, значения могут извлекаться из архива-истории.
На рисунке изображена структурная схема виджета примитива "Документ". Согласно этой структуре, "Документ" содержит: XHTML-шаблон, результирующие документы и процедуру обработки данных. Источником данных процедуры и результирующих документов являются атрибуты виджета.
Предусматривается работа виджета в двух режимах: "Динамический" и "Архивный". Отличием архивного режима является наличие архива указанной глубины и атрибутов, позволяющих управлять процессом архивирования и просмотра указанного документа в архиве.
Генерация документа всегда производится в момент установки атрибута времени time относительно установленного ранее начального времени документа в атрибуте bTime. При выключенном архиве, результирующий документ помещается непосредственно в атрибут doc. При включенном архиве, результирующий документ помещается в ячейку под курсором, атрибут aCur, а так-же в doc, если значение курсора архива aCur и курсора визуализируемого документа vCur совпадают. Атрибуты архивных курсоров предусматривают несколько командных значений:
- "aCur < 0" — перемещает курсор архиватора на следующую позицию, тем самым оставляя предыдущий документ в архиве и очищая документ под курсором, если кольцевой архив замкнулся.
- "vCur == -1" — выбор следующего документа для отображения, выбранный документ копируется в атрибут doc.
- "vCur == -2" — выбор предыдущего документа для отображений, выбранный документ копируется в атрибут doc.
Как было указано выше, динамика шаблона документа определяется вставками исполняемых инструкций вида "<?dp {procedure} ?>". В процедурах могут использоваться одноимённые атрибуты виджета и функции пользовательского интерфейса программирования OpenSCADA. Кроме атрибутов виджета, зарезервированы специальные атрибуты, смотри таблицу.
Таблица. Специальные и зарезервированные элементы шаблона.
Имя | Назначение |
---|---|
Атрибуты | |
rez | Атрибут результата исполнения процедуры, содержимое которого помещается в дерево документа. |
lTime | Время последнего формирования. Если документ формируется впервые то lTime равен bTime. |
rTime | Содержит время перебираемых значений, секунды, определяется внутри тегов с атрибутом "docRept". |
rTimeU | Содержит время перебираемых значений, микросекунды, определяется внутри тегов с атрибутом "docRept". |
rPer | Содержит период перебора значений, атрибут "docRept". |
mTime, mTimeU, mLev, mCat, mVal |
Определяются внутри тегов с атрибутом "docAMess" при разборе сообщений архива сообщений:
|
Специальные теги | |
Специальные атрибуты стандартных тегов | |
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-файл и другие табличные форматы. |
3.9.8 Контейнер (Box)
Примитив контейнера, используется для формирования составных виджетов и/или страниц пользовательского интерфейса.
Таблица. Набор дополнительных свойств/атрибутов примитива "Контейнер (Box)"
Идентификатор | Имя | Номер | Значение |
---|---|---|---|
pgOpenSrc | Страница: источник открытия | 3 | Полный адрес страницы, которая включена внутрь данного контейнера. |
pgGrp | Страница: группа | 4 | Группа контейнера включаемых страниц. Только страницы в такой группе будут включаться в этот бокс как контейнер. |
backColor | Фон: цвет | 20 |
Фоновый цвет. Имя цвета в виде "{color}[-{alpha}]", где:
Примеры:
|
backImg | Фон: изображение | 21 |
Фоновое изображение. Имя изображения в виде "[{src}:]{name}", где:
Примеры:
|
bordWidth | Граница: ширина | 22 | Ширина бордюра. |
bordColor | Граница: цвет | 23 | Цвет бордюра (детальнее в атрибуте 20). |
bordStyle | Граница: стиль | 24 | Стиль бордюра: "Нет", "Точечный", "Пунктирный", "Сплошной", "Двойной", "Канавка", "Кромка", "Вдавлен", "Выступающий". |
3.10 Использование БД для хранения библиотек виджетов и проектов
Хранение данных виджетов, библиотек виджетов и проектов реализовано в БД, доступных OpenSCADA. БД организована по принадлежности данных к библиотеке-проекту. Т.е. отдельная библиотека-проект хранится в отдельной группе таблиц БД. Перечень библиотек виджетов хранится в индексной таблице библиотек с именем "VCALibs" и структурой "Libs", а перечень проектов в индексной таблице "VCAPrjs" и структурой "Projs". Экземпляр этих таблиц создаётся в каждой БД, где хранятся данные этого модуля. В состав таблиц, принадлежащих библиотеке виджетов и проекту, входят следующие:
- "{DB_TBL}" — таблица виджетов, принадлежащих библиотеке (структура "LibWigets"), или страниц, принадлежащих проекту (структура "ProjPages");
- "{DB_TBL}_io" — таблица рабочих свойств виджетов и вложенных виджетов библиотеки (структура "LibWidgetIO") или свойств страниц проектов (структура "ProjPageIO");
- "{DB_TBL}_uio" — таблица пользовательских свойств виджетов и вложенных виджетов этой библиотеки (структура "LibWidgetUserIO") или пользовательских свойств страниц (структура "ProjPageUserIO");
- "{DB_TBL}_incl" — таблица виджетов, вложенных в виджеты-контейнеры, библиотеки (структура "LibWidgetIncl") или проекта (структура "ProjPageWIncl");
- "{DB_TBL}_mime" — таблица ресурсов библиотеки и её виджетов (структура "LibWidgetMime"), или проекта и его страниц (структура "ProjMime");
- "{DB_TBL}_stls" — таблица значений стилевых параметров проекта (структура "PrjStlsIO");
- "{DB_TBL}_stl" — устаревшая таблица значений стилевых параметров проекта (структура "PrjStlIO");
- "{DB_TBL}_ses" — таблица данных режима исполнения проекта, т.е. сеансов (структура "PrjSesIO").
{DB_TBL} сейчас формируется в виде "wlb_{ID}" для библиотек и "prj_{ID}" для проектов, а отдельное поле DB_TBL таблиц "Libs", "Projs" застарело и будет удалено в випуске OpenSCADA 1.0!
Проекции (структуры) основных таблиц таковы:
- Libs(ID, NAME, DSCR, DB_TBL, ICO) — библиотеки виджетов ID.
- ID — идентификатор;
- NAME — имя;
- DSCR — описание;
- DB_TBL (УСТАРЕЛО) — корень таблиц БД с виджетами;
- ICO — закодированное (Base64) изображение иконки библиотеки.
- LibWigets(ID, ICO, PARENT, PROC, PROC_PER, ATTRS, TIMESTAMP) — виджеты ID библиотеки.
- ID — идентификатор;
- ICO — закодированное (Base64) изображение иконки виджета;
- PARENT — адрес виджета основы, в виде /wlb_originals/wdg_Box;
- PROC — внутренняя процедура и язык процедуры виджета;
- PROC_PER — период вычисления процедуры виджета;
- ATTRS — перечень атрибутов виджета, модифицированных пользователем;
- TIMESTAMP — метка времени последней модификации.
- LibWidgetIO(IDW, ID, IDC, IO_VAL, SELF_FLG, CFG_TMPL, CFG_VAL) — рабочие атрибуты ID виджета IDW дочернего виджета IDC.
- IDW — идентификатор виджета;
- ID — идентификатор атрибута;
- IDC — идентификатор дочернего виджета;
- IO_VAL — значение атрибута;
- SELF_FLG — внутренние флаги атрибутов;
- CFG_TMPL — шаблон элемента конфигурации, основанного на данном атрибуте;
- CFG_VAL — значение элемента конфигурации (ссылка, константа ...).
- LibWidgetUserIO(IDW, ID, IDC, NAME, IO_TP, IO_VAL, SELF_FLG, CFG_TMPL, CFG_VAL) — пользовательские атрибуты ID виджета IDW дочернего виджета IDC.
- IDW — идентификатор виджета;
- ID — идентификатор атрибута;
- IDC — идентификатор дочернего виджета;
- NAME — имя атрибута;
- IO_TP — тип и главные флаги атрибута;
- IO_VAL — значение атрибута;
- SELF_FLG — внутренние флаги атрибута;
- CFG_TMPL — шаблон элемента конфигурации, основанного на данном атрибуте;
- CFG_VAL — значение элемента конфигурации (ссылка, константа ...).
- LibWidgetIncl(IDW, ID, PARENT, ATTRS) — включенные в контейнер IDW виджеты ID.
- IDW — идентификатор виджета;
- ID — идентификатор экземпляра вложенного виджета;
- PARENT — адрес виджета основы, в виде /wlb_originals/wdg_Box;
- ATTRS — перечень атрибутов виджета, модифицированных пользователем.
- LibWidgetMime(ID, MIME, DATA) — audio, video, media и другие ресурсы виджетов ID библиотеки.
- ID — идентификатор ресурса;
- MIME — MIME ресурса, в формате — "{MIME};{Size}";
- DATA — данные ресурса, кодированные Base64.
- Projs(ID, NAME, DSCR, DB_TBL, ICO, USER, GRP, PERMIT, PER, FLGS, STYLE) — проекты ID интерфейса визуализации.
- ID — идентификатор проекта;
- NAME — имя проекта;
- DSCR — описание проекта;
- DB_TBL (УСТАРЕЛО) — корень таблиц БД со страницами;
- ICO — закодированное (Base64) изображение иконки проекта;
- USER — имя владельца проекта;
- GRP — имя группы пользователей проекта;
- PERMIT — права доступа к проекту;
- PER — период вычисления проекта, в миллисекундах;
- FLGS — флаги проекта;
- STYLE — типовой стиль проекта.
- ProjPages(OWNER, ID, ICO, PARENT, PROC, PROC_PER, FLGS, ATTRS, TIMESTAMP) — страницы ID, содержащиеся в проекте-странице OWNER.
- OWNER — проект-страница — владелец данной страницы, в виде — "/AGLKS/so/1/gcadr";
- ID — идентификатор страницы;
- ICO — закодированное (Base64) изображение иконки страницы;
- PARENT — адрес виджета основы, в виде /wlb_originals/wdg_Box;
- PROC — внутренняя процедура и язык процедуры страницы;
- PROC_PER — период вычисления процедуры страницы;
- FLGS — флаги типов страницы;
- ATTRS — перечень атрибутов страницы, модифицированных пользователем;
- TIMESTAMP — метка времени последней модификации.
- ProjPageIO(IDW, ID, IDC, IO_VAL, SELF_FLG, CFG_TMPL, CFG_VAL) — рабочие атрибуты страниц, структура фактически совпадает с таблицей "LibWidgetIO".
- ProjPageUserIO(IDW, ID, IDC, NAME, IO_TP, IO_VAL, SELF_FLG, CFG_TMPL, CFG_VAL) — пользовательские атрибуты страниц, структура фактически совпадает с таблицей "LibWidgetUserIO".
- ProjPageWIncl(IDW, ID, PARENT, ATTRS) — виджеты, включенные на страницы, структура фактически совпадает с таблицей "LibWidgetIncl".
- ProjMime(ID, MIME, DATA) — audio, video, media и другие ресурсы страниц проектов, структура фактически совпадает с таблицей "LibWidgetMime".
- PrjStls(SID, ID, VAL) — значение VAL поля ID стиля IDS проекта.
- IDS — идентификатор стиля;
- ID — идентификатор поля стиля;
- VAL — значение поля стиля.
- PrjStl(ID, V_0, V_1, V_2, V_3, V_4, V_5, V_6, V_7, V_8, V_9) — значения поля стиля ID проекта.
- ID — идентификатор поля стиля;
- V_{N} — значение поля стиля для стиля N.
- ProjSess(IDW, ID, IO_VAL) — таблица проекта IDW для хранения данных сеансов, исполняющих проект.
- IDW — полный путь элемента проекта;
- ID — атрибут элемента;
- IO_VAL — значение атрибута.
3.11 API пользовательского программирования и сервисные интерфейсы OpenSCADA
3.11.1 API пользовательского программирования
API пользовательского программирования движка визуализации непосредственно представлено объектами OpenSCADA, формирующие пользовательский интерфейс, а именно "Сеансом" и "Виджетами-страницами". Для пользователя эти объекты предоставляют набор функций управления:
Объект "Сеанс" ( this.ownerSess() )
- string user( ) — текущий пользователь сеанса.
- int alrmQuietance( int quit_tmpl, string wpath = "", bool ret = false ) — квитирует нарушение wpath с шаблоном quit_tmpl. Если wpath это пустая строка то производится глобальное квитирование. В строке wpath, через символ ';', могут быть перечислены адреса нескольких виджетов. При установке ret осуществляется возврат квитирования.
- int reqTm( ) — время последнего запроса в секундах от эпохи 1.1.1970.
- string reqUser( ) — пользователь последнего запроса.
- string reqLang( ) — язык последнего запроса.
- int userActTm( ) — время последнего действия пользователя в секундах от эпохи 1.1.1970.
- bool uiCmd( string cmd, string prm, string src ) — отправляет UI команду управления страницами, как: "open", "next", "prev"; детальнее смотрите в секции сообщений. Эта функция должна быть приоритетной для использования при контроле страницами перед прямой записью в атрибут страниц "pgOpen" и "pgOpenSrc" поскольку это единственный метод корректной работы с линкованными страницами.
Объект "Виджет" (this)
- TCntrNodeObj ownerSess( ) — объект сеанса данного виджета.
- TCntrNodeObj ownerPage( ) — объект родительской страницы данного виджета.
- TCntrNodeObj ownerWdg( bool base = false ) — объект родительского виджета данного виджета. При указании base будут возвращены и объекты страниц.
- TCntrNodeObj wdgAdd( string wid, string wname, string parent ) — добавляет виджет wid с именем wname на основе библиотечного виджета parent.
//Добавляет новый виджет на основе виджета текстового примитива nw = this.wdgAdd("nw", "Новый виджет", "/wlb_originals/wdg_Text"); nw.attrSet("geomX", 50).attrSet("geomY", 50);
- bool wdgDel( string wid ) — удаляет виджет wid.
- TCntrNodeObj wdgAt( string wid, bool byPath = false ) — подключается к дочернему или глобальному виджету, посредством пути byPath. В случае глобального подключения можно использовать абсолютный или относительный путь к виджету. Точкой отсчёта абсолютного адреса выступает объект корня модуля "VCAEngine", а значит, первым элементом абсолютного адреса является идентификатор сеанса, который опускается. Относительный адрес берёт отсчёт от текущего виджета. Специальным элементом относительного адреса является элемент вышестоящего узла "..".
- Array attrList() — перечень атрибутов виджета.
- bool attrPresent( string attr ) — проверяет атрибут виджета attr на факт присутствия.
- ElTp attr( string attr, bool fromSess = false ) — значение атрибута виджета attr или из сеанса fromSess. Для отсутствующих атрибутов возвращается пустая строка.
- TCntrNodeObj attrSet( string attr, ElTp vl, bool toSess = false ) — устанавливает значение vl в атрибут виджета attr или в сеанс, для toSess. Возвращает текущий объект, для конкатенации функций установки.
- string link( string attr, bool prm = false ) — ссылка атрибута виджета attr. При установке prm запрашивает ссылку группы атрибутов (параметр), представленную указанным атрибутом.
- string linkSet( string attr, string vl, bool prm = false ) — устанавливает ссылку атрибута виджета attr. При установке prm осуществляется установка ссылки группы атрибутов (параметр), представленной указанным атрибутом.
//Устанавливает ссылку восьмого тренда параметром this.linkSet("el8.name", "prm:/LogicLev/experiment/Pi", true);
- string {resource,mime}( string addr, string MIME = "" ) — ресурс объекта по адресу addr (прямая ссылка на ресурс или атрибут виджета с этой ссылкой) с типом MIME, из таблицы сеанса или источника. Предназначено для редактирования ресурса объекта и подстановки его в контексте сеанса, например, изображений SVG.
- int {resourceSet,mimeSet}( string addr, string data, string MIME = "" ) — устанавливает ресурс объекта в data с типом MIME по адресу addr.
- int messDebug( string mess ); int messInfo( string mess ); int messNote( string mess ); int messWarning( string mess ); int messErr( string mess ); int messCrit( string mess ); int messAlert( string mess ); int messEmerg( string mess ); — формирует сообщения программы mess с категорией — путь к данному виджету.
Объект "Виджет", примитива "Документ" (this)
- string getArhDoc( int nDoc) — текст документа архива на глубине nDoc (0-{aSize-1}).
Устаревшее, но поддерживаемое, API представляется группой функций непосредственно в модуле движка СВУ. Вызов этих функций из процедуры виджета может осуществляться прямо по идентификатору, поскольку их область имён определяется в контексте процедур виджетов.
Список виджетов (WdgList)
Описание: Возвращает список виджетов, в контейнере виджетов, или дочерних виджетов. Если установлено pg, то возвращается список страниц проектов и сеанса.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
list | Список | Строка | Возврат | |
addr | Адрес | Строка | Вход | |
pg | Страницы | Логический | Вход | 0 |
Присутствие узла (NodePresent)
Описание: Проверка узла на присутствие, включая виджеты, атрибуты и другие.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
rez | Результат | Логический | Возврат | |
addr | Адрес | Строка | Вход |
Список атрибутов (AttrList)
Описание: Возвращает список атрибутов виджета. Если установлен noUser тогда возвращаются только не пользовательские атрибуты.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
list | Список | Строка | Возврат | |
addr | Адрес | Строка | Вход | |
noUser | Без пользовательских | Логический | Вход | 1 |
Получить атрибут (AttrGet)
Описание: Запрос значения атрибута виджета. Запрос может осуществляться как указанием полного адреса атрибута в addr, так и: отдельно адрес виджета в addr и идентификатор атрибута в attr.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
val | Значение | Строка | Возврат | |
addr | Адрес | Строка | Вход | |
attr | Атрибут | Логический | Вход |
Установить атрибут (AttrSet)
Описание: Установка значения атрибута виджета. Установка может осуществляться как указанием полного адреса атрибута в addr, так и: отдельно адрес виджета в addr и идентификатор атрибута в attr.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
addr | Адрес | Строка | Вход | |
val | Значение | Строка | Вход | |
attr | Атрибут | Логический | Вход |
Пользователь сеанса (SesUser)
Описание: Возвращает пользователя сеанса по пути к виджету сеанса.
Параметры:
Идентификатор | Имя | Тип | Режим | По умолчанию |
---|---|---|---|---|
user | Пользователь | Строка | Возврат | |
addr | Адрес | Строка | Вход |
3.11.2 Сервисные интерфейсы OpenSCADA
Сервисные интерфейсы это интерфейсы доступа к OpenSCADA посредством интерфейса управления OpenSCADA. Данный механизм положен в основу всех механизмов обмена внутри OpenSCADA, реализованных посредством слабых связей и стандартного протокола обмена OpenSCADA.
3.11.2.1 Доступ к значениям атрибутов элементов визуализации (виджеты)
С целью предоставления унифицированного, группового и сравнительно быстрого доступа к значениям атрибутов визуальных элементов, предусмотрена сервисная функция визуального элемента "/serv/attr" и команды получения-установки значений атрибутов:
- получение: <get path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/>;
- установка: <set path="/UI/VCAEngine/{wdg_addr}/%2fserv%2fattr"/>.
Таблица. Атрибуты команд получения и установки атрибутов визуальных элементов
Идентификатор | Имя | Значение |
---|---|---|
Команда запроса визуальных атрибутов виджета: <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 | Флаги атрибута |
3.11.2.2 Групповой доступ к значениям атрибутов элементов визуализации (виджетам)
С целью оптимизации трафика сетевого взаимодействия путём исключения мелких запросов и использования одного большого, предусмотрен групповой запрос значений атрибутов визуальных элементов. Группировка данного запроса подразумевает запрос атрибутов всей ветви виджета, включая и вложенные элементы. Для данного запроса предусмотрена сервисная команда "/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.
3.11.2.3 Доступ к страницам сеанса
С целью унификации и оптимизации доступа к страницам, предусмотрена сервисная функция сеанса "/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. Если данный атрибут устанавливается при запросе, то, для каждой открытой страницы, возвращается список изменённых, с момента указанного значения счётчика, виджетов открытой страницы.
3.11.2.4 Управление сигнализацией
Для предоставления механизма глобального контроля за сигнализацией сеанса, предусмотрена сервисная функция сеанса "/serv/alarm" и команды:
- запрос статуса сигналов: <get path="/UI/VCAEngine/ses_{Session}/%2fserv%2falarm"/>;
- квитирование сигналов: <quietance path="/UI/VCAEngine/ses_{Session}/%2fserv%2falarm"/>.
Запрос статуса сигналов возвращает обобщённое состояние сигналов, а также ресурс уведомления, если атрибут "mode" равен "resource". Результатом запроса ресурса уведомления, обычно, является звуковой файл, для воспроизведения. В это-же время, обеспечивается отслеживание последовательности сигнализации и квитации отдельных ресурсов сообщений.
Запрос на квитацию выполняет квитацию, указанного в атрибуте wdg, виджета, согласно шаблону в атрибуте tmpl.
3.11.2.5 Манипуляция сеансами проектов
Для предоставления унифицированного механизма манипуляции сеансами, модулем движка СВУ (VCAEngine), для визуализаторов СВУ, предусмотрена сервисная функция "/serv/sess" и команды:
- запроса перечня открытых сеансов: <list path="/UI/VCAEngine/%2fserv%2fsess"/>;
- подключения-создания нового сеанса: <connect path="/UI/VCAEngine/%2fserv%2fsess"/>;
- отключения-удаления сеанса: <disconnect path="/UI/VCAEngine/%2fserv%2fsess"/>.
Таблица. Атрибуты команд механизма манипуляции сеансами
Идентификатор | Имя | Значение |
---|---|---|
Команда запроса перечня открытых сеансов для проекта: <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 | Установка имени сеанса | Указывает имя сеанса от которого выполняется отключение или закрытие. Сеансы, не являющиеся фоновыми, и к которым ни один из визуализаторов не подключен, автоматически закрываются. |
3.11.2.6 Групповой запрос дерева библиотек виджетов
С целью оптимизации производительности локального и, особенно, сетевого взаимодействия, предусмотрена сервисная функция "/serv/wlbBr" и команда запроса дерева библиотек виджетов: <get path="/UI/VCAEngine/%2fserv%2fwlbBr"/>. Результатом запроса является дерево с элементами библиотек виджетов — теги wlb. Внутри тегов библиотек виджетов содержаться тег иконки ico и теги виджетов библиотеки w. Теги виджетов, в свою очередь, содержат тег иконки и теги дочерних виджетов cw.
4 Конфигурация модуля посредством интерфейса управления OpenSCADA
Посредством интерфейса управления OpenSCADA компоненты, которые его используют, можно конфигурировать из любого конфигуратора OpenSCADA. Данным модулем предоставляется интерфейс доступа ко всем объектам данных СВУ. Главная вкладка конфигурационной страницы модуля предоставляет доступ к библиотекам виджетов и проектам (рис.4.1). Вкладка "Сеансы" предоставляет доступ и открытым сеансам проектов (рис.4.2).
Кроме списка открытых сеансов, вкладка на рисунке 4.2 содержит таблицу с перечнем сеансов, которые должны создаваться и запускаться в момент загрузки OpenSCADA. Создание сеансов посредством этого механизма может быть полезным для Web-интерфейса. В таком случае, при подключении Web-пользователя, все данные уже готовы и обеспечивается непрерывность формирования архивных документов.
Конфигурация контейнеров виджетов в лице библиотек виджетов и проектов выполняется посредством страниц на рисунке 4.3 (для проекта) и рисунке 4.5 (для библиотеки виджетов). Библиотека виджетов содержит виджеты, а проект — страницы. Оба типа контейнера содержат вкладку конфигурации ресурсов, используемых виджетами (рис.4.6). Страница проекта также содержит вкладку "Диагностика" (рис.4.4) для отладки и контроля за исполнением страницы в сеансах.
С помощью этой страницы можно установить:
- Состояние контейнера, а именно: "Включен", имя БД (содержащей конфигурацию и с отслеживанием наличия данных в различных хранилищах и предоставлением последовательного удаления дубликатов), дата и время последней модификации, счётчик использования.
-
Объект всё ещё поддерживает определение избыточного адреса хранилища с таблицей, до того момента как вы переименуете её в стандартную форму "prj_{ObjID}".
- Идентификатор, имя, описание и иконка контейнера.
- Владелец, группа пользователей и права доступа к элементу.
- Период вычисления сеансов, основанных на данном проекте.
- Признак включения по надобности.
В этой вкладке Вы можете выбрать время (или обновить к текущему) и размер для получения диагностических сообщений сеансов исполнения данного проекта.
С помощью этой страницы можно установить:
- Состояние контейнера, а именно: "Включен", имя БД (содержащей конфигурацию и с отслеживанием наличия данных в различных хранилищах и предоставлением последовательного удаления дубликатов) дата и время последней модификации, счётчик использования.
-
Объект всё ещё поддерживает определение избыточного адреса хранилища с таблицей, до того момента как вы переименуете её в стандартную форму "wlb_{ObjID}".
- Идентификатор, имя, описание и иконка контейнера.
Конфигурация сеанса проекта значительно отличается от конфигурации проекта (рис.4.7), однако, также, содержит страницы проекта.
С помощью этой страницы можно установить:
- Состояние сеанса, а именно: "Включен"; "Исполняется"; пользователь; владелец; группа пользователей; доступ; исходный проект; режим исполнения в фоне; время исполнения сеанса; счётчик клиентских подключений; время, пользователь, язык последнего запроса; последнее действие пользователя и остаток времени до принудительного закрытия.
- Период обсчёта сеанса.
- Текущий стиль проекта.
- Перечень открытых страниц.
Страницы конфигурации визуальных элементов, расположенных в разных контейнерах, могут сильно отличаться, однако, это отличие заключается в наличии или отсутствии отдельных вкладок. Главная вкладка визуальных элементов фактически везде одинакова, отличаясь на одно конфигурационное поле и три в сеансе (рис.4.8). У страниц присутствуют вкладки дочерних страниц и вложенных виджетов. У контейнерных виджетов содержится вкладка вложенных виджетов. Все визуальные элементы содержат вкладку атрибутов (рис.4.9), кроме логических контейнеров проектов. Элементы, на уровне которых можно формировать пользовательскую процедуру и определять связи, содержат вкладки "Обработка" (рис.4.10) и "Связи" (рис.4.11).
С помощью этой страницы можно установить:
- Состояние элемента, а именно: "Включен", количество использования, родительский элемент и переход к нему, дата и время последней модификации.
- Состояния режима сеанса исполнения: "Открыт", "Обработка" и использовано времени при исполнении поддерева и элемента, в режиме отладки.
- Идентификатор, тип, корень, путь, имя, описание и иконка элемента.
- Команда — очистить изменения.
- Команда — опустить изменения виджета его предку.