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

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

Объект 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)

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

    Параметры:

    • 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)

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

    Параметр:

    • 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 — ссылка для перехода при нажатии на браузерном уведомлении