Настройка и ведение уведомлений =============================== Ведение уведомлений ------------------- Ведение уведомлений осуществляется через транзакцию ``/TRL/XDE_NOTIFY``. .. image:: media/notify1.png :scale: 70 :align: center Основной экран транзакции предоставляет доступ к ведению кластера ракурсов. Уведомления разделены на два типа: * `Уведомления для документов`_ * `Уведомления для приглашений`_ Для каждого из уведомлений доступна настройка пользователей и ролей, которым будет отправляться оповещение. Экран настройки уведомления является двухуровневым (для существующих строк доступен по двойному клику). Переход в режим редактирования и добавление новых записей осуществляется стандартным для ракурсов ведения способом. Обзорный экран доступен при наличии более одной строки с условиями. .. image:: media/notify5.png :scale: 100 :align: center Отсюда же доступно управлениями доп. текстами для уведомлений (`Ведение текстов`_ ). .. note:: Уведомление - это набор условий, которые должны выполниться для того, чтобы сформированный текст письма был отправлен соответствующим пользователям или пользователям из ролей. Уведомления для документов ~~~~~~~~~~~~~~~~~~~~~~~~~~ Настроенное уведомление будет отправлено при выполнении заполненных условий. .. image:: media/notify2.png :scale: 77 :align: center .. note:: В текущей версии Продукта компонент для работы с кастомными статусами не поддерживается. Поля для установки условия отправки уведомления: * Балансовая единица; * Направление документооборота; * Код статуса; * Код оператора; * Вид документа; * Кредитор; * Дебитор. .. attention:: Отсутствие значения в одном из вышеописанных полей приведет к тому, что данное поле будет исключено из проверки. .. note:: **Пример заполнения условий для отправки уведомления**. Если необходимо получать уведомления только для статуса ``I`` в БЕ ``1000``, при получении документа ``UKDDIS`` через оператора ``2BM``, а внутренний номер дебитора в учетной системе ``1``, то условия уведомления должны быть следующими: .. image:: media/notify4.png :scale: 100 :align: center После установки условий получения уведомления нужно настроить `Общие параметры уведомлений`_. Если в конструкторе уведомления указан конкретный статус, то должно быть указано направление документооборота. .. image:: media/notify18.png :scale: 77 :align: center В конструкторе уведомлений можно одновременно заполнить поля и "Дебитора", и "Кредитора". Однако заполнить их нужно данными одной и той же организации. Т.е. если указан дебитор, то кредитор должен соответствовать ему. Уведомления для приглашений ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Настроенное уведомление о приглашении будет отправлено при выполнении заполненных условий. .. image:: media/notify3.png :scale: 75 :align: center Поля для установки условия отправки уведомления: * Балансовая единица; * Код оператора ЭД; * Код статуса отношений между контрагентами; * Кредитор; * Дебитор. .. attention:: Отсутствие значения в одном из вышеописанных полей приведет к тому, что данное поле будет исключено из проверки. .. note:: **Пример заполнения условий для отправки уведомления**. Если необходимо получать уведомления только когда будет закреплен статус отношений партнерства между контрагентами у оператора ``2BM``, то условия уведомления должны быть следующими: .. image:: media/notify6.png :scale: 100 :align: center После установки условий получения уведомления нужно настроить `Общие параметры уведомлений`_. .. _not_common_params: Общие параметры уведомлений ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Ниже приведены параметры, которые доступны для всех видов уведомлений. * |notify_att| Выбор этого чекбокса позволяет прикреплять к письму с уведомлением Shortcut файл с расширением ``.SAP``. Это позволит перейти к документу или приглашению, у которого сменился статус, непосредственно из письма в учетную систему SAP. * Для документов будет открываться транзакция ``/TRL/XDE_OUTBOX``. * Для приглашений будет открываться транзакция ``/TRL/XDE_INVITE``. * |notify_sendtype| Выбор осуществляется через выпадающее меню: .. image:: media/notify7.png :scale: 100 :align: center Параметр определяет, будет ли уведомление отправлено сразу при наступлении условий, или при следующем запуске отложенной отправки (см. `Настройка отложенных уведомлений`_). * |notify_descr| Название уведомления для удобства настройки и различения уведомлений между собой. * |notify_clsexit| Поле позволяет указать класс расширения для корректировки логики отправки уведомлений (подробнее см. :ref:`Точки расширения для заказчиков `). .. note:: Указанный класс должен реализовывать :ref:`интерфейс для реализации расширений `. Ведение текстов ~~~~~~~~~~~~~~~ Функционал отправки уведомлений предусматривает расширение текста письма с уведомлением с помощью ведения кастомных текстов. .. note:: Кастомные тексты могут быть вставлены в текст письма только при единичной отправке уведомлений (см. `Общие параметры уведомлений`_). Ниже приведен пример письма с таким текстом. .. image:: media/notify9.png :scale: 60 :align: center Ведение текстов осуществляется через соответствующие кнопки в кластере ракурсов ``/TRL/XDE_NOTIFY``: * на подробном экране уведомления .. image:: media/notify11.png :scale: 70 :align: center * на обзорном экране со списком (в первых двух столбцах) .. image:: media/notify10.png :align: center .. note:: Для того, чтобы можно было отличить уведомления с кастомными текстами и без кастомных текстов, кнопки ведения текстов наглядно меняют вид в зависимости от наличия или отсутствия текста. При нажатии кнопки **Создать/изменить текст** откроется текстовый процессор или SAP Script Text Editor (в зависимости от настроек безопасности SAP GUI). .. image:: media/notify8.png :scale: 85 :align: center .. note:: В кастомном тексте уведомления имеется возможность указать имена полей, соответствующих уведомлению таблиц, которые в конечном виде будут заменены на соответствующие значения. Имена полей должны быть заключены в фигурные, квадратные или угловые скобки: ``{TAG}``, ``[TAG]``, ````. Имена полей можно посмотреть в тр. ``SE11``, ``SE16``, ``SE16n`` : * для документов - из таблицы ``/TRL/XDE_HEADER``; * для приглашений - из таблицы ``/TRL/XDE_DEB_REL``. .. attention:: Неверно указанные или несуществующие поля будут выведены как обычный текст. Ведение пользователей и ролей ----------------------------- Получателями уведомлений могут быть как отдельные пользователи, так и роли. Ведение осуществляется в соответсвтующих ракурсах кластера, для документов и приглаешений отдельно. Для поиска пользователей и ролей существуют средства поиска. Шапка ракурса указывает на то, к какому уведомлению добавляются получатели. .. image:: media/notify12.png :scale: 70 :align: center Для каждого получателя необходимо указать следующие поля: * **Адрес электронной почты** Указывается для отправки на e-mail. .. note:: Если оставить поле пустым, то адрес электронной почты будет взят из основной записи пользователя (тр. ``SU01``). .. note:: При назначении уведомления роли поле с адресом электронной почты не заполняется конкретным значением, уведомления отправляются на те ящики, которые настроены для пользователя в транзакции ``SU01``. Если в настройках пользователя не указан адрес электронной почты, то уведомление не будет отправлено. * **SAP Office** Чекбокс отвечает за отправку на внутреннюю почту SAP. .. note:: Если этот чекбокс выбран, отправка на e-mail осуществляться не будет. * **Приоритет отправки SAP Office** Выбор приоритета отправки на внутреннюю почту SAP. Выбор из выпадающего списка. Приоритет учитывается только при отправке уведомлений в SAP Office. .. note:: Если поле останется пустым, а чекбокс SAP Office заполнен, отправка письма во внутреннюю почту будет выполнена с максимальным приоритетом. .. attention:: Ведение ролей осуществляется аналогично ведению пользователей - получателей. При этом отправка сообщений будет осуществляться с выбранными настройками всем пользователям указанной в ракурсе роли. Если пользователь указан как получатель в ракурсе пользователей и присвоен роли, также указанной получателем, то он получит оповещение один раз. Настройка отложенных уведомлений -------------------------------- Отложенные уведомления отправляются с помощью настроенного в фоне задания с запуском отчета ``/TRL/XDE_NOTIFY_BACKGROUND`` с требуемой периодичностью. Для настройки отложенных уведомлений выполните следующие действия. #. Создайте вариант для первого запуска отчета. .. image:: media/notify13.png :scale: 100 :align: center Для этого установите параметр ``Момент времени с..`` макимально назад во времени, например, на год назад. Это можно сделать, скопировав значение параметра ``Момент времени по..``, который берется в момент запуска отчета, и изменив год метки. .. image:: media/notify14.png :scale: 100 :align: center Затем нажмите ``Сохранить``. В атрибутах варианта скопируйте присвоение экрана и дайте варианту имя. .. image:: media/notify15.png :scale: 50 :align: center .. attention:: Для параметра экрана выбора ``Момент времени по..`` необходимо отметить чекбокс ``Сохранить поле без значений``. #. Настройте фоновое задание. Для этого в транзакции ``SM36`` заполните: * Имя задания; * Цель выполнения; * Условие запуска - немедленно. .. image:: media/notify16.png :scale: 75 :align: center .. note:: Здесь можно выбрать значения периодов для отправки уведомлений. * Определить шаг задания * Имя отчета - ``/TRL/XDE_NOTIFY_BACKGROUND`` * Вариант - созданный вариант из п.1 .. image:: media/notify17.png :scale: 80 :align: center После настройки нажмите ``Сохранить``. .. |notify_att| image:: media/notify_att.png :width: 145 :height: 22 .. |notify_sendtype| image:: media/notify_sendtype.png :width: 135 :height: 23 .. |notify_descr| image:: media/notify_descr.png :width: 142 :height: 22 .. |notify_clsexit| image:: media/notify_clsexit.png :width: 144 :height: 22