Wiki source code of Профессиональный редактор фильтров
Version 2.1 by pugachevskaya_elena on 2025/09/22 18:45
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
1.1 | 1 | {{layout}} |
| 2 | {{layout-section ac:type="two_right_sidebar"}} | ||
| 3 | {{layout-cell}} | ||
| 4 | В данном разделе приведено описание профессионального редактора фильтров событий Платформы НЕЙРОСС. | ||
| 5 | |||
| 6 | {{info}} | ||
| 7 | Общие сведения о фильтрации событий приведены в разделе ~[[[doc:ui.Параметры узла.События и фильтры.WebHome]]]. | ||
| 8 | {{/info}} | ||
| 9 | |||
| 10 | {{info}} | ||
| |
2.1 | 11 | **Переход к функционалу**: |
| 12 | |||
| 13 | * С версии 20.40 ~[[[doc:ui.Рабочий стол НЕЙРОСС.Изменения интерфейса НЕЙРОСС.WebHome]]]: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > [[doc:ui.Параметры узла.WebHome]] > [[doc:ui.Параметры узла.События и фильтры.WebHome]] > вкладка Фильтры. | ||
| 14 | * До версии 20.39 включительно: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > События и фильтры > вкладка Фильтры. | ||
| 15 | * До версии 20.22: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > Фильтры. | ||
| |
1.1 | 16 | {{/info}} |
| 17 | {{/layout-cell}} | ||
| 18 | |||
| 19 | {{layout-cell}} | ||
| 20 | [[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание: | ||
| 21 | |||
| 22 | {{toc/}} | ||
| 23 | {{/layout-cell}} | ||
| 24 | {{/layout-section}} | ||
| 25 | |||
| 26 | {{layout-section ac:type="single"}} | ||
| 27 | {{layout-cell}} | ||
| 28 | == {{id name="Профессиональныйредакторфильтров-Общиесведения"/}}Общие сведения == | ||
| 29 | |||
| 30 | Профессиональный редактор позволяет построить фильтр, включающий произвольное количество веток условий. Фильтр записывается в виде логического дерева, корнем которого выступает один из логических операторов И/ИЛИ/НЕ, далее дерево дополняется произвольным количеством логических ветвей, каждая ветвь может содержать дополнительные ветки условий И/ИЛИ/НЕ, а также конечные условия ПО МЕТКЕ / ПО ИСТОЧНИКУ / ПО ТЕМАМ / ПРОИЗВОЛЬНЫЙ СКРИПТ». | ||
| 31 | |||
| 32 | {{info}} | ||
| 33 | **ПОДСКАЗКА** | ||
| 34 | |||
| 35 | По умолчанию отображается [[doc:ui.Параметры узла.События и фильтры.Базовый редактор фильтров.WebHome]]. Для перехода в профессиональный редактор установите переключатель **Профессиональный режим** в положение [[image:attach:ui.Параметры узла.WebHome@fa-on.png||thumbnail="true" height="18"]] **Включено**. | ||
| 36 | {{/info}} | ||
| 37 | |||
| 38 | Чтобы правильно построить логическое дерево, рекомендуется предварительно сформулировать требования фильтра в виде логического выражения. Примеры приведены в таблице ниже. | ||
| 39 | |||
| |
2.1 | 40 | (% class="wrapped" %) |
| |
1.1 | 41 | |=(% style="width: 38.0px;" %)((( |
| 42 | № | ||
| 43 | )))|=(% style="width: 473.0px;" %)((( | ||
| 44 | Фильтр | ||
| 45 | )))|=(% style="width: 325.0px;" %)((( | ||
| 46 | Логическое дерево | ||
| 47 | )))|=(% style="width: 986.0px;" %)((( | ||
| 48 | Комментарий | ||
| 49 | ))) | ||
| 50 | |(% style="width: 38.0px;" %)((( | ||
| 51 | 1 | ||
| 52 | )))|(% style="width: 473.0px;" %)((( | ||
| 53 | #Тревога И #СКУД | ||
| 54 | |||
| 55 | Тревожные события доступа (все точки доступа). | ||
| 56 | )))|(% style="width: 325.0px;" %)((( | ||
| 57 | (% class="content-wrapper" %) | ||
| 58 | ((( | ||
| 59 | [[image:attach:filtr_example1.png]] | ||
| 60 | ))) | ||
| 61 | )))|(% style="width: 986.0px;" %)((( | ||
| 62 | Все тревожные события помечаются меткой #Тревога, все события точек доступа помечаются меткой #СКУД. Если «И» заменить на «ИЛИ», то фильтр пропустит все тревожные события и все события системы контроля доступа. | ||
| 63 | ))) | ||
| 64 | |(% style="width: 38.0px;" %)((( | ||
| 65 | 2 | ||
| 66 | )))|(% style="width: 473.0px;" %)((( | ||
| 67 | #Тревога И «ТД1» | ||
| 68 | |||
| 69 | Тревожные события доступа от точки доступа «ТД1». | ||
| 70 | )))|(% style="width: 325.0px;" %)((( | ||
| 71 | (% class="content-wrapper" %) | ||
| 72 | ((( | ||
| 73 | [[image:attach:filtr_example2.png]] | ||
| 74 | ))) | ||
| 75 | )))|(% style="width: 986.0px;" %)((( | ||
| 76 | Все условия должны выполняться одновременно. Фильтр пропустит только события от источника ТД1, содержащие метки тревоги. Метка #СКУД здесь лишняя, так как все события от точек доступа помечаются меткой #СКУД, а в фильтре указана конкретная точка доступа. | ||
| 77 | ))) | ||
| 78 | |(% style="width: 38.0px;" %)((( | ||
| 79 | 3 | ||
| 80 | )))|(% style="width: 473.0px;" %)((( | ||
| 81 | #Тревога И («ТД 12.1» ИЛИ «ТД 22.1» ИЛИ «Раздел 1»). | ||
| 82 | |||
| 83 | Тревожные события доступа от нескольких точек доступа или разделов сигнализации. | ||
| 84 | )))|(% style="width: 325.0px;" %)((( | ||
| 85 | (% class="content-wrapper" %) | ||
| 86 | ((( | ||
| 87 | [[image:attach:filtr_example3.png]] | ||
| 88 | ))) | ||
| 89 | )))|(% style="width: 986.0px;" %)((( | ||
| 90 | Одно событие может происходить только от одного источника. Требуется отобрать события тревоги от «ТД 12.1», или от «ТД 22,1», или от раздела «Раздел 1». В одной ветви дерева источники событий могут быть разного типа. | ||
| 91 | ))) | ||
| 92 | |(% style="width: 38.0px;" %)((( | ||
| 93 | 4 | ||
| 94 | )))|(% style="width: 473.0px;" %)((( | ||
| 95 | #Тревога И (НЕ «ТД 8.1») | ||
| 96 | |||
| 97 | Тревожные события доступа от всех точек, кроме «ТД 8.1». | ||
| 98 | )))|(% style="width: 325.0px;" %)((( | ||
| 99 | (% class="content-wrapper" %) | ||
| 100 | ((( | ||
| 101 | [[image:attach:filtr_example4.png]] | ||
| 102 | ))) | ||
| 103 | )))|(% style="width: 986.0px;" %)((( | ||
| 104 | Логический оператор НЕ может содержать только одно условие, при необходимости перечисления нескольких, для каждого добавляйте своё условие «НЕ». Ниже приведён пример. | ||
| 105 | ))) | ||
| 106 | |(% style="width: 38.0px;" %)((( | ||
| 107 | 5 | ||
| 108 | )))|(% style="width: 473.0px;" %)((( | ||
| 109 | #Тревога И (НЕ «ТД 8.1») И (НЕ «Доступ запрещен: по команде оператора») | ||
| 110 | |||
| 111 | Тревожные события доступа от всех точек доступа, кроме «ТД 8.1», кроме запрета доступа по команде оператора. | ||
| 112 | )))|(% style="width: 325.0px;" %)((( | ||
| 113 | (% class="content-wrapper" %) | ||
| 114 | ((( | ||
| 115 | [[image:attach:filtr_example6.png]] | ||
| 116 | ))) | ||
| 117 | )))|(% style="width: 986.0px;" %)((( | ||
| 118 | \\ | ||
| 119 | ))) | ||
| 120 | |||
| 121 | \\ | ||
| 122 | |||
| 123 | {{info}} | ||
| 124 | Если необходимо построить фильтр, пропускающий события нескольких групп условий одновременно, необходимо объединить такие группы оператором «ИЛИ». На скриншоте ниже приведён пример фильтра, который пропустит тревожные события СКУД. а также события тревоги и неисправности от всех разделов сигнализации, кроме раздела «Раздел 1». | ||
| 125 | {{/info}} | ||
| 126 | |||
| 127 | \\ | ||
| 128 | |||
| 129 | == {{id name="Профессиональныйредакторфильтров-Окнораздела"/}}Окно раздела == | ||
| 130 | |||
| |
2.1 | 131 | [[image:attach:s_filters_prof_wnd.png||width="900"]] |
| |
1.1 | 132 | |
| |
2.1 | 133 | 1. **Список фильтров**: команды переименования и удаления расположены в строке фильтра. |
| |
1.1 | 134 | 1. **Дерево условий**: условия фильтра, записанные в виде логического дерева, команды управления условиями расположены в строке условия. |
| 135 | |||
| 136 | == {{id name="Профессиональныйредакторфильтров-Созданиефильтравпрофессиональномрежиме"/}}Создание фильтра в профессиональном режиме == | ||
| 137 | |||
| 138 | {{info}} | ||
| 139 | Описание настройки фильтра дано на примере. | ||
| 140 | {{/info}} | ||
| 141 | |||
| 142 | (% style="color: rgb(23,43,77);" %)В заголовке блока [1] нажмите на кнопку [[image:attach:btn_plus_circle.png||thumbnail="true" height="17"]] **Добавить фильтр.** | ||
| 143 | |||
| 144 | (% style="color: rgb(23,43,77);" %)В отобразившемся окне введите название нового фильтра. Нажмите на кнопку **ОК**. | ||
| 145 | |||
| 146 | (% style="color: rgb(23,43,77);" %)[[image:attach:nfilters_add.png]]\\ | ||
| 147 | |||
| 148 | (% style="color: rgb(23,43,77);" %)Имя нового фильтра отобразится в списке фильтров [1]. | ||
| 149 | |||
| 150 | (% style="color: rgb(23,43,77);" %)Перейдите в профессиональный режим. Для этого переведите переключатель Профессиональный режим в положение [[image:attach:fa-on.png||thumbnail="true" height="18"]] **Включено**. | ||
| 151 | |||
| 152 | (% style="color: rgb(23,43,77);" %)Постройте логическое дерево. | ||
| 153 | |||
| 154 | 1. (% style="color: rgb(23,43,77);" %)Задайте корневое логическое условие. По умолчанию установлено ИЛИ. Если требуется изменить его на И/НЕ, нажмите на кнопку [[image:attach:btn_edit1.png||thumbnail="true" height="20"]]**Изменить условие**, расположенную в строке условия. | ||
| 155 | 1. (% style="color: rgb(23,43,77);" %)В отобразившемся окне выберите из раскрывающегося списка требуемый тип условия, например, — **И**, — и нажмите на кнопку **ОК**. | ||
| 156 | [[image:attach:filtr_if_chg.png||width="350"]]\\ | ||
| 157 | 1. (% style="color: rgb(23,43,77);" %)Добавьте к корневому условию дочернее. Для этого нажмите на кнопку [[image:attach:btn_plus_circle.png||thumbnail="true" height="17"]]**Добавить дочернее условие**, расположенную в строке корневого условия. | ||
| 158 | 1. (% style="color: rgb(23,43,77);" %)В отобразившемся окне выберите из раскрывающегося списка тип дочернего условия. Например, — **По метке события**. В поле **Условие** выберите из раскрывающегося списка требуемую метку. Нажмите на кнопку **ОК**. | ||
| 159 | [[image:attach:filtr_if_add.png||width="340"]] [[image:attach:filtr_if_add2.png||width="400"]]\\ | ||
| 160 | 1. (% style="color: rgb(23,43,77);" %)Добавьте к корневому условию И еще одно дочернее условие. Для этого нажмите на кнопку [[image:attach:btn_plus_circle.png||thumbnail="true" height="17"]]**Добавить дочернее условие**, расположенную в строке корневого условия. Выберите из раскрывающегося списка тип дочернего условия, например, — **ИЛИ**. Нажмите на кнопку **ОК**. | ||
| 161 | 1. (% style="color: rgb(23,43,77);" %)Добавьте к добавленному условию **ИЛИ** конечное условие **По типу элемента** и выберите из раскрывающегося списка **ТД 12.1**. Для этого нажмите на кнопку [[image:attach:btn_plus_circle.png||thumbnail="true" height="17"]]**Добавить дочернее условие**, расположенную в строке условия **ИЛИ**. | ||
| 162 | [[image:attach:filtr_if_add3.png]]\\ | ||
| 163 | 1. ((( | ||
| 164 | (% style="color: rgb(23,43,77);" %)В отобразившемся окне в поле **Тип условия** выберите из раскрывающегося списка требуемый тип, например, — **По источнику события**, в поле **Условие** выберите из дерева функциональных элементов требуемый элемент, например, — ТД 12.1. Нажмите на кнопку **ОК**. | ||
| 165 | [[image:attach:filtr_if_add4.png||width="340"]]\\ | ||
| 166 | ))) | ||
| 167 | 1. Повторите шаги f-g для добавления других дочерних условий. | ||
| 168 | 1. При необходимости, вы можете удалить ветку дерева или все дерево, кроме корневого условия и начать процедуру построения дерева заново. Чтобы удалить ветку или конечное условие, нажмите на кнопку [[image:attach:btn_delete.png||thumbnail="true" height="16"]] **Удалить**, расположенную в строке условия. | ||
| 169 | 1. Вы можете использовать в качестве типа условия темы извещений ~[[[doc:ui.Параметры узла.События и фильтры.Базовый редактор фильтров.WebHome]] → Редактор тем извещений] или произвольный скрипт ~[[[#Пользовательский скрипт как условие фильтра>>doc:||anchor="Профессиональныйредакторфильтров-Пользовательскийскрипткакусловиефильтра"]]]. | ||
| 170 | |||
| 171 | Когда дерево условий полностью готово, нажмите на кнопку **Сохранить**, расположенную внизу страницы. | ||
| 172 | |||
| 173 | {{info}} | ||
| 174 | Переименование, редактирование и удаление фильтра в профессиональном режиме осуществляется аналогично соответствующим процедурам базового режима ~[[[doc:ui.Параметры узла.События и фильтры.Базовый редактор фильтров.WebHome]]]. | ||
| 175 | {{/info}} | ||
| 176 | |||
| 177 | == {{id name="Профессиональныйредакторфильтров-Пользовательскийскрипткакусловиефильтра"/}}Пользовательский скрипт как условие фильтра == | ||
| 178 | |||
| 179 | Для реализации произвольных условий отбора событий по нестандартным условиям предусмотрена возможность использования произвольных SCALA-скриптов в качестве условия фильтра. Причем фильтр может комбинироваться стандартными связками И/ИЛИ/НЕ с другими условиями. | ||
| 180 | |||
| 181 | [[image:attach:filtr_scrypt.png||width="900"]] | ||
| 182 | |||
| 183 | На рисунке выше приведён пример отбора событий доступа в нерабочее время (произошедших до 9 утра или после 7 вечера). События доступа отбираются по метке СКУД, время события не должно входить в интервал 09:00:00 — 19:00:00. | ||
| 184 | |||
| 185 | Чтобы использовать скрипт в качестве условия фильтра: | ||
| 186 | |||
| 187 | 1. Добавьте в фильтр условие с типом: **Произвольный скрипт**. | ||
| 188 | 1. Вставьте код скрипта в редактор. Чтобы открыть редактор в полноэкранном режиме, нажмите на кнопку [[image:attach:btn_edit1.png||thumbnail="true" height="20"]]. | ||
| 189 | 1. По окончании правки скрипта нажмите на кнопку **Применить**. | ||
| 190 | |||
| 191 | {{info}} | ||
| 192 | После завершения настройки не забудьте сохранить параметры фильтра. | ||
| 193 | {{/info}} | ||
| 194 | {{/layout-cell}} | ||
| 195 | {{/layout-section}} | ||
| 196 | {{/layout}} |