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

Материал из WiKi - UserSide
(Новая страница: «{{activ}} '''usm_utm5''' - модуль для организации импорта данных из биллинговой системы UTM5 в ERP "UserSid…»)
 
Строка 61: Строка 61:
  $billingDBName      - имя базы данных биллинга
  $billingDBName      - имя базы данных биллинга
   
   
  $confAdrDistrictMode                   - (1 - добавлять к названию улицы название района (только при $zadress = 1), 2 - то переносить название района в название города, 3 - использовать название города из districts.city)
  $confServiceData                   = 2; //0 - Use Service Links, 1 - Use Tariff Links, 2 - Use Service & Tariff Links (old: $zservice_data)
$confDateConnectSrc                    - откуда брать дату подключения абонента к сети (1 - users.registration, 2 - dv_log.start)
  $confIsHideShablonsFromTariffList  = 0; //Flag - Hide Shablons From Tariff List [0|1] (old: $znot_sh_tar)
  $confUserImportExpr                    - факультативное условие для импорта абонентов
  $confServiceDataServiceTypeRestrict = ''; //Import Tariff And Customer Only With This services_data.service_type (old: $zservice_data_type)
$confAddFieldPhone                      - users_pi. - название поля в таблице users_pi с номером телефона (по-умолчанию: phone)
  $confRentId                        = ''; //Id Tariff Rent (It Is Recommended Not To Change) (old: $zabon_id)
  $confAddFieldCellPhone                  - users_pi. - название поля в таблице users_pi с номером мобильного телефона
  $confDontImportTariffWithComment    = ''; //Don`t Import Tariff With Comment ... (old: $znotcom_tar)
$confAddFieldEntrance                  - users_pi. - название поля в таблице users_pi с номером подъезда
  $confMultiplicationTariffFees      = 0; //The Multiplication Factor For Tariff Fees At The Rates (1.20 - 20% VAT, etc.) (old: $zabon_k)
  $confAddFieldFloor                      - users_pi. - название поля в таблице users_pi с номером этажа
$confIsSavePasswordToComment            - флаг - сохранять пароль абонента в заметки
  $confIsCidIp                            - флаг - поле dvlog.CID содержит IP-адрес абонента
$confIsIpAdrOnlyFromDhcpHosts          - флаг - импортировать IP-адрес только из dhcphosts_hosts
$confIsIpAdrSkipFromDhcpHosts          - флаг - не импортировать IP-адреса из dhcphosts_hosts
$confUserStateSrc                      - источник для состояния абонента в биллинге (если пусто - то dm.disable (либо u.disable))
$confWorkState2                        - состояние "Не активизирован" преобразовывать в [0|1|2] (0 - Стоп, 1 - Пауза, 2 - Активен) (по-умолчанию: 0)
  $confWorkState5                        - состояние "Слишком маленький депозит" преобразовывать в [0|1|2] (0 - Стоп, 1 - Пауза, 2 - Активен) (по-умолчанию: 1)
$confIsHideDvLogData                    - флаг - не импортировать данные из таблицы dv_log
$confIsHideIpAdrFromDvCalls            - флаг - не импортировать IP-адрес из таблицы dvcalls
$confIsHideCidFromDvMain                - флаг - не импортировать CID из таблицы "dv_main"
$confUserAccountSrc                    - источник лицеового счета абонента [uid|bill_id] (по-умолчанию: uid)
$confIsImportTags                      - флаг - импортировать абонентские метки (tags)
   
   
  $confImportTaxNumber                    - импортировать налоговый номер абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
  $confIsUseDateConnect              = 0; //0 - Use users.create_date, 1 - Use users.connect_date (old: $zdateinnet_ucd)
  $confTaxNumberField                    - имя поля с налоговым номером из таблицы "users"
$confIsCustomerConnectFix          = 0; //Flag - Fix Info About Customers Connect To Switches (old: $zdop_switch)
  $confImportPassport                    - импортировать паспорт абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
  $confIsImportBankInformation      = 0; //Flag - Is Import The Bank Details Of Customer In The "Comment" (old: $zimport_bank)
  $confPassportField                      - имя поля с паспортом из таблицы "users"
  $confDontImportCustomerFromGroupId = ''; //Don`t Import Customers From Group Id ... (groups.id) (old: $zgrouppass)
  $confImportNasIp                        - импортировать NAS IP-адрес абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
$confImportCustomerOnlyFromGroupId = ''; //Import Customers Only From Group Id ... (groups.id) (old: $zgrouponly)
  $confImportNasPort                      - импортировать NAS порт абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
$confImportCustomerExpr            = ''; //Import Customers Expression (used BEFORE where) (old: $zimport_if)
  $confImportNasName                      - импортировать NAS имя абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
$confImportCustomerExpr2          = ''; //Import Customers Expression (used AFTER where) (old: $zimport_if2)
  $confImportGroup                        - импортировать группу абонента в доп.поля абонента (указать ID доп.поля из tbl_conf_basedopdata.CODE)
  $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

Версия от 19:20, 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                    = 2; //0 - Use Service Links, 1 - Use Tariff Links, 2 - Use Service & Tariff Links (old: $zservice_data)
$confIsHideShablonsFromTariffList   = 0; //Flag - Hide Shablons From Tariff List [0|1] (old: $znot_sh_tar)
$confServiceDataServiceTypeRestrict = ; //Import Tariff And Customer Only With This services_data.service_type (old: $zservice_data_type)
$confRentId                         = ; //Id Tariff Rent (It Is Recommended Not To Change) (old: $zabon_id)
$confDontImportTariffWithComment    = ; //Don`t Import Tariff With Comment ... (old: $znotcom_tar)
$confMultiplicationTariffFees       = 0; //The Multiplication Factor For Tariff Fees At The Rates (1.20 - 20% VAT, etc.) (old: $zabon_k)

$confIsUseDateConnect              = 0; //0 - Use users.create_date, 1 - Use users.connect_date (old: $zdateinnet_ucd)
$confIsCustomerConnectFix          = 0; //Flag - Fix Info About Customers Connect To Switches (old: $zdop_switch)
$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