Документация по АСР «Гидра»
Page tree

Versions Compared

Old Version 13

changes.mady.by.user Денис Шилин

Saved on

compared with

New Version 14

changes.mady.by.user Денис Шилин

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Для отладки процесса формирования выгрузки и самой миграции все работы сначала выполняются итеративно на тестовом экземпляре Гидры:

  1. Формируется выгрузка и выполняется пробная миграция на тестовую Гидру
  2. Выполняется совместная проверка результатов пробной миграции:
    • Сверка совокупных показателей по отчётам;
    • Выборочная сверка отдельных абонентов с исходными данными в старом биллинге;
    • Выявление недостающих биллинговых или технических реквизитов абонентов для интеграций Гидры с внешними системами и управления доступом к услугам.
    • Обнаружение несоответствия настроенных в Гидре тарифных планов и услуг: цен, параметров схем оказания, ассортимента доступных услуги для той или иной группы абонентов.
  3. Устраняется как можно больше расхождений и ошибок данных:
    • Исправляются данные в старом биллинге;
    • Корректируются скрипты формирования выгрузки;
    • Исправляются и дополняются тарифные планы и услуги в основном экземпляре Гидры;
    • Меняются настройки миграции.
  4. Тестовый экземпляр Гидры перезагружается снимком данных с основного, формируется новая выгрузка данных из старого биллинга и процесс повторяется.
  5. Когда результат пробной миграции признаётся качественным и достаточным для запуска в эксплуатацию, процесс повторяется на основном экземпляре Гидры.

Формат данных

Note
  • Каждая таблица выгружается в отдельный CSV-файл, имя которого совпадает с названием таблицы.
  • Для текста используется кодировка UTF-8.
  • Поля (столбцы) разделяются точкой с запятой — ;
  • Значения полей обрамляются двойными кавычками — "
  • В первой строке указываются названия полей таблицы.
  • Символы переноса строк (LF, \n) в значениях полей не допускаются.
    • Если перенос строки в значении необходим (например для комментария в столбце REMARK), он должен быть представлен уникальным символом, например  (знак абзаца).
  • Первичные ключи (поля ID) и внешние ключи (поля *_ID) — натуральные (целые положительные) числа.
  • Каждая таблица выгружается в отдельный CSV-файл, имя которого совпадает с названием таблицы.
  • Все файлы выгрузки упаковываются в ZIP-архив.
    • В архиве должны содержаться только CSV-файлы выгрузки, без директорий и посторонних файлов.
    • В архиве должны присутствовать файлы всех таблиц промежуточной схемы. Необязательность таблиц относится только к их заполнению, но файл с заголовочной строкой должен быть всегда.
  • Для значений с типом Дата и Дата с временем (поля *_DATE кроме BILLING_DATE) допускается два формата:
    • С указанием времени: ДД.ММ.ГГГГ чч:мм:сс (в Oracle — DD.MM.YYYY HH24:MI:SS), например 12.04.1961 09:07:00. Время может быть указано без минут или секунд: отсутствующие данные считаются равными нулю.
    • Без указания времени:ДД.ММ.ГГГГ (в Oracle — DD.MM.YYYY), например 12.04.1961. В таком случае время считается равным полуночи.

...

Таблицы промежуточной схемы данных

Tip

Для понимания взаимосвязей таблиц рекомендуем ознакомиться с ER-диаграммой промежуточной схемы данных.


Note
  • Столбцы ID — это первичные ключи таблиц: их значения должен быть уникальны в пределах таблицы.
  • Столбцы *_ID — это внешние ключи таблиц, ссылки на записи других таблиц. Контролируйте их целостность:
    • В выгрузке не должно быть ссылок на несуществующие записи.
      Например в таблице CONTRACTS не должно быть договоров для отсутствующих в CUSTOMERS абонентов: если отдельный абонент по каким-то причинам исключён из выгрузки, то по нему не должно быть данных в других таблицах.
    • Ссылки в одной записи не должны противоречить друг другу.
      Например в таблице SUBSCRIPTIONS для подписки на услуги обязательно должны быть заполнены ссылки на договор (столбец CONTRACT_ID) и лицевой счёт (столбец ACCOUNT_ID) — эти договор и лицевой счёт должны принадлежать одному абоненту.
Tip

Для понимания взаимосвязей таблиц рекомендуем ознакомиться с ER-диаграммой промежуточной схемы данных.


Info

Обязательные для заполнения таблицы и столбцы в описании отмечены знаком (warning)

Таблицы с столбцы, которые для упрощения выгрузки можно оставить пустыми отмечены знаком (green star)

По договорённости в выгрузку могут быть добавлены дополнительные таблицы и дополнительные столбцы стандартных таблиц.

...

Столбец

Источник значений

Описание

ID


Идентификатор услуги.

NAME


Наименование услуги.

TYPE
Y для тарифных планов, N — для всего остального.
UNIT_IDUNITS.IDИдентификатор единицы измерения для услуг с количеством из таблицы UNITS.
Должна соответствовать единице измерения услуги в номенклатуре Гидры.
Если в номенклатуре единица не задана (прочерк), оставляйте поле пустым.
REMARK
Примечание для правильного выбора соответствия.

...