Исходный код вики Тип действия: отправка письма по email
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 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} — заголовок события (отражает тип события) | ||
| 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 | == {{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 | Заполните поля согласно таблице ниже. Нажмите на кнопку **Сохранить задание**. | ||
| 87 | |||
| 88 | |=Поле|=Комментарий | ||
| 89 | |Заголовок письма|((( | ||
| 90 | Введите любой текст заголовка письма. Если в задании задан фильтр по тревожным сообщениям, можно вписать, например: | ||
| 91 | |||
| 92 | {{code language="java"}} | ||
| 93 | Тревога: ${event.headline} | ||
| 94 | {{/code}} | ||
| 95 | ))) | ||
| 96 | |Тело письма|((( | ||
| 97 | Введите текст письма, например: | ||
| 98 | |||
| 99 | {{code language="java"}} | ||
| 100 | В системе безопасности НЕЙРОСС зафиксировано тревожное событие. | ||
| 101 | Источник: ${element.name} | ||
| 102 | Тип события: ${event.headline} | ||
| 103 | {{/code}} | ||
| 104 | ))) | ||
| 105 | |Адрес получателя|Введите email-адрес получателя сообщения. | ||
| 106 | |(% colspan="2" %)((( | ||
| 107 | {{info}} | ||
| 108 | Поля ниже настраиваются в случае, если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам. | ||
| 109 | {{/info}} | ||
| 110 | ))) | ||
| 111 | |Отправлять связанные кадры архива|Если требуется приложить к письму кадр видеоархива за время события (по одному кадру от каждой связанной камеры), установите значение в **Да**. | ||
| 112 | |Отправлять дополнительные (исторические) связанные кадры архива|Если требуется приложить к письму кадры видеоархива на некоторое время до события (по одному кадру от каждой связанной камеры), установите значение в **Да**. В поле ниже укажите период времени в секундах до события | ||
| 113 | |Количество секунд до события для дополнительных (исторических) кадров архива:|Если в поле Отправлять дополнительные (исторические) связанные кадры архива установлено Да, то укажите период времени в секундах. | ||
| 114 | |||
| 115 | |||
| 116 | |||
| 117 | |||
| 118 | |||
| 119 | |||
| 120 | Если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам, то к письму могут быть приложены кадры видеоархива за время события, по одному кадру с каждой камеры. Для включения функции установите **Да** в поле **Отправлять связанные кадры архива**. | ||
| 121 | |||
| 122 | {{error}} | ||
| 123 | Обратите особое внимание на требования к настройке данной функции: | ||
| 124 | |||
| 125 | 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[Видеонаблюдение>>doc:ui.Приложения НЕЙРОСС.Видеонаблюдение.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[Параметры видеорегистратора>>doc:ui.Параметры видеорегистратора.WebHome]]. | ||
| 126 | 1. Камера «привязана» к источнику тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]] . | ||
| 127 | {{/error}} | ||
| 128 | |||
| 129 | Нажмите на кнопку **Сохранить задание**. | ||
| 130 | |||
| 131 | При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**. | ||
| 132 | |||
| 133 | {{info}} | ||
| 134 | Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события. | ||
| 135 | {{/info}} | ||
| 136 | |||
| 137 | [[image:attach:action_email_eхample.png||width="800"]] | ||
| 138 | |||
| 139 | //Пример письма по событию «Взлом двери» с кадром камеры видеонаблюдения// | ||
| 140 | |||
| 141 | |||
| 142 | {{info}} | ||
| 143 | Дополнительная информация по настройке заданий автоматизации приведена в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]]. | ||
| 144 | {{/info}} |