{toc}
{info}Выгрузка подготовлена только для операторов ШПД.{info}
h2. Как развернуть
# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/157614082/sorm3-signaltec_20211011.tar.gz
mkdir /app/asr_billing/cfg/sorm3-signaltec
tar xzf sorm3-signaltec_20211011.tar.gz -C /app/asr_billing/cfg/sorm3-signaltec/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-signaltec/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-signaltec/config.ini* - укажите там параметры Вашего FTP. Секция FTP в конфигурационном файле должна выглядеть приблизительно так:
{code}
[ftp]
# Данные подключения к FTP
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-signaltec/etc-host/cron.d/sorm3-signaltec-upload.sh* и перезапустите cron
* Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gates_short ip_numbering_plan_short switches_short
{code}
h3. Какие выгрузки формируются
- Данные об абонентах
-* abonents
- Справочные данные
-* ip_numbering_plan
-* payments_complete
-* payments_daily
-* supplement_services
-* switches
-* telcos
-* doc_types
-* gates
-* ip_data_points_long
-* pay_types
h3. Как сделать выгрузку вручную
Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gateways{code}
Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:
{code:title=Команда}/app/asr_billing/cfg/sorm3-signaltec/upload.sh{code}
{code:title=Вывод}
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
{code}
h3. Получение отчётов об выгрузках и ошибках с FTP
Визирь сохраняет отчёты о выгрузках на FTP:
* Файлы с расширением *txt* содержат сводный отчёт: сколько было сделано выгрузок за сутки, сколько удачных, сколько неудачных, какое количество данных в них содержалось
* Файлы с расширением *doc* содержат отчёт по конкретной выгрузке, *если в ней были ошибки*. Если выгрузка был полностью корректной - файла ods не будет. В отчёте будут выделены красным столбцы, в которых обнаружены ошибки. В последней колонке - пояснение, какакая именно ошибка была обнаружена.
Для удобства работы с отчётами добавлен скрипт *error_reports.sh*, он позволяет получить список файлов на FTP и скачать необходимые файлы на сервер биллинга.
Если запустить его без аргументов, Вы получите справку:
{code}
Укажите, что нужно сделать:
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
{code}
{info}Выгрузка подготовлена только для операторов ШПД.{info}
h2. Как развернуть
# Скачайте архив с файлами интеграции и распакуйте в нужной директории:
{code}
yum install -y wget
wget --no-check-certificate https://docs.carbonsoft.ru/download/attachments/157614082/sorm3-signaltec_20211011.tar.gz
mkdir /app/asr_billing/cfg/sorm3-signaltec
tar xzf sorm3-signaltec_20211011.tar.gz -C /app/asr_billing/cfg/sorm3-signaltec/
{code}
# Выполните скрипт настройки, он добавит системный атрибут типам документа (паспорт, загранпаспорт и тд), добавит его всем абонентам, настроит планировщик ОС и ротацию файла журнала
{code}/app/asr_billing/cfg/sorm3-signaltec/configure.sh{code}
# Исправьте файл */app/asr_billing/cfg/sorm3-signaltec/config.ini* - укажите там параметры Вашего FTP. Секция FTP в конфигурационном файле должна выглядеть приблизительно так:
{code}
[ftp]
# Данные подключения к FTP
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-signaltec/etc-host/cron.d/sorm3-signaltec-upload.sh* и перезапустите cron
* Справочники нужно выгружать только при необходимости вручную, передав имена нужных выгрузок. Примерно так:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gates_short ip_numbering_plan_short switches_short
{code}
h3. Какие выгрузки формируются
- Данные об абонентах
-* abonents
- Справочные данные
-* ip_numbering_plan
-* payments_complete
-* payments_daily
-* supplement_services
-* switches
-* telcos
-* doc_types
-* gates
-* ip_data_points_long
-* pay_types
h3. Как сделать выгрузку вручную
Скриптом upload.sh, в качестве параметров через пробел перечислите нужные отчёты для выгрузки, например:
{code}/app/asr_billing/cfg/sorm3-signaltec/upload.sh gateways{code}
Можете запустить без параметров, скрипт напшиет краткую справку и список отчётов которые можно выполнить:
{code:title=Команда}/app/asr_billing/cfg/sorm3-signaltec/upload.sh{code}
{code:title=Вывод}
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
{code}
h3. Получение отчётов об выгрузках и ошибках с FTP
Визирь сохраняет отчёты о выгрузках на FTP:
* Файлы с расширением *txt* содержат сводный отчёт: сколько было сделано выгрузок за сутки, сколько удачных, сколько неудачных, какое количество данных в них содержалось
* Файлы с расширением *doc* содержат отчёт по конкретной выгрузке, *если в ней были ошибки*. Если выгрузка был полностью корректной - файла ods не будет. В отчёте будут выделены красным столбцы, в которых обнаружены ошибки. В последней колонке - пояснение, какакая именно ошибка была обнаружена.
Для удобства работы с отчётами добавлен скрипт *error_reports.sh*, он позволяет получить список файлов на FTP и скачать необходимые файлы на сервер биллинга.
Если запустить его без аргументов, Вы получите справку:
{code}
Укажите, что нужно сделать:
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
{code}