Пользовательский виджет можно также создать с помощью комплекта для создания виджетов. Комплект может быть использован для создания виджета с нуля.
Программирование пользовательского виджета осуществляется независимо от «КАСКАД Цифра» в загружаемом рабочем пространстве, что не требует наличия лицензии.
В этом руководстве показано, как создать дашборд с виджетом калибровки. Для этого требуется запущенный проект «КАСКАД Цифра» с уже настроенным менеджером Сервера Дашбордов и пользователь «КАСКАД Цифра» с правами редактирования и публикации:
Полоса прогресса показывает состояние одной точки данных в виде вертикальной полосы.
| Datatype | Supported? |
|---|---|
| int | ✓ |
| uint | ✓ |
| float | ✓ |
| long | ✓ |
| ulong | ✓ |
| string | ✗ |
| char | ✗ |
| bool | ✗ |
Настройки индикатора выполнения включают цвет индикатора и один из трех размеров шрифта. Если выбрано «отображение абсолютных значений», то можно задать цифры, отображаемые до и после запятой, единицы измерения и диапазон значений. Значения для каждого из этих параметров могут быть импортированы из «КАСКАД Цифра», заданы вручную или вовсе отключены. Единицы измерения также могут быть выбраны вручную из списка единиц СИ. Если «отображение абсолютных значений» деактивировано, то значение отображается в процентах.
Виджет ярлыка используется для отображения простого текста.
| Тип данных | Поддерживается? |
|---|---|
| int | ✓ |
| uint | ✓ |
| float | ✓ |
| long | ✓ |
| ulong | ✓ |
| string | ✓ |
| char | ✓ |
| bool | ✓ |
Виджет этикетки может быть использован для добавления префикса и суффиксов на доступных языках проекта. Суффикс может быть взят из единицы измерения точки данных. Формат точки данных задается вручную, импортируется из «КАСКАД Цифра» или отключается. Размер шрифта может быть выбран из трех доступных, а цвет шрифта настраивается с помощью селектора цветов. С помощью селектора пиктограмм пользователь может добавить одну из нескольких пиктограмм. Положение пиктограммы относительно текста задается с помощью стрелок положения.
Манометр показывает значение точки данных по отклонению иглы.
| Тип данных | Поддерживается? |
|---|---|
| int | ✓ |
| uint | ✓ |
| float | ✓ |
| long | ✓ |
| ulong | ✓ |
| string | ✗ |
| char | ✗ |
| bool | ✗ |
Настройки виджета калибровки позволяют выбрать формат значения точки данных, единицы измерения и диапазон значений. Эти настройки могут быть импортированы из «КАСКАД Цифра», заданы вручную или полностью отключены. Единицы измерения также могут быть выбраны вручную из списка единиц СИ.
Диаграмма Ганта представляет собой интервальное представление значения точки данных. Ширина каждой полосы показывает период, в течение которого присутствовало определенное значение.
| Тип данных | Поддерживается? |
|---|---|
| int | ✓ |
| uint | ✓ |
| float | ✓ |
| long | ✓ |
| ulong | ✓ |
| string | ✓ |
| char | ✓ |
| bool | ✓ |
Каждая отдельная линия столбиков представляет собой одну серию.
Для нескольких серий могут быть установлены различные значения точек данных. Управление каждой серией осуществляется с помощью отображения значений и связанной с ними информации.
Параметры, определяемые в этом отображении, — это значение («ключ»), которого должна достичь точка данных, связанные с ним «имя» и «описание», а также «цвет», который будет отображаться. Если для конкретного значения не было задано никакой записи, то будет использоваться ключ по умолчанию. Значение по умолчанию генерируется автоматически и будет присутствовать в каждом отображении.
Отображаемый диапазон времени может быть настроен на любой из заданных диапазонов. Чтобы сделать этот диапазон настраиваемым в режиме просмотра, необходимо установить флажок «Селектор диапазона изменяемый». Всплывающую подсказку можно активизировать и деактивизировать.
С помощью соответствующих флажков можно настроить появление сеток по оси времени или оси y. Легенда для серии точек данных и выбранного отображения может быть размещена в изменяемом положении по бокам графика. Настройки масштабирования данных определяют, возможно ли масштабирование по оси времени. Кроме того, можно настроить угол наклона меток на оси времени.
В стандартном представлении Dashboard во всплывающей подсказке виджета будет отображаться текущее выбранное значение, а также значения до и после него. Это делается в формате before < curent > after. Дополнительная информация о том, как долго выбранное в данный момент значение присутствует в точке данных, приведена ниже.
Гистограмма отображает значения одной или нескольких точек данных и групп точек данных в виде столбиков.
| Типы данных | Поддерживается? |
|---|---|
| int | ✓ |
| uint | ✓ |
| float | ✓ |
| long | ✓ |
| ulong | ✓ |
| string | ✗ |
| char | ✗ |
| bool | ✓ |
Точки данных
Пользователь может добавить на гистограмму несколько точек данных, каждая из которых будет представлять собой отдельный ряд значений.
Форматирование
Для каждой отдельной серии точек данных могут быть заданы различные цвета и описания, которые будут отображаться в легенде. Формат значений и единицы измерения устанавливаются вручную, наследуются из «КАСКАД Цифра» или отключаются. Единица измерения может быть выбрана вручную из списка единиц СИ. Отдельные серии могут быть объединены в группы. Несколько групп могут быть размещены рядом друг с другом на графике.
Группы могут быть представлены в сложенном виде и снабжены подсказкой для отображения адреса точки данных. Диапазон значений может быть задан автоматически или выбран вручную. Разрыв между различными сериями может быть задан вручную, по умолчанию он составляет 0,8. С помощью соответствующих флажков можно настроить появление сеток по осям x или y. Легенда для серии точек данных может быть размещена в переменной позиции на любой стороне графика. Настройки масштабирования данных определяют, вдоль какой оси происходит масштабирование. Масштабирование может происходить как по оси x или y, так и по обеим осям, а также может быть полностью отключено.
Вид «Оповещения» предоставляет обзор всех активных оповещений, аналогичный экрану «Оповещения и события».
Установив флажок «использовать фильтры», пользователь может выбрать один из доступных фильтров оповещений из проекта. Фильтрация только подтвержденных или только непризнанных оповещений может быть задана отдельно или выбрана во время выполнения программы. Кроме того, оповещения могут быть отсортированы по приоритету и времени, как по возрастанию, так и по убыванию. Это можно выбрать во время выполнения программы.
Просмотр исторических оповещений можно включить, установив флажок «Ограничить оповещения временным диапазоном». После этого в раскрывающемся поле можно выбрать закрытый временной диапазон, чтобы отображать оповещения в этом временном диапазоне. Новые, входящие оповещения не будут отображаться до тех пор, пока выбран временной диапазон. Исторические оповещения не будут иметь ни цвета, ни текста оповещения.
Колонки можно активировать или деактивировать, установив соответствующие флажки. Виджет просмотра оповещений можно настроить на постоянное отображение мобильного вида или выбрать автоматическое переключение на него. Размер шрифта может быть выбран один из трех.
В стандартном представлении дашборда присутствующий значок оповещения показывает количество активных в данный момент оповещений.
Символ воронки разворачивается в выборку для сортировки оповещений.
Ползунок в центре управляет отображением всех или только непризнанных оповещений.
Значок лупы открывает поиск.
Кнопка справа позволяет приостанавливать и возобновлять входящие оповещения.
В селекторе точек данных отображаются все имеющиеся в проекте точки данных, сгруппированные в соответствующие им структуры основных точек данных. Для удобства работы с ними рядом с адресом указывается соответствующий тип точки данных. При выборе одной точки данных открывается выбор доступных виджетов. Не все виджеты могут использоваться для всех типов точек данных (например, для строковых типов данных можно использовать только виджет «Метка»).
Функция поиска в Селекторе данных принимает один или несколько следующих параметров:
шаблон
Шаблон поиска. Если шаблон не содержит символов ‘‘ или ‘?’, то он будет заключен в звездочки (например, «шаблон*»).
области (необязательно)
Массив областей, в которых должен производиться поиск. Поиск будет производиться в порядке возрастания значений в массиве, который может быть одним или несколькими из:
maxResults (необязательно)
Максимальное количество возвращаемых результатов (по умолчанию: 500)
internal (опционально)
Если этот параметр задан как true, то поиск точек данных и имен элементов точек данных будет включать и внутренние точки данных.
locale
Расположение имен СНН, по которым будет производиться поиск и возврат. Это необходимо, если «areas» включает «CNS».
Результат будет содержать один массив результатов для каждой области в запросе. Кроме того, если результат содержит «DP», то он также будет содержать «DPT», который содержит все типы точек данных, используемые точками данных, перечисленными в «DP». Если результат содержит «alias», то он также будет содержать «DPT_alias», который содержит все типы точек данных для точек данных, перечисленных в «alias».
Обзор дашборда — это центральное навигационное представление. Он открывается непосредственно после входа в систему и показывает все панели, доступные текущему пользователю в текущем проекте.
Боковая панель навигации всегда видна в левой части браузера. Сам вид дашборда можно открыть с помощью значка «КАСКАД Цифра», расположенного вверху. Под ним можно разместить до 4 значков навигации по дашборду, чтобы легко открывать дашборды, помеченные как избранные. Кнопка со стрелкой внизу позволяет выйти из системы и вернуться к экрану входа в систему. Боковая панель навигации может быть расширена за счет заголовков с помощью кнопки «развернуть», расположенной слева внизу.
Добавление новых панелей с помощью кнопки «Добавить», расположенной справа. При этом сразу же открывается страница «Настройки панели».
Настройки панели открываются автоматически при добавлении новой панели индикаторов. Здесь пользователь может отредактировать название и описание на всех доступных языках проекта. Одна из кнопок справа служит для удаления панели, а другая — для размещения ее дубликата в обзоре. С помощью ползунка панель можно перевести в режим приватного просмотра, в результате чего она будет видна только создавшему ее пользователю. Цвет фона панели задается с помощью цветового селектора. Параметр «Выбор временного диапазона по умолчанию» позволяет выбрать значение, которое будет установлено по умолчанию для временных диапазонов.
Каждый значок представляет одну панель индикаторов и показывает ее название и описание. Щелчок на названии открывает дашборд в стандартном режиме «Вид панели». Кнопка «избранное» добавляет значок дашборда в боковую панель навигации для быстрого доступа. Расположенная рядом с ней кнопка «редактировать» открывает меню редактирования настроек дашборда. В информационном блоке ниже отображается пользователь, создавший панель индикатоов, и количество содержащихся в ней виджетов. Цветная полоса у нижнего края значка показывает цвет фона, установленный для панели.