Новая версия интеграции с СОРМ МФИ Софт согласно докумнетации 2020 года.
{toc}
h2. Про новую версию
h3. Для чего новая версия?
* За 2 года МФИ обновили структуру СОРМ и добавились новые поля
* Предыдущая версия сложна в установке.
h3. Отличия от старой интеграции
# Полностью переписан скрипт выгрузки и принцип интеграции в cron
# Добавлены файлы заголовков
h3. Что не готово
Практический готово, не хватает только отчёта payments
h2. Как развернуть
# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/186286305/sorm3-mfi_202008.tar.gz
tar xzf sorm3-mfi_202008.tar.gz -C /app/asr_billing/cfg/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-mfi/config* - укажите там параметры Вашего FTP. Должно быть что-то вроде этого:
{code}
scrits_dir="/app/asr_billing/cfg/sorm3-mfi/"
sql_dir="/app/asr_billing/cfg/sorm3-mfi/sql_csv"
data_dir="/app/asr_billing/var/sorm3_data"
ftp_ip=10.90.1.185
ftp_login=carbon
ftp_pass=carbon
{code}
h2. Что нужно знать о выгрузках, скриптах и тд
h3. Примечания по архитектуре интеграции
* По-умолчанию автоматический делаются выгрузки:
** раз в сутки: abonents abonent_ident abonent_address abonent_service
** раз в час: undefined_payment
* Если хотите изменить частоту или набор выгрузок - поправьте */app/asr_billing/cfg/sorm3-mfi/etc_host/cron.d/sorm3-mfi-upload.sh* и перезапустите cron
* Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:
{code}/app/asr_billing/cfg/sorm3-mfi/upload.sh ip_gateway ip_plan commutators gateways regions supplementary_service
{code}
h3. Какие выгрузки формируются
- Данные об абонентах
-* ABONENT
-* ABONENT_IDENT
-* ABONENT_SERVICE
-* ABONENT_ADDRESS
- Справочные данные
-* COMMUTATORS
-* GATEWAYS
-* IP_GATEWAY
-* IP_PLAN
-* SUPPLEMENTARY_SERVICE
-* DOC_TYPE
-* PAY_TYPE
-* UNDEFINED_PAYMENT
h3. Как сделать выгрузку вручную
Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:
{code}/app/asr_billing/cfg/sorm3-mfi/upload.sh gateways{code}
Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:
{code:title=Команда}/app/asr_billing/cfg/sorm3-mfi/upload.sh{code}
{code:title=Вывод}
2020-08-05 15:48:58 скрипт запущен
Укажите какие отчёты надо выгружать. Например:
mupload.sh abonents abonent_ident abonent_address abonent_service
Справочники и данные об абонентах, которые можно выгрузить этим скриптом:
abonent_address
abonent_ident
abonents
abonent_service
commutators
gateways
ip_gateway
ip_plan
regions
supplementary_service
undefined_payment
{code}
h2. Как запустить настройку
Запустите скрипт configure.sh:
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}
Если нужно выполнить только какую-то часть, например добавить массово атрибут новым абонентам, укажите это первым агрументом функции, например:
{code}
./configure.sh prepare_references
./configure.sh prepare_abonents
./configure.sh install_cron
./configure.sh install_logrotate
./configure.sh prepare_payment_report
{code}
* prepare_references - добавит реквизит типа документа
* prepare_abonents - добавит реквизит всем абонентам физлицам у кого его ещё нет
* install_cron - добавить задачу в планировщик и перезапустит его
* install_logrotate - настроит ротацию журнала выгрузки в СОРМ
* prepare_payment_report - сделает выгрузку актуального списка платёжных системы *pay_types.csv* и настроит SQL ежечасной выгрузки платежей *undefined_payment.sql*
{toc}
h2. Про новую версию
h3. Для чего новая версия?
* За 2 года МФИ обновили структуру СОРМ и добавились новые поля
* Предыдущая версия сложна в установке.
h3. Отличия от старой интеграции
# Полностью переписан скрипт выгрузки и принцип интеграции в cron
# Добавлены файлы заголовков
h3. Что не готово
Практический готово, не хватает только отчёта payments
h2. Как развернуть
# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/186286305/sorm3-mfi_202008.tar.gz
tar xzf sorm3-mfi_202008.tar.gz -C /app/asr_billing/cfg/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-mfi/config* - укажите там параметры Вашего FTP. Должно быть что-то вроде этого:
{code}
scrits_dir="/app/asr_billing/cfg/sorm3-mfi/"
sql_dir="/app/asr_billing/cfg/sorm3-mfi/sql_csv"
data_dir="/app/asr_billing/var/sorm3_data"
ftp_ip=10.90.1.185
ftp_login=carbon
ftp_pass=carbon
{code}
h2. Что нужно знать о выгрузках, скриптах и тд
h3. Примечания по архитектуре интеграции
* По-умолчанию автоматический делаются выгрузки:
** раз в сутки: abonents abonent_ident abonent_address abonent_service
** раз в час: undefined_payment
* Если хотите изменить частоту или набор выгрузок - поправьте */app/asr_billing/cfg/sorm3-mfi/etc_host/cron.d/sorm3-mfi-upload.sh* и перезапустите cron
* Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:
{code}/app/asr_billing/cfg/sorm3-mfi/upload.sh ip_gateway ip_plan commutators gateways regions supplementary_service
{code}
h3. Какие выгрузки формируются
- Данные об абонентах
-* ABONENT
-* ABONENT_IDENT
-* ABONENT_SERVICE
-* ABONENT_ADDRESS
- Справочные данные
-* COMMUTATORS
-* GATEWAYS
-* IP_GATEWAY
-* IP_PLAN
-* SUPPLEMENTARY_SERVICE
-* DOC_TYPE
-* PAY_TYPE
-* UNDEFINED_PAYMENT
h3. Как сделать выгрузку вручную
Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:
{code}/app/asr_billing/cfg/sorm3-mfi/upload.sh gateways{code}
Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:
{code:title=Команда}/app/asr_billing/cfg/sorm3-mfi/upload.sh{code}
{code:title=Вывод}
2020-08-05 15:48:58 скрипт запущен
Укажите какие отчёты надо выгружать. Например:
mupload.sh abonents abonent_ident abonent_address abonent_service
Справочники и данные об абонентах, которые можно выгрузить этим скриптом:
abonent_address
abonent_ident
abonents
abonent_service
commutators
gateways
ip_gateway
ip_plan
regions
supplementary_service
undefined_payment
{code}
h2. Как запустить настройку
Запустите скрипт configure.sh:
{code}/app/asr_billing/cfg/sorm3-mfi/configure.sh{code}
Если нужно выполнить только какую-то часть, например добавить массово атрибут новым абонентам, укажите это первым агрументом функции, например:
{code}
./configure.sh prepare_references
./configure.sh prepare_abonents
./configure.sh install_cron
./configure.sh install_logrotate
./configure.sh prepare_payment_report
{code}
* prepare_references - добавит реквизит типа документа
* prepare_abonents - добавит реквизит всем абонентам физлицам у кого его ещё нет
* install_cron - добавить задачу в планировщик и перезапустит его
* install_logrotate - настроит ротацию журнала выгрузки в СОРМ
* prepare_payment_report - сделает выгрузку актуального списка платёжных системы *pay_types.csv* и настроит SQL ежечасной выгрузки платежей *undefined_payment.sql*