Перейти к содержимому
Редактировал(а) admin 2026/09/03 12:17
Скрыть последних авторов
admin 12.1 1 В данном разделе приведены сведения по настройке заданий автоматизации на отправку писем электронной почты в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС. С версии 20.55 в письме могут быть приложены видеоматериалы: кадры видео от связанных с источником тревог камер в формате JPEG и видеоархивы в формате MKV.
pugachevskaya_elena 1.1 2
3 {{info}}
admin 14.40 4 Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[Автоматизация>>doc:ui.node.ui-automation.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.automation.WebHome]].
pugachevskaya_elena 1.1 5 {{/info}}
6
7 == {{id name="Типдействия:отправкаписьмапоemail-Общиесведения"/}}Общие сведения ==
8
9 Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе.
10
11 {{info}}
admin 14.27 12 Для отправки писем укажите параметры почтового ящика и SMTP-сервера в разделе **Дополнительные настройки** ~[[[Параметры почтового сервера (Email)>>doc:ui.node.ui-advanced.ui-email.WebHome]]].
pugachevskaya_elena 1.1 13 {{/info}}
14
15 При выборе в качестве параметра действия «//Отправка письма на email//», вам потребуется:
16
17 1. Задать заголовок письма.
18 1. Сформулировать текст письма.
19 1. Ввести email-адрес получателя сообщения.
20 1. При необходимости, включить отправку во вложении к письму кадров со «связанных» камер видеонаблюдения.
21
22
admin 3.3 23
pugachevskaya_elena 1.1 24 Функция отправки писем наиболее востребована для информирования о тревожном событии. В этом случае удобно в заголовке и/или тексте письма включить информацию о событии:
25
26 * ${event.headline} — заголовок события (отражает тип события)
admin 3.3 27 * ${event.description} — описание события
pugachevskaya_elena 1.1 28 * ${event.timestamp} — время отправки уведомления о событии от узла-источника (обычно совпадает с временем возникновения события) (UNIX timestamp)
29 * ${event.registered} — время регистрации события (UNIX timestamp)
30 * ${event.data.EventTags} — метки события
31 * ${element.name} — название элемента-источника события
32
33 Если событие связано с предъявлением карты:
34
35 * ${pass.uuid} — идентификатор пропуска
36 * ${pass.facility} — код предприятия
37 * ${pass.card} — номер карты
38 * ${pass.pincode} — ПИН
39 * ${pass.duress_pincode} — ПИН прохода под принуждением
40 * ${pass.type} — тип пропуска
41 * ${pass.state} — состояние пропуска
42 * ${pass.activation_date} — время начала действия пропуска (UNIX Timestamp)
43 * ${pass.expiration_date} — время конца действия пропуска (UNIX Timestamp)
44 * ${person.uuid} — идентификатор владельца пропуска
45 * ${person.photo} — идентификатор фотографии владельца пропуска
46 * ${person.name} — имя владельца пропуска
47 * ${person.surname} — фамилия владельца пропуска
48 * ${person.patronymic} — отчество владельца пропуска
49 * ${person.organization} — организация владельца пропуска
50 * ${person.division} — подразделение владельца пропуска
51 * ${person.post} — должность владельца пропуска
52
53 Вы вольны включать эти переменные в тест письма в любой последовательности.
54
55 Если событие сформировано получением HTTP-запроса от «внешней» системы:
56
57 * ${token} — токен запроса
58 * ${body.myField} — произвольное поле (myField) из JSON-тела запроса
59
60 Если источником события для задачи автоматизации служит произвольная запись в системном журнале:
61
62 * ${record.message} — текст системного сообщения
63 * ${record.timestamp} — время регистрации сообщения
64 * ${record.origin} — идентификатор сетевого узла-источника
65 * ${record.subject} — идентификатор субъекта
66 * ${user.username} — логин пользователя
67 * ${user.firstName} — имя пользователя
68 * ${user.lastName} — фамилия пользователя
69 * ${user.patronymic} — отчество пользователя
70
admin 13.1 71
72
73 **Условия наличия видеоматериалов**
74
75 Для добавления к письму видеоматериалов необходимо выполнить следующие условия:
76
admin 16.1 77 1. Задача запускается по событию — соответственно, есть источник тревог ~[[[Тип сигнала: по событию>>doc:ui.node.ui-automation.ui-automation-signals.ui-signal-on-event.WebHome]]];
78 1. Для источника тревог указаны «связанные медиаисточники» — то есть задана связь источника тревог и ближайших к нему камер ~[[[«Привязка» камер источникам тревог>>doc:ui.node.ui-elements.ui-elements-camera-alarm-bind.WebHome]]];
79 1. Для «связанных медиаисточников» настроена постоянная запись или запись по тем событиям, по которым будет выполняться данное задание автоматизации ~[[[Настройка задач на запись>>doc:neyross.setup.video-control.recording-tasks.WebHome]]].
admin 13.1 80
admin 7.7 81 == Добавление задания ==
pugachevskaya_elena 1.1 82
83 Чтобы создать новое задание автоматизации:
84
admin 15.1 85 В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.node.ui-automation.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
pugachevskaya_elena 1.1 86
admin 15.1 87 [[image:attach:ui.node.ui-automation.WebHome@action_newtask.png]]
pugachevskaya_elena 1.1 88
admin 14.40 89 Настройте параметры сигнала ~[[[Сигналы автоматизации>>doc:ui.node.ui-automation.ui-automation-signals.WebHome]]].
pugachevskaya_elena 1.1 90
91 В блоке **Параметры действия** выберите из раскрывающегося списка **Отправка письма по email**.
92
93 [[image:attach:action_email.png]]
94
admin 7.7 95 == Параметры задания ==
pugachevskaya_elena 1.1 96
admin 3.6 97 Заполните поля согласно таблице ниже. Нажмите на кнопку **Сохранить задание**.
98
99 |=Поле|=Комментарий
admin 4.1 100 |Заголовок письма|(((
101 Введите любой текст заголовка письма. Если в задании задан фильтр по тревожным сообщениям, можно вписать, например:
admin 3.6 102
admin 2.1 103 {{code language="java"}}
pugachevskaya_elena 1.1 104 Тревога: ${event.headline}
105 {{/code}}
admin 4.1 106 )))
107 |Тело письма|(((
pugachevskaya_elena 1.1 108 Введите текст письма, например:
109
admin 2.1 110 {{code language="java"}}
pugachevskaya_elena 1.1 111 В системе безопасности НЕЙРОСС зафиксировано тревожное событие.
112 Источник: ${element.name}
113 Тип события: ${event.headline} 
114 {{/code}}
admin 4.1 115 )))
116 |Адрес получателя|Введите email-адрес получателя сообщения.
admin 7.1 117 |(% colspan="2" %)(((
admin 7.2 118 {{info}}
119 Поля ниже настраиваются в случае, если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам.
120 {{/info}}
admin 7.7 121
122 {{error}}
123 Обратите особое внимание на требования к настройке данной функции:
124
admin 16.2 125 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[Видеонаблюдение>>doc:ui.ui-apps.ui-app-video.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[Параметры видеорегистратора>>doc:ui.ui-dvr-params.WebHome]].
admin 14.28 126 1. Камера «привязана» к источнику тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.node.ui-elements.ui-elements-camera-alarm-bind.WebHome]]] .
admin 7.7 127 {{/error}}
128
129
admin 7.1 130 )))
admin 7.7 131 |Отправлять связанные кадры архива|Если требуется приложить к письму кадр видеоархива за время события** **(по одному кадру от каждой связанной камеры), установите значение в **Да**. Кадры сохраняются в формате **JPEG**.
132 |Отправлять дополнительные (исторические) связанные кадры архива|Если требуется приложить к письму кадры видеоархива на некоторое время до события (по одному кадру от каждой связанной камеры), установите значение в **Да**. В поле ниже укажите период времени в секундах до события.
133 |Количество секунд до события для дополнительных (исторических) кадров архива:|(((
134 Если в поле **Отправлять дополнительные (исторические) связанные кадры архива** установлено** Да**, то укажите период времени в секундах до события. От зафиксированного времени события будет вычтен указанный интервал, кадр за полученное время будет приложен к письму (по одному кадру от каждой связанной камеры). Кадры сохраняются в формате **JPEG**.
pugachevskaya_elena 1.1 135
136
admin 7.7 137 Вы можете указать несколько периодов времени. Значения указываются через запятую без пробелов, например:
pugachevskaya_elena 1.1 138
admin 7.7 139 {{code}}
140 5,10,15
141 {{/code}}
admin 4.1 142
143
admin 16.3 144 Если за указанное время нет архивного видео, то в [[Системном журнале>>doc:ui.ui-system-log.WebHome]] будет зафиксирована ошибка:
admin 4.1 145
admin 14.2 146 {{code language="text"}}
admin 7.7 147 Не удалось найти снимок видеоархива для медиаисточника «Название медиаисточника» за время [дата и время]
148 {{/code}}
149 )))
150 |Отправлять фрагменты видеоархива|Если требуется приложить к письму видеофайл(ы) в формате **MKV**, установите в поле значение **Да**.
151 |Размер фрагментов видеоархива (в секундах)|(((
152 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, укажите число секунд (N). Будет запрошен архив за период:
pugachevskaya_elena 1.1 153
admin 14.2 154 {{code language="text"}}
admin 7.7 155 [Время события — N: Время события]
156 {{/code}}
pugachevskaya_elena 1.1 157
158
admin 7.7 159 Полученный видеофайл будет приложен к письму.
160 )))
pugachevskaya_elena 1.1 161
admin 7.7 162
163
admin 3.3 164 При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**.
pugachevskaya_elena 1.1 165
166 {{info}}
167 Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события.
168 {{/info}}
169
admin 7.7 170 == Пример работы задания ==
171
pugachevskaya_elena 1.1 172 [[image:attach:action_email_eхample.png||width="800"]]
173
admin 10.1 174 //Пример письма по событию «Взлом двери» с кадрами и видеоархивом камер видеонаблюдения//
pugachevskaya_elena 1.1 175
admin 7.7 176

Интерфейс НЕЙРОСС