−Содержание

Ureports

Модуль является коммерческим

Система оповещения пользователей о состоянии счёта и другим событиям (новостям) системы посредством e-mail (для отправки должен быть настроен локальный MTA), sms (Уставнолен модуль Sms) или факс (Через внешние программы) сообщений.

Для отправки SMS используется модуль 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; Округдение рекомендуемой суммы оплаты к целым числам, округление всегдапроисходит в большую сторону

Работа с системой

Заведение сервиса

/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%

Правка и список шаблонов отчётов находится в Настройка / Другое / Шаблоны (Работа с шаблонами)

Переменные шаблонов

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 поздравляет абонентов с днем рождения