...
ID | ID вида привязки телефона |
NAME | Вид привязки (Мобильный, Домашний, Рабочий итди т. д.) |
Примечание: значения сопоставляются со справочником видов адресов
...
Примечание: значения сопоставляются со справочником видов адресов
...
Справочник типов платежей
Таблица PAYMENT_TYPE
ID | ID типа платежа |
NAME | Наименование типа платежа |
VIRTUAL | Флаг. 'Y' если корректировка |
...
Данные из следующих таблиц используются при миграции для создания сущностей соответствующего вида.
...
Абоненты и базовые субъекты учёта
Таблица USERS
Поле | Описание | Примечание |
ID | ID абонента | |
STATUS_ID | ID состояния абонента | Ссылка на STATUS.ID . Базовый СУ всегда создаётся в состоянии Активен |
BASE_ID | ID базового СУ | Ссылка на USERS.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 | Рабочий телефон в формате E.164 | Можно указать несколько, разделив запятыми |
H_PHONE | Контактный домашний телефон в формате E.164 | Только для физических лиц, у которых в поле JUR указано 0. Можно указать несколько, разделив запятыми |
M_PHONE | Контактный мобильный телефон в формате E.164 | Можно указать несколько, разделив запятыми |
Контактный email | ||
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 | Дата и время расчёта баланса | Нужно учитывать, что все платежи из PAYMENTS, которые пришли позже, чем дата указанная здесь, будут добавляться к балансу указанному в ACCOUNTS.BALANCE. |
Привязки
...
абонентов к сетевым службам
Таблица NETSERV
Поле | Описание | Примечание |
ID | ID привязки | |
USER_ID | ID абонента | Ссылка на USERS.ID |
NS_ID | ID сетевой службы | Ссылка на NS_LIST.ID |
EQUIP_ID | ID абонентского оборудования | Ссылка на Заполняется только для подписок на службы, в которых должно быть указано оборудование. В строках доступа к приложениям (например Личный кабинет абонента) поле должно быть пустым. |
LOGIN | Логин | Логин должен быть уникален в разрезе сетевой службы |
PASSWORD | Пароль | |
PASS_TYPE | Тип хеширования пароля (SSHA1, MD5 итд). Оставлять пустым для plaintext | Типы шифрования не сопоставляются. Значение из базового справочника «Поддерживаемые типы хэшей паролей» подбирается по совпадению наименования |
...
Примечание: если в системе, откуда производится выгрузка, нет понятия групп, то желательно хотя бы разделить всех выгружаемых абонентов на три группы: юридические лица, физические лица и сотрудники. То есть добавьте эти три группы в таблицу GROUPS и укажите к ним привязку (определите кому какую группу добавлять по своим критериям во время выгрузки).
...
Подписки абонентов на услуги
Таблица SUBSCR
Поле | Описание | Примечание |
ID | ID подписки | |
ACC_ID | ID лицевого счёта | Ссылка на ACCOUNTS.ID |
CONTRACT_ID | ID договора | Ссылка на CONTRACTS.ID |
TARIFF_ID | ID услуги (тарифного плана) | Ссылка на SERVICES.ID |
EQUIP_ID | ID абонентского оборудования | Ссылка на EQUIP.ID |
D_BEGIN | Дата и время начала подписки | Дата, когда абонент выбрал новый тарифный план/услугу для смены |
D_END | Дата и время окончания подписки | Оставлять пустым, если это последний выбранный тариф |
QUANT | Заказанное количество услуги | Для тарифных планов - оставлять пустым |
PAY_DAY | Расчетный день | Для плавающего расчетного дня оставлять пустым |
Примечание: выгружаются услуги и тарифный план на следующий период. Если у вас фиксированный расчётный день, привязанный к 1 числу месяца, то выгружайте PAY_DAY = 1 (обычно для юридических лиц).
...
Абонентское оборудование
...
Таблица EQUIP
Поле | Описание | Примечание |
ID | ID оборудования | |
USER_ID | ID абонента | Ссылка на USERS.ID |
EQUIP_TYPE_ID | ID типа абонентского оборудования | Ссылка на Оставлять пустым для компонентов служб с единственным типом спецификации В случае пустого значения для самостоятельного активного оборудования используется тип, задаваемый на форме значений по умолчанию |
OP_EQUIP_ID | ID операторского оборудования | Ссылка на OP_EQUIP.ID |
OP_EQUIP_PORT | Порт операторского оборудования | |
OP_EQUIP_PORT_TYPE | Код типа порта операторского оборудования | Значение сопоставляется по коду, поскольку архитектурно в системе одинаковые типы портов различного оборудования являются различными сущностями |
NS_ID | ID сетевой службы для управления оборудованием | Ссылка на NS_LIST.ID . Обычно не используется - оставлять пустым |
CODE | Код оборудования | Уникальное краткое наименование, идентифицирующее оборудование |
MAC | Физический адрес (MAC) | Можно указать несколько, разделив запятой |
IP | IP-адрес | Можно указать несколько, разделив запятой |
MASK | Маска IP-адреса | |
PHONE | Абонентский телефонный номер в формате E.164 | Можно указать несколько, разделив запятой |
ADDR | Адрес обслуживания | Адрес выгружается в таком же формате, как USERS.ADDR |
ADDR_REM | Примечание к адресу обслуживания |
Примечание: поля OP_EQUIP_ID, OP_EQUIP_PORT, OP_EQUIP_PORT_TYPE используются для указания привязки абонентского оборудования к операторскому и не являются необходимыми.
...
Договоры на оказание услуг
Таблица CONTRACTS
Поле | Описание | Примечание |
ID | ID договора | |
USER_ID | ID абонента | Ссылка на USERS.ID |
NUM | Номер договора | |
D_DOC | Дата заключения договора | |
D_BEGIN | Дата начала действия договора | |
D_END | Дата окончания действия договора |
...
Суммы в таблице WRITEOFFS не должны быть отрицательными - : только положительные значения и 0. В данную таблицу могут быть выгружены не только списания за прошлые расчётные периоды (выполненные инвойсы), но и сведения о текущих расчётных периодах абонентов (актуальные инвойсы).
Многофилиальная структура
...
В процессе миграции некоторые поля разбираются, и данные из них записываются в дополнительные таблицы. В частности, адрес из 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 | Район | |
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
Поле | Описание | Примечание |
EQUIP_ID | Соответствующий ID из таблицы EQUIP* | Ссылка на EQUIP.ID |
ADDR_BIND_TYPE_ID | Вид адреса | Ссылка на FACT_ADDR_BIND_TYPES .ID . Необязательное поле. По умолчанию - адрес обслуживания |
VC_ORIGINAL | Строка с адресом из EQUIP.ADDR. При ручном заполнении необязательно. | |
VC_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 | Комментарий |
Разобранные телефоны базовых субъектов учёта
Таблица 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 (Отделы)
Поле | Описание | |
1 | ID | Идентификатор отдела |
2 | FIRM_ID | Ссылка на фирму из FIRMS.ID |
3 | NAME | Наименование отдела |
Таблица EMPLOYEE_TYPES (типы сотрудников)
Поле | Описание | |
1 | ID | Идентификатор |
2 | NAME | Наименование |
Таблица EMPLOYEES (сотрудники)
Поле | Описание | Примечание | |
1 | ID | Идентификатор | |
2 | USER_ID | Абонент | Ссылка на USERS.ID |
3 | FIRM_ID | Фирма, сотрудником которой является абонент | Ссылка на FIRMS.ID |
4 | DEPARTMENT_ID | Отдел (может быть использован в Гидре для разграничения прав) | Ссылка на DEPARTMENTS.ID |
5 | EMPLOYEE_TYPE_ID | Тип сотрудника (может быть использован в Гидре для разграничения прав) | Ссылка на EMPLOYEE_TYPES.ID |
6 | NAME_GENITIVE | ФИО в родительном падеже | |
7 | APPOINTMENT | Должность | |
8 | APPOINTMENT_GENITIVE | Должность в родительном падеже | |
9 | ACT_AUTHORITY | Действует на основании | |
10 | TAB_NO | Табельный номер | |
11 | D_BEGIN | Дата принятия на работу | |
12 | D_FIRE | Дата увольнения | |
13 | REM | Комментарий |