Модули

Модули к САП "UserSide" делятся на внутренние и внешние. Внешние модули представляют собой - отдельные скрипты или программы, которые могут в т.ч. работать удаленно от основной системы (имея при этом соединение с базой данных системы), а внутренние уже заложены в систему и могут включаться/выключаться в разделе "Настройка"

Частые вопросы по модулям собраны в соответствующем разделе "Частые вопросы"

Общая информация для всех модулей

1. В процессе работы все модули ведут логи работы. Путь для каталога с логами указывается в файле конфигурации us_config.tmp. Крайне рекомендуется для каждого из модулей создавать отдельный каталог для логов, т.к. почти у всех модулей названия файлов-логов совпадают, что приведет к неразберихе. Не забудьте указать права на запись для этого каталога.

Распространенные названия файлов логов:

rep_alllog.txt - запуск и окончание всех циклов работы модуля с фиксацией времени
rep_logupd.txt - текущий цикл работы модуля
rep_mysql.txt -  все mysql команды, исполняемые модулем. Полезно при поиске ошибок.
pid.txt - файл-флаг по которому модуль ориентируется о том, что он уже запущен, для предотвращения повторного одновременного запуска

2. Для некоторых модулей требуется наличие дополнительных perl-пакетов (DBI, Socket, Encode и т.д.) Если у вас они не установлены - модуль выдаст ошибку при запуске и perl-пакет необходимо будет установить (с помощью CPAN или PPM).

3. Модули служат как правило для постоянной работы. Их необходимо записать в системный cron/планировщик с частотой запуска 5-15 минут (в зависимости от нагрузки). При первом запуске рекомендуется запустить модуль вручную из системной консоли и убедиться, что ошибок не возникает и данные импортируются/обрабатываются корректно.

Общая информация для модулей взаимосвязи с биллингами

1. Адрес абонента обрабатывается и фиксируется во встроенную в САП "UserSide" систему учёта улиц и домов. В случае если необходимого дома нет в САП "UserSide" он будет создан. В случае если дом уже есть и добавлен в систему не средствами модуля, то он все-равно будет корректно обработан и прописан абонентам.

2. Если абонент есть в САП "UserSide", но не найден в биллинге, то он не удаляется из САП "UserSide", а помечается статусом "нет в биллинге". Так сделано в целях безопасности - в противном случае при сбое в обновлении - все абоненты могут быть удалены, т.к. не будут найдены в биллинге.

3. Если у абонента дата активности в интернете позже даты активности в сети, то дата активности в сети приравнивается к дате активности в интернете.

4. При обновлении данных из биллинга - не все данные абонента обновляются - например ФИО, адрес, телефон могут оставаться без изменений. Загрузку таких данных можно включить в разделе "Настройка - Биллинги" для необходимого биллинга.

5. Некоторые модули могут импортировать из биллинга пароль на авторизатор/вход в личный кабинет биллинга или пароль доступа в интернет. В этом случае такой пароль можно использовать как пароль входа в личный кабинет абонента в САП "UserSide". Это модули: us_nodeny, us_utm5

Текущие версии модулей

us_abills - 3.13.84
us_nodeny - 3.14.137