Настройка схемы обработки инцидентов

1

Инструменты раздела [[doc:ui.Параметры узла.Инциденты.WebHome]] (вкладка **Обработка инцидентов**) позволяют задать схему обработки инцидентов оператором [[neyross.АРМ НЕЙРОСС Центр.WebHome]]. Вы можете выполнить загрузку готовой схемы обработки или сформировать схему непосредственно из веб-интерфейса с помощью встроенного редактора.

2

3

4

**Переход к функционалу**:

5

6

* С версии 20.40 ~[[[doc:ui.Рабочий стол НЕЙРОСС.Изменения интерфейса НЕЙРОСС.WebHome]]]: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > [[doc:ui.Параметры узла.WebHome]] > Инциденты > вкладка Обработка инцидентов.

7

* До версии 20.39 включительно: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > Ситуационный центр > вкладка Обработка инцидентов(% style="letter-spacing: 0.0px;" %).

Возможна полностью автоматическая обработка событий, например, события технической неисправности могут автоматически адресоваться службе эксплуатации. В этом случае воспользуйтесь сервисом автоматизации ~[[[neyross.НЕЙРОСС Автоматика.WebHome]]].

12

13

14

[[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание:

== {{id name="Настройкасхемыобработкиинцидентов-Общиесведения"/}}Общие сведения ==

19

20

(% style="color: rgb(23,43,77);" %)Платформа НЕЙРОСС обеспечивает возможность выбора схемы обработки инцидентов в зависимости от условий возникновения события и шагов оператора, выполняющего обработку, согласно заданному сценарию, с подсказкой оператору по шагам обработки и контролем действий оператора. (%%)Предустановлена стандартная схема обработки: о(% style="color: rgb(23,43,77);" %)ператор принимает инцидент в обработку, самостоятельно изучает состояния и события элементов, просматривает «живое» видео и видеоархив, формирует фото- и видеоматериалы, выполняет управляющие команды, формирует текстовый комментарий к инциденту и завершает его обработку.

21

22

23

(% style="color: rgb(23,43,77);" %)При необходимости использования более сложного сценария обработки (с разветвлением и инструкциями оператору по шагам обработки) вы можете самостоятельно разработать такой сценарий или оформить заявку на разработку нестандартного многошагового алгоритма. Для работы в режиме PSIM (обработки события по алгоритму), требуется приобретение соответствующей лицензии ~[[[neyross.Лицензирование | Платформа НЕЙРОСС.WebHome]]].

24

25

26

(% style="color: rgb(23,43,77);" %)Запуск задачи обработки осуществляется при возникновении события, удовлетворяющего конкретному фильтру. Таким образом, с(%%)оздавая пары [фильтр + алгоритм обработки], можно распределять инциденты по операторам и назначать разные схемы обработки разным типам событий. Обработка событий может быть частично или полностью автоматизирована. К пользовательским шагам обработки относится: отметка о выполнении заданного действия, заполнение формы, добавление комментария, вынос резолюции по инциденту, возможность скачать отчёт по инциденту. К автоматическим шагам обработки относится: возможность «привязать» архивные скриншоты, выполнить произвольный SCALA-скрипт, сформировать отчёт по инциденту и отправить на заданную почту.

27

28

**Порядок настройки:**

29

30

1. **Рисование схемы

31

**Для рисования базовой схемы (каркаса) рекомендуется использовать встроенный редактор BPMN-схем.

32

\\

33

1. **Дополнение схемы

34

**Для всех автоматических и пользовательских шагов с помощью атрибутов настройте параметры шага. Для всех операторов ветвления нужно задать условия ветвления. Также необходимо указать уникальный идентификатор процесса.

35

\\

36

1. **Добавление фильтра

37

**Требуется задать условия запуска процесса обработки по заданному сценарию — фильтр отбора целевых событий.

38

39

Каждая схема должна содержать **Стартовое событие**, которое иницилизирует запуск процесса в нотации BPMN изображается в виде круга, а также **Конечное событие** — изображается в виде «жирного» круга. Для упрощения действий администратора по созданию сценария обработки, в Платформе НЕЙРОСС при создании алгоритма ему автоматически присваивается типовая схема, содержащая обязательные шаги и шаг ручного завершения оператором процедуры обработки инцидента.

40

41

[[image:attach:processing_scheme_start.png||width="500"]]

42

43

Вся логика работы (ход) процесса выражается во всевозможных элементах, расположенных между Стартовым и Конечным событием. Достаточно добавить типовые шаги обработки и настроить их параметры.

44

45

[[image:attach:processing_scheme_standart.png||width="800"]]

46

//Пример схемы с автоматическим формированием фотоматериалов и выгрузкой отчёта в формате PDF//

47

\\

48

49

[[image:attach:algorithms.png||width="800"]]

50

51

//Пример сложной разветвлённой схемы обработки инцидентов АвтоКПП//

52

53

== {{id name="Настройкасхемыобработкиинцидентов-Созданиесхемыобработки"/}}(% class="auto-cursor-target" %)Создание схемы обработки(%%) ==

54

55

В блоке **Алгоритмы обработки** нажмите на кнопку [[image:attach:btn_plus_new.png]] для добавления нового алгоритма.

56

57

В отобразившемся окне:

58

59

[[image:attach:algorithm_add.png||width="450"]]

60

61

1. В поле **Название** введите произвольное текстовое название нового алгоритма.

62

1. (((

63

В поле **Фильтр по событиям** из раскрывающегося списка выберите фильтр событий.

64

65

66

Фильтр событий позволяет разделить все входящие события на несколько потоков и для каждого потока в отдельности задать свой алгоритм обработки. Фильтры настраиваются в разделе [[doc:ui.Параметры узла.События и фильтры.WebHome]]. Для перехода к разделу вы также можете воспользоваться кнопкой **Настроить фильтры [[image:attach:filtr_btn.png]].**

67

68

)))

69

1. Нажмите на кнопку **Добавить и начать редактировать**. Будет создан новый алгоритм со стандартной схемой обработки.

\\

Загрузите готовую схему обработки или создайте её с помощью редактора

74

75

1. [[Загрузить готовую схему обработки>>doc:WebHome]]

76

1. [[Создать схему с помощью редактора>>doc:||anchor="Настройкасхемыобработкиинцидентов-Редакторсхемобработки"]]

77

78

=== {{id name="Настройкасхемыобработкиинцидентов-Загрузкаготовойсхемыобработки"/}}Загрузка готовой схемы обработки ===

79

80

Вы можете загрузить готовый XML-файл схемы, а также вставить исходный код с помощью текстового редактора.

**Загрузка файла**

1. В поле **Описание схемы** нажмите на кнопку **Выбрать файл** и укажите файл XML-описания алгоритма обработки. Будет загружен графический вид схемы.

85

1. Нажмите на кнопку **Сохранить**.

86

87

**Загрузка исходного кода**

88

89

1. Скопируйте исходный код схемы в буфер обмена.

90

1. В поле **Описание схемы** нажмите на кнопку **Открыть редактор**.

91

1. На вкладке **Текстовый редактор** вставьте код схемы из буфера обмена.

92

1. Нажмите на кнопку **Сохранить**.

93

94

95

Подробная информация по работе с редактором схем обработки приведена ниже.

\\

=== {{id name="Настройкасхемыобработкиинцидентов-Созданиесхемывредакторе"/}}Создание схемы в редакторе ===

101

102

В поле **Описание схемы** нажмите на кнопку **Открыть редактор**.

103

[[image:attach:processing_redactor_open.png||height="57"]]

104

105

В отобразившемся [[окне редактора схем>>doc:||anchor="Настройкасхемыобработкиинцидентов-Окноредакторасхем"]]:

106

107

1. (((

108

Сформируйте каркас схемы обработки [3] при помощи готовых элементов, доступных на панели элементов [2], задайте последовательность шагов. Рекомендуется использовать базовую схему с шагами запуска и завершения инцидента и дополнить её готовыми или произвольными шагами обработки. Для обеспечения «ветвления» алгоритма — выбор «ветки» в зависимости от заданных оператором условий — предусмотрен оператор ветвления.

109

110

111

[[#Готовые элементы схемы обработки>>doc:||anchor="Настройкасхемыобработкиинцидентов-Готовыеэлементысхемыобработки"]]

112

113

)))

114

1. На панели свойств [5] измените, при необходимости, уникальный идентификатор каждого шага и потока, укажите параметры.

115

1. Перейдите к вкладке **Текстовый редактор** [1] задайте дополнительные параметры элементов, условия ветвления.

116

[[image:attach:processing_scheme_text.png||width="800"]]

117

1. (((

118

Нажмите на кнопку **Сохранить**.

119

120

121

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

122

123

)))

124

1. Закройте окно редактора схем.

125

[[image:attach:processing_redactor_close.png||width="500"]]

\\

== {{id name="Настройкасхемыобработкиинцидентов-Окноредакторасхем"/}}Окно редактора схем ==

130

131

[[image:attach:s_center_redactor_schemes.png||width="900"]]

132

133

1. **Вкладки Диаграмма и Текстовый редактор**: вкладка **Диаграмма** предоставляет графический редактор для формирования каркаса схемы, вкладка** Текстовый редактор** предоставляет доступ к коду xml-схемы с подсветкой синтаксиса, позволяет задать параметры шагов схемы.

134

1. **Панель элементов**:[[ готовые элементы схемы обработки>>doc:||anchor="Настройкасхемыобработкиинцидентов-Готовыеэлементысхемыобработки"]]; достаточно выбрать требуемый элемент и нанести на схему.

135

1. **Схема обработки**: визуальное представление схемы с указанием последовательности обработки шага; формируется автоматически в процессе добавления новых элементов; каждому элементу и потоку присваивается уникальный идентификатор, который вы можете изменить в поле id панели свойств [5].

136

1. **Элемент схемы обработки**: при выделении элемента отображаются доступные инструменты по изменению типа элемента, добавлением нового потока и проч.

137

1. **Панель свойств**: содержит базовые свойства выделенного на схеме [3] элемента ~[[[#Готовые элементы схемы обработки>>doc:||anchor="Настройкасхемыобработкиинцидентов-Готовыеэлементысхемыобработки"]]].

138

1. Кнопка **Сохранить**: сохранение схемы, в процессе сохранения выполняется валидация.

\\

== {{id name="Настройкасхемыобработкиинцидентов-Готовыеэлементысхемыобработки"/}}Готовые элементы схемы обработки ==

143

144

Платформа НЕЙРОСС предоставляет готовые элементы для построения схемы обработки инцидентов:

145

146

* пользовательские шаги: отметка о выполнении действия, заполнение формы;

147

* автоматические шаги: добавление медиаматериалов, формирование отчёта по инциденту и отправка его на электронную почту, выполнение произвольного скрипта.

148

149

Подержаны операторы условного ветвления.

150

151

(% class="wrapped" %)

152

|=(% colspan="4" style="text-align: left;" %)(((

153

Пользовательские шаги | User Task

154

)))

155

|=(% style="text-align: left;" %)(((

156

№

157

)))|=(% style="text-align: left;" %)(((

158

Шаг / Панель свойств

159

)))|=(% style="text-align: left;" %)(((

160

Описание

161

)))|=(% style="text-align: left;" %)(((

162

Пример XML-описания

163

)))

164

|(% style="text-align: left;" %)(((

165

1

166

)))|(% style="text-align: left;" %)(((

167

(% class="content-wrapper" %)

168

(((

169

Отметить выполнение действия

170

171

[[image:attach:processing_scheme_chekbox1.png||height="96"]]

172

)))

173

174

[[image:attach:processing_scheme_chekbox.png||thumbnail="true" width="200"]]

175

)))|(% style="text-align: left;" %)(((

176

Пользовательский произвольный шаг обработки, факт выполнения которого оператор фиксирует установкой флага в соответствующем поле. Задаёт алгоритм действий оператора: подсказывает последовательность шагов и контролирует их выполнение.

177

178

Инструкция оператору задаётся в поле {{code language="none"}}name{{/code}}.

179

180

В карточке инцидента отображается в виде чек-бокса с текстом. Оператор знакомится с текстом инструкции, выполняет требуемые действия. По факту завершения устанавливает флаг в поле. Система фиксирует время выполнения шага и передает управление следующему шагу.

181

)))|(% style="text-align: left;" %)(((

182

(% class="content-wrapper" %)

(((

<ultima:bpmnElementExtension class="extensions.vmc.incident.SimpleIncidentTask"/>

</extensionElements>

</userTask>

)))

)))

|(% style="text-align: left;" %)(((

194

2

195

)))|(% style="text-align: left;" %)(((

196

(% class="content-wrapper" %)

197

(((

198

Завершить обработку / пометить инцидент ложным

199

200

[[image:attach:processing_scheme_finish1.png||width="320"]]

201

)))

202

203

[[image:attach:processing_scheme_finish.png||thumbnail="true" width="200"]]

204

)))|(% style="text-align: left;" %)(((

205

Завершает обработку инцидента. Выносит резолюцию «Ложный» / «Подтверждённый» для инцидента.

206

207

В карточке инцидента отображается в виде виде двух кнопок: **Завершить** и **Ложный**.

208

209

Шаг включён в стандартную схему обработки.

210

)))|(% style="text-align: left;" %)(((

211

(% class="content-wrapper" %)

(((

<ultima:bpmnElementExtension class="extensions.vmc.incident.FinishProcessingIncidentTask"/>

</extensionElements>

</userTask>

)))

)))

|(% style="text-align: left;" %)(((

223

3

224

)))|(% style="text-align: left;" %)(((

225

Заполнить произвольную форму

226

227

[[image:attach:processing_scheme_form1.png||width="320"]]

228

229

[[image:attach:processing_scheme_form.png||thumbnail="true" width="200"]]

\\

\\

(% class="content-wrapper" %)

(((

\\

)))

)))|(% style="text-align: left;" %)(((

240

Позволяет оператору заполнить и отправить произвольную форму из полей типа string, long, boolean, date, enum и selectvalue. Возможно указание списка полей, обязательных к заполнению, значений по умолчанию для полей, текстовых подсказок оператору.

241

242

В карточке инцидента отображается в виде заголовка, списка полей формы и кнопки **Отправить**.

243

244

Заголовок формы задаётся в поле name для шага обработки. Параметры полей указываются отдельно: идентификатор (id), тип поля (type), заголовок поля (name), флаг обязательности (required), значение по умолчанию (default), флаг «только для чтения» (readonly).

245

246

Система фиксирует время выполнения шага и передает управление следующему шагу.

247

248

Все введённые значения доступны при обработке следующих шагов, в частности, — в зависимости от введённого оператором значения возможен выбор ветки алгоритма.

249

)))|(% style="text-align: left;" %)(((

250

(% class="content-wrapper" %)

(((

<ultima:bpmnElementExtension class="extensions.vmc.incident.UserFormIncidentTask"/>

256

<activiti:formProperty id="stringValue" name="Текст" type="string" default="123"/>

257

<activiti:formProperty id="booleanValue" name="Да/Нет" type="boolean" required="true"/>

258

<activiti:formProperty type="long" name="Число" id="longValue" default="Целое число"/>

259

<activiti:formProperty id="dateValue" name="Дата" type="date"/>

260

<activiti:formProperty id="selectValue" name= "Выбор из списка" type="enum">

261

<activiti:value id="value1" name="Первое значение"/>

262

<activiti:value id="value12" name="Второе значение"/>

263

<activiti:value id="value13" name="Третье значение"/>

264

<activiti:value id="value14" name="Четвёртое значение"/>

265

</activiti:formProperty>

</extensionElements>

</userTask>

)))

)))

|(% style="text-align: left;" %)(((

272

4

273

)))|(% style="text-align: left;" %)(((

274

(% class="content-wrapper" %)

275

(((

276

Запустить процесс сформирования PDF-отчета об инцидентен и сохранения его в папку загрузок браузера

277

278

[[image:attach:processing_scheme_download1.png||width="320"]]

279

280

[[image:attach:processing_scheme_download.png||thumbnail="true" width="200"]]

281

)))

282

)))|(% style="text-align: left;" %)(((

283

Позволяет оператору скачать pdf-отчёт об инциденте.

284

285

В XML-описании указывается: ключ отчёта, идентификатор источника данных и форма, которая будет использована при формировании отчёта.

286

287

В карточке инцидента отображается в виде двух кнопок **Сохранить отчёт** и **Не сохранять**. На момент подготовки отчёта кнопки не активны. В случае возникновения ошибки создания отчёта отображается кнопка **Ошибка**.

288

289

Система фиксирует время выполнения шага и передает управление следующему шагу.

290

)))|(% style="text-align: left;" %)(((

291

(% class="content-wrapper" %)

(((

<ultima:bpmnElementExtension class="extensions.vmc.incident.DownloadReportTask"/>

297

<activiti:formProperty id="reportDefinitionKey" type="string" default="ultima-reports-vmc-incident-detail" writable="false" readable="true"/>

298

<activiti:formProperty id="dataSourceId" type="long" default="1" writable="false" readable="true"/>

299

<activiti:formProperty id="INCIDENT_ID" type="long" default="${incidentId}" writable="false" readable="true"/>

</extensionElements>

</userTask>

)))

)))

|=(% colspan="4" style="text-align: left;" %)(((

306

Автоматические шаги | Service Task

307

)))

308

|(% style="text-align: left;" %)(((

309

1

310

)))|(% style="text-align: left;" %)(((

311

(% class="content-wrapper" %)

312

(((

313

«Привязать» архивные скриншоты

314

315

[[image:attach:processing_scheme_screenshots.png||width="200"]]

316

)))

317

)))|(% style="text-align: left;" %)(((

318

Добавляет в карточку инцидента скриншоты из архива «привязанных» к источнику инцидента камер. Действий пользователя не требуется. Скриншоты добавляются в отчёт по инциденту.

319

320

(% style="letter-spacing: 0.0px;" %)В поле **Относительное время** (параметр **relativeTimestamps в **коде) через запятую задаются сдвиги относительно времени возникновения инцидента, за которые нужно «привязать» скриншоты.

321

322

Необходимо обеспечить связь камер с источником тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]] и наличие видеоархива за требуемый период.

323

)))|(% style="text-align: left;" %)(((

324

(% class="content-wrapper" %)

(((

<activiti:field stringValue="-5,0,5" name="relativeTimestamps"/>

330

<activiti:field name="incidentId" expression="${incidentId}"/>

</extensionElements>

</serviceTask>

)))

)))

|(% style="text-align: left;" %)(((

337

2

338

)))|(% style="text-align: left;" %)(((

339

(% class="content-wrapper" %)

340

(((

341

Отправить отчёт по e-mail

342

343

[[image:attach:processing_scheme_email_.png||thumbnail="true" width="200"]]

344

)))

345

)))|(% style="text-align: left;" %)(((

346

Формирует отчёт об инциденте и отправляет его на заданную почту. Отчёт формируется в формате pdf.

347

348

Необходимо настроить параметры почтового сервера в разделе [[Дополнительные настройки>>doc:ui.Параметры узла.Дополнительные настройки.Параметры изображений планов, интеграция с ГИС.WebHome]]. Требуется наличие лицензий ~[[[neyross.НЕЙРОСС Автоматика.WebHome]]].

349

350

E-mail-адрес получателя указывается в параметрах шага.

351

)))|(% style="text-align: left;" %)(((

352

(% class="content-wrapper" %)

(((

<activiti:field stringValue="example@example.com" name="emailTo" type="string"/>

358

<activiti:field name="incidentId" expression="${incidentId}"/>

359

<activiti:field stringValue="ultima-reports-vmc-incident-detail" name="reportDefinitionKey" type="string"/>

</extensionElements>

</serviceTask>

)))

)))

|(% style="text-align: left;" %)(((

366

3

367

)))|(% style="text-align: left;" %)(((

368

(% class="content-wrapper" %)

(((

(% class="code" %)

(((

Выполнить произвольный скрипт

373

[[image:attach:processing_scheme_scrypt.png||thumbnail="true" width="200"]]

374

)))

375

)))

376

)))|(% style="text-align: left;" %)(((

377

Запускает на выполнение произвольный scala-скрипт. Специальные символы в скрипте необходимо экранировать, согласно стандарту XML. Переносы строки в коде нужно заменить на ";"

378

)))|(% style="text-align: left;" %)(((

379

(% class="content-wrapper" %)

(((

<activiti:field stringValue="import services.common.{SystemLogService, SystemLogTag};val systemLogService = ctx.injector.instanceOf[SystemLogService];systemLogService.log(SystemLogTag.ALARM)("ТРЕВОГА")" name="script" type="string"/>

385

<activiti:field name="incidentId" expression="${incidentId}"/>

</extensionElements>

</serviceTask>

)))

)))