Usm bgbilling

Материал из WiKi - UserSide

Эта функция является одной из возможностью
обновления даты активности у объекта

usm_bgbilling - модуль для организации импорта данных из биллинговой системы BGBilling в ERP "UserSide"

Данный модуль является заменой устаревшему модулю us_bgbilling - См.: Переход с us bgbilling на usm bgbilling

Язык модуля: PHP

Текущая версия: см. на странице: Модули

Статус модуля: Платный

Дополнительную информацию и перечень импортируемых данных см. на странице: BGBilling

Информация по установке модуля

Архив usm_bgbilling.zip содержит файлы

usm_bgbilling.php
usm_bgbilling.conf.php-example

1. На любом сервере (без разницы - сервер биллинга, userside или третья машина) выделить отдельный (произвольный) каталог для модуля и поместить в него эти файлы

2. Выделить отдельный каталог для логов работы модуля. Дайте права на запись в этот каталог.

3. Пример файла конфигурации usm_bgbilling.conf.php-example следует переименовать в usm_bgbilling.conf.php и внести в нём требуемые изменения (перечень параметров указан ниже)

4. Запустите несколько раз (*) вручную модуль командой

php usm_bgbilling.php

Он должен отработать без ошибок и вернуть данные:

usm_bgbilling
====================================
 Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

* - При первом запуске - будут предварительно лишь созданы многие объекты. Чем больше объектов импортирует модуль - тем дольше это будет. При втором и последующих запусках сверяются изменённые данные и только они будут обновлены. Второй запуск также будет длиться долго, т.к. после первого запуска новосозданные объекты практические не содержат данных. А вот третий и последующие запуски будут работать гораздо быстрее.

5. Проверьте визуально полноту импортируемых данных в ERP "UserSide"

6. Когда станет понятно, что модуль работает стабильно - добавляем его в системный cron на периодическую работу (укажите нужные пути)

*/10 * * * * php usm_bgbilling.php

Параметры

Настройка модуля осуществляется в файле usm_bgbilling.conf.php

$usersideUrl         - URL к ERP "UserSide"
$usersideApiKey      - API-ключ ERP "UserSide" (Указывается в файле "userside/main/config/config.php")
$billingId           - Номер биллинга в ERP "UserSide" ("Настройка - Биллинги")
$logPath             - Путь для записи логов
$isSilence           - Флаг "Режим тишины" (скрыть вывод информационных сообщений от модуля в консоль)

$billingDBHost       - адрес сервера биллинга
$billingDBUser       - имя пользователя для доступа к базе биллинга
$billingDBPassword   - пароль для доступа к базе биллинга
$billingDBName       - имя базы данных биллинга
$billingCodePage     - кодировка базы данных биллинга

$confModuleInetNumber   - номер модуля inet
$confModuleDialupNumber - номер модуля dialup
$confModuleIpnNumber    - номер модуля ipn

$confAddFieldAgreementNumber  - id дополнительного поля с номером договора в таблице contract_parameter_type_1
$confImportAgreementDateClose - id дополнительного поля ERP "UserSide" (tbl_conf_basedopdata.CODE) для импорта даты окончания договора

$confBillingState0 - статус в биллинге "0 - подключен"
$confBillingState1 - статус в биллинге "1 - на отключении"
$confBillingState2 - статус в биллинге "2 - отключен"
$confBillingState3 - статус в биллинге "3 - закрыт"
$confBillingState4 - статус в биллинге "4 - приостановлен"
$confBillingState5 - статус в биллинге "5 - на подключении"

$contractAddString - дополнительная строка для импорта информации о контрактах
$confAddFieldPhone - id дополнительного поля с номером телефона в таблице contract_parameter_type_1