Перейти к содержимому
Версия 9.1 от admin на 2026/07/20 16:53
Последние авторы
1 В данном разделе приведены сведения по настройке заданий автоматизации на отправку писем электронной почты в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС.
2
3 {{info}}
4 Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]].
5 {{/info}}
6
7 == {{id name="Типдействия:отправкаписьмапоemail-Общиесведения"/}}Общие сведения ==
8
9 Платформа НЕЙРОСС использует задачи автоматизации для информирования ответственных лиц о каких-либо событиях в системе.
10
11 {{info}}
12 Для отправки писем укажите параметры почтового ящика и SMTP-сервера в разделе **Дополнительные настройки** ~[[[doc: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 В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.Параметры узла.Автоматизация.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
76
77 [[image:attach:ui.Параметры узла.Автоматизация.WebHome@action_newtask.png]]
78
79 Настройте параметры сигнала ~[[[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.WebHome]]].
80
81 В блоке **Параметры действия** выберите из раскрывающегося списка **Отправка письма по email**.
82
83 [[image:attach:action_email.png]]
84
85 == Параметры задания ==
86
87 Заполните поля согласно таблице ниже. Нажмите на кнопку **Сохранить задание**.
88
89 |=Поле|=Комментарий
90 |Заголовок письма|(((
91 Введите любой текст заголовка письма. Если в задании задан фильтр по тревожным сообщениям, можно вписать, например:
92
93 {{code language="java"}}
94 Тревога: ${event.headline}
95 {{/code}}
96 )))
97 |Тело письма|(((
98 Введите текст письма, например:
99
100 {{code language="java"}}
101 В системе безопасности НЕЙРОСС зафиксировано тревожное событие.
102 Источник: ${element.name}
103 Тип события: ${event.headline} 
104 {{/code}}
105 )))
106 |Адрес получателя|Введите email-адрес получателя сообщения.
107 |(% colspan="2" %)(((
108 {{info}}
109 Поля ниже настраиваются в случае, если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам.
110 {{/info}}
111
112 {{error}}
113 Обратите особое внимание на требования к настройке данной функции:
114
115 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[Видеонаблюдение>>doc:ui.Приложения НЕЙРОСС.Видеонаблюдение.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[Параметры видеорегистратора>>doc:ui.Параметры видеорегистратора.WebHome]].
116 1. Камера «привязана» к источнику тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]] .
117 {{/error}}
118
119
120 )))
121 |Отправлять связанные кадры архива|Если требуется приложить к письму кадр видеоархива за время события** **(по одному кадру от каждой связанной камеры), установите значение в **Да**. Кадры сохраняются в формате **JPEG**.
122 |Отправлять дополнительные (исторические) связанные кадры архива|Если требуется приложить к письму кадры видеоархива на некоторое время до события (по одному кадру от каждой связанной камеры), установите значение в **Да**. В поле ниже укажите период времени в секундах до события.
123 |Количество секунд до события для дополнительных (исторических) кадров архива:|(((
124 Если в поле **Отправлять дополнительные (исторические) связанные кадры архива** установлено** Да**, то укажите период времени в секундах до события. От зафиксированного времени события будет вычтен указанный интервал, кадр за полученное время будет приложен к письму (по одному кадру от каждой связанной камеры). Кадры сохраняются в формате **JPEG**.
125
126
127 Вы можете указать несколько периодов времени. Значения указываются через запятую без пробелов, например:
128
129 {{code}}
130 5,10,15
131 {{/code}}
132
133
134 Если за указанное время нет архивного видео, то в [[Системном журнале>>doc:ui.Системный журнал.WebHome]] будет зафиксирована ошибка:
135
136 {{code language="none"}}
137 Не удалось найти снимок видеоархива для медиаисточника «Название медиаисточника» за время [дата и время]
138 {{/code}}
139 )))
140 |Отправлять фрагменты видеоархива|Если требуется приложить к письму видеофайл(ы) в формате **MKV**, установите в поле значение **Да**.
141 |Размер фрагментов видеоархива (в секундах)|(((
142 Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, укажите число секунд (N). Будет запрошен архив за период:
143
144 {{code language="none"}}
145 [Время события — N: Время события]
146 {{/code}}
147
148
149 Полученный видеофайл будет приложен к письму.
150 )))
151
152
153
154 При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**.
155
156 {{info}}
157 Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события.
158 {{/info}}
159
160 == Пример работы задания ==
161
162 [[image:attach:action_email_eхample.png||width="800"]]
163
164 //Пример письма по событию «Взлом двери» с кадром камеры видеонаблюдения//
165
166