СОРМ3 Сигналтек Визирь

Выгрузка подготовлена только для операторов ШПД.

Как развернуть

1. Скачайте архив с файлами интеграции и распакуйте в нужной директории:

   yum install -y wget 
   wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/157614082/sorm3-signaltec_20211014.tar.gz
   mkdir /app/asr_billing/cfg/sorm3-signaltec
   tar xzf sorm3-signaltec_20211014.tar.gz -C /app/asr_billing/cfg/sorm3-signaltec/
   

2. Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала

   /app/asr_billing/cfg/sorm3-signaltec/configure.sh

3. Исправьте файл /app/asr_billing/cfg/sorm3-signaltec/config.ini - укажите там параметры Вашего FTP. Секция FTP в конфигурационном файле должна выглядеть приблизительно так:

   [ftp]
   # Данные подключения к FTP 
   ftp_ip=10.90.1.185
   ftp_login=carbon
   ftp_pass=carbon
   

Что нужно знать о выгрузках, скриптах и тд

Что нужно знать о выгрузках, скриптах и тд

Примечания по архитектуре интеграции

• По-умолчанию автоматический делаются выгрузки:
  • раз в сутки: abonents abonent_ident abonent_address abonent_service
  • раз в час: undefined_payment
• Если хотите изменить частоту или набор выгрузок - поправьте /app/asr_billing/cfg/sorm3-signaltec/etc-host/cron.d/sorm3-signaltec-upload.sh и перезапустите cron
• Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:

  /app/asr_billing/cfg/sorm3-signaltec/upload.sh gates_short ip_numbering_plan_short switches_short
  

Какие выгрузки формируются

• Данные об абонентах
  • abonents
• Справочные данные
  • ip_numbering_plan
  • payments_complete
  • payments_daily
  • supplement_services
  • switches
  • telcos
  • doc_types
  • gates
  • ip_data_points_long
  • pay_types

Как сделать выгрузку вручную

Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:

/app/asr_billing/cfg/sorm3-signaltec/upload.sh gateways

Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:

/app/asr_billing/cfg/sorm3-signaltec/upload.sh

2021-10-06 12:46:06 скрипт запущен

Укажите какие отчёты надо выгружать. Например:

  upload.sh abonent abonent_ident abonent_address abonent_service

Справочники и данные об абонентах, которые можно выгрузить этим скриптом:

  abonents
  ip_numbering_plan
  payments_complete
  payments_daily
  supplement_services
  switches
  telcos
  doc_types
  gates
  ip_data_points_long
  pay_types


Ещё скрипт можно запустить с дебагом, тогда файлы будут созданы, но без выгрузки на FTP. Например:

  upload.sh abonent --debug

Получение отчётов об выгрузках и ошибках с FTP

Визирь сохраняет отчёты о выгрузках на FTP:

• Файлы с расширением txt содержат сводный отчёт: сколько было сделано выгрузок за сутки, сколько удачных, сколько неудачных, какое количество данных в них содержалось
• Файлы с расширением doc содержат отчёт по конкретной выгрузке, если в ней были ошибки. Если выгрузка был полностью корректной - файла ods не будет. В отчёте будут выделены красным столбцы, в которых обнаружены ошибки. В последней колонке - пояснение, какакая именно ошибка была обнаружена.

Для удобства работы с отчётами добавлен скрипт error_reports.sh, он позволяет получить список файлов на FTP и скачать необходимые файлы на сервер биллинга.
Если запустить его без аргументов, Вы получите справку:

Укажите, что нужно сделать:

   list - получить список файлов с ошибками за сегодня
   list all - файлы с ошибками за всё время
   list dd.mm.yyyy - файлы с ошибками за выбранную дату ДД.ММ.ГГГГ
   download - скачать самый последний файл в папке с отчётами об ошибках
   download file - скачать выбранный файл


Например:

  /app/asr_billing/cfg/sorm3-signaltec/error_reports.sh list
  /app/asr_billing/cfg/sorm3-signaltec/error_reports.sh download abonents_20211007_1025.csv.invalid.ods