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

Материал из WiKi - UserSide
Нет описания правки
 
(не показано 11 промежуточных версий 1 участника)
Строка 1: Строка 1:
[[Usm_nodeny_EN|en]] | [[Usm_nodeny|ru]]
{{activ}}
{{activ}}


Строка 14: Строка 16:


== Информация по установке модуля ==
== Информация по установке модуля ==
'''Убедитесь, что в системе где будет работать модуль присутствует библиотека php_mysqli'''


Архив usm_nodeny.zip содержит файлы
Архив usm_nodeny.zip содержит файлы
Строка 49: Строка 53:


Настройка модуля осуществляется в файле '''usm_nodeny.conf.php'''
Настройка модуля осуществляется в файле '''usm_nodeny.conf.php'''
Также можно использовать стандартные параметры из модуля [[usm_billing#Параметры конфигурации|usm_billing]]


  $usersideUrl        - URL к ERP "UserSide"
  $usersideUrl        - URL к ERP "UserSide"
  $usersideApiKey      - API-ключ ERP "UserSide" ''(Указывается в файле "userside/main/config/config.php")''
  $usersideApiKey      - [[UserSide API Key|API-ключ ERP "UserSide"]]
  $billingId          - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")''
  $billingId          - Номер биллинга в ERP "UserSide" ''("Настройка - Биллинги")''
  $logPath            - Путь для записи логов
  $logPath            - Путь для записи логов
Строка 63: Строка 69:
  $billingDBPort      - номер порта базы данных биллинга
  $billingDBPort      - номер порта базы данных биллинга
   
   
  $confListIgnoreImportCustomerState - перечень статусов абонентов [[(users.cstate)]], с которыми их не импортировать ''(по-умолчанию: 9,14)''
  $confListIgnoreImportCustomerState - перечень статусов абонентов ''(users.cstate)'', с которыми их не импортировать ''(по-умолчанию: 9,14)''
  $confIsDisableImportAlias          - флаг - не импортировать дочерние записи ''(алиасы)''
  $confIsDisableImportAlias          - флаг - не импортировать дочерние записи ''(алиасы)''
  $confPasswordAESDecryptString      - кодовая строка для AES шифрования пароля в биллинге
  $confPasswordAESDecryptString      - кодовая строка для AES шифрования пароля в биллинге
Строка 69: Строка 75:
  $confIdGroupCustomersOnPause      - индекс доп.группы абонентов, которая отведена для "паузы"
  $confIdGroupCustomersOnPause      - индекс доп.группы абонентов, которая отведена для "паузы"
  $confIsSavePasswordToComment      - флаг - сохранять пароль абонента на авторизатор/статистику в поле "доп.данные"
  $confIsSavePasswordToComment      - флаг - сохранять пароль абонента на авторизатор/статистику в поле "доп.данные"
$confImportCustomerExpr            - дополнительная строка импорта абонентов ''(используется ПОСЛЕ where)''
$confIsSwapTrafCounter            - флаг - заменять значения вх./исх. трафика по абонентам между собой
$confIsImportPaidCodeInComment    - флаг - импортировать "персональный платежный код" в комментарии по абоненту
$confFieldDateConnect              - импортировать дату подключения абонента в доп.данные UserSide ''(нужно указать id доп.поля)''
   
   
  $confAddFieldIdCity        - код поля "Населенный пункт" - если есть. 0 - если не используется
  $confAddFieldIdCity        - код поля "Населенный пункт" - если есть. 0 - если не используется
  $confAddFieldIdStreet      - код доп.поля "[02]Улица" в dopfields.id  
  $confAddFieldIdStreet      - код доп.поля "Улица" в dopfields.id  
  $confAddFieldIdHouseNumber - код доп.поля "[03]Дом" в dopfields.id
  $confAddFieldIdHouseNumber - код доп.поля "Дом" в dopfields.id
  $confAddFieldIdHouseBlock  - код доп.поля "[04]Блок" в dopfields.id
  $confAddFieldIdHouseBlock  - код доп.поля "Блок" в dopfields.id
  $confAddFieldIdEntrance    - код доп.поля "[05]Подъезд" в dopfields.id
  $confAddFieldIdEntrance    - код доп.поля "Подъезд" в dopfields.id
  $confAddFieldIdFloor      - код поля "[06]Этаж" в dopfields.id
  $confAddFieldIdFloor      - код поля "Этаж" в dopfields.id
  $confAddFieldIdApartment  - код доп.поля "[07]Квартира" в dopfields.id
  $confAddFieldIdApartment  - код доп.поля "Квартира" в dopfields.id
  $confAddFieldIdMac        - код доп.поля "[10]Мак-адрес" в dopfields.id
  $confAddFieldIdMac        - код доп.поля "Мак-адрес" в dopfields.id
  $confAddFieldIdPhone      - код доп.поля "[10]Телефон" в dopfields.id
  $confAddFieldIdPhone      - код доп.поля "Телефон" в dopfields.id
  $confAddFieldIdPhone2      - код доп.поля "Домашний телефон (Телефон 2)" в dopfields.id
  $confAddFieldIdPhone2      - код доп.поля "Домашний телефон (Телефон 2)" в dopfields.id
   
  $confAddFieldIdEMail      - код доп.поля "E-mail" в dopfields.id
  $confImportCustomerExpr            - дополнительная строка импорта абонентов ''(используется ПОСЛЕ where)''
  $confAddFieldIdRealIp      - код доп.поля "Реальный IP-адрес" в dopfields.id

Текущая версия от 12:56, 26 октября 2023

en | ru

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

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

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

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

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

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

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

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

Убедитесь, что в системе где будет работать модуль присутствует библиотека php_mysqli

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

usm_nodeny.php
usm_nodeny.conf.php-example

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

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

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

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

php usm_nodeny.php

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

usm_nodeny
====================================
 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_nodeny.php

Параметры

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

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

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

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

$confListIgnoreImportCustomerState - перечень статусов абонентов (users.cstate), с которыми их не импортировать (по-умолчанию: 9,14)
$confIsDisableImportAlias          - флаг - не импортировать дочерние записи (алиасы)
$confPasswordAESDecryptString      - кодовая строка для AES шифрования пароля в биллинге
$confIdGroupDeleteCustomers        - индекс доп.группы абонентов, которая отведена для "удаленных абонентов". Абоненты этой группы не импортируются
$confIdGroupCustomersOnPause       - индекс доп.группы абонентов, которая отведена для "паузы"
$confIsSavePasswordToComment       - флаг - сохранять пароль абонента на авторизатор/статистику в поле "доп.данные"
$confImportCustomerExpr            - дополнительная строка импорта абонентов (используется ПОСЛЕ where)
$confIsSwapTrafCounter             - флаг - заменять значения вх./исх. трафика по абонентам между собой
$confIsImportPaidCodeInComment     - флаг - импортировать "персональный платежный код" в комментарии по абоненту
$confFieldDateConnect              - импортировать дату подключения абонента в доп.данные UserSide (нужно указать id доп.поля)

$confAddFieldIdCity        - код поля "Населенный пункт" - если есть. 0 - если не используется
$confAddFieldIdStreet      - код доп.поля "Улица" в dopfields.id 
$confAddFieldIdHouseNumber - код доп.поля "Дом" в dopfields.id
$confAddFieldIdHouseBlock  - код доп.поля "Блок" в dopfields.id
$confAddFieldIdEntrance    - код доп.поля "Подъезд" в dopfields.id
$confAddFieldIdFloor       - код поля "Этаж" в dopfields.id
$confAddFieldIdApartment   - код доп.поля "Квартира" в dopfields.id
$confAddFieldIdMac         - код доп.поля "Мак-адрес" в dopfields.id
$confAddFieldIdPhone       - код доп.поля "Телефон" в dopfields.id
$confAddFieldIdPhone2      - код доп.поля "Домашний телефон (Телефон 2)" в dopfields.id
$confAddFieldIdEMail       - код доп.поля "E-mail" в dopfields.id
$confAddFieldIdRealIp      - код доп.поля "Реальный IP-адрес" в dopfields.id