Usm bgbilling: различия между версиями

Текущая версия от 07:02, 28 сентября 2023

en | ru

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

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

@@ Строка 1: / Строка 1: @@
+[[Usm_bgbilling_EN|en]] | [[Usm_bgbilling|ru]]
 {{activ}}
-'''US_BGBILLING''' - модуль для организации импорта данных из биллинговой системы BGBilling в ERP "UserSide"
+'''usm_bgbilling''' - модуль для организации импорта данных из биллинговой системы BGBilling в ERP "UserSide"
-'''Данный модуль является заменой устаревшему модулю [[us_bgbilling]]'''
+'''Данный модуль является заменой устаревшему модулю [[us_bgbilling]]''' - См.: [[Переход с us bgbilling на usm bgbilling]]
+'''Язык модуля:''' PHP
-'''Язык модуля:''' Perl
 '''Текущая версия:''' см. на странице: [[Модули]]
@@ Строка 12: / Строка 13: @@
 '''Статус модуля:''' [http://userside.ua/price.php Платный]
-Необходимые модули Perl:
+Дополнительную информацию и перечень импортируемых данных см. на странице: [[BGBilling]]
-  DBI
-  Socket
+== Информация по установке модуля ==
-  Time::Local
-  FindBin
+'''Убедитесь, что в системе где будет работать модуль присутствует библиотека php_mysqli'''
+Архив usm_bgbilling.zip содержит файлы
+  usm_bgbilling.php
+  usm_bgbilling.conf.php-example
+. На любом сервере ''(без разницы - сервер биллинга, userside или третья машина)'' выделить отдельный ''(произвольный)'' каталог для модуля и поместить в него эти файлы
+. Выделить отдельный каталог для логов работы модуля. Дайте права на запись в этот каталог.
+. Пример файла конфигурации usm_bgbilling.conf.php-example следует переименовать в usm_bgbilling.conf.php и внести в нём требуемые изменения ''(перечень параметров указан ниже)''
+. Запустите несколько раз (*) вручную модуль командой
+ php usm_bgbilling.php
+Он должен отработать без ошибок и вернуть данные:
+ usm_bgbilling
+ ====================================
+  Start module at 2015-11-22 17:32:03
+  Finish module at 2015-11-22 17:32:14
+  ====================================
-Дополнительную информацию и перечень импортируемых данных см. на странице: [[BGBilling]]
+''* - При первом запуске - будут предварительно лишь созданы многие объекты. Чем больше объектов импортирует модуль - тем дольше это будет. При втором и последующих запусках сверяются изменённые данные и только они будут обновлены. Второй запуск также будет длиться долго, т.к. после первого запуска новосозданные объекты практические не содержат данных. А вот третий и последующие запуски будут работать гораздо быстрее.''
-'''Информацию по установке модуля''' и общую информацию для всех модулей см. на странице: [[Модули]]
+. Проверьте визуально полноту импортируемых данных в ERP "UserSide"
+. Когда станет понятно, что модуль работает стабильно - добавляем его в системный cron на периодическую работу ''(укажите нужные пути)''
+ */10 * * * * php usm_bgbilling.php
 == Параметры ==
-Настройка модуля осуществляется в файле '''us_config.tmp'''
+Настройка модуля осуществляется в файле '''usm_bgbilling.conf.php'''
- $znserver - адрес сервера биллинга
+Также можно использовать стандартные параметры из модуля [[usm_billing#Параметры конфигурации|usm_billing]]
- $znbase - имя базы данных биллинга
-  $znuser - имя пользователя для доступа к базе биллинга
+  $usersideUrl         - URL к ERP "UserSide"
- $znpass - пароль для доступа к базе биллинга
+  $usersideApiKey      - [[UserSide API Key|API-ключ ERP "UserSide"]]
- $zncp - кодировка базы биллинга
+  $billingId           - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")''
- $zuserver - адрес сервера с UserSide
+  $logPath             - Путь для записи логов
-  $zubase - имя базы данных UserSide
+  $isSilence           - Флаг "Режим тишины" ''(скрыть вывод информационных сообщений от модуля в консоль)''
- $zuuser - имя пользователя для доступа к базе UserSide
-  $zupass - пароль для доступа к базе UserSide
- $zucp - кодировка базы UserSide
- $zusqlport - порт подключения к базе данных ''(по-умолчанию 3306)''
-  $ps_logpath - путь к логам модуля
-  $zbillcode - [[Настройка - Биллинги|номер биллинга]] по версии САП "UserSide"
- $zsilence - не выводить уведомления о работе модуля в консоль
-  $z_inetmodule_no - номер модуля inet
+  $billingDBHost       - адрес сервера биллинга
-  $z_dialupmodule_no - номер модуля dialup
+ $billingDBUser       - имя пользователя для доступа к базе биллинга
-  $z_ipnmodule_no - номер модуля ipn
+ $billingDBPassword   - пароль для доступа к базе биллинга
-  $zimport_if - условие для импорта абонентов. Даёт возможность импорта только части абонентов из биллинга ''(выполняется до WHERE)''
+ $billingDBName       - имя базы данных биллинга
-  $zimport_if2 - условие для импорта абонентов. Даёт возможность импорта только части абонентов из биллинга ''(выполняется после WHERE)''
+ $billingCodePage     - кодировка базы данных биллинга
-  $z_wo_tarif_otkl - абонентов без тарифа отмечать как отключенных
+ $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 - подключен"
@@ Строка 54: / Строка 90: @@
   $confBillingState4 - статус в биллинге "4 - приостановлен"
   $confBillingState5 - статус в биллинге "5 - на подключении"
+ $contractAddString - дополнительная строка для импорта информации о контрактах
+ $confAddFieldPhone - id дополнительного поля с номером телефона в таблице contract_parameter_type_1
+ $confIsImportAgreementAsLogin - флаг - импортировать номер договора как логинLogin