Wiki source code of Тип действия: отправка письма по email
Last modified by superadmin on 2026/06/15 21:57
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | В данном разделе приведены сведения по настройке заданий автоматизации на отправку писем электронной почты в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС. |
| 2 | |||
| 3 | {{info}} | ||
| 4 | Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[doc:ui.Параметры узла.Автоматизация.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} — заголовок события (отражает тип события) | ||
| |
3.1 | 27 | * ${event.description} — описание события\\ |
| |
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 | |||
| 71 | == {{id name="Типдействия:отправкаписьмапоemail-Порядокдействий"/}}Порядок действий == | ||
| 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 | |||
| |
2.1 | 87 | {{code language="java"}} |
| |
1.1 | 88 | Тревога: ${event.headline} |
| 89 | {{/code}} | ||
| 90 | |||
| 91 | Введите текст письма, например: | ||
| 92 | |||
| |
2.1 | 93 | {{code language="java"}} |
| |
1.1 | 94 | В системе безопасности НЕЙРОСС зафиксировано тревожное событие. |
| 95 | Источник: ${element.name} | ||
| 96 | Время происшествия: ${event.sent} | ||
| 97 | Тип события: ${event.headline} | ||
| 98 | {{/code}} | ||
| 99 | |||
| 100 | \\ | ||
| 101 | |||
| 102 | Введите email-адрес получателя сообщения. | ||
| 103 | |||
| 104 | Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то к письму могут быть приложены кадры видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите **Да** в поле **Отправлять связанные кадры архива**. | ||
| 105 | |||
| 106 | {{error}} | ||
| 107 | Обратите особое внимание на требования к настройке данной функции: | ||
| 108 | |||
| 109 | 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[doc:ui.Приложения НЕЙРОСС.Видеонаблюдение.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[doc:ui.Параметры видеорегистратора.WebHome]]. | ||
| 110 | 1. Камера «привязана» к источнику тревог. Сопоставление камер элементам осуществляется в разделе [[Ситуационный центр ~> Источники тревог>>doc:ui.Параметры узла.Планы и карта.WebHome||anchor="Планыикарта-«Привязка»камеристочникамтревог"]]. | ||
| 111 | {{/error}} | ||
| 112 | |||
| 113 | Нажмите на кнопку **Сохранить задание**. | ||
| 114 | |||
| |
3.1 | 115 | При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест**(%%) в заголовке блока **Параметры действия**. |
| |
1.1 | 116 | |
| 117 | {{info}} | ||
| 118 | Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события. | ||
| 119 | {{/info}} | ||
| 120 | |||
| 121 | [[image:attach:action_email_eхample.png||width="800"]] | ||
| 122 | |||
| 123 | //Пример письма по событию «Взлом двери» с кадром камеры видеонаблюдения// | ||
| 124 | |||
| 125 | \\ | ||
| 126 | |||
| 127 | {{info}} | ||
| |
1.2 | 128 | Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]]. |
| |
1.1 | 129 | {{/info}} |