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

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]] > Конфигурация узлов > Ситуационный центр > вкладка Обработка инцидентов.

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

12

13

14

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

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

19

20

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

21

22

23

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

24

25

26

Запуск задачи обработки осуществляется при возникновении события, удовлетворяющего конкретному фильтру. Таким образом, с(%%)оздавая пары [фильтр + алгоритм обработки], можно распределять инциденты по операторам и назначать разные схемы обработки разным типам событий. Обработка событий может быть частично или полностью автоматизирована. К пользовательским шагам обработки относится: отметка о выполнении заданного действия, заполнение формы, добавление комментария, вынос резолюции по инциденту, возможность скачать отчёт по инциденту. К автоматическим шагам обработки относится: возможность «привязать» архивные скриншоты, выполнить произвольный 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

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

152

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

153

)))

154

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

155

№

156

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

157

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

158

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

159

Описание

160

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

161

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

162

)))

163

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

164

1

165

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

166

(% class="content-wrapper" %)

167

(((

168

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

169

170

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

171

)))

172

173

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

174

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

175

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

176

177

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

178

179

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

180

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

181

(% class="content-wrapper" %)

(((

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

</extensionElements>

</userTask>

)))

)))

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

193

2

194

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

195

(% class="content-wrapper" %)

196

(((

197

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

198

199

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

200

)))

201

202

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

203

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

204

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

205

206

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

207

208

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

209

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

210

(% class="content-wrapper" %)

(((

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

</extensionElements>

</userTask>

)))

)))

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

222

3

223

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

224

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

225

226

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

227

228

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

\\

\\

(% class="content-wrapper" %)

(((

\\

)))

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

239

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

240

241

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

242

243

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

244

245

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

246

247

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

248

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

249

(% class="content-wrapper" %)

(((

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

255

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

256

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

257

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

258

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

259

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

260

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

261

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

262

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

263

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

264

</activiti:formProperty>

</extensionElements>

</userTask>

)))

)))

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

271

4

272

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

273

(% class="content-wrapper" %)

274

(((

275

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

276

277

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

278

279

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

280

)))

281

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

282

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

283

284

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

285

286

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

287

288

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

289

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

290

(% class="content-wrapper" %)

(((

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

296

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

297

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

298

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

</extensionElements>

</userTask>

)))

)))

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

305

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

306

)))

307

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

308

1

309

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

310

(% class="content-wrapper" %)

311

(((

312

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

313

314

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

315

)))

316

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

317

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

318

319

В поле **Относительное время** (параметр **relativeTimestamps в **коде) через запятую задаются сдвиги относительно времени возникновения инцидента, за которые нужно «привязать» скриншоты.

320

321

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

322

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

323

(% class="content-wrapper" %)

(((

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

329

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

</extensionElements>

</serviceTask>

)))

)))

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

336

2

337

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

338

(% class="content-wrapper" %)

339

(((

340

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

341

342

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

343

)))

344

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

345

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

346

347

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

348

349

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

350

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

351

(% class="content-wrapper" %)

(((

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

357

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

358

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

</extensionElements>

</serviceTask>

)))

)))

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

365

3

366

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

367

(% class="content-wrapper" %)

(((

(% class="code" %)

(((

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

372

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

373

)))

374

)))

375

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

376

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

377

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

378

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

384

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

</extensionElements>

</serviceTask>

)))

)))