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

Настройка оповещений

Объект notification может использоваться внутри скрипта кастомизации оповещения, внутри темы и внутри текста сообщения. Перед отправкой оповещения объект notification можно модифицировать, что позволяет изменять следующие параметры оповещений:

• notification.parameters — параметры отправки оповещения:

  • parameters.from — адрес отправителя.

    При изменении параметра в скрипте, важно учитывать ограничения используемого сервера, например, для сервера smtp.gmail.com допустимо использовать только подтвержденные реальные адреса;

  • parameters.name — имя отправителя;
  • parameters.feedbackAddress — адрес электронной почты, на который будут автоматически отсылаться сообщения о серверных ошибках;
  • parameters.outgoingServer — код подключения к серверу исходящей почты;
  • parameters.characterEncoding — кодировка текста, по умолчанию UTF-8.
  • parameters.transliterateSubject — транслитерация заголовков писем, по умолчанию false.

• notification.setHeader(headerName, headerValue)

  Добавление и редактирование заголовка оповещения. Только для протокола SMTP.

  Параметры:

  • headerName — название заголовка;
  • headerValue — значение указанного заголовка.

  Пример:

  notification.setHeader('In-Reply-To', '52D635DD.90108@naumen.ru')'

Изображения в теле письма

• utils.imageForHtml(fileUUID)

  Добавление изображения в тело оповещения или уведомления. Метод преобразует изображение в HTML-строку.

  Параметр:

  • fileUUID — uuid файла с изображением

  Возвращает строку вида <img src="data:… "/> с закодированным в base64 изображением или пустую строку в случае ошибки.

  Пример в тексте оповещения:

  ${utils.imageForHtml('file$72801')}

Прикрепление события календаря к оповещению

• notification.addCalendarEvent(event)

  Добавление события календаря к оповещению. Только для протокола SMTP.

  Параметр:

  • event — событие календаря, которое нужно добавить.

Параметры упоминания объекта

Переменная mention доступна для действия по событию "Упоминание в рамках выбранных объектов".

• mention — параметры упоминания объекта (атрибута, в котором использовались упоминания):

  • mention.changedAttribute — измененный атрибут типа "Текст в формате RTF" (если упоминание добавлено в рамках комментария, то содержит text);
  • mention.newMentions — список идентификаторов новых упоминаний;
  • mention.untouchedMentions — список идентификаторов неизмененных упоминаний;
  • mention.removedMentions — список идентификаторов удаленных упоминаний.

Переменная mentions доступна для действий по событию "Добавление комментария", "Редактирование комментария", "Добавление объекта", "Редактирование объекта", "Смена статуса", "Смена ответственного".

• mentions — список атрибутов, в которых использовались упоминания, в формате:

  mentions == [код_атрибута_1: mention, код_атрибута_2:mention...]

Настройка всплывающих уведомлений в интерфейсе

Объект push может использоваться внутри скрипта кастомизации уведомления, внутри темы и внутри текста сообщения.

Перед отправкой оповещения объект push можно модифицировать, что позволяет изменять следующие параметры уведомления:

• Параметры уведомления в веб-интерфейсе:

  • push.toEmployee — список сотрудников-получателей уведомлений. Поле push.toEmployee всегда будет пустым списком в момент начала выполнения скрипта. Данное поле необходимо заполнять в самом скрипте;
  • push.toRemoveEmployee — список сотрудников-для исключения из получателей уведомления;
  • push.browserNoticeLink — ссылка для перехода при нажатии на браузерном уведомлении.