Alpha.Community

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

SetAdvancedRequestFilter

Применяет расширенный фильтр запроса.

Столбцы таблицы событий, по которым возможна фильтрация:

Столбец Атрибут события на AE сервере Тип
Время генерации LocalTime Дата и время
Время срабатывания LocalActiveTime Дата и время
Время деактивации LocalInactiveTime Дата и время
Сообщение Message Строка
Источник события Source Строка
Важность Severity Число
Квитировано AckedAsString Строка
Время квитирования LocalAckTime Дата и время
Пользователь ActorId Строка
Комментарий квитирования AckComment Строка
Группа важности SeverityGroup Строка
Источник данных ServerDescription Строка
Значение сигнала ValueAsString Строка
Качество сигнала Quality Строка

Установленный фильтр применяется при запросе исторических данных с помощью функции SetHistoricalInterval.

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

Синтаксис

bool SetAdvancedRequestFilter(string FilterExpr)

Параметры

FilterExpr string Условия фильтрации. Правила формирования условий фильтрации описаны ниже.

Возвращаемые значения

1 расширенный фильтр отображения успешно установлен
0 неудачный разбор выражения фильтрации, фильтр не установлен

Правила формирования условий фильтрации

Общие правила:

  • круглые скобки: ( , ) – предназначены для группировки условий фильтра и указания приоритетов операций;
  • строковые значения должны быть заключены в одинарные кавычки;
  • значения даты должны быть указаны в формате: DD.MM.YYYY hh:mm:ss (DD – день, MM – месяц, YYYY – год, hh – часы, mm – минуты, ss – секунды) и заключены в одинарные кавычки;
  • имена операторов нечувствительны к регистру написания.

Операторы:

Операторы сравнения:

  • < (меньше)
  • > (больше)
  • <= (меньше или равно)
  • >= (больше или равно)
  • <> (не равно)
  • = (равно)
Операторы сравнивают поля набора данных с некоторыми значениями.

Логические операторы:

  • AND
  • OR
  • NOT

Предназначены для объединения нескольких условий в одно условие, а также для создания отрицательного условия фильтрации:

  • AND – логическое "и";
  • OR – логическое "или";
  • NOT – логическое "не".

Оператор AND имеет приоритет перед другими операторами.

Операторы шаблона:

  • LIKE
  • NOT LIKE

Отбор строковых значений, соответствующих указанному шаблону:

  • LIKE – значение содержит указанный шаблон;
  • NOT LIKE – значение не содержит указанный шаблон.

Шаблоном называется строковое значение с подстановочными символами *, которые обозначают любое количество символов строки:

  • text* – значение начинается на text;
  • *text – значение заканчивается на text;
  • *text* – значение содержит text.

Если строковое значение шаблона содержит символы *, %, [, ], совпадающие со служебными, то каждый из указанных символов шаблона должен быть заключен в квадратные скобки.

Операторы принадлежности к набору значений:

  • IN
  • NOT IN

Указывает принадлежность к некоторому набору значений:

  • IN – параметр входит в набор значений;
  • NOT IN – параметр не входит в набор значений.

Синтаксис:

<имя параметра> IN (<значение1>, <значение2>, …,<значениеN>)

<имя параметра> NOT IN (<значение1>, <значение2>,…, <значениеN>)

Операторы пустого значения:

  • IS NULL
  • IS NOT NULL

Отбор пустых значений:

  • IS NULL – поле содержит пустое значение;
  • IS NOT NULL – поле содержит не пустое значение.

Запросить события, важность которых меньше или равна 3 и сгенерированные до 18:00:00 10 января 2019.

AlarmsAxControl1.SetAdvancedFilter("Severity<=3 AND LocalTime<='10.01.2019 18:00:00'")

Запросить события, имя источника которых содержит строку RVS PA 1_101, важность которых не равна 100, 108 и 109, имеющие комментарий квитирования.

AlarmsAxControl1.SetAdvancedFilter("Source LIKE '* RVS PA 1_101*' AND Severity NOT IN(100, 108, 109) AND AckComment IS NOT NULL")