Уведомления
Администратор может использовать уведомления для отправки сообщений эл. почты или текстовых сообщений пользователям ThingWorx в зависимости от
события.
Уведомления составляются на основании одного или нескольких триггеров. Триггер определяет, какие пользователи должны быть уведомлены об указанных событиях и какие сообщения они должны получить. При создании триггера необходимо определить следующие элементы.
• Источник - сущность источника и событие, приводящее к отправке уведомления.
• Обработчик - сущность, предоставляющая сервисы для отправки сообщений с уведомлением. Обработчик определяет тип содержимого, которое он может отправить. Можно использовать следующие обработчики:
◦ MailServer - вещь из расширения Mail (версия расширения 3.5.0 и выше).
Сообщения этого обработчика включают в себя тему и тело.
◦ Twilio - вещь из расширения Twilio (версия расширения 3.1.0 и выше).
Сообщения этого обработчика включают в себя тело.
|
Уведомление не может иметь более одного триггера, использующего одну и ту же сущность "обработчик". Если имеется несколько триггеров, использующих один и тот же обработчик, необходимо создать другую сущность "уведомление".
|
• Содержимое - сообщение, отправляемое пользователю. Содержимое может содержать дополнительные данные события, инициировавшего уведомление, включая данные из пакета данных события, определенного в его структуре данных (см. раздел
События вещи). Можно включить данные события, используя нотацию с двойными квадратными скобками и двоеточиями. Например,
[[:<event_data>:]], где
event_data ссылается на наименование параметра события. Это то же самое наименование, которое используется при добавлении подписки в событие (см. раздел
Подписки вещи).
Чтобы найти доступные параметры события, выполните следующие действия.
1. В Composer выберите > , или Шаблоны вещей, или Профили вещей, а затем откройте сущность.
2. Чтобы добавить временную подписку, в области Подписки нажмите кнопку Добавить.
3. Щелкните область Входные данные, а затем выберите Событие из выпадающего списка.
4. (Необязательно) Можно также выбрать свойство из выпадающего списка.
Откроется список входных данных.
5. Чтобы добавить параметр в область сценария, щелкните значок стрелки (
).
Наименование параметра, которое отображается в области сценария, может использоваться в содержимом уведомления.
6. Нажмите кнопку Готово.
Рекомендуемый способ формирования содержимого уведомления - это интернационализация текста путем создания лексем в таблице локализации по умолчанию и определения там текста. Можно определить содержимое уведомления, задав наименование лексемы локализации в двойных квадратных скобках, как в следующем примере: [[<token_name>]].
| Могут существовать ограничения для отправляемой информации в зависимости от реализации обработчика и конечного сервиса отправки сообщения. Например, могут существовать ограничения размера для длины тела электронного сообщения, отправляемого определенным почтовым сервером. В Twilio существует предел для числа символов в SMS-сообщениях. Дополнительные сведения, позволяющие обеспечить соответствие содержимого этим ограничениям, см. в документации, предоставляемой сервисом обмена сообщениями. |
• Получатели - один или несколько пользователей ThingWorx, которым должно быть отправлено сообщение с уведомлением.
| Пользователи должны иметь допустимый адрес электронной почты (свойство emailAddress) и/или номер мобильного телефона (свойство mobilePhone), заданные в их конфигурации пользовательских расширений (профиль вещи UserExtensions), чтобы успешно получать сообщения эл. почты и/или текстовые сообщения. Текстовые сообщения отправляются на указанный номер мобильного телефона, а не по SMS-адресу (свойство smsAddress). |
События уведомления
При инициировании уведомлений возникают следующие события.
• NotificationSent
• NotificationFailed
Чтобы подписаться на эти события и затем отвечать на них (например, внести запись в файл потока или журнала), выполните следующие действия.
1. В Composer выберите > , а затем выберите вещь уведомления.
2. Щелкните вкладку Входные данные и выберите событие NotificationSent или NotificationFailed в качестве входного параметра для подписки.
3. Введите логику подписки.
Импорт или экспорт уведомлений
Уведомления экспортируются в один файл, содержащий основные данные уведомления и сведения о соответствующем триггере (например, NotificationDefinition_<имя>.xml).
Кроме того, можно экспортировать все системные сущности в Composer из опции > > > или из опции > > . При этом экспортируются уведомления и триггеры в собственные файлы в папках NotificationDefinitions и NotificationContents указанного репозитория. Невозможно экспортировать триггеры, указав тег модели или наименование проекта.
Ниже приведены предварительные требования для импорта уведомлений.
• Убедитесь, что сущность источника и событие существуют.
• Должны существовать сущности "обработчик" (вещь MailServer или вещь Twilio).
• Должны существовать сущности "пользователь", указанные в качестве получателей.
Дополнительные сведения см. в разделе
Добавление уведомлений.