... {toc} {info}Выгрузка подготовлена только для операторов ШПД.{info} h2. Как развернуть # Скачайте архив с файлами интеграции и распакуйте в нужной директории: {code} 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/ {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 -* services -* supplement_services -* switches -* telcos -* doc_types -* gates -* ip_data_points_long -* pay_types h3. Какие не формируются и почему -* ip_data_points - в биллинге не хранятся данные по точкам подключения трафика. -* termination_causes - в биллинге не хранятся данные о причинах завершения соединений Эти справочники Вы можете сформировать и загрузить на FTP вручную. Обязательно обсудите с поддержкой Сигналтек. 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 22:42:22 скрипт запущен Укажите какие отчёты надо выгружать. Например: upload.sh abonent abonent_ident abonent_address abonent_service Справочники и данные об абонентах, которые можно выгрузить этим скриптом: abonents ip_numbering_plan_short payments_short_complete payments_short_daily services supplement_services switches_short telcos_short doc_types_short gates_short 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 - скачать выбранный файл Например: ./error_reports.sh list ./error_reports.sh download abonents_2021_10_07_10_25.csv.invalid.ods
|
h4. Выгрузки проходят с ошибками, что делать? # Скачайте отчёты на компьютер и откройте в Excel или LibreOffice Calc. # В каждой строке красным отмечены поля, в которых обнаружены ошибки. В последней колонке написано, что эти ошибки значат. # Обычно, они достаточно говорящие, например если абоненту или платежу не завели какие-то обязательные данные. # Исправьте ошибки - заведите данные или адаптируйте SQL-запросы под особенности Вашей выгрузки (например, каких-то абонентов выгружать не нужно, т.к. они служебные, или какие-то данные Вы храните в другом формате или реквизите, чаще всего это адреса и паспортные данные) # Повторите выгрузку вручную скриптом *upload.sh*
|