Это старая версия документа!

Содержание

О подсистеме Email-уведомлений

О подсистеме Email-уведомлений

Функция электронных уведомлений представляет собой фундаментальный элемент, который автоматически сообщает пользователям системы Airlay о различных активностях, таких как создание объектов, изменение их статуса или закрытие задач.

Для настройки Email-уведомлений необходимо:

Базовые навыки HTML

HTML (HyperText Markup Language) - это язык разметки, который используется для создания веб-страниц и приложений. HTML позволяет определить структуру и содержание документа, а также включать на страницу различные элементы, такие как текст, изображения, ссылки и формы для ввода данных. Код HTML может быть интерпретирован браузером, который отображает содержимое страницы для пользователя.

Для работы с HTML не требуется особых знаний или квалификации, так как это язык разметки, используемый для создания веб-страниц. Но, для того чтобы создавать веб-страницы с помощью HTML, необходимо иметь базовое понимание структуры языка, его основных элементов и атрибутов, которые используются для создания веб-страниц.

Вот несколько примеров, чтобы проиллюстрировать, как работает HTML:

Пример	Что это означает?
html	Открывающий тег для начала HTML документа
head	Раздел документа, который содержит информацию о странице, такую как заголовок и мета-теги
body	Раздел документа, который содержит основное содержимое страницы, такое как текст, изображения и другие элементы
p	Тег для создания абзаца текста
img src=«example.jpg» alt=«Пример изображения»	Тег для добавления изображения на страницу

Каждый из этих примеров - это HTML-тег, который говорит браузеру, как отображать содержимое на странице. Например, тег сообщает браузеру, что следующий текст должен быть отформатирован как абзац, а <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}} – описание изменений.

Описание тэгов времени:

- Конвертация unix-времени.
- преобразует секунды в часы:минуты (Пример: 6000 = 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}}
```

Настройка раздела "Список категорий"

Сущность «Категория» является дополнительным параметром, который имеет массив из атрибутивного состава.

Примеры использования:
При добавлении нового объекта в набор данных, установить категорию «Новый», который содержит свойства в виде атрибутивного состава

Т.е. при добавлении объектов, им будет присвоен атрибут «status», со значением «Новый»
Необходимо учесть, что если у объекта имеется атрибут «status» с любым значением, то при загрузке ему будет присвоено то значение, которое указано в категории.

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

Для создания новой категории необходимо:

Авторизоваться в системе с ролью «Администратор»
Перейти в модуль «Администрирование»
Перейти в раздел «Список категорий»
Ввести наименование категории
Нажать на кнопку «Добавить»
Выбрать набор данных
Выбрать цвет (опционально)
Выбрать тип геометрии (каким типам объектов назначать категорию)
Нажать на кнопку «Список параметров»
Указать атрибут и его значение
Нажать на кнопку «Добавить»
Нажать на кнопку «Сохранить»

Создание новой категории

Настройка категории

Указание параметров для категории

Настройка раздела "Email уведомления"

Email-уведомления работают совместно с email шаблонами, а также служат для настройки периодичности отправки шаблонов по событиям и по определенным категориям.

Для создания нового email-уведомления необходимо:

В режиме администрирования перейти в раздел «Email уведомления»
Перейти в модуль «Администрирование»
Перейти в раздел «Email уведомления»
Ввести наименование уведомления
Нажать на кнопку «Добавить»
Выбрать шаблон уведомлений
Добавить категорию уведомлений
Указать периодичность повторной отправки
Нажать на кнопку «Добавить»

Добавление нового уведомления

Настройка уведомления

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

Настройка задачи для получения уведомлений

После настройки обязательных параметров для получения email-уведомлений, необходимо перейти в соответствующую задачу и в поле «Уведомления» установить созданное раннее Email-уведомление.

Navikey Wiki Pages

Инструменты пользователя

Инструменты сайта

Содержание

О подсистеме Email-уведомлений

Базовые навыки HTML

Настройка раздела "Email шаблоны"

Email о регистрации пользователя мастер пользователем

Описание

Переменные email шаблона

Email со ссылкой для установки пароля

Описание

Переменные email шаблона

Email об изменении задачи

Описание

Email о изменении задачи типа мониторинг

Описание

Настройка раздела "Список категорий"

Настройка раздела "Email уведомления"

Настройка задачи для получения уведомлений

Инструменты страницы