Usm utm5
 |
Эта функция является одной из возможностью |
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