Как создать внешнюю обработку для рассылки (для разработчиков)

Торговое предприятие 7Рассылки в Telegram и по почтеЧтение: 2 мин

Страница для разработчиков внешних обработок. Обработку нужно загрузить в механизм дополнительных отчётов и обработок в вашей базе ТП7.

Методы модуля

  • «СведенияОВнешнейОбработке» — обязательная часть БСП для механизма дополнительных обработок.
  • «ЗапускПоРасписанию»(ПараметрыРассылки) — основной сценарий по расписанию рассылки. Имя можно сменить, но тогда его нужно указать в «ИмяМетодаВнешнейОбработки» элемента справочника «Рассылки».
  • «СтруктураНастроекРассылки» — необязательная: передаёт состав параметров и значения по умолчанию; возвращаемая структура сохраняется в реквизитах и табличных частях элемента «Рассылки».

Задачи «ЗапускПоРасписанию»

  • получить информацию о событиях изменения документов и параметры из элемента «Рассылки»;
  • решить, нужна ли рассылка сейчас;
  • при использовании регистрации изменений документов отобрать нужные (например, по «Разделителю» из расписания);
  • сформировать и отправить сообщения;
  • вернуть через параметры таблицу соответствия обработанных событий и ссылки на сформированные письма.

Параметры (структура)

СвойствоТипНазначение
РассылкаСсылка на РассылкиРассылка, вызвавшая запуск
РазделительСсылкаПараметр расписания, вызвавшего запуск
ИдентификаторЗапускаУникальный идентификаторСлучайное значение для логов
ДатаВремяГенерацииДата и времяВремя сервера при запуске
УчетнаяЗаписьОтправителяСсылка на УчетныеЗаписиЭлектроннойПочтыОт кого и через какой сервер отправлять
УчетнаяЗаписьТелеграмБотаСсылка на Телеграм_УчетныеЗаписиБотовДанные подключения к Telegram
ШаблонСообщенияСсылка на ШаблоныСообщенийДля составления сообщений
ЗаписыватьУдачныеПопыткиВЖурналРегистрации, ЗаписыватьНеУдачныеПопыткиВЖурналРегистрации, ЗапретПовторныхУведомленийБулевоНа усмотрение разработчика
ФиксированныеПараметрыСтруктураИмена соответствуют фиксированным параметрам справочника «Рассылки»
ПолучателиПисьма, ПолучателиТелеграмТаблица значенийФиксированные списки получателей
ВидыКонтактнойИнформацииТаблица значенийКакой вид контактной информации использовать для этой рассылки
ДополнительныеНастройкиСтруктураДанные механизма дополнительных настроек, если используется
ДокументыТаблица значенийСобытия изменений из регистра Рассылки_ПоследниеИзмененияДокументов (Документ, ДатаИзменения, УниверсальнаяДатаИзменения, Обработан, Сообщение). Рассылка обязана заполнить флаг «Обработан»; «Сообщение» — по желанию

Примеры

  • Для каждого созданного документа «Приходная накладная» отправить ответственному сообщение по почте: нужен механизм регистрации событий этого вида документа и электронная почта; адрес берётся из контактной информации контрагента накладной, вид контакта — из настройки видов контактной информации рассылки.
  • Раз в сутки проверить итоги продаж по магазинам и отправить директору сводку: регистрация изменений не нужна — выберите документы за период, соберите текст и отправьте по фиксированному списку получателей.

Можно ничего этого не использовать и слать админам «Сервер работает» каждые полчаса — решает разработчик конкретной рассылки.

Не получилось?Наши специалисты сделают это за вас.+7 (499) 700-00-74