Alpha.Community

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

Настройка генерации событий

Генерация событий настраивается для объектов, размещаемых в Alpha.Server.

Чтобы настроить генерацию событий:

  1. Выберите параметр, описывающий сигнал сервера, при изменении значений которого должны генерироваться события.
  2. Для выбранного сигнала в окне События:

    1. Включите генерацию событий, установив флаг Генерировать события.

    2. Выберите тип условия генерации события. Доступные типы условий генерации зависят от типа сигнала.

      Тип сигнала Типы условий срабатывания
      bool

      Только логическое условие

      int1, uint1,

      int2, uint2,

      int4, uint4,

      int8, uint8

      • Перечисление
      • По уровню
      • Отклонение
      float, double
      • По уровню
      • Отклонение
      string

      Только генерация сообщения

      Подробнее о типах условий сказано в документации на модуль OPC AE Server.

    3. Опишите подусловия генерации событий. Подусловия описываются путем задания значений параметрам, описанным в таблице ниже. Чтобы добавить подусловие, в контекстном меню выберите Добавить подусловие или нажмите клавишу Insert.

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

      Параметр Описание

      Столбец без заголовка

      Включить/отключить генерацию выбранного события при выполнении подусловия.
      Подусловие Название подусловия.
      Значение Значение, используемое в подусловии. У нечисловых типов (bool, string) отсутствует.
      Сообщение

      Текст сообщения, выдаваемого при выполнении подусловия генерации события (далее – сообщение о событии). Конкатенируется с описанием объекта: <описание объекта><сообщение>.

      Для удобочитаемости рекомендуем в начало сообщения добавлять пробел или точку с пробелом.

      При формировании текста сообщения можно использовать:

      • Шаблон, указанный в виде значения свойства Шаблон сообщения события элемента OPC AE Сервер.
      • Значения пользовательских атрибутов и параметров. Инструкция по формированию ссылки расположена в разделе Вычисление значений атрибутов.
      • Экземпляр элемента Обработчик события. При подготовке сообщения в обработчике можно изменять текст сообщения, важность, звук, условие и подусловие. Элемент удобно использовать, когда нужно добавить в текст значение другого сигнала, или заменить в нём ранее указанное значение на другое. Как редактировать текст с помощью обработчика событий, описано ниже.
      Важность

      Важность события при выполнении подусловия.

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

      Деактивирующее

      Включить/отключить деактивацию условия при выполнении подусловия.

      По такому подусловию клиенты модуля OPC AE Server Alpha.Server получат событие активации, которое сразу же деактивируется.

      Повторная генерация

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

      Значение по умолчанию зависит от типа условия:

      • Перечисление – включено;
      • дискретное – выключено;
      • динамическое – включено;
      • По уровню – выключено;
      • Отклонение – включено;
      • Внешние события – включено.

      Подробнее о типах условий можно почитать в документации на Alpha.Server → Модули → Коммуникационные модули → Модули OPC → OPC AE Server → Функциональные возможности → Генерация событий.

      Задержка генерации события, мс

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

      Указывается значение в диапазоне от 1 до 4294967295 мс.

      Квитировать

      Требование квитировать событие:

      • Не требуется – квитирование не требуется, событие квитируется сервером автоматически;
      • Требуется – требуется ручное квитирование;
      • Последнее – требуется автоматическое квитирование только последнего активного подусловия. Подробнее об автоквитировании можно почитать в документации на Alpha.Server → Модули → Коммуникационные модули → Модули OPC → OPC AE Server → Функциональные возможности → Квитирование.
      Время квитирования, сек. Промежуток времени, по истечении которого потребуется повторное квитирование. Подробнее о режиме квитирования с ограничением по времени можно почитать в документации на Alpha.Server → Модули → Коммуникационные модули → Модули OPC → OPC AE Server → Функциональные возможности → Квитирование.
      Звук

      Имя звукового файла, который будет проигрываться при генерации события. Можно указать несколько файлов через запятую: файлы будут воспроизводиться последовательно один за другим. Расширение файлов указывать необязательно.

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

  3. У объекта, в котором расположен сигнал, в окне События установите флаг Генерировать события (по умолчанию установлен).

    Если флаг не установлен, события в объекте генерироваться не будут (но могут генерироваться во вложенных объектах).

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

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

Чтобы Alpha.Server генерировал события, нужно добавить модуль OPC AE Server в его описание.

События не генерируются для сигнала:

  • имеющего плохое качество, даже если значение менялось;
  • качество которого сменилось с плохого на хорошее, но значение при этом не менялось.

Это сделано для того, чтобы при разрывах связи с ПЛК не происходило повторной генерации событий.

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

События можно сохранять в историю.

Включение генерации событий по условию

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

Чтобы указать условие включения генерации событий, еще раз щелкните флаг Генерировать события, галочка должна смениться черным квадратом. В появившемся поле При условии задайте условие включения генерации события. В качестве условия должно быть указано логическое выражение1Выражение, относительно которого можно сказать истинно оно (то есть выполняется) или ложно (то есть не выполняется).. Условие включения может зависеть от значения какого-либо атрибута. Инструкция по формированию ссылки на атрибут расположена в разделе Вычисление значений атрибутов.

Предположим, для типа нужно настроить генерацию событий по значению параметра. Пусть для одного объекта этого типа генерация событий должна выполняться, а для другого – нет. Чтобы не делать два почти одинаковых типа – с генерацией событий и без нее – можно настроить генерацию событий по условию. В приведенном ниже примере события для параметра Pressure будут генерироваться только в тех случаях, когда атрибут IsEnabled объекта Test будет принимать значение Да.

Редактирование текста сообщения о событии с помощью обработчика событий

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

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

  1. Перейдите в объект (или тип), в котором расположен параметр, для которого редактируется событие. Для примера приведен логический объект Object, в котором расположен параметр Pressure, для которого нужно редактировать сообщение о событии.
  2. Добавьте в объект (или тип) экземпляр элемента Обработчик события.
  3. Соедините параметр, событие которого содержит редактируемое сообщение, с ранее добавленным экземпляром Обработчик события. Для созданной связи в качестве значения свойства Событие выберите из выпадающего списка вариант Подготовка сообщения.

  4. Для экземпляра Обработчик события укажите код подготовки сообщения о событии. Код должен быть написан на языке Alpha.Om.

    Обращение к полю, содержащему текст сообщения, выглядит следующим образом: Parameter.Messages.Selected.Message, где Parameter – название параметра, для события которого редактируется текст сообщения.

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

    ValString: string = String.ToString("%."+ String.ToString(Digits) +"f", NewValue);
    OldValString: string = String.ToString("%."+ String.ToString(Digits) +"f", OldValue);
    Msgs.Messages.Selected.Message = String.Replace(Msgs.Messages.Selected.Message, "#0", OldValString);
    Msgs.Messages.Selected.Message = String.Replace(Msgs.Messages.Selected.Message, "#1", ValString);

    С примером решения, использующего такой обработчик событий, можно ознакомиться, открыв его из папки с решениями, поставляемой с составе дистрибутива Alpha.DevStudio. Для этого перейдите в меню Пуск → Automiq → Примеры решений → DataBuffer. В данном решении обработчик называется PrepareMessage и находится в типе Types.IOS.AI.