Пошаговая инструкция создания рассылки через Telegram

470

На данной странице рассматривается пример формирования ежедневной рассылки через мессенджер Telegram с отчетом о выручке по Торговым объектам фирмы за предыдущий день / за любой прошедший день. Логика рассылки реализована во внешней обработке «ПримерРассылкиТелеграмРассылкаДанныхОВыручке.epf», которая включена в каталог внешних файлов "ExtFiles" комплекта поставки конфигурации «Торговое предприятие 7». Этот каталог помещается в каталог шаблона конфигурации. Обычно это c:\Program Files (x86)\ilexx\TorgPred7\7_0_50_1\ExtForms\, но может быть и в папке «User» (или «Пользователи»)— подпапка, которая содержит информацию о профиле текущего пользователя.

В отчет рассылки с данными о выручке по каждому Торговому объекту выводится следующая информация:

Магазин [Название торгового объекта]

Сумма выручки:

   [Вид оплаты Наличными] [Сумма по виду оплаты Наличными по всем отчетам отдела этого ТО]

    [Вид оплаты Кредит] [Сумма по виду оплаты Кредит по всем отчетам отдела этого ТО]

    [Вид оплаты Аванс] [Сумма по виду оплаты Аванс по всем отчетам отдела этого ТО]

    [Вид оплаты не предопределенный 1] [Сумма по виду оплаты строки по всем отчетам отдела этого ТО]

    [Вид оплаты не предопределенный 2] [Сумма по виду оплаты строки по всем отчетам отдела этого ТО]

Обработаны данные со всех ККМ

 

Логика, реализованная во внешней обработке:

• в параметре рассылки указывается количество дней смещения от текущей даты. За эту дату анализируются все документы «Отчет отдела» в разрезе ККМ и Торговых объектов;
• если сумма по виду оплат равна 0, то строка с этим видом оплат в отчет НЕ выводится;
• выводятся данные по ВСЕМ Торговым объектам, с которыми связаны НЕ помеченные на удаление ККМ. Если у Торгового объекта нет включенных касс, отчет по данному ТО не формируется;
• рассылка с отчетом высылается пользователям Telegram, идентификационные номера которых указаны в закладке «Пользователи Telegram». При формировании рассылка закладка «Вид контактной информации» справочника «Рассылки» НЕ учитывается;
• в рассылке не используются «Шаблоны сообщений»;
• в закладке «Расписание» справочника «Рассылки» НЕ учитываются разделители — необходимо сформировать ОДНО расписание для выполнения рассылки в определенной время дня. Если сформировать расписание нескольких рассылок с использованием «Разделителя», то по КАЖДОМУ расписанию с разделителем по справочнику «Торговые объекты» будет формироваться отчет по ВСЕМ Торговым объектам с включенными ККМ.

 

Рассылка создается в справочнике «Рассылки». До создания рассылки необходимо:

• активировать механизм рассылок в базе Торгового предприятия;
• создать Telegram-бота, через которого будет выполняться рассылка;
• подписать получателей рассылки на созданного Telegram-бота;
• узнать идентификатор Telegram получателей рассылки и, желательно, добавить этот идентификатор в справочник «Telegram: Получатели рассылок»;
• внешнюю обработку «ПримерРассылкиТелеграмРассылкаДанныхОВыручке.epf» из каталога внешних файлов комплекта поставки добавить в справочник «Дополнительные отчеты и обработки»;
• настроить расписание выполнения регламентного задания «Рассылки: Проверка необходимости рассылки по расписанию». Рекомендуемая периодичность запуска регламентного задания — от 3-х до 5-ти минут.

 

После выполнения этих подготовительных действий можно добавлять рассылку в справочник «Рассылки».

Справочник вызывается командой «Рассылки (дополнительными обработками)», которая доступна в группе «Сервис» раздела «Сервис».

В шапке формы нового элемента справочника следует:

1.) Заполнить «Наименование» — строка с пояснением что это за рассылка, например, «Выручка за предыдущий день».

2.) Задать флаг «Использовать» — признак того, что рассылка будет выполняться.

3.) В реквизите «Внешняя обработка» указать внешнюю обработку «ПримерРассылкиТелеграмРассылкаДанныхОВыручке.epf», в которой реализована логика рассылки. Обработка выбирается в справочнике «Дополнительные отчеты и обработки». На вопрос «Загрузить настройки из модуля обработки?» следует ответить «Да»:

•  В реквизит «Имя метода внешней обработки» добавится значение «ЗапускПоРасписанию»;
•  В закладку «Параметры» добавится параметр «ДнейСмещения». По умолчанию значение этого параметра задается «1» и рассылка будет выводить выручку за предыдущий день. Изменяя значение параметра можно будет получать данные за нужный прошедший день.

4.) В закладке «Получатели Telegram» задать получателей рассылки с их идентификаторами Telegram. Это можно сделать либо через кнопку «Добавить», либо из «Адресной книги».

5.) Сохранить созданную рассылку нажатием кнопки «Записать» в форме справочника. Становится доступна кнопка «Создать» в закладке «Расписание».

с

5.) В закладке «Расписание» необходимо задать расписание выполнения рассылки. Для этого надо нажать кнопку «Создать» — откроется форма «Рассылки: Расписание запуска». В этой форме:

• при необходимости убрать флаг у дня, в который рассылку делать не надо;
• в реквизитах «Время начала интервала» и «Время окончания интервала» надо задать одно и тоже значение — время получения рассылки. Реквизит «Периодичность» заполнится значением по умолчанию – 60 сек;

• сохранить созданное расписание нажатием кнопки «Записать»;

6.) Сохранить созданную рассылку нажатием кнопки «Записать и закрыть» в форме справочника. В закладке «Расписание» становится доступны кнопка «Запустить сейчас»;

7.) Нажатием кнопки «Запустить сейчас» в табличной части закладки «Расписание» надо проверить работу сформированной рассылки и убедиться в том, что рассылка работает.