Usm hydra

Материал из WiKi - UserSide

en | ru

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

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

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

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

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

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

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

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

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

usm_hydra.php
usm_hydra.conf.php-example

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

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

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

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

php usm_hydra.php

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

usm_hydra
====================================
 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_hydra.php

Возможно вам потребуется установка дополнительных модулей: https://gist.github.com/hewerthomn/81eea2935051eb2500941a9309bca703

Параметры

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

Также можно использовать стандартные параметры из модуля usm_billing

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

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

$confBillingVersion                - версия биллинга [3|4|5|5.1] (по-умолчанию: 3)
$confIsCustomerWoAgreenentToOld    - флаг - переводить абонентов без номера договора в бывшие абоненты
$confIsImportMacFromEpSessions     - флаг - импортировать MAC-адреса из таблицы EP_SESSIONS (Custom Latera Function)
$confAddressHierarchyTypeIdExpr    - импортировать адресную иерархию только с указанными типами
$confIsImportAddressWithPrefix     - флаг - импортировать адресные объекты с префиксами
$confIsCustomImportCustomerState   - флаг - особый импорт статусов абонентов (частное решение)
$confIsSkipAddressAdditionalPrefix - флаг - импортировать ли префиксы адресных объектов в имени объекта 
$confImportTariffGoodId            - список id типов тарифных пакетов, что будут импортированы
$confHierarchy                     - массив с типами адресной иерархии
$confIsSkipEquipmentAddress        - флаг - не импортировать адреса оборудования
$confImportCustomerRealLogin       - импортировать "User Real Login" в доп.данные UserSide (нужно указать id доп.поля)
$confIsImportHierarchyPrefix       - флаг - импортировать префиксы в адресной иерархии (по-умолчанию импортируются суффиксы)
$confStateWithPositiveBalance      - состояние/статус абонента при положительному балансе ((баланс + кредит) >= 0) (1 - Пауза, 2 - Активен, 3 - Стоп)
$confStateWithNegativeBalance      - состояние/статус абонента при отрицательном балансе ((баланс + кредит) < 0) (1 - Пауза, 2 - Активен, 3 - Стоп)
$confUserExprString                - дополнительная строка с условием импорта абонентов
$confImportCustomerPPPoELogin      - импортировать "User PPPoE Login" в доп.данные UserSide (нужно указать id доп.поля)
$confImportCustomerTaxNumber       - импортировать налоговый номер абонента в в доп.данные UserSide (нужно указать id доп.поля)
$confImportCustomerIdentityNumber  - импортировать номер документа абонента в в доп.данные UserSide (нужно указать id доп.поля)