| Info |
|---|
This article in English Intermediate Schema for Data Migration |
| Table of Contents |
|---|
Общие требования
Миграция из других АСР делается через промежуточный набор таблиц в формате CSV.
...
| Note |
|---|
Для полей с типом «Дата и время» допускается два формата:
Для полей с типом «Дата» допускается только один формат: |
Упрощения и допущения
- Юридические и физические лица находятся в одной таблице и отличаются только по специальному признаку.
- Из реквизитов юридического лица выгружается только его название, остальное требует ручного ввода (таблицу при необходимости можно дополнить полями с реквизитами).
- Текущий объём потреблённых услуг (трафик, минуты) никак не мигрирует, но дата окончания текущего периода мигрирует.
- Особенности оказания услуг (периодичность, пороги, единицы измерения, стоимость и т.д.) не мигрируют, а переносятся вручную и затем сопоставляются.
Выгрузка из старой АСР
| Info |
|---|
К каждой таблице можно добавить поле REM, в которое будут выгружаться полезные текстовые данные. Выгруженные в него данные станут комментарием к соответствующей сущности: абоненту, оборудованию, договору и т. д. |
| Info |
|---|
Первичный ключ в каждой таблице всегда называется ID |
Таблицы сопоставлений, обязательные для выгрузки
В этом разделе указаны таблицы, данные из которых не мигрируются, а служат для сопоставления значений в приложении «Миграция» в мигрируемой системе с состояниями абонентов в Гидре.
...
Примечание: значения сопоставляются со справочником типов документов - удостоверений личности
Необязательные таблицы сопоставлений
При выставлении корректных управляющих значений по умолчанию, таблицы из этого раздела выгружать не обязательно.
...
Примечание: справочник служит для разделения платежей по разным видам (исправление ошибки, наличные, безналичные банк, ОСМП, Visa, Webmoney и тп), тип используется для удобства построения отчётов.
Многофилиальная структура
При наличии многофилиальной структуры используется справочник филиалов, на который ссылаются поля FIRM_ID в таблицах USERS и OP_EQUIP
Таблица FIRMS
ID | ID филиала |
NAME | Наименование филиала |
Сопоставляется с организационной структурой предприятия.
Таблицы с данными для миграции
Данные из следующих таблиц используются при миграции для создания сущностей соответствующего вида.
...
| Поле | Описание | Примечание |
ID | ID операции | |
ACC_ID | ID лицевого счёта | Ссылка на ACCOUNTS.ID |
CONTRACT_ID | ID договора | Ссылка на CONTRACTS.ID |
D_OPER | Дата и время операции (списания) | Должна входить в период списания, указанный в D_BEGIN и D_END |
TARIFF_ID | ID услуги (тарифного плана) | Ссылка на SERVICES.ID |
EQUIP_ID | ID абонентского оборудования | Ссылка на EQUIP.ID |
SUM | Сумма списания, умноженная на 100 | Полная сумма списания, не цена услуги. |
D_BEGIN | Дата и время начала периода списания | |
D_END | Дата и время окончания периода списания | |
USED | Количество, умноженное на 100 | В единицах измерения, указанных для услуги в TARIFF_ID, введенной в Гидре |
Суммы в таблице WRITEOFFS не должны быть отрицательными: только положительные значения и 0. В данную таблицу могут быть выгружены не только списания за прошлые расчётные периоды (выполненные инвойсы), но и сведения о текущих расчётных периодах абонентов (актуальные инвойсы).
Многофилиальная структура
При наличии многофилиальной структуры используется справочник филиалов, на который ссылаются поля FIRM_ID в таблицах USERS и OP_EQUIP
Таблица FIRMS
ID | ID филиала |
NAME | Наименование филиала |
Сопоставляется с организационной структурой предприятия.
Дополнительные таблицы
Множественные комментарии
Поддерживается загрузка множественных комментариев к абонентам и абонентскому оборудованию
...
| ID | Идентификатор |
| EQUIP_ID | Ссылка на EQUIP.ID |
| COMMENT_TYPE_ID | Ссылка на COMMENT_TYPES.ID |
| CL_COMMENT | Текст комментария |
| D_OPER | Дата и время создания |
| D_SIGNAL | Дата и время напоминания |
| D_EXEC | Дата и время выполнения |
...
Структурированные адреса
В процессе миграции некоторые поля разбираются, и данные из них записываются в дополнительные таблицы. В частности, адрес из USERS.ADDR подвергается парсингу и записывается в таблицу PARSED_USER_ADDRESSES. Таким образом, если в биллинге, из которого выгружаются данные, информация об адресе хранится в разобранном виде, то нет нужды писать его в одну строку — можно сразу заполнить таблицу.
Структурированные адреса базовых субъектов учёта
Таблица PARSED_USER_ADDRESSES
| Поле | Описание | Примечание |
USER_ID | Соответствующий ID из таблицы USERS | Ссылка на USERS.ID |
| ADDR_BIND_TYPE_ID | Вид адреса | Ссылка на FACT_ADDR_BIND_TYPES.IDНеобязательное поле. По умолчанию — фактический адрес |
VC_ORIGINAL | Строка с адресом из USERS.ADDR. При ручном заполнении необязательно | |
| VC_DISTRICT | Район федерального уровня (родительский регион населённого пункта) | Тип региона используется фиксированный — Регион с кодом REGION_TYPE_District |
VC_CITY | Название населенного пункта | |
VC_CITY_TYPE | Тип населенного пункта | Краткое наименование типа региона: «г.», «пгт.»... |
VC_STREET | Название улицы | |
VC_STREET_TYPE | Тип улицы | Краткое наименование типа региона: «ул.», «п-т», «пер.»... |
VC_HOUSE | Номер дома | |
VC_BUILDING | Корпус | |
| VC_CONSTRUCT | Строение | |
| VC_OWNERSHIP | Владение | |
VC_ENTRANCE_NO | Номер подъезда | Допустимо только числовое значение |
VC_FLOOR | Номер этажа | Допустимо только числовое значение |
VC_FLAT | Квартира | |
VC_DIS_CODE | Код домофона | |
| VC_CUSTOM_ADDRESS | Нестандартный адрес | |
| VC_REM | Комментарий |
|
Структурированные адреса абонентского оборудования
Таблица PARSED_EQUIP_ADDRESSES
...
| USER_ID | Соответствующий ID из таблицы USERS |
| PHONE_TYPE_ID | Соответствующий ID вида привязки телефона к СУ из таблицы PHONE_TYPES |
| PHONE | Телефон |
| REM | Примечание |
Соответствие выгруженных абонентов существующим в Гидре
Во время повторной миграции может оказаться полезным загрузить состав абонента из выгрузки в состав уже существующего абонента в Гидре. Для этого необходимо заполнить таблицу USER_MAPPINGS
...
| USER_ID | ID выгруженного абонента из таблицы USERS |
| USER_DST_CODE | Код существующего абонента в Гидре |
Сотрудники компании
Часто число сотрудников достаточно велико, и вводить их вручную нецелесообразно. Для этого необходимо добавить сотрудников как абонентов в таблицу USERS, выдать доступ к приложениям с помощью NETSERV (по аналогии с доступом в ЛК) и заполнить следующие таблицы.
...