=====Ureports===== [[abills:price:price|Модуль является коммерческим]] Система оповещения пользователей о состоянии счёта и другим событиям (новостям) системы посредством e-mail (для отправки должен быть настроен локальный MTA), sms (Уставнолен модуль Sms) или факс (Через внешние программы) сообщений. \\ Для отправки SMS используется модуль [[abills:docs:modules:sms:ru|SMS]] \\ ====Возможности==== * Подписка на отчёты с аккаунта пользователя. * Лимиты срабатывания сенсоров отчётов устанавливаются пользователями самостоятельно. * Группирование отчётов в тарифные планы. * Возможность взыскание средств за активизацию тарифного плана. * Тарификация предоставления услуги (месячная абон. плата, плата за отчёт). * Ведение журнала предоставленных отчётов. * Поддержка модулей расширения отчётов * Возможность запретить абонентам управлять отчётами **Предоставление отчётов о:** ^1|Оповещение абонента с статусом услуги интернет "Активно" и сумой депозита ниже значения тригера | ^2|Депозит + Кредит ниже значения тригера| ^3|Предоплаченный трафик закончился. (Значение тригера не учитывается) \\ %REST% - Осталось трафика в байтах \\ %REST_DIMENSION% - Осталось трафика приведенно в разрядность \\ %PREPAID% - Предоплачено трафика \\ Маркеры с учетом классов трафика %REST_0% %REST_DIMENSION_0% %PREPAID_0% | ^4|Дневной трафик привысил лимит тригера| ^5|Месячный отчёт: Депози, кредит, использованный траффик. Рассылается только первого числа (тригер не учитывается) | ^6|Дневной отчёт: Депози, кредит, использованный траффик. Рассылается только первого числа (тригер не учитывается)| ^7|Оповещение о завершении кредита через указанное в тригере количество дней | ^8|Оповещение об отключенном логине (тригер не учитывается) | ^9|Оповещение о завершении тарифа через указанное количество дней. количество дней до завершения в шаблоне задается опцией %CREDIT_EXPIRE_DAYS%. Дней до завершения предоплаченного периода| ^10|Недостаточно средств для работы в следующем месяце (Депозит + Кредит) | ^11|Депозит ниже чем абонплата следующего месяца | ^12|Оповещение о пополнении счета | ^13|Оповещение о завершении всех сервисов (Internet,Abon,Iptv,Voip) за несколько дней (количество дней до завершения указывается в тригере) | ^14|Оповещение о начислении абонплаты через период дней указанный в тригере | ^15|В услуги интернет изменился статус (тригер не учитывается) | ^16|Предупреждение о начале следующего учётного периода. В тригере указывается количество дней | ====Работа==== Система рассылает сообщения через программу ureports_sender.pl, кроме смообщения о пополнении оно отправляется моментально после поступления средств. После отправки сообщения система отмечает отчет как выполненный и больше не отправляет сообщения по нему. 1 числа месячные отчеты обнуляются и становяться готово опять для отправки сообщений. Обнуление происходит дневным периодиком (periodic daily) ====Установка==== Создать таблицы в базе. # cd /usr/abills/ # mysql -D abills < db/Ureports.sql Установка агента рассылки сообщений (сендера). # cd libexec # ln -s ../Abills/modules/Ureports/ureports_sender.pl ureports_sender.pl Подключение модуля. **abills/libexec/config.pl** @MODULES = ( 'Ureports' ); ====Настройка==== **abills/libexec/config.pl** ^$conf{UREPORTS_EXT_SENDER}="" | Внешняя программы рассылки сообщений. Система передаёт ей следующие параметры \\ DESTINATION - адрес получения \\ MESSAGES - сообщение | ^$conf{UREPORTS_SKIP_ACTIVATE_SMS}=1; | не отправлять SMS при активации и изменении данных услуги. \\ По умолчанию при активиции или изминении услуги оповещения система отправляет сообщение о действии. | ^$conf{UREPORTS_ROUNDING}=1; | Округдение рекомендуемой суммы оплаты к целым числам, округление всегдапроисходит в большую сторону | =====Работа с системой===== * [[abills:docs:manual:admin:ureports:ureports_tp|Настройка тарифных планов]] ====Заведение сервиса==== ** /Customers/ Logins/ Information/ Services/ Reports/ ** \\ ^Tarif plan: | Тарифный план | ^Type: | Тип отправки | ^Destination (PHONE/E-MAIL): | Телефон | ^Status: | Статус сервиса | ^Registration: 2009-02-24 | Дата регистрации | После включения сервиса появляется список доступных данному тарифному плану сенсоров. У пользователя есть возможность самостоятельно менять порог срабатывания сенсора. **сенсоры**\\ ^# |включить сенсор | ^Name |Название сенсора| ^Value |Значение срабатывания сенсора | ^Default | Значен сенсора по умолчанию | ^Date | Дата последнего срабатывания сенсора | ====Отчёты==== =====Рассылка сообщений===== Рассылкой сообщений занимается программа /usr/abills/libexec/ureports_sender.pl. доступны следующие опции. ^ DEBUG=0..6 | режим отладки | ^ TP_IDS= | Список тарифных планов для обработки. Номера тарифных планов разделяются запятыми без пробелов. | ^ LOGIN= | Список логинов для отправки сообщений. Разделяются запятыми | ^ DATE= | Установка даты формирования отчётов. Используется если есть необходимость сформировать отчёт за определённое число. | ^ help | Помощь | Данные программу следует поместить в /etc/crontab с параметрами времени рассылки \\ **Пример** \\ Рассылать сообщения каждый день в 10 утра 1 10 * * * root /usr/abills/libexec/ureports_sender.pl ====Шаблоны сообщений==== \\ Общие шаблоны * ureports_email_message.tpl шаблон E-mail сообщения * ureports_sms_message.tpl шаблон SMS сообщения Индивидуальные шаблоны отчётов (для изменения стандартного представления) * ureports_reports_1.tpl - Шаблон для отчёта 1 * ureports_reports_%NUM%.tpl - Шаблон для отчёта %NUM% Правка и список шаблонов отчётов находится в ''Настройка / Другое / Шаблоны'' ([[abills:docs:manual:system_configuration:system_configuration#template|Работа с шаблонами]]) \\ Переменные шаблонов |UID | UID | |LOGIN | Логин | |FIO | Фамилия | |CONTRACT_ID | Номер контракта | |CONTRACT_DATE | Дата котнракта | |MESSAGE | Сообщение отчёта | |DATE | Текущая дата | |TP_ID | Номер ТП отчёта | |CREDIT | Кредит абонента | |DEPOSIT | Депозит абонента | |EXPIRE_DAYS |Дней до завершения всех услуг | |EXPIRE_DATE |Дата завершения услуг | |RECOMMENDED_PAYMENT | Рекомендованная сумма оплат | |TOTAL_FEES_SUM|Сума всех месячных начислений | |TP_MONTH_FEE| месячная абонплата | |MESSAGE| как стандартное тело отчёта которое формирует программа отчётов в некоторых отчётах может не заполняться | ====Система плагинов===== Добавлена возможность создавать собственный плагины для отчетов плагины размещаются в папке modules/Ureports с расширением *.pm пример плагин **Report1.pm** поздравляет абонентов с днем рождения