Usm abills UK

Материал из WiKi - UserSide
Версия от 10:27, 18 мая 2026; IronBot (обсуждение | вклад) ([IronBot] Create UK localization from RU)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

en | uk | ru

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

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

Цей модуль є заміною застарілого модуля us_abills - див.: Перехід з us_abills на usm_abills

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

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

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

Додаткову інформацію та перелік імпортованих даних див. на сторінці: 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.

$usersideUrl                         - URL до ERP "UserSide"
$usersideApiKey                      - 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