Alpha.Community

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

SetAdvancedFilter

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

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

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

Чтобы активировать расширенный фильтр отображения, установите свойству IsAdvancedFilterActive значение true.

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

Синтаксис

bool SetAdvancedFilter(string FilterExpr)

Параметры

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

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

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

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

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

  • круглые скобки: ( , ) – предназначены для группировки условий фильтра и указания приоритетов операций;
  • строковые значения должны быть заключены в одинарные кавычки;
  • значения даты должны быть указаны в формате: 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 – поле содержит не пустое значение.

Примеры

Отобразить события с важностью больше или равной 100.

AlarmsAxControl1.SetAdvancedFilter("Severity>=100")

Отобразить квитированные события, важность которых меньше или равна 10, и квитирующий пользователь не Администратор.

AlarmsAxControl1.SetAdvancedFilter("AckedAsString ='Да' AND Severity<=10 AND NOT ActorID ='Администратор'")

Отобразить события, имя источника которых содержит строку A1, а комментарий квитирования не содержит строку тест.

AlarmsAxControl1.SetAdvancedFilter("Source LIKE '*A1*' AND AckComment NOT LIKE '*тест*'")

Отобразить события, имя источника которых содержит строку A1, а комментарий квитирования начинается со строки тест%.

AlarmsAxControl1.SetAdvancedFilter("Source LIKE '*A1*' AND AckComment LIKE 'тест[%]*'")

Отобразить события, содержащие в тексте сообщения информацию о неисправностях или о превышении допустимого значения, важность которых равна 205, 206 или 312.

AlarmsAxControl1.SetAdvancedFilter("(Message LIKE '*неисправность*' OR Message LIKE '*выше допустимого значения*') AND Severity IN (205, 206, 312)")