Подписки на события. Отправка сообщений контрагентам
начиная с версии 161208
Продемонстрирую возможность отправки сообщений контрагентам по событию: смене состояния документа.
Сценарий подробнее:
- Ведётся учёт документов "Выполнения работ"
- Используется учёт состояния документов
- При установке такого состояния "готово" - клиенту отправляется сообщение SMS с заданным содержанием.
Как это настроить:
1. Проверить, что включены необходимые настройки:
Учет сообщений контрагентам:
Включена подписка на события:
Способ доставки сообщений
2. Нужно создать и заполнить "Способ доставки электронных сообщений" и указать средство доставки (в нашем случае - SMS).
На закладке "Содержание" я привожу пример шаблона, который формируется по полям источника подписки - документу выполненные работы индивидуально для каждого контрагента.
Пример полей шаблона упоминается в справке программы.
Здесь же установлена ссылка на внешнюю обработку отправки электронных сообщений.
Разумеется каждый оператор (провайдер) для рассылки SMS или EMAIL сообщений даёт различные средства организации обмена.
В карточке "Способа доставки сообщений" на закладке "Подключения" хранятся настройки доступа.
А во внешнюю обработку программист выносит только механизмы обмена (отправки).
Если поля параметров связи не заполнены, то они строго заданы прямо в обработке обмена.
Подписка на событие
3. Теперь можно создать подписку на событие - при установке состояния "Готово" документу выполненных работ:
Все эти значения условий выдумывать не нужно - они выбираются из списка, заполненного программой.
Здесь задано, что подписка действует "при записи" регистра сведений "состояние работ", когда реквизит "Состояние" принимает значение "Готово" (элемент справочника состояний документов выполненных работ).
При этом в качестве объекта подписки выступает собственно сам документ выполненных работ (а не запись регистра).
Если бы не был задан реквизит - подписка бы действовала всегда "при записи" регистра для любого состояния.
В качестве реакции на событие подписки выбрана постановка в очередь к отправке сообщений контрагенту:
И указан способ доставки сообщений (упомянутый нами на предыдущем этапе).
Вместо "очереди на отправку" можно выбрать и "немедленную отправку" сообщений контрагентам. Ввиду того, что за сообщения оператором (провайдером) взымается плата - это несколько небезопасно.
Отправка вручную
Подписка и реакции заданы, теперь при установки состояния документу выполнения работ "Готово":
Появится новое отложенное сообщение к отправке контрагенту. Сформируется его текст. Адрес/телефон/email для сообщения будут взяты из карточки контрагента.
Чтобы посмотреть и отправить эти сообщения (отменить, отложить), следует перейти к обработке по меню "Сервис - Отправка отложенных сообщений контрагентам".
Сюда автоматически попадают неотправленные сообщения:
В этой обработке можно:
1. По клику на строку - открыть сообщение контрагенту, где можно проверить и исправить текст сообщения, адрес получателя, посмотреть состояния сообщения:
2. Задать другое время сообщения (если его позволяет задать оператор (провайдер).
3. Отсюда можно перейти к карточке способа доставки и к вложенной обработке.
4. Отправить выделенные или все сообщения или отменить выделенные или все сообщения.
После отправки у сообщения контрагенту сменится состояние на "Доставлено"
Посмотреть на историю и состояние сообщений контрагенту можно в его карточке:
