Исходный код вики Тип действия: отправка письма по email
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | В данном разделе приведены сведения по настройке заданий автоматизации на отправку писем электронной почты в автоматическом режиме. Настройка доступна только для узлов Платформа НЕЙРОСС. |
| 2 | |||
| 3 | {{info}} | ||
| |
7.7 | 4 | Общие сведения об автоматизации и порядке настройке заданий автоматизации приведены в разделе ~[[[doc:ui.Параметры узла.Автоматизация.WebHome]]]. Примеры заданий приведены в разделе [[здесь>>neyross.НЕЙРОСС Автоматика.WebHome]]. |
| |
1.1 | 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 | |||
| |
3.3 | 23 | |
| |
1.1 | 24 | Функция отправки писем наиболее востребована для информирования о тревожном событии. В этом случае удобно в заголовке и/или тексте письма включить информацию о событии: |
| 25 | |||
| 26 | * ${event.headline} — заголовок события (отражает тип события) | ||
| |
3.3 | 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 | |||
| |
7.7 | 71 | == Добавление задания == |
| |
1.1 | 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 | |||
| |
7.7 | 85 | == Параметры задания == |
| |
1.1 | 86 | |
| |
3.6 | 87 | Заполните поля согласно таблице ниже. Нажмите на кнопку **Сохранить задание**. |
| 88 | |||
| 89 | |=Поле|=Комментарий | ||
| |
4.1 | 90 | |Заголовок письма|((( |
| 91 | Введите любой текст заголовка письма. Если в задании задан фильтр по тревожным сообщениям, можно вписать, например: | ||
| |
3.6 | 92 | |
| |
2.1 | 93 | {{code language="java"}} |
| |
1.1 | 94 | Тревога: ${event.headline} |
| 95 | {{/code}} | ||
| |
4.1 | 96 | ))) |
| 97 | |Тело письма|((( | ||
| |
1.1 | 98 | Введите текст письма, например: |
| 99 | |||
| |
2.1 | 100 | {{code language="java"}} |
| |
1.1 | 101 | В системе безопасности НЕЙРОСС зафиксировано тревожное событие. |
| 102 | Источник: ${element.name} | ||
| 103 | Тип события: ${event.headline} | ||
| 104 | {{/code}} | ||
| |
4.1 | 105 | ))) |
| 106 | |Адрес получателя|Введите email-адрес получателя сообщения. | ||
| |
7.1 | 107 | |(% colspan="2" %)((( |
| |
7.2 | 108 | {{info}} |
| 109 | Поля ниже настраиваются в случае, если осуществляется видеонаблюдение, ведется запись видео места возникновения события, и на момент фиксации события есть видеоархив по одной или нескольким камерам. | ||
| 110 | {{/info}} | ||
| |
7.7 | 111 | |
| 112 | {{error}} | ||
| 113 | Обратите особое внимание на требования к настройке данной функции: | ||
| 114 | |||
| 115 | 1. Ведётся видеоархив (непрерывный в режиме 24/7 или по данному событию) и за время события есть видеоданные. Просмотреть наличие видеоархива можно в приложении [[Видеонаблюдение>>doc:ui.Приложения НЕЙРОСС.Видеонаблюдение.WebHome]]. Настройка задач на запись видеоархива осуществляется в разделе [[Параметры видеорегистратора>>doc:ui.Параметры видеорегистратора.WebHome]]. | ||
| 116 | 1. Камера «привязана» к источнику тревог ~[[[«Привязка» камер источникам тревог>>doc:ui.Параметры узла.Элементы.«Привязка» камер источникам тревог.WebHome]]] . | ||
| 117 | {{/error}} | ||
| 118 | |||
| 119 | |||
| |
7.1 | 120 | ))) |
| |
7.7 | 121 | |Отправлять связанные кадры архива|Если требуется приложить к письму кадр видеоархива за время события** **(по одному кадру от каждой связанной камеры), установите значение в **Да**. Кадры сохраняются в формате **JPEG**. |
| 122 | |Отправлять дополнительные (исторические) связанные кадры архива|Если требуется приложить к письму кадры видеоархива на некоторое время до события (по одному кадру от каждой связанной камеры), установите значение в **Да**. В поле ниже укажите период времени в секундах до события. | ||
| 123 | |Количество секунд до события для дополнительных (исторических) кадров архива:|((( | ||
| 124 | Если в поле **Отправлять дополнительные (исторические) связанные кадры архива** установлено** Да**, то укажите период времени в секундах до события. От зафиксированного времени события будет вычтен указанный интервал, кадр за полученное время будет приложен к письму (по одному кадру от каждой связанной камеры). Кадры сохраняются в формате **JPEG**. | ||
| |
1.1 | 125 | |
| 126 | |||
| |
7.7 | 127 | Вы можете указать несколько периодов времени. Значения указываются через запятую без пробелов, например: |
| |
1.1 | 128 | |
| |
7.7 | 129 | {{code}} |
| 130 | 5,10,15 | ||
| 131 | {{/code}} | ||
| |
4.1 | 132 | |
| 133 | |||
| |
7.7 | 134 | Если за указанное время нет архивного видео, то в [[Системном журнале>>doc:ui.Системный журнал.WebHome]] будет зафиксирована ошибка: |
| |
4.1 | 135 | |
| |
7.7 | 136 | {{code language="none"}} |
| 137 | Не удалось найти снимок видеоархива для медиаисточника «Название медиаисточника» за время [дата и время] | ||
| 138 | {{/code}} | ||
| 139 | ))) | ||
| 140 | |Отправлять фрагменты видеоархива|Если требуется приложить к письму видеофайл(ы) в формате **MKV**, установите в поле значение **Да**. | ||
| 141 | |Размер фрагментов видеоархива (в секундах)|((( | ||
| 142 | Если в поле **Отправлять фрагменты видеоархива** установлено **Да**, укажите число секунд (N). Будет запрошен архив за период: | ||
| |
1.1 | 143 | |
| |
7.7 | 144 | {{code language="none"}} |
| 145 | [Время события — N: Время события] | ||
| 146 | {{/code}} | ||
| |
1.1 | 147 | |
| 148 | |||
| |
7.7 | 149 | Полученный видеофайл будет приложен к письму. |
| 150 | ))) | ||
| |
1.1 | 151 | |
| |
7.7 | 152 | |
| 153 | |||
| |
3.3 | 154 | При необходимости и организационной возможности выполнения теста, нажмите **выполнить тест** в заголовке блока **Параметры действия**. |
| |
1.1 | 155 | |
| 156 | {{info}} | ||
| 157 | Обратите внимание, что, если задание настроено на запуск по событиям, переменные в письме будут пустыми, так как при тестовом запуске нет источника события. | ||
| 158 | {{/info}} | ||
| 159 | |||
| |
7.7 | 160 | == Пример работы задания == |
| 161 | |||
| |
1.1 | 162 | [[image:attach:action_email_eхample.png||width="800"]] |
| 163 | |||
| 164 | //Пример письма по событию «Взлом двери» с кадром камеры видеонаблюдения// | ||
| 165 | |||
| |
7.7 | 166 |