Перейти к содержимому
Редактировал(а) admin 2026/09/03 12:17
Последние авторы
1 В данном разделе приведены сведения по настройке заданий автоматизации на отправку писем электронной почты в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС. С версии 20.55 в письме могут быть приложены видеоматериалы: кадры видео от связанных с источником тревог камер в формате JPEG и видеоархивы в формате MKV.
2
3 {{info}}
4 Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[Автоматизация>>doc:ui.node.ui-automation.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.automation.WebHome]].
5 {{/info}}
6
7 == {{id name="Типдействия:отправкаписьмапоemail-Общиесведения"/}}Общие сведения ==
8
9 Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе.
10
11 {{info}}
12 Для отправки писем укажите параметры почтового ящика и SMTP-сервера в разделе **Дополнительные настройки** ~[[[Параметры почтового сервера (Email)>>doc:ui.node.ui-advanced.ui-email.WebHome]]].
13 {{/info}}
14
15 При выборе в качестве параметра действия «//Отправка письма на email//», вам потребуется:
16
17 1. Задать заголовок письма.
18 1. Сформулировать текст письма.
19 1. Ввести email-адрес получателя сообщения.
20 1. При необходимости, включить отправку во вложении к письму кадров со «связанных» камер видеонаблюдения.
21
22
23
24 Функция отправки писем наиболее востребована для информирования о тревожном событии. В этом случае удобно в заголовке и/или тексте письма включить информацию о событии:
25
26 * ${event.headline} — заголовок события (отражает тип события)
27 * ${event.description} — описание события
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
71
72
73 **Условия наличия видеоматериалов**
74
75 Для добавления к письму видеоматериалов необходимо выполнить следующие условия:
76
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]]].
80
81 == Добавление задания ==
82
83 Чтобы создать новое задание автоматизации:
84
85 В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.node.ui-automation.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
86
87 [[image:attach:ui.node.ui-automation.WebHome@action_newtask.png]]
88
89 Настройте параметры сигнала ~[[[Сигналы автоматизации>>doc:ui.node.ui-automation.ui-automation-signals.WebHome]]].
90
91 В блоке **Параметры действия** выберите из раскрывающегося списка **Отправка письма по email**.
92
93 [[image:attach:action_email.png]]
94
95 == Параметры задания ==
96
97 Заполните поля согласно таблице ниже. Нажмите на кнопку **Сохранить задание**.
98
99 |=Поле|=Комментарий
100 |Заголовок письма|(((
101 Введите любой текст заголовка письма. Если в задании задан фильтр по тревожным сообщениям, можно вписать, например:
102
103 {{code language="java"}}
104 Тревога: ${event.headline}
105 {{/code}}
106 )))
107 |Тело письма|(((
108 Введите текст письма, например:
109
110 {{code language="java"}}
111 В системе безопасности НЕЙРОСС зафиксировано тревожное событие.
112 Источник: ${element.name}
113 Тип события: ${event.headline} 
114 {{/code}}
115 )))
116 |Адрес получателя|Введите email-адрес получателя сообщения.
117 |(% colspan="2" %)(((
118 {{info}}
119 Поля ниже настраиваются в случае, если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам.
120 {{/info}}
121
122 {{error}}
123 Обратите особое внимание на требования к настройке данной функции:
124
125 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[Видеонаблюдение>>doc:ui.ui-apps.ui-app-video.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[Параметры видеорегистратора>>doc:ui.ui-dvr-params.WebHome]].
126 1. Камера «привязана» к источнику тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.node.ui-elements.ui-elements-camera-alarm-bind.WebHome]]] .
127 {{/error}}
128
129
130 )))
131 |Отправлять связанные кадры архива|Если требуется приложить к письму кадр видеоархива за время события** **(по одному кадру от каждой связанной камеры), установите значение в **Да**. Кадры сохраняются в формате **JPEG**.
132 |Отправлять дополнительные (исторические) связанные кадры архива|Если требуется приложить к письму кадры видеоархива на некоторое время до события (по одному кадру от каждой связанной камеры), установите значение в **Да**. В поле ниже укажите период времени в секундах до события.
133 |Количество секунд до события для дополнительных (исторических) кадров архива:|(((
134 Если в поле **Отправлять дополнительные (исторические) связанные кадры архива** установлено** Да**, то укажите период времени в секундах до события. От зафиксированного времени события будет вычтен указанный интервал, кадр за полученное время будет приложен к письму (по одному кадру от каждой связанной камеры). Кадры сохраняются в формате **JPEG**.
135
136
137 Вы можете указать несколько периодов времени. Значения указываются через запятую без пробелов, например:
138
139 {{code}}
140 5,10,15
141 {{/code}}
142
143
144 Если за указанное время нет архивного видео, то в [[Системном журнале>>doc:ui.ui-system-log.WebHome]] будет зафиксирована ошибка:
145
146 {{code language="text"}}
147 Не удалось найти снимок видеоархива для медиаисточника «Название медиаисточника» за время [дата и время]
148 {{/code}}
149 )))
150 |Отправлять фрагменты видеоархива|Если требуется приложить к письму видеофайл(ы) в формате **MKV**, установите в поле значение **Да**.
151 |Размер фрагментов видеоархива (в секундах)|(((
152 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, укажите число секунд (N). Будет запрошен архив за период:
153
154 {{code language="text"}}
155 [Время события — N: Время события]
156 {{/code}}
157
158
159 Полученный видеофайл будет приложен к письму.
160 )))
161
162
163
164 При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**.
165
166 {{info}}
167 Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события.
168 {{/info}}
169
170 == Пример работы задания ==
171
172 [[image:attach:action_email_eхample.png||width="800"]]
173
174 //Пример письма по событию «Взлом двери» с кадрами и видеоархивом камер видеонаблюдения//
175
176

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