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

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

5

6

7

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

8

9

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

10

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

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

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

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

28

29

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

30

31

32

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

33

34

35

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

36

37

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

38

39

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

40

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

41

\\

42

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

43

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

44

\\

45

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

46

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

47

48

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

49

50

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

51

52

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

53

54

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

55

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

56

\\

57

58

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

59

60

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

61

62

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

63

64

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

65

66

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

67

68

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

69

70

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

71

1. (((

72

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

73

74

75

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

76

77

)))

78

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

\\

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

83

84

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

85

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

86

87

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

88

89

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

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

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

94

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

95

96

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

97

98

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

99

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

100

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

101

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

102

103

104

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

\\

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

110

111

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

112

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

113

114

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

115

116

1. (((

117

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

118

119

120

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

121

122

)))

123

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

124

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

125

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

126

1. (((

127

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

128

129

130

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

131

132

)))

133

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

134

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

\\

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

139

140

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

141

142

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

143

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

144

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

145

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

146

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

147

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

\\

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

152

153

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

154

155

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

156

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

157

158

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

159

160

(% class="wrapped" %)

161

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

162

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

163

)))

164

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

165

№

166

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

167

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

168

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

169

Описание

170

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

171

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

172

)))

173

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

174

1

175

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

176

(% class="content-wrapper" %)

177

(((

178

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

179

180

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

181

)))

182

183

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

184

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

185

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

186

187

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

188

189

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

190

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

191

(% class="content-wrapper" %)

(((

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

</extensionElements>

</userTask>

)))

)))

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

203

2

204

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

205

(% class="content-wrapper" %)

206

(((

207

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

208

209

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

210

)))

211

212

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

213

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

214

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

215

216

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

217

218

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

219

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

220

(% class="content-wrapper" %)

(((

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

</extensionElements>

</userTask>

)))

)))

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

232

3

233

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

234

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

235

236

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

237

238

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

\\

\\

(% class="content-wrapper" %)

(((

\\

)))

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

249

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

250

251

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

252

253

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

254

255

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

256

257

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

258

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

259

(% class="content-wrapper" %)

(((

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

265

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

266

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

267

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

268

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

269

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

270

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

271

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

272

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

273

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

274

</activiti:formProperty>

</extensionElements>

</userTask>

)))

)))

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

281

4

282

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

283

(% class="content-wrapper" %)

284

(((

285

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

286

287

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

288

289

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

290

)))

291

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

292

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

293

294

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

295

296

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

297

298

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

299

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

300

(% class="content-wrapper" %)

(((

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

306

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

307

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

308

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

</extensionElements>

</userTask>

)))

)))

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

315

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

316

)))

317

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

318

1

319

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

320

(% class="content-wrapper" %)

321

(((

322

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

323

324

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

325

)))

326

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

327

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

328

329

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

330

331

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

332

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

333

(% class="content-wrapper" %)

(((

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

339

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

</extensionElements>

</serviceTask>

)))

)))

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

346

2

347

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

348

(% class="content-wrapper" %)

349

(((

350

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

351

352

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

353

)))

354

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

355

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

356

357

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

358

359

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

360

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

361

(% class="content-wrapper" %)

(((

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

367

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

368

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

</extensionElements>

</serviceTask>

)))

)))

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

375

3

376

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

377

(% class="content-wrapper" %)

(((

(% class="code" %)

(((

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

382

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

383

)))

384

)))

385

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

386

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

387

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

388

(% 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"/>

394

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

</extensionElements>

</serviceTask>

)))

)))