Просмотр кода страницы Usm abills UK

[[Usm_abills_EN|en]] | '''uk''' | [[Usm_abills|ru]]

{{activ}}

'''usm_abills''' - модуль для організації імпорту даних із білінгової системи ABillS в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_abills_UK|us_abills]]''' - див.: [[Переход_с_us_abills_на_usm_abills_UK|Перехід з us_abills на usm_abills]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.eu/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[ABillS_UK|ABillS]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_abills.zip містить файли:

 usm_abills.php
 usm_abills.conf.php-example

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

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

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

4. Кілька разів запустіть модуль вручну командою:

 php usm_abills.php

Він має відпрацювати без помилок і повернути дані.

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

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(вкажіть потрібні шляхи)'':

 */10 * * * * php usm_abills.php

== Параметри конфігурації ==

Налаштування модуля виконується у файлі '''usm_abills.conf.php'''.

Також можна використовувати стандартні параметри з модуля [[usm_billing_UK#Параметри_конфігурації|usm_billing]].

 $usersideUrl                         - URL до ERP "UserSide"
 $usersideApiKey                      - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
 $billingId                           - номер білінгу в ERP "UserSide" ''("Налаштування - Білінги")''
 $logPath                             - шлях для запису логів
 $isSilence                           - прапорець "режим тиші" ''(приховати виведення інформаційних повідомлень модуля в консоль)''

 $billingDBHost                       - адреса сервера білінгу
 $billingDBPort                       - порт mysql-підключення до бази білінгу
 $billingDBUser                       - ім'я користувача для доступу до бази білінгу
 $billingDBPassword                   - пароль для доступу до бази білінгу
 $billingDBName                       - ім'я бази даних білінгу

 $confAdrDistrictMode                 - режим обробки району в адресі
 $confAddressListCityIds              - список ID населених пунктів
 $confDateConnectSrc                  - джерело дати підключення абонента до мережі
 $confUserImportExpr                  - додаткова умова для імпорту абонентів
 $confAddFieldPhone                   - поле таблиці users_pi з номером телефону
 $confAddFieldCellPhone               - поле таблиці users_pi з номером мобільного телефону
 $confAddFieldEntrance                - поле таблиці users_pi з номером під'їзду
 $confAddFieldFloor                   - поле таблиці users_pi з номером поверху
 $confIsSavePasswordToComment         - зберігати пароль абонента в примітках
 $confIsCidIp                         - поле dv/internet_log.CID містить IP-адресу абонента
 $confIsIpAdrOnlyFromDhcpHosts        - імпортувати IP-адресу тільки з dhcphosts_hosts
 $confIsIpAdrSkipFromDhcpHosts        - не імпортувати IP-адреси з dhcphosts_hosts
 $confUserStateSrc                    - джерело стану абонента в білінгу
 $confWorkState2                      - перетворення стану "Не активізований" у статус ERP
 $confWorkState5                      - перетворення стану "Занадто малий депозит" у статус ERP
 $confIsHideDvLogData                 - не імпортувати дані з таблиці dv/internet_log
 $confIsHideIpAdrFromDvCalls          - не імпортувати IP-адресу з таблиці dv/internet_calls
 $confIsHideCidFromDvMain             - не імпортувати CID з таблиці dv/internet_main
 $confUserAccountSrc                  - джерело особового рахунку абонента
 $confIsImportTags                    - імпортувати абонентські позначки (tags)
 $confAddressSrc                      - джерело інформації про адресу абонента
 $confIsImportMsg                     - імпортувати повідомлення абонентів
 $confPasswordSecretKey               - Secret Key для розшифрування паролів абонентів
 $confIsImportPasswordToUsPassword    - імпортувати пароль абонента в пароль UserSide
 $confIsImportOnlyUsedAddress         - імпортувати тільки використовувані адреси
 $confIsPrimaryDvModule               - використовувати тільки інформацію модуля DV
 $confWorkStateArray                  - масив відповідності ID статусів абонента в білінгу та в ERP
 $confImportCustomerTaxNumber         - імпортувати податковий номер абонента в додаткові поля
 $confTaxNumberField                  - поле з податковим номером у таблиці users
 $confImportCustomerPassport          - імпортувати паспорт абонента в додаткові поля
 $confPassportField                   - поле з паспортом у таблиці users
 $confImportCustomerNasIp             - імпортувати NAS IP-адресу абонента в додаткові поля
 $confImportCustomerNasPort           - імпортувати NAS-порт абонента в додаткові поля
 $confImportCustomerNasName           - імпортувати NAS-ім'я абонента в додаткові поля
 $confImportCustomerNasVlan           - імпортувати NAS VLAN абонента в додаткові поля
 $confImportCustomerGroup             - імпортувати групу абонента в додаткові поля
 $confContactTypeIdPhone              - Type Id для імпорту телефонного номера
 $confContactTypeIdCellPhone          - Type Id для імпорту мобільного номера
 $confAddFieldPhone1                  - поле з додатковим телефоном N1
 $confAddFieldPhone2                  - поле з додатковим телефоном N2
 $confIsImportTriplePay               - імпортувати тарифи Triple Pay
 $confTariffIdSrcField                - поле з id у таблиці тарифів

== Запуск у Docker-оточенні ==

Якщо ви використовуєте USERSIDE в Docker-оточенні, зовнішні модулі usm зручно запускати в окремих Docker-контейнерах.

Docker-оточення для запуску модуля usm_abills доступне за посиланням: https://github.com/userside/usm_abills-docker-env/releases