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

Материал из WiKi - UserSide
Строка 61: Строка 61:
  $billingDBName      - имя базы данных биллинга
  $billingDBName      - имя базы данных биллинга
   
   
  $confServiceData                    = 2; //0 - Use Service Links, 1 - Use Tariff Links, 2 - Use Service & Tariff Links (old: $zservice_data)
  $confServiceData                    - использовать сервисные связки вместо тарифных (0 - сервисные связки, 1 - тарифные связки, 2 - и то и другое)
  $confIsHideShablonsFromTariffList  = 0; //Flag - Hide Shablons From Tariff List [0|1] (old: $znot_sh_tar)
  $confIsHideShablonsFromTariffList  - флаг - не включать шаблоны в импорт тарифов
  $confServiceDataServiceTypeRestrict = ''; //Import Tariff And Customer Only With This services_data.service_type (old: $zservice_data_type)
  $confServiceDataServiceTypeRestrict - импортировать тарифы (и абонентов) с таким services_data.service_type
  $confRentId                        = ''; //Id Tariff Rent (It Is Recommended Not To Change) (old: $zabon_id)
  $confRentId                        - ID поля с абонентской платой для тарифа (services_data.service_type в биллинге)
  $confDontImportTariffWithComment    = ''; //Don`t Import Tariff With Comment ... (old: $znotcom_tar)
  $confDontImportTariffWithComment    - НЕ импортировать тарифы с таким комментарием
  $confMultiplicationTariffFees      = 0; //The Multiplication Factor For Tariff Fees At The Rates (1.20 - 20% VAT, etc.) (old: $zabon_k)
  $confMultiplicationTariffFees      - коэффициент умножения для абонентской платы в тарифах (1.20 - 20% НДС и т.п.)
   
   
  $confIsUseDateConnect             = 0; //0 - Use users.create_date, 1 - Use users.connect_date (old: $zdateinnet_ucd)
  $confIsUseDateConnect               - использовать поле users.connect_date для получения даты подключения к сети (0 - users.create_date, 1 - users.connect_date)
  $confIsCustomerConnectFix         = 0; //Flag - Fix Info About Customers Connect To Switches (old: $zdop_switch)
  $confIsCustomerConnectFix           - флаг - дописывать в доп.данные информацию о привязке абонентов к коммутаторам
  $confIsImportBankInformation      = 0; //Flag - Is Import The Bank Details Of Customer In The "Comment" (old: $zimport_bank)
  $confIsImportBankInformation      = 0; //Flag - Is Import The Bank Details Of Customer In The "Comment" (old: $zimport_bank)
  $confDontImportCustomerFromGroupId = ''; //Don`t Import Customers From Group Id ... (groups.id) (old: $zgrouppass)
  $confDontImportCustomerFromGroupId = ''; //Don`t Import Customers From Group Id ... (groups.id) (old: $zgrouppass)

Версия от 19:22, 8 июня 2016

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

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

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

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

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

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

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

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

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

usm_utm5.php
usm_utm5.conf.php-example

1. Выделить отдельный (произвольный) каталог для модуля и поместить в него эти файлы

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

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

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

php usm_utm5.php

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

usm_utm5
====================================
 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_utm5.php

Параметры конфигурации

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

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

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

$confServiceData                    - использовать сервисные связки вместо тарифных (0 - сервисные связки, 1 - тарифные связки, 2 - и то и другое)
$confIsHideShablonsFromTariffList   - флаг - не включать шаблоны в импорт тарифов
$confServiceDataServiceTypeRestrict - импортировать тарифы (и абонентов) с таким services_data.service_type
$confRentId                         - ID поля с абонентской платой для тарифа (services_data.service_type в биллинге)
$confDontImportTariffWithComment    - НЕ импортировать тарифы с таким комментарием
$confMultiplicationTariffFees       - коэффициент умножения для абонентской платы в тарифах (1.20 - 20% НДС и т.п.)

$confIsUseDateConnect               - использовать поле users.connect_date для получения даты подключения к сети (0 - users.create_date, 1 - users.connect_date)
$confIsCustomerConnectFix           - флаг - дописывать в доп.данные информацию о привязке абонентов к коммутаторам
$confIsImportBankInformation       = 0; //Flag - Is Import The Bank Details Of Customer In The "Comment" (old: $zimport_bank)
$confDontImportCustomerFromGroupId = ; //Don`t Import Customers From Group Id ... (groups.id) (old: $zgrouppass)
$confImportCustomerOnlyFromGroupId = ; //Import Customers Only From Group Id ... (groups.id) (old: $zgrouponly)
$confImportCustomerExpr            = ; //Import Customers Expression (used BEFORE where) (old: $zimport_if)
$confImportCustomerExpr2           = ; //Import Customers Expression (used AFTER where) (old: $zimport_if2)
$confTrafficRxClass                = '10'; //Traffic RX Class (old: $zintraf_1)
$confTrafficTxClass                = '20'; //Traffic TX Class (old: $zouttraf_1)
$confUseIpMethod                   = 1; //2 - Ip From "ip_groups.allowed_cid" (old: $zvariant)
$confIsUseDhcpData                 = 0; //Flag - Load DHCP-Data from "dhs_sessions_log" (old: $z_dhcp_use)
$confDhcpServiceLinkId             = 3; //Service Link Id "dhs_sessions_log.Acct_Status_Type" (default: 3) (old: $zacct_status_type)
$confIsHostByteOrder               = 0; //Flag - Is Host Byte Order In "dhs_sessions_log.Framed_IP_Address" (actual for UTM >= 5.3 update 3) (old: $zframedip_order)
$confIsActiveAllDhcp               = 0; //Flag - Is Update Active Time For All DHCP Session (old: $zact_dhs_sessions)
$confIsDhcpLeasesLogUse            = 0; //Flag - Is Use Data From "dhcp_leases_log" (default: $z_dhcp_leases)
$confIsBlockType1IsPause           = 0; //Flag - Is "block_info.block_type" = 1 Is Pause (old: $zbib1_pause)
$confIsBlockType2IsStop            = 0; //Flag - Is "block_info.block_type" = 2 Is Stop (old: $zbib2_stop)
$confIsUseIdToAgreement            = 0; //Flag - Is Use UserId To Agreement Number (old: $zidtodog)
$confIsSavePasswordToComment       = 0; //Flag - Is Save UserPassword To Comment (old: $zpass_give)
$confIsImportPaidHistory           = 0; //Flag - Is Import Paid History (old: $zimport_paid)

$confIpGrayNet                    = ; //"Gray" IP-Net (example: "172.16.0.0") (old: $z_ip_check)
$confIpWhiteNet                   = ; //"White" IP-Net (example: "77.0.0.0") (old: $z_ip_write)

$additionalDataMerge[1] = 1; // [utm5.uaddparams_desc.paramid] = userside.id
$additionalDataMerge[2] = 2; // [utm5.uaddparams_desc.paramid] = userside.id