Это старая версия документа!
Содержание
О подсистеме Email-уведомлений
Функция электронных уведомлений представляет собой фундаментальный элемент, который автоматически сообщает пользователям системы Airlay о различных активностях, таких как создание объектов, изменение их статуса или закрытие задач.
Для настройки Email-уведомлений необходимо:
Базовые навыки HTML
HTML (HyperText Markup Language) - это язык разметки, который используется для создания веб-страниц и приложений. HTML позволяет определить структуру и содержание документа, а также включать на страницу различные элементы, такие как текст, изображения, ссылки и формы для ввода данных. Код HTML может быть интерпретирован браузером, который отображает содержимое страницы для пользователя.
Для работы с HTML не требуется особых знаний или квалификации, так как это язык разметки, используемый для создания веб-страниц. Но, для того чтобы создавать веб-страницы с помощью HTML, необходимо иметь базовое понимание структуры языка, его основных элементов и атрибутов, которые используются для создания веб-страниц.
Вот несколько примеров, чтобы проиллюстрировать, как работает HTML:
| Пример | Что это означает? |
|---|---|
| html | Открывающий тег для начала HTML документа |
| head | Раздел документа, который содержит информацию о странице, такую как заголовок и мета-теги |
| body | Раздел документа, который содержит основное содержимое страницы, такое как текст, изображения и другие элементы |
| p | Тег для создания абзаца текста |
| img src=«example.jpg» alt=«Пример изображения» | Тег для добавления изображения на страницу |
Каждый из этих примеров - это HTML-тег, который говорит браузеру, как отображать содержимое на странице. Например, <p> тег сообщает браузеру, что следующий текст должен быть отформатирован как абзац, а <img> тег сообщает браузеру, что следующий элемент - это изображение.
Более подробно с базой HTML можно ознакомиться в книге Дэвида Уитни
Настройка раздела "Email шаблоны"
Для создания шаблона email уведомлений необходимо:
- В режиме администрирования перейти в раздел «Email шаблоны»;
- Нажать на кнопку «Добавить шаблон»
- Выбрать тип шаблона
- Ввести название шаблона
- Нажать кнопку «Сохранить»
- Выбрать добавленный шаблон
- Заполнить шаблон письма
Система автоматически сохраняет любые изменения в шаблонах.
Email о регистрации пользователя мастер пользователем
Описание
Тип «Email о регистрации пользователя мастер пользователем» - является типом уведомлений, который отправляется пользователю на указанный email адрес при регистрации в Системе.
Данное письмо отправляется в двух случаях:
- Информация о пользователе загружается через файл в панели администрирования «Пользователи».
- Пользователь был создан через диалог «Добавить пользователя» в панели администрирования «Пользователи».
Переменные email шаблона
В шаблоне письма доступные следующие переменные:
- domain - домен, с которого отправлено письмо. Например https://airlay.ru/
- link - ссылка для установки пароля, если при создании он не был задан.
- name - логин созданного пользователя.
- email - адрес электронной почты созданного пользователя.
- firstName - имя созданного пользователя.
- secondName - фамилия созданного пользователя.
- lastName - отчество созданного пользователя.
- number - номер телефона созданного пользователя.
- department - подразделение созданного пользователя.
- position - должность созданного пользователя.
- employeeID - табельный номер созданного пользователя.
- SAPLogin - SAP логин созданного пользователя.
Пример шаблона:
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Регистрация пользователя мастер пользователем</title>
</head>
<body>
Здравствуйте. <br />
На веб-ресурсе {{domain}} создан пользователь {{name}}, привязанный к вашему почтовому ящику. <br />
Для установки пароля перейдите по <a href="{{ link }}">ссылке</a>.
</body>
</html>
Email со ссылкой для установки пароля
Описание
Тип «Email со ссылкой для установки пароля» - является типом уведомлений, который отправляется пользователю при восстановлении пароля.
Данное письмо отправляется в двух случаях:
- Пользователь сам сбросил свой пароль через форму «Восстановление пароля».
- Администратор через диалог «Редактировать пользователя» в панели администрирование «Пользователи» воспользовался кнопкой «Отправить ссылку для установки пароля».
Переменные email шаблона
В шаблоне письма доступные следующие переменные:
- domain - домен, с которого отправлено письмо. Например https://airlay.ru/
- link - ссылка для установки пароля.
- name - логин пользователя.
- email - адрес электронной почты пользователя.
- firstName - имя пользователя.
- secondName - фамилия пользователя.
- lastName - отчество пользователя.
- number - номер телефона пользователя.
- department - подразделение пользователя.
- position - должность пользователя.
- employeeID - табельный номер пользователя.
- SAPLogin - SAP логин пользователя.
Пример шаблона:
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Установка пароля</title>
</head>
<body>
Здравствуйте, {{name}}. <br />
Для установки нового пароля на веб-ресурсе {{domain}} перейдите по <a href="{{ link }}">ссылке</a>.
</body>
</html>
Email об изменении задачи
Описание
Тип «Email об изменении задачи» - является типом уведомлений, которое отправляется привязанным к задаче пользователям (назначенным исполнителям и наблюдателям), при внесении изменений в задаче.
Пример шаблона:
<!DOCTYPE html>
<html lang=\"ru\">
<head>
<meta charset=\"UTF-8\" />
<title>Уведомление</title>
</head>
<body>
<p>Изменена задача: <a href="">#{{number}}: {{name}} </a></p>
<p>Описание: {{description}} </p>
<p>Дата создания: <b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'>{{createDate}} </b> </p>
<p>Дата обновления: <b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'>{{updateDate}} </b> </p>
<p>Дата закрытия: <b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'>{{closeDate}} </b> </p>
<p>Дата окончания: <b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'>{{endDate}} </b> </p>
<p>Время на выполнение: <b data-convertSecondsToHoursAndMinutes=''> {{estimatedTime}} </b> </p>
<p>Затраченное время: <b data-convertSecondsToHoursAndMinutes=''> {{spentTime}} </b> </p>
<p>Прогресс: {{progress}}% </p>
<p>Статус: {{status.name}} </p>
<p>Назначен: {{assign.name}} </p>
<p>Приоритет: {{priority.name}} </p>
<p>Мероприятие: {{milestone.name}} </p>
<h4>Изменения: </h4>
<p>{{message}} </p>
</body>
</html>
Описание полей базового шаблона:
{{id}} - идентификатор задачи.
{{number}} – номер изменённой задачи.
{{name}} – имя задачи.
{{description}} – описание задачи.
{{createDate}} – дата создания задачи. (в unix-time формате)
{{updateDate}} – дата изменения задачи. (в unix-time формате)
{{closeDate}} – дата закрытия задачи (дата и время в которое задача перешла в статус «Закрыта»). (в unix-time формате)
{{endDate}} – дата окончания задачи. (в unix-time формате)
{{estimatedTime}} – отведенное на задачу время. (в минутах)
{{spentTime}} – затраченное время. (в минутах)
{{progress}} – прогресс выполнения. (в процентах от 0 до 100)
{{status.name}} – статус задачи.
{{assign.type}} - тип исполнителя ("пользователь", "группа", "бригада").
{{assign.name}} – исполнитель задачи.
{{assign.fullName}} - полное имя исполнителя (в случае если тип исполнителя "пользователь").
{{priority.name}} – приоритет задачи.
{{milestone.name}} – мероприятие задачи.
{{message}} – описание изменений.
Описание тэгов времени:
- <b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'> - Конвертация unix-времени.
- <b data-convertSecondsToHoursAndMinutes=' '> - преобразует секунды в часы:минуты (Пример: <b data-convertSecondsToHoursAndMinutes=''>6000</b> = 1:40)
Email о изменении задачи типа мониторинг
Описание
Тип «Email о изменении задачи типа мониторинг» - является типом уведомлений, который отправляется пользователю при регистрации в системе нового события.
Пример шаблона:
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8" />
<title>Создание email шаблона</title>
</head>
<body>
Здравствуйте.<br />
На объекте {{masterProperties.name}} произошел инцидент.<br />
<a target="_blank" href="https://airlay.ru/map/navikey/179?searchId=62d537ba4ee0fa1fe06e01d8&searchValue={{masterProperties.name}}">Открыть объект на карте</a><br>
</body>
</html>
В шаблоне письма доступные следующие переменные:
- Все атрибуты объекта в формате
{{attr}} - Вложенные атрибуты
{{attr.subattr}}
Настройка раздела "Список категорий"
В Системе, категория позволяет устанавливать статусы/атрибуты для новых событий по умолчанию. Например: произошло событие № 1 и для него автоматически присваивается статус (категория) с параметром «status» и значением «Новая». В дальнейшем, оператор для обработки события меняет статус (категорию) «Закрыта»
Примеры использования:
При добавлении нового объекта в набор данных, установить категорию «Новый», который содержит свойства в виде атрибутивного состава
Т.е. при добавлении объектов, им будет присвоен атрибут «status», со значением «Новый»
Необходимо учесть, что если у объекта имеется атрибут «status» с любым значением, то при загрузке ему будет присвоено то значение, которое указано в категории.
Настройка категорий для Email-уведомлений с типом «Email об изменении задачи типа мониторинг» необходима для того, чтобы по определенному событию, т.е. назначении категории, отправлять email-уведомление.
Для создания новой категории необходимо:
- Авторизоваться в системе с ролью «Администратор»
- Перейти в модуль «Администрирование»
- Перейти в раздел «Список категорий»
- Ввести наименование категории
- Нажать на кнопку «Добавить»
- Выбрать набор данных
- Выбрать цвет (опционально)
- Выбрать тип геометрии (каким типам объектов назначать категорию)
- Нажать на кнопку «Список параметров»
- Указать атрибут и его значение
- Нажать на кнопку «Добавить»
- Нажать на кнопку «Сохранить»

Указание параметров для категории
Настройка раздела "Email уведомления"
Email-уведомления работают совместно с email шаблонами, а также служат для настройки периодичности отправки шаблонов по соответствующим событиям в виде категорий.
Для создания нового email-уведомления необходимо:
- В режиме администрирования перейти в раздел «Email уведомления»
- Ввести наименование уведомления
- Нажать на кнопку «Добавить»
- Добавить категорию уведомлений
- Указать периодичность повторной отправки
- Нажать на кнопку «Добавить»

** Добавление нового уведомления **
Для разовой отправки уведомления, необходимо указать параметр в периодичности = -1




