Alpha.Community

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

Создание пользовательского дерева сигналов для Alpha.HMI.Trends

Из всех описанных в Alpha.DevStudio сигналов, образующих дерево сигналов Alpha.Server, можно выделить сигналы для отображения в окне приложения Alpha.HMI.Trends. Выделенные сигналы образуют так называемое пользовательское дерево сигналов. Alpha.DevStudio позволяет автоматически сгенерировать файл, содержащий такое дерево. Сгенерированный файл можно загрузить в Alpha.HMI.Trends, чтобы вместо полного серверного дерева сигналов в окне приложения отобразилось дерево с выбранными сигналами.

Подготовка пользовательского дерева сигналов в Alpha.DevStudio

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

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

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

При формировании пользовательского дерева не учитываются одиночные объекты. Это значит, что, если все сигналы, выбранные для помещения в пользовательское дерево, находятся на одном уровне вложенности, то иерархия одиночных родительских объектов не будет отображаться в пользовательском дереве. Такая схема ускоряет доступ к сигналам при работе с пользовательским деревом в Alpha.HMI.Trends. На рисунке ниже показано, как в таком случае выглядит пользовательское дерево сигналов в Alpha.HMI.Trends (справа) по сравнению с деревом сигналов в Alpha.DevStudio (слева).

Пусть создано три логических объекта: Object1, Object2 и Object3. Объектам Object1 и Object3 добавлен атрибут Показывать на графиках со значением Да, а для Object2 такой атрибут не добавлен вовсе. Еще для параметра Test8 внутри Object3 атрибут Показывать на графиках добавлен со значением Нет.

Тогда в пользовательское дерево сигналов:

  • попадут все сигналы, описанные в Object1;
  • не попадет ни один сигнал объекта Object2;
  • попадут только сигналы Test7 и Test9 из Object3.

Указание диапазона значений

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

Добавление линий уровней на график сигнала

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

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

{ "color": "0xff000000", "brushStyle": 1, "weight": 1 }

Чтобы изменить внешний вид линии уровня, поменяйте значения параметров json-объекта.

Генерация файла пользовательского дерева сигналов

Чтобы создать файл пользовательского дерева сигналов, скомпилируйте и постройте решение. При построении решения для каждого экземпляра Alpha.Server, в котором имеются сигналы для отображения на графиках, сохранятся файлы trends_tree.json и trends_tree.jtr в папке с конфигурацией этого экземпляра: ~\Папка_с_решением\bin\Название_среды_исполнения\Имя_узла_Alpha.Domain\Имя_экземпляра_Alpha.Server. Файлы отличаются структурой содержимого и назначением: файл *.jtr предназначен для загрузки в Alpha.HMI.Trends версии 2.5.1 и новее, файл *.json – для загрузки в более ранние версии Alpha.HMI.Trends.

Как использовать полученные файлы пользовательского дерева сигналов, описано в документации на Alpha.HMI.Trends.

Структура пользовательского дерева сигналов trends_tree.jtr

Формат *.jtr – более новый формат файла с пользовательским деревом сигналов. Такой файл можно загружать в тип Тренды, предоставляемый расширением Alpha.HMI.Trends версии 2.5.1 и новее. Пользовательское дерево сигналов формируется в формате JSON. Оно имеет иерархическую структуру. В нем каждому логическому объекту, параметру и линии на графике соответствует свой json-объект. Значения параметров json-объектов можно менять:

  • name – имя сигнала или объекта;
  • children – параметр, в качестве значения которого указаны json-объекты, вложенные в текущий объект;
  • prototype – название типа, на основе которого был создан текущий объект;
  • tag – тег сигнала или сигнала-уровня;
  • dataType – тип сигнала или сигнала-уровня;
  • unit – единицы измерения сигнала (значение берется из атрибута Единицы измерения, если он был добавлен параметру);
  • description – описание сигнала (значение берется из атрибута Описание, если он был добавлен параметру);
  • lowRange, highRange – нижняя и верхняя граница сигнала, если указаны у описывающего его параметра;
  • levels – параметр, в качестве значения которого указаны json-объекты, описывающие сигналы-уровни, если они были добавлены сигналу. Параметры указанных здесь json-объектов:

    • visible – видимость линии на графике;
    • lineStyle – хранит json-объект, описывающий внешний вид линии на графике.

Пример структуры пользовательского дерева сигналов, полученного при построении решения из примера выше:

{
 "TreeDescription": [{
   "name": "Object1",
   "children": [{
     "name": "Lines",
     "children": [{
       "name": "Level1",
       "tag": "Object1.Lines.Level1",
       "dataType": "int2"
      }, {
       "name": "Level2",
       "tag": "Object1.Lines.Level2",
       "dataType": "int2"
      }
     ]
    }, {
     "name": "Test1",
     "tag": "Object1.Test1",
     "dataType": "string"
    }, {
     "name": "Test2",
     "tag": "Object1.Test2",
     "dataType": "int2",
     "lowRange": 50,
     "highRange": 120,
     "levels": [{
       "tag": "Object1.Lines.Level1",
       "visible": true,
       "lineStyle": { "color": "0xff43A047", "brushStyle": 3, "weight": 3 }
      }, {
       "tag": "Object1.Lines.Level2",
       "visible": true,
       "lineStyle": { "color": "0xff0064B2", "brushStyle": 4, "weight": 4 }
      }
     ]
    }, {
     "name": "Test3",
     "tag": "Object1.Test3",
     "dataType": "float"
    }
   ]
  }, {
   "name": "Object3",
   "children": [{
     "name": "Test7",
     "tag": "Object3.Test7",
     "dataType": "string"
    }, {
     "name": "Test9",
     "tag": "Object3.Test9",
     "dataType": "float"
    }
   ]
  }
 ]
}