Alpha.Community

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

Вычисление значений атрибутов

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

Вычисляемое выражение может содержать:

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

Вычисляемое выражение, содержащее ссылку на значение другого атрибута, представляет собой конструкцию вида @(Source:Attribute), где Source – алгоритм поиска атрибута, Attribute – тип атрибута. При вычислении значение найденного атрибута будет подставлено вместо вычисляемого параметра.

Source может иметь следующие значения:

  • не указан – атрибут ищется среди атрибутов данного элемента.
  • object – атрибут ищется среди атрибутов контекстного объекта.

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

  • *object – атрибут ищется среди атрибутов контекстного объекта и вверх по иерархии элементов в проекте: если у объекта не будет искомого атрибута, он будет искаться среди атрибутов родительского элемента и т.д..

  • parent – атрибут ищется среди атрибутов родителя контекстного объекта (элемента, в который объект вложен).

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

  • *parent – атрибут будет искаться среди атрибутов родителя контекстного объекта и вверх по иерархии элементов в проекте: если у объекта не будет искомого атрибута, он будет искаться среди атрибутов его родительского элемента и т.д..
  • @N – атрибут будет искаться на N уровней выше относительно вычисляемого параметра.
  • путь к любому элементу в проекте. Тогда атрибут будет взят у конкретного элемента. Элемент, к которому ведет путь, должен быть доступен относительно редактируемого атрибута. Путь может содержать переходы по ссылкам.

В Attribute нужно указать путь к типу атрибута в текущем проекте. Чтобы узнать путь к типу атрибута:

  • в окне Атрибуты наведите мышью на атрибут нужного типа – путь отобразится во всплывающей подсказке.
  • добавьте карту значений атрибутов (элемент Значения атрибутов) и в свойстве Тип выберите атрибут нужного типа – в свойство будет подставлен путь к выбранному типу атрибута.

В Attribute можно использовать типы атрибутов из других модулей (например, Om.System) или пользовательские типы атрибутов. Пользовательские типы атрибутов создаются пользователем и предназначены для использования в вычислениях значений других атрибутов. Как создать пользовательский тип атрибута, описано в разделе Создание пользовательских атрибутов. После создания пользовательского типа атрибута элементам можно добавлять атрибуты этого типа.

В тексте сообщения о событии нужно указать имя объекта, в котором произошло событие:

  1. В типе сигналу настраиваем генерацию событий.
  2. В окне Атрибуты в атрибуте События в текст сообщения вставляем имя объекта: @(object:System.Attributes.Name).

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

Для сигнала в типе настроена генерация событий. Нужно в некоторых объектах этого типа изменить важность события:

  1. Создаём тип атрибута Severity.

    В свойствах указываем:

    • Тип значения – uint2
    • Название – Важность события
  2. В типе сигналу настраиваем генерацию событий.
  3. В окне Атрибуты в атрибуте События заменяем значение поля Severity на @(:Attributes.Severity) (нужно указать путь к типу атрибута, где он находится в проекте).
  4. Добавляем сигналу атрибут созданного типа: Важность события. Указываем ему значение по умолчанию: 500.
  5. Для объектов этого типа, в которых нужно изменить важность события, переопределяем её с помощью карты атрибутов:

    1. Переходим в Приложение, в котором размещены объекты.
    2. Добавляем элемент Значения атрибутов, создаём файл карты атрибутов и указываем созданный тип атрибута – Важность события.
    3. В карте атрибутов объектам, в которых нужно, указываем новую важность события.

В результате:

  • По умолчанию в объектах используется значение важности, указанное в типе.
  • В объектах, где значение атрибута переопределено, используется значение важности, указанное в карте атрибутов.
  • Все остальные параметры события (текст сообщения, звук и т.д.) имеют значения, указанные в типе.

Для сигнала в типе настроена генерация событий. В каждом объекте этого типа должен быть свой текст сообщения о событии:

  1. Создаём тип атрибута Message.

    В свойствах указываем:

    • Тип значения – string
    • Название – Сообщение о событии
  2. В типе сигналу настраиваем генерацию событий.
  3. В окне Атрибуты в атрибуте События заменяем текст сообщения на @(object:Attributes.Message) (нужно указать путь к типу атрибута, где он находится в проекте).
  4. Объектам этого типа добавляем атрибут созданного типа: Сообщение о событии. Значение атрибута – текст сообщения.

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

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

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

Вычисляемое выражение, содержащее ссылку на значение свойства параметра, представляет собой конструкцию вида @(member:Path:Property), где Path – это путь к нужному параметру (сигналу), а Property – именной или числовой идентификатор свойства, значение которого участвует в вычислении (может отсутствовать). Ниже приведены некоторые именные идентификаторы:

  • Value – свойство 2;
  • Quality – свойство 3;
  • TimeStamp – свойство 4;
  • EUnit – свойство 100;
  • Description – свойство 101.

Пусть создан пользовательский атрибут события Сообщение – как описано в разделе Настройка пользовательских атрибутов в событиях. Атрибут добавлен сигналу-источнику событий Pressure. В качестве значения добавленного атрибута укажем @(member:string_message) – ссылку на значение сигнала string_message, находящегося в том же объекте, что и сигнал, генерирующий события. Тогда при генерации нового события пользовательский атрибут Сообщение примет значение сигнала string_message.