Usm bgbilling: различия между версиями
Admin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
(не показано 14 промежуточных версий 1 участника) | |||
Строка 1: | Строка 1: | ||
[[Usm_bgbilling_EN|en]] | [[Usm_bgbilling|ru]] | |||
{{activ}} | {{activ}} | ||
Строка 14: | Строка 16: | ||
== Информация по установке модуля == | == Информация по установке модуля == | ||
'''Убедитесь, что в системе где будет работать модуль присутствует библиотека php_mysqli''' | |||
Архив usm_bgbilling.zip содержит файлы | Архив usm_bgbilling.zip содержит файлы | ||
Строка 20: | Строка 24: | ||
usm_bgbilling.conf.php-example | usm_bgbilling.conf.php-example | ||
1. | 1. На любом сервере ''(без разницы - сервер биллинга, userside или третья машина)'' выделить отдельный ''(произвольный)'' каталог для модуля и поместить в него эти файлы | ||
2. Выделить отдельный каталог для логов работы модуля. Дайте права на запись в этот каталог. | 2. Выделить отдельный каталог для логов работы модуля. Дайте права на запись в этот каталог. | ||
Строка 49: | Строка 53: | ||
Настройка модуля осуществляется в файле '''usm_bgbilling.conf.php''' | Настройка модуля осуществляется в файле '''usm_bgbilling.conf.php''' | ||
Также можно использовать стандартные параметры из модуля [[usm_billing#Параметры конфигурации|usm_billing]] | |||
$usersideUrl - URL к ERP "UserSide" | $usersideUrl - URL к ERP "UserSide" | ||
$usersideApiKey - API-ключ ERP "UserSide" | $usersideApiKey - [[UserSide API Key|API-ключ ERP "UserSide"]] | ||
$billingId - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")'' | $billingId - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")'' | ||
$logPath - Путь для записи логов | $logPath - Путь для записи логов | ||
Строка 61: | Строка 67: | ||
$billingDBName - имя базы данных биллинга | $billingDBName - имя базы данных биллинга | ||
$billingCodePage - кодировка базы данных биллинга | $billingCodePage - кодировка базы данных биллинга | ||
$confIsIgroneTtlTable - флаг - игнорировать данные из таблицы "tariff_tree_link" | |||
$confPidAddressContract - значение PID из таблицы contract_parameter_type_2 с полем адреса | |||
$confIsUseCustomerNameTable - флаг - использовать таблицу contract_parameter_type_1 для получения имени абонента | |||
$confIsWoPaymentParent - флаг - не использовать значение родительских платежей в тарифах | |||
$confIsSkipCustomerWoLogin - флаг - не импортировать абонентов без логина | |||
$confModuleInetNumber - номер модуля inet | $confModuleInetNumber - номер модуля inet | ||
Строка 66: | Строка 78: | ||
$confModuleIpnNumber - номер модуля ipn | $confModuleIpnNumber - номер модуля ipn | ||
$confAddFieldAgreementNumber | $confAddFieldAgreementNumber - id дополнительного поля с номером договора в таблице contract_parameter_type_1 | ||
$ | $confImportCustomerAgreementDateClose - id дополнительного поля ERP "UserSide" для импорта даты окончания договора | ||
$confImportCustomerVlan - id дополнительного поля ERP "UserSide" для импорта vlan абонента | |||
$confImportPppoeLogin - id дополнительного поля ERP "UserSide" для импорта pppoe-логина абонента | |||
$confImportPppoePass - id дополнительного поля ERP "UserSide" для импорта pppoe-пароля абонента | |||
$confBillingState0 - статус в биллинге "0 - подключен" | $confBillingState0 - статус в биллинге "0 - подключен" | ||
Строка 75: | Строка 90: | ||
$confBillingState4 - статус в биллинге "4 - приостановлен" | $confBillingState4 - статус в биллинге "4 - приостановлен" | ||
$confBillingState5 - статус в биллинге "5 - на подключении" | $confBillingState5 - статус в биллинге "5 - на подключении" | ||
$contractAddString - дополнительная строка для импорта информации о контрактах | |||
$confAddFieldPhone - id дополнительного поля с номером телефона в таблице contract_parameter_type_1 | |||
$confIsImportAgreementAsLogin - флаг - импортировать номер договора как логинLogin |
Текущая версия от 07:02, 28 сентября 2023
Эта функция является одной из возможностью |
usm_bgbilling - модуль для организации импорта данных из биллинговой системы BGBilling в ERP "UserSide"
Данный модуль является заменой устаревшему модулю us_bgbilling - См.: Переход с us bgbilling на usm bgbilling
Язык модуля: PHP
Текущая версия: см. на странице: Модули
Статус модуля: Платный
Дополнительную информацию и перечень импортируемых данных см. на странице: BGBilling
Информация по установке модуля
Убедитесь, что в системе где будет работать модуль присутствует библиотека php_mysqli
Архив 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
Также можно использовать стандартные параметры из модуля usm_billing
$usersideUrl - URL к ERP "UserSide" $usersideApiKey - API-ключ ERP "UserSide" $billingId - Номер биллинга в ERP "UserSide" ("Настройка - Биллинги") $logPath - Путь для записи логов $isSilence - Флаг "Режим тишины" (скрыть вывод информационных сообщений от модуля в консоль) $billingDBHost - адрес сервера биллинга $billingDBUser - имя пользователя для доступа к базе биллинга $billingDBPassword - пароль для доступа к базе биллинга $billingDBName - имя базы данных биллинга $billingCodePage - кодировка базы данных биллинга $confIsIgroneTtlTable - флаг - игнорировать данные из таблицы "tariff_tree_link" $confPidAddressContract - значение PID из таблицы contract_parameter_type_2 с полем адреса $confIsUseCustomerNameTable - флаг - использовать таблицу contract_parameter_type_1 для получения имени абонента $confIsWoPaymentParent - флаг - не использовать значение родительских платежей в тарифах $confIsSkipCustomerWoLogin - флаг - не импортировать абонентов без логина $confModuleInetNumber - номер модуля inet $confModuleDialupNumber - номер модуля dialup $confModuleIpnNumber - номер модуля ipn $confAddFieldAgreementNumber - id дополнительного поля с номером договора в таблице contract_parameter_type_1 $confImportCustomerAgreementDateClose - id дополнительного поля ERP "UserSide" для импорта даты окончания договора $confImportCustomerVlan - id дополнительного поля ERP "UserSide" для импорта vlan абонента $confImportPppoeLogin - id дополнительного поля ERP "UserSide" для импорта pppoe-логина абонента $confImportPppoePass - id дополнительного поля ERP "UserSide" для импорта pppoe-пароля абонента $confBillingState0 - статус в биллинге "0 - подключен" $confBillingState1 - статус в биллинге "1 - на отключении" $confBillingState2 - статус в биллинге "2 - отключен" $confBillingState3 - статус в биллинге "3 - закрыт" $confBillingState4 - статус в биллинге "4 - приостановлен" $confBillingState5 - статус в биллинге "5 - на подключении" $contractAddString - дополнительная строка для импорта информации о контрактах $confAddFieldPhone - id дополнительного поля с номером телефона в таблице contract_parameter_type_1 $confIsImportAgreementAsLogin - флаг - импортировать номер договора как логинLogin