QP7.Framework Docs

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Свойства уведомления ======

===== Основные свойства =====
  ***Имя** (**Name**) -- уникальный идентфикатор уведомления в пределах контента. Кроме этого, данное значение подставляется в поле Тема отправляемого письма.
  ***Формат** -- можно выбрать существующий формат (для выбора предлагаются все форматы, принадлещащие к объектам типа //Publishing Container//, связанные с текущим контентом) либо выставить галочку **Создать формат по умолчанию** (только для нового уведомления). В этом случае в шаблоне //Default Notification Template// создастся новый объект типа //Publishing Container// и в нем в соответствии со структурой контента будет сгенерирован формат, который будет привязан к создаваемому уведомлению. Кнопка **Новый объект** позволяет перейти в интерфейс создания нового объекта в шаблоне //Default Notification Template//.

===== События =====

Выбор из предопределенного набора одного или нескольких событий, при возникновении любого из которых будет отправляться уведомление.


Поддерживаются следующие события:
  * **При создании** (**On Create**)
  * **При обновлении** (**On Modify**)
  * **При удалении** (**On Remove**)
  * **При изменении статуса** (**On Status Changed**) -- можно настроить отправку уведомления как на любое изменение статуса, так и на достижение статьей конкретного статуса.
  * **При частичном изменении статуса** (**On Status Partially Changed**) -- данное событие возникает при использовании параллельного Workflow, когда пользователь изменяет статус статьи, но это изменение еще не подтверждено остальными пользователями.
  * **Запрос по требованию** (**Request On Demand**) -- Данный тип события используется, когда нужно отправлять уведомление из пользовательского кода, с помощью метода [[:api:qpage:other#SendNotification|SendNotification]]

===== Отправитель =====

C помощью опции **От имени по умолчанию** (**From Default Name**) может быть выбрано имя по умолчанию -- //Q-Publishing Backend//. Эта настройка по умолчанию может быть изменена [[admin:config|в конфигурационном файле QP7]]. Другой вариант -- явно задать имя отправителя (опция **От имени** (**From Name (optional)**)).

При указании почтового адреса отправителя можно выбрать с помощью опции **От e-mail адреса пользователя** (**From User Email Address**) выбрать одного из пользователей бэкенда, либо явно указать адрес в поле **От e-mail адреса** (**From Email Address**).

Необходимо, чтобы выбранный в результате адрес реально существовал на сервере (сервер поддерживал указанный почтовый домен). В противном случае с большой долей вероятности соообщение будет расценено как спам и не дойдет до адресата.

===== Получатель =====

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

  * **Пользователь** (**User**) -- пользователь бэкенда. Уведомление отправляется по е-mail, заданному в [[profile|профиле]].
  * **Группа** (Group) -- группа пользователей бэкенда. Уведомление отправляется каждому пользователю, входящему в эту группу.
  * **Все пользователи из истории изменений** (**Everyone in History**) -- уведомление отправляется всем пользователем бэкенда, которые есть в истории изменений, если она не очищена.
  * **Уведомление на поле из статьи** (**E-Mail from Article Field**) -- Адрес получателя берется из указанного поля статьи. Данная опция обычно используется при добавлении/изменении статьи с фронтенда. 
  * **Не уведомлять (просто триггер)** (**No E-mail (just trigger)**) -- данная опция обычно используется при реализации пользователськой логики, которая должна срабатывать на стандартные события (Create, Modify, Delete). При этом формат уведомления вызывается и код, написанный в нем -- отрабатывает, но никаких почтовых сообщений не посылается.
	
Если необходимо задать несколько почтовых ящиков для одного пользователя, можно перечислить из через точку с запятой при любом из вариантов отправки.

Необходимо, чтобы адреса получателей были реальными. Использование несуществующих адресов может привести к тому, что сервер попадет в черный список за рассылку спама.

===== Дополнительные опции =====
  * **Послать файлы в аттаче** (**Send files as attachments**) -- если данная опция установлена, то содержимое полей типа Файл и Изображение будет использовано в отправляемом уведомлении как вложения, в противном случае эти поля игнорируются.
  * **Использовать компонент QA_Mail в бэкенде** (**Use QA_Mail Component in Backend**) -- данная опция используется для обратной совместимости при обновлении на 7.7.0.0. В новых инсталляциях она работать не будет. По умолчанию она установлена для всех уведомлений, которые были созданы до версии 7.7.0.0, для новых уведомлений она сброшена. Ее введение связано с тем, что классы из пространства имен .NET [[http://msdn.microsoft.com/en-us/library/system.net.mail.aspx|System.Net.Mail]] некорректно работают с кодировкой //windows-1251//, которая раньше использовалась очень часто при отправке русскоязычных сообщений. Таким образом рекомендуемые кодировки (настраиваются в [[template|свойствах шаблона]] Default Notification Template):
    * При отключенной опции (рекомендуемое поведение) -- //UTF-8//
    * При включенной опции (режим совместимости) -- //windows-1251// (или другая локальная кодировка)

===== Настройка конфигурации =====

Для того, чтобы уведомления работали, кроме создания уведомления в бэкенде, нужно выполнить ряд настроек
   * Для того, чтобы уведомления срабатывали на события бэкенда, необходимо [[admin:config#настройки_почты|настроить конфигурационный файл QP7]].
QP7.Framework Docs

User Tools

Site Tools

Page Tools
