GetActualEvents

<< Click to Display Table of Contents >>

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

GetActualEvents

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

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

Вид в дереве

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

GetActualEvents

GetActualEvents_1

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

Название

Тип

Назначение

Входы

Fields

STRING

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

Filter

STRING

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

Для выполнения запроса поиска подстроки в строке используется оператор Contains. Пример, ["Message Contains 'Взл'"], где Message соотвествует свойству тревоги Сообщение. При таких настройках фильтра будут отображаться все сообщения, в которых содержится подстрока "Взл".

Полный список соответствий приведен в разделе Список программных имен параметров тревог.

IsGlobal

BOOL

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

Archive

REF_TO

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

Выходы

Count

DINT

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

Events

ARRAY [*] OF ANY

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

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

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