GetNewEvents

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево библиотек > Библиотека BaseObjects > BaseObjects.ФБ.Системные > Тревоги и сообщения >

GetNewEvents

GetNewEvents на каждый вызов возвращает только те сообщения, которые были выданы с момента предыдущего вызова (если одно событие за это время было выдано несколько раз, фиксируется каждое срабатывание). В любом случае в выборку попадут только те сообщения, которые становились активными с момента прошлого вызова, а также безусловные сообщения, которые были выданы с прошлого вызова.

Важно! Функциональный блок работает только с актуальными сообщениями, т.е. с теми, которые хранятся в оперативной памяти устройства.

Вид в дереве

Вид в редакторе FBD

GetNewEvents

GetNewEvents_1

Входы и выходы ФБ:

Название

Тип

Назначение

Входы

Fields

STRING

Перечисляются список полей, которые необходимо отобразить. Значения полей (параметры тревоги) вводятся через запятую без использования квадратных скобок [].Пример Message , Acked). Указываются программные имена полей (параметров). Список полей и их программные имена смотрите в разделах Тревога и Список программных имен параметров тревог

Filter

STRING

Задается фильтр, определяющий сообщения, которые должны быть подсчитаны. Пример,  [ "Severity <= 100 or Severity >= 900"], где Severity соответствует свойству Приоритет. Полный список соответствий приведен в разделе Список программных имен параметров тревог.

IsGlobal

BOOL

Определяет место поиска сообщений. Если вход принимает значение False, то ФБ подсчитывает сообщения только того объекта (и его подобъектов), в котором находится.

Archive

REF_TO

Если установлена связь с каким-либо архивом или указан ID этого архива, то будут выдаваться только сообщения, которые назначены в данный архив, например, только в Архив сообщений ИБ

Выходы

Count

DINT

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

Events

ARRAY [*] OF ANY

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

Рекомендации по работе с ФБ

Для использования результатов полученных на выходе Events необходимо в пользовательской библиотеке создать тип данных массив структур переменной длины. Порядок и количество полей структуры должно соответствовать порядку и количеству полей, указанных на входе ФБ Fields. Затем создать параметр этого типа данных. Параметр связать уже с выходом блока Events  и использовать в дальнейшем  в проекте.

В панели свойств программы, в которой находится ФБ, в категории Задача рекомендуется устанавливать свойство Способ исполнения в состояние По вызову:

UsersGet_2