Версия формата миграции: 2.4.1
Warning |
---|
Данное описание относится к устаревшим версиям Гидры. Актуальное описание: Миграция абонентов в Гидру версии 6.2+ |
Info |
---|
This article in English: Intermediate Schema for Data Migration |
Table of Contents |
---|
Info |
---|
ER-диаграмма таблиц промежуточной схемы доступна по адресу: https://dbdiagram.io/d/5fca9ba19a6c525a03b9da84 |
Общие требования
Миграция из других АСР делается через промежуточный набор таблиц в формате , представленных файлами формата CSV.
- Кодировка UTF-8 ,без BOM
- Разделитель полей — точка с запятой ;
- Экранирование точки с запятой внутри значений не используется
- Значения полей обрамляются двойными кавычками (в "
- В том числе пустые значения, которые представляются пустыми
- кавычками (;"";)
- Экранирование двойных кавычек внутри значений не используется
- В первой строке указываются названия полей таблицы
- Первичные ключи (поля ID) и внешние ключи (поля *_ID) должны быть числовыми
- Все файлы выгрузки должны быть упакованы в ZIP-архив. В архиве должны содержаться только CSV-файлы выгрузки
Пример записи:
"ID";"STATUSUSER_ID";"LOGINACC_NUM";"JURACC_TYPE_ID";"NAMECUR_ID";"ADDRBANK_ID";"PASSPORTBALANCE";"W_PHONECREDIT";"HCREDIT_PHONEEND_DATE";"MBALANCE_PHONEDATE";"EMAIL"
"121001";"1101";"example123456";"01";"Шварценгольд Виктор Робертович";"Москва г, Большой Сергиевский пер.,8,1,2,53,";"";"926,07";"9101234567500";"9031234567";"23.09.2017 23:59:59"
Info |
---|
Пример выгрузки: example_load.zip |
Далее с помощью специального инструмента CSV-файлы загружаются в в
ais_name |
---|
Note |
---|
Для полей с типом «Дата и время» допускается два формата:
Для полей с типом «Дата» допускается только один формат: |
Упрощения и допущения
- Юр. лица и физ. Юридические и физические лица находятся в одной таблице и отличаются только по специальному признаку.
- Из реквизитов юр. юридического лица выгружается только его название, остальное требует ручного ввода (таблицу при необходимости можно дополнить полями с реквизитами).
- Текущий объём потреблённых услуг (трафик, минуты) никак не мигрирует, но дата окончания текущего периода мигрирует.
- Подробности тарифов Особенности оказания услуг (периодичность, пороги, единицы измерения, стоимость и т.д.) не мигрируют, а переносятся вручную и затем сопоставляются.
Выгрузка из старой АСР
...
Info |
---|
К каждой таблице можно добавить поле |
...
REM |
...
, в которое будут выгружаться полезные текстовые данные. |
...
Выгруженные в него данные станут комментарием к соответствующей сущности: абоненту, оборудованию, договору и т. д. |
Info |
---|
Первичный ключ в каждой таблице всегда называется ID |
Таблицы сопоставлений, обязательные для выгрузки
В этом разделе указаны таблицы, данные из которых не мигрируются, а служат для сопоставления значений в приложении «Миграция» в мигрируемой системе с состояниями абонентов в Гидре.
Справочник состояний абонента
Таблица STATUS
Поле | Описание |
---|---|
ID | ID состояния |
NAME | Наименование состояния |
В простейшем случае в справочнике всего два состояния (включен, отключен).
Примечание: значения данного справочника не мигрируют, а служат для сопоставления значений в приложении «Миграция» в мигрируемой системе с состояниями абонентов в Гидре.
Справочник сетевых служб
Таблица NS_LIST
Поле | Описание |
---|---|
ID | ID сетевой службы |
NAME | Название сетевой службы |
Примечание: этот справочник формируется вручную и состоит из перечня сетевых служб, для доступа к которым абоненту нужен логин и пароль : (RADIUS, личный кабинет, телефония, почта и т. п. Значения данного справочника не мигрируют, а сопоставляются.)
Справочник единиц измерения
Таблица UNITS_LIST
Поле | Описание |
---|---|
ID | ID единицы измерения |
NAME | Название единицы измерения |
Примечание: значения сопоставляются со справочником единиц измерения в Гидре.
Справочник услуг и тарифных планов
Таблица SERVICES
Поле | Описание | Примечание |
---|---|---|
ID | ID услуги (тарифного плана) | |
NAME | Наименование услуги (тарифного плана) | |
TYPE | Признак тарифного плана (если Y, то ТП; если N, то услуга) | |
UNIT_ID | ID единицы измерения — ссылка на UNITS_LIST.ID | Должна соответствовать единице измерения в номенклатуре. Если в номенклатуре единица не задана (прочерк), оставляйте поле пустым |
Примечание: значения данного справочника не мигрируют, а сопоставляются с Номенклатурой (записи с TYPE = "Y"
сопоставляются с позициями из группы Все → Пакеты услуг, а с TYPE = "N"
— с позициями из группы Все → Услуги)
Справочник валют
Таблица CURRENCY
Поле | Описание |
---|---|
ID | ID валюты |
NAME | Наименование валюты |
Примечание: значения сопоставляются со справочником единиц измерения в Гидре.
Справочник типов оборудования
Таблица EQUIP_TYPE
Поле | Описание |
---|---|
ID | ID типа |
NAME | Название оборудования |
Например: Dlink 3526
Примечание: значения данного справочника не мигрируют, а сопоставляются с позициями номенклатуры, как правило из раздела Активное оборудование.
Справочник операторского оборудования
Таблица OP_EQUIP
Поле | Описание | Примечание |
---|---|---|
ID | ID оборудования | |
EQUIP_TYPE_ID | ID типа оборудования | Ссылка на EQUIP_TYPE.ID |
CODE | Код оборудования | |
IP | IP-адрес для управления | |
FIRM_ID | ID филиала | Ссылка на FIRMS.ID . Используется только при миграции с учетом многофилиальности |
Примечание: таблица используется для корректных привязок к уже загруженному в систему операторскому оборудованию. При запуске секции миграции операторского оборудования будут проставлены сопоставления исходя из выгруженных данных.
Справочник абонентских групп
Таблица GROUPS
Поле | Описание |
---|---|
ID | ID группы |
NAME | Название группы |
Примечание: значения данного справочника не мигрируют, а сопоставляются со справочником групп. Если в вашей системе нет групп, то имеет смысл всё равно добавить значения в этот справочник и привязать всех абонентов к группам в зависимости от их категории, например, Физические лица, Юридические лица, Сотрудники и т.п.
Справочник банков
Таблица BANKS
Поле | Описание |
---|---|
ID | ID банка |
NAME | Название банка |
Примечание: значения данного справочника не мигрируют, а сопоставляются со справочником банков. Соответственно банки, которые встречаются в выгрузке нужно ввести в Гидру вручную.
Справочник типов счетов
Таблица ACCTACC_TYPES
Поле | Описание |
---|---|
ID | ID типа счета |
NAME | Тип счета |
Примечание: значения данного справочника не мигрируют, а сопоставляются со справочником типов счетов
Справочник
...
Таблица SERVICES
ID | ID услуги (тарифного плана) |
NAME | Наименование услуги (ТП) |
TYPE | Признак тарифного плана (если Y, то ТП; если N, то услуга) |
UNIT_ID | ID единицы измерения* |
Примечание: в этот справочник выгружаются все тарифные планы, и услуги. Значения данного справочника не мигрируют, а сопоставляются с Номенклатурой.
Справочник лицевых счетов
Таблица ACCOUNTS
...
ID
...
ID лицевого счёта
...
USER_ID
...
ID абонента*
...
ACCT_NUM
...
Номер счёта
...
типов удостоверений личности
Таблица AUTH_DOC_TYPES
Поле | Описание |
---|---|
ID | ID типа документа |
NAME | Тип документа |
Примечание: значения сопоставляются со справочником типов документов - удостоверений личности
Справочник типов платежей
Таблица PAYMENT_TYPE
Поле | Описание |
---|---|
ID | ID типа платежа |
NAME | Наименование типа платежа |
VIRTUAL | Флаг. 'Y' если корректировка |
Примечание: справочник служит для разделения платежей по разным видам (исправление ошибки, наличные, безналичные банк, ОСМП, Visa, Webmoney и тп), тип используется для удобства построения отчётов.
Необязательные таблицы сопоставлений
При выставлении корректных управляющих значений по умолчанию, таблицы из этого раздела выгружать не обязательно.
Справочник видов телефонов
Таблица PHONE_TYPES
Поле | Описание |
---|---|
ID | ID вида привязки телефона |
NAME | Вид привязки (Мобильный, Домашний, Рабочий и т. д.) |
Примечание: значения сопоставляются со справочником видов адресов
Справочник видов привязки обычных адресов
Таблица FACT_ADDR_BIND_TYPES
Поле | Описание |
---|---|
ID | ID вида привязки обычного адреса |
NAME | Вид привязки (Фактический, Юридический, Адрес обслуживания и т. д.) |
Примечание: значения сопоставляются со справочником видов адресов
Многофилиальная структура
При наличии многофилиальной структуры используется справочник филиалов, на который ссылаются поля FIRM_ID в таблицах USERS и OP_EQUIP
Таблица FIRMS
Поле | Описание |
---|---|
ID | ID филиала |
NAME | Наименование филиала |
Сопоставляется с организационной структурой предприятия.
Таблицы с данными для миграции
Данные из следующих таблиц используются при миграции для создания сущностей соответствующего вида.
Абоненты и базовые субъекты учёта
Таблица USERS
Поле | Описание | Примечание |
---|---|---|
ID | ID абонента | |
STATUS_ID | ID состояния абонента | Ссылка на STATUS.ID . Базовый СУ всегда создаётся в состоянии Активен |
BASE_ID | ID базового СУ | Ссылка на USERS.ID базового СУ (отдельная запись с отрицательным ID в таблице). Обычно выгружается пустым для автоматического формирования привязок |
LOGIN | Код абонента | Уникальное краткое наименование, идентифицирующее абонента |
JUR | Физическое или юридическое лицо (0 — физическое, 1 — юридическое) | |
NAME | ФИО (физ. лица) / Наименование (юр. лица) | |
ADDR | Фактический адрес в формате | Если каких-то данных нет, то оставляйте пустые запятые, например, Самара г.,Пролетарская ул.,5,,,78,5к234 Номер дома может быть дополнен номером корпуса: Самара г.,Пролетарская ул.,5 корп. 7,,,78,5к234 |
ADDR_REM | Примечание к адресу субъекта | |
AUTH_DOC_TYPE_ID | Тип документа - удостоверения личности | Ссылка на AUTH_DOC_TYPES.ID |
AUTH_DOC_SERIAL | Серия документа | |
AUTH_DOC_NO | Номер документа | |
AUTH_DOC_DATE | Дата выдачи документа | Формат DD.MM.YYYY |
AUTH_DOC_ISSUE | Кем/где выдан | |
D_BIRTH | Дата рождения | Формат DD.MM.YYYY |
BIRTH_PLACE | Место рождения | |
INN | ИНН | |
OPF | Наименование организационно-правовой формы, например: Индивидуальный предприниматель, Общество с ограниченной ответственностью | ОПФ не сопоставляются. По наименованию подбирается запись из базового справочника Организационно-правовые формы предприятий |
W_PHONE | Контактный рабочий телефон | Только цифры, начиная с кода страны, например 78122128506 . Можно указать несколько, разделив запятыми |
H_PHONE | Контактный домашний телефон | Только для физических лиц, у которых в поле JUR указано 0. Можно указать несколько, разделив запятыми |
M_PHONE | Контактный мобильный телефон | Только цифры, начиная с кода страны, например 78122128506 . Можно указать несколько, разделив запятыми |
Контактный email | Только цифры, начиная с кода страны, например 78122128506 . Можно указать несколько, разделив запятыми | |
FIRM_ID | ID филиала | Ссылка на FIRMS.ID . Используется только при миграции с учетом многофилиальности |
Примечание: список атрибутов для личных данных абонента может быть расширен по необходимости.
Счета абонентов и базовых субъектов учёта
Таблица ACCOUNTS
Поле | Описание | Примечание |
---|---|---|
ID | ID лицевого счёта | |
USER_ID | ID абонента | Ссылка на USERS.ID |
ACC_NUM | Номер счёта | |
ACC_TYPE_ID | ID типа счета |
(ЛС, РС итд) | Ссылка на ACC_TYPES.ID |
CUR_ID | ID валюты |
Ссылка на CURRENCY.ID (если в системе только российский рубль, можно не указывать) | ||
BANK_ID | ID банка | Ссылка на BANKS.ID (для лицевых счетов - оставлять пустым) |
BALANCE | Баланс счёта | |
CREDIT |
Кредитный лимит
Текущий кредит абонента | Заполняется, только если кредит нужен. Если нет — оставлять пустым. | |
CREDIT_END_DATE | Дата и время окончания кредитного лимита | Если поле пустое, но в CREDIT указана величина кредита, то кредит будет постоянным |
BALANCE_DATE | Дата |
Привязки абонента к сетевым службам
Таблица NETSERV
ID | ID привязки |
USER_ID | ID абонента* |
NS_ID | ID сетевой службы* |
EQUIP_ID | ID абонентского оборудования* |
LOGIN | Логин |
PASSWORD | Пароль |
PASS_TYPE | Тип шифрования пароля (md5 итд). Оставлять пустым для plaintext |
...
и время расчёта баланса | Нужно учитывать, что все платежи из PAYMENTS, которые пришли позже, чем дата указанная здесь, будут добавляться к балансу указанному в ACCOUNTS.BALANCE. |
Участие абонентов в группах
Таблица GROUPLINK
Поле | Описание | Примечание |
---|---|---|
ID | ID записи об участии | |
USER_ID | ID абонента |
Ссылка на USERS.ID | |
GROUP_ID | ID группы |
Ссылка на GROUPS.ID | |
MAIN | Признак основной группы - 'Y' |
Используется для выделения основной группы при привязке абонента к нескольким группам. |
Основная группа должна быть одна. |
Примечание: если в системе, откуда производится выгрузка, нет понятия групп, то желательно хотя бы разделить всех выгружаемых абонентов на три группы: юридические лица, физические лица и сотрудники. То есть добавьте эти три группы в таблицу GROUPS и укажите к ним привязку (определите кому какую группу добавлять по своим критериям во время выгрузки).
...
Абонентское оборудование
Таблица SUBSCR EQUIP
Поле |
---|
ID подписки
Описание | Примечание |
---|---|
ID | ID |
оборудования | |
USER_ID | ID |
TARIFF_ID
ID услуги (тарифного плана)*
абонента | Ссылка на USERS.ID |
EQUIP_TYPE_ID | ID типа абонентского оборудования |
D_BEGIN
Дата начала подписки, когда абонент выбрал новый тарифный план/услугу для смены
D_END
Дата окончания подписки, оставлять пусто, если это последний выбранный тариф
QUANT
Заказанное количество, умноженное на 100. Для тарифных планов - оставлять пустым.
PAY_DAY
Расчетный день (оставлять пустым для плавающего расчетного дня)
Примечание: выгружаются услуги и тарифный план на следующий период. Если у вас фиксированный расчётный день, привязанный к 1 числу месяца, то выгружайте PAY_DAY = 1 (обычно для юридических лиц).
Операторское оборудование
Таблица OP_EQUIP
ID | ID оборудования |
EQUIP_TYPE_ID | ID типа оборудования* |
GROUP_ID | ID группы* |
CODE | Код оборудования |
IP | IP-адрес для управления |
LOGIN | Логин для управления |
PASSWORD | Пароль |
FIRM_ID | ID филиала* |
Примечание: ID группы можно использовать для привязки оборудования к определённому региону или филиалу. Список атрибутов для оборудования может быть расширен по необходимости (адрес, количество портов и т. д.).
Оконечное оборудование абонентов
Таблица EQUIP
ID | ID оборудования |
USER_ID | ID абонента* |
EQUIP_TYPE_ID | ID типа абонентского оборудования. При пустом значении используется |
OP_EQUIP_ID | ID операторского оборудования* |
OP_EQUIP_PORT | Порт операторского оборудования |
CODE | Код оборудования |
MAC | Физический адрес (MAC) |
IP | IP-адрес |
MASK | Маска IP-адреса |
PHONE | Абонентский телефонный номер в формате E.164 |
ADDR | Адрес обслуживания |
Примечание: поля OP_EQUIP_ID и OP_EQUIP_PORT необходимы для указания привязки абонентского оборудования к операторскому.
Справочник абонентских договоров
Таблица CONTRACTS
ID
ID договора
USER_ID
ID абонента
NUM
Номер договора
Ссылка на Оставлять пустым для компонентов служб с единственным типом спецификации В случае пустого значения для самостоятельного активного оборудования используется тип, задаваемый на форме значений по умолчанию | ||
OP_EQUIP_ID | ID операторского оборудования | Ссылка на OP_EQUIP.ID |
OP_EQUIP_PORT | Номер (код) порта операторского оборудования | |
OP_EQUIP_PORT_TYPE | Код типа порта операторского оборудования | Значение сопоставляется по коду, поскольку архитектурно в системе одинаковые типы портов различного оборудования являются различными сущностями |
NS_ID | ID сетевой службы для управления оборудованием | Ссылка на NS_LIST.ID . Обычно не используется - оставлять пустым |
CODE | Код оборудования | Уникальное краткое наименование, идентифицирующее оборудование |
MAC | Физический адрес (MAC) в формате | Можно указать несколько, разделив запятой |
IP | IPv4 адрес или подсеть (в CIDR-нотации) | Можно указать несколько, разделив запятой |
IP6 | IPv6 подсеть | Можно указать несколько, разделив запятой |
PHONE | Абонентский телефонный номер | Только цифры, начиная с кода страны, например 78122128506 . Можно указать несколько, разделив запятыми |
ADDR | Адрес обслуживания | Адрес выгружается в таком же формате, как USERS.ADDR |
ADDR_REM | Примечание к адресу обслуживания |
Примечание: поля OP_EQUIP_ID, OP_EQUIP_PORT, OP_EQUIP_PORT_TYPE используются для указания привязки абонентского оборудования к операторскому и не являются необходимыми.
Подписки абонентов на сетевые службы и доступы к приложениям
Таблица NETSERV
Поле | Описание | Примечание |
---|---|---|
ID | ID привязки | |
USER_ID | ID абонента | Ссылка на USERS.ID |
NS_ID | ID сетевой службы | Ссылка на NS_LIST.ID |
EQUIP_ID | ID абонентского оборудования | Ссылка на Заполняется только для подписок на службы, в которых должно быть указано оборудование. В строках доступа к приложениям (например Личный кабинет абонента) поле должно быть пустым. |
LOGIN | Логин | Логин должен быть уникален в разрезе сетевой службы |
PASSWORD | Пароль | |
PASS_TYPE | Тип хеширования пароля | Если пароль выгружается открытым текстом, оставлять пустым. Типы шифрования не сопоставляются. Значение из базового справочника «Поддерживаемые типы хэшей паролей» подбирается по совпадению наименования: SSHA1, MD5 и т. д. |
Примечание: в эту таблицу выгружаются логины и пароли на VPN, на личный кабинет, SIP-аккаунт и на другие ресурсы, которые контролирует биллинг. При этом в целях безопасности пароли при тестовых выгрузках нужно заменять на звёздочки или случайные строки. Настоящие пароли будут выгружаться всего один раз, при окончательной миграции.
Договоры на оказание услуг
Таблица CONTRACTS
Поле | Описание | Примечание |
---|---|---|
ID | ID договора | |
USER_ID | ID абонента | Ссылка на USERS.ID |
NUM | Номер договора | |
D_DOC | Дата заключения договора | |
D_BEGIN | Дата начала действия договора | |
D_END | Дата окончания действия договора |
...
Подписки абонентов на услуги
Таблица USERS SUBSCR
Поле | Описание | Примечание |
---|---|---|
ID | ID |
подписки |
ACC_ID | ID |
LOGIN
Код абонента
JUR
Физическое или юридическое лицо (0 — физ. лицо, 1 — юр. лицо)
NAME
ФИО (физ. лица) / Наименование (юр. лица)
ADDR
Домашний адрес. Формат адреса абонента:
<Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира>,<Код домофона>
Если каких-то данных нет, то оставляйте пустые запятые, например, Самара г, Пролетарская ул,5,,,078
PASSPORT
Номер паспорта
PASS_DATE
Дата выдачи паспорта
PASS_ISSUE
Место выдачи паспорта
INN
ИНН
OPF
Организационно-правовая форма, например ИП, ООО
W_PHONE
Рабочий телефон в формате E.164
H_PHONE
Контактный домашний телефон в формате E.164
M_PHONE
Контактный мобильный телефон в формате E.164
Контактный email
FIRM_ID
ID филиала*
...
лицевого счёта | Ссылка на ACCOUNTS.ID | |
CONTRACT_ID | ID договора | Ссылка на CONTRACTS.ID |
TARIFF_ID | ID услуги (тарифного плана) | Ссылка на SERVICES.ID |
EQUIP_ID | ID абонентского оборудования | Ссылка на EQUIP.ID |
D_BEGIN | Дата и время начала подписки | Дата, когда абонент выбрал этот тарифный план или услугу |
D_END | Дата и время окончания подписки | Оставлять пустым, если это последний выбранный тариф |
QUANT | Заказанное количество услуги | В единицах измерения, указанных для услуги SERVICES.UNIT_ID не указана, оставьте пустым |
PAY_DAY | Расчетный день | Для плавающего расчетного дня оставлять пустым |
Примечание: выгружаются услуги и тарифный план на следующий период. Если у вас фиксированный расчётный день, привязанный к 1 числу месяца, то выгружайте PAY_DAY = 1 (обычно для юридических лиц).
Платежи
Таблица PAYMENTS
...
Поле | Описание | Примечание |
---|---|---|
ID | ID операции |
ACC_ID | ID лицевого счёта |
Ссылка на ACCOUNTS.ID | |
BANK_ID | ID банка |
Ссылка на BANKS.ID . Оператор связи должен иметь счет в этом банке | ||
D_OPER | Дата и время операции (платежа) | |
PAYMENT_SUM | Сумма платежа, умноженная на 100 (целое число) | |
PAYMENT_TYPE_ID | Тип платежа |
Типы платежей
Ссылка на PAYMENT_TYPE |
...
ID | ID типа платежа |
NAME | Наименование типа платежа |
VIRTUAL | Флаг. 'Y' если корректировка |
...
.ID . Можно оставлять пустым - будут использоваться типы платежей по умолчанию |
Списания
Таблица WRITEOFFS
Поле | Описание | Примечание |
---|---|---|
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 |
В единицах измерения, указанных для услуги |
Многофилиальная структура
При наличии многофилиальной структуры используется справочник филиалов, на который ссылаются поля FIRM_ID в таблицах USERS и OP_EQUIP
Таблица FIRMS
ID | ID филиала |
NAME | Наименование филиала |
Сопоставляется с организационной структурой предприятия.
Дополнительные таблицы
Если единица измерения |
Суммы в таблице WRITEOFFS не должны быть отрицательными: только положительные значения и 0. В данную таблицу могут быть выгружены не только списания за прошлые расчётные периоды (выполненные инвойсы), но и сведения о текущих расчётных периодах абонентов (актуальные инвойсы).
Дополнительные таблицы
Множественные комментарии
Поддерживается загрузка множественных комментариев к абонентам и абонентскому оборудованию
Таблица COMMENT_TYPES
Поле | Описание |
---|---|
ID | ID типа комментария |
NAME | Наименование комментария |
Сопоставляется со справочником "Типы комментариев"
Таблица USER_COMMENTS
Поле | Описание |
---|---|
ID | Идентификатор |
USER_ID | Ссылка на USERS.ID |
COMMENT_TYPE_ID | Ссылка на COMMENT_TYPES.ID |
CL_COMMENT | Текст комментария |
D_OPER | Дата и время создания |
D_SIGNAL | Дата и время напоминания |
D_EXEC | Дата и время выполнения |
Таблица EQUIP_COMMENTS
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
Структурированные адреса базовых субъектов учёта
Таблица CUSTOMER_STREET_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 | Комментарий |
|
Структурированные адреса абонентского оборудования
Таблица EQUIPMENT_STREET_ADDRESSES
Поле | Описание | Примечание |
---|---|---|
EQUIP_ID | Соответствующий ID из таблицы EQUIP | Ссылка на EQUIP.ID |
ADDR_BIND_TYPE_ID | Вид адреса | Ссылка на FACT_ADDR_BIND_TYPES .ID . Необязательное поле. По умолчанию - адрес обслуживания |
VC_ORIGINAL | Строка с адресом из EQUIP.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 | Код домофона |
Также, парсингу подвергаются другие данные из USERS и записываются в PARSED_USER_INFO. Таким образом, если в биллинге, из которого выгружаются данные, эта информация хранится в разобранном виде, то можно сразу заполнить таблицу.
Таблица PARSED_USER_INFO
USER_ID | Соответствующий ID из таблицы USERS* |
NAME | Имя |
SURNAME | Фамилия |
SECOND NAME | Отчество |
SEX | Пол (M - male, F - female) |
AUTH_DOC_TYPE | Тип документа, удостоверяющего личность |
DOC_NO | Серия |
DOC_SERIES | Номер |
DOC_GIVEN | Кем выдан |
DOC_ADD_CODE | Дополнительный код |
REG_ADDRESS | Адрес регистрации |
CITIZENSHIP | Гражданство |
VC_CUSTOM_ADDRESS | Нестандартный адрес | |
VC_REM | Комментарий |
Телефоны базовых субъектов учёта
Таблица USER_PHONES
Поле | Описание |
---|---|
USER_ID | Соответствующий ID из таблицы USERS |
PHONE_TYPE_ID | Соответствующий ID вида привязки телефона к СУ из таблицы PHONE_TYPES |
PHONE | Телефон |
REM | Примечание |
Соответствие выгруженных абонентов существующим в Гидре
Во время повторной миграции может оказаться полезным загрузить состав абонента из выгрузки в состав уже существующего абонента в Гидре. Для этого необходимо заполнить таблицу USER_MAPPINGS
Таблица USER_MAPPINGS
Поле | Описание |
---|---|
USER_ID | ID выгруженного абонента из таблицы USERS |
USER_DST_CODE | Код существующего абонента в Гидре |
Сотрудники компании
Часто число сотрудников достаточно велико, и вводить их вручную нецелесообразно. Для этого необходимо добавить сотрудников как абонентов в таблицу USERS
, выдать доступ к приложениям с помощью NETSERV
(по аналогии с доступом в ЛК) и заполнить следующие таблицы.
Таблица DEPARTMENTS (Отделы)
Поле | Описание |
---|---|
ID | Идентификатор отдела |
FIRM_ID | Ссылка на фирму из FIRMS.ID |
NAME | Наименование отдела |
Таблица EMPLOYEE_TYPES (типы сотрудников)
Поле | Описание |
---|---|
ID | Идентификатор |
NAME | Наименование |
Таблица EMPLOYEES (сотрудники)
Поле | Описание | Примечание |
---|---|---|
ID | Идентификатор | |
USER_ID | Абонент | Ссылка на USERS.ID |
FIRM_ID | Фирма, сотрудником которой является абонент | Ссылка на FIRMS.ID |
DEPARTMENT_ID | Отдел (может быть использован в Гидре для разграничения прав) | Ссылка на DEPARTMENTS.ID |
EMPLOYEE_TYPE_ID | Тип сотрудника (может быть использован в Гидре для разграничения прав) | Ссылка на EMPLOYEE_TYPES.ID |
NAME_GENITIVE | ФИО в родительном падеже | |
APPOINTMENT | Должность | |
APPOINTMENT_GENITIVE | Должность в родительном падеже | |
ACT_AUTHORITY | Действует на основании | |
TAB_NO | Табельный номер | |
D_BEGIN | Дата принятия на работу | |
D_FIRE | Дата увольнения | |
REM | Комментарий |