Действие SendNotifications
Действие SendNotification отправляет уведомление с заданным текстом и списком получателей.
Параметры действия
Общие для всех действий параметры (в новой вкладке)
| Имя параметра | Обязательный | Описание параметра | Значения параметра |
|---|---|---|---|
| subscribers | нет | Задаёт список пользователей, которые должны получить уведомления |
Список выражений вида:
"old.attr.auditors.person.id",
|
| ignoreList | нет | Задаёт список пользователей, которые не должны получить уведомления | |
| message | нет | Задаёт текст сообщения | Текстовая строка и выражения. |
| notificationName | нет | Используется для того, чтобы на уровне SDK различать нотификации, сгенерированные автоматизацией. |
Имя уведомления (нотификации). Для получения имени нотификации используется свойство INotification.NotificationName. |
Примеры реализации действия
Пример 1
В приведённом ниже примере уведомление уйдет только добавившимся аудиторам: те аудиторы, что были в списке до изменения, уведомления не получат. Кроме того, если пользователь сам назначил себя аудитором (явно или с помощью другого действия), уведомления он также не получит.
{
"activity": "SendNotifications",
"params": {
"sourceTypes": [],
"target": "Self",
"targetTypes": [],
"subscribers": [
"new.attr.auditors.person.id"
],
"ignoreList": [
"old.attr.auditors.person.id",
"initiatingPerson.id"
],
"message": "{initiatingPerson.displayName} назначил(а) вас аудитором задания"
}
}
Пример 2
При создании пользовательских действий с помощью SDK можно указать параметр notificationName, который будет давать возможность отличать разные уведомления. Ниже приведён пример с заданным notificationName, который будет уведомлять пользователя об изменившемся названии проекта:
{
"activity": "SendNotifications",
"params": {
"sourceTypes": ["project"],
"target": "Self",
"notificationName":"ProjectNameChanged",
"subscribers": [
"new.attr.owner.person.id"
],
"message": "Изменилось название проекта: {old.attr.project_name} -> {new.attr.project_name}"
}
}