...
Архив с полным набором файлов, содержащими только заголовочные строки без данных:
View file name headers_only.zip height 250 Tip Используйте данный архив в качестве основы для формирования выгрузки
Образец содержимого файла ACCOUNTS.csv для таблицы ACCOUNTS:
Code Block theme Confluence linenumbers true "ID";"CUSTOMER_ID";"ACCOUNT_NUMBER";"ACCOUNT_TYPE_ID";"CURRENCY_ID";"BANK_ID";"BALANCE";"CREDIT";"CREDIT_END_DATE";"BALANCE_DATE";"REMARK" "10";"1";"14170";"1";"643";"";"802.00";"";"";"29.02.2024 23:59:59";"" "11";"1";"14170★";"3";"999";"";"560";"";"";"29.02.2024 23:59:59";"Открыт при заключении договора.¶Списание бонусов производить только по согласованию с Фёдором Сумкиным."
Архив с упрощённой выгрузкой, включающей только базовый набор данных:
View file name example_basic.zip height 250 Архив с расширенной выгрузкой, включающей необязательные дополнительные таблицы и поля:
View file name example_extended.zip height 250
...
- Юридические и физические лица находятся в единой таблице CUSTOMERS и различаются по значению поля ORGANIZATION.
- Из реквизитов юридических лиц по умолчанию мигрируют только наименование, организационно-правовая форма и ИНН.
- История начислений мигрирует «как есть» в виде архивированных актов начислений.
- Для текущих расчётных периодов при миграции акты начислений формируются Гидрой на основании настроенных схем оказания услуг и приказов по ценам, с учётом выгруженных дат начала расчётных периодов и подписок на услуги.
- Объём потреблённых потоковых услуг в текущем периоде: интернет-трафик, «минуты» услуг телефонии — не мигрирует.
- Тарифные планы, услуги и их особенности: периодичность, квоты, цены, ограничения скоростей доступа — не мигрируют, а настраиваются вручную в Гидре и затем сопоставляются с выгруженным справочником (таблица PRODUCTS).
- Внутренние идентификаторы мигрированных сущностей в Гидре будут отличаться от выгруженных. Но соответствия выгруженных и результирующих идентификаторов в ходе миграции сохраняются в БД Гидры для возможностей последующей обработки абонентов.
...
Info |
---|
Обязательные для заполнения таблицы и столбцы в описании отмечены знаком Таблицы с столбцы, которые для упрощения выгрузки можно оставить пустыми, отмечены знаком По договорённости в выгрузку могут быть добавлены дополнительные таблицы и дополнительные столбцы стандартных таблиц. |
Anchor | ||||
---|---|---|---|---|
|
Сопоставляемые справочники
...
Info |
---|
Соответствия сохраняются между итерациями миграции, если от выгрузки к выгрузке не меняются идентификаторы и наименования записей. |
Anchor | ||||
---|---|---|---|---|
|
ACCOUNT_TYPES — типы счетов
Необходимы хотя бы лицевые счета.
Столбец | Описание |
---|---|
ID | Идентификатор типа счёта |
NAME | Наименование типа счёта |
REMARK | Примечание для правильного выбора соответствия |
...
Примеры: Лицевой счёт, Расчётный счёт.
Anchor | ||||
---|---|---|---|---|
|
AUTH_DOC_TYPES — типы документов, удостоверяющих личность
Оставьте таблицу пустой, если не выгружаете реквизиты удостоверений личности абонентов-физлиц.
Столбец | Описание |
---|---|
ID | Идентификатор типа документа |
NAME | Наименование типа документа |
REMARK | Примечание для правильного выбора соответствия |
...
Примеры: Паспорт, Справка.
Anchor banks banks
BANKS — банки счетов и источники платежей
Оставьте таблицу пустой, если не выгружаете расчётные счета и историю платежей.
Столбец | Описание |
---|---|
ID | Идентификатор банка. |
NAME | Наименование банка. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Сбербанк, Касса в офисе, Платёжная система Киберплат.
Anchor | ||||
---|---|---|---|---|
|
COMMENT_TYPES — типы комментариев
Оставьте таблицу пустой, если не выгружаете расширенные комментарии к абонентам и к их оборудованию.
Столбец | Описание |
---|---|
ID | Идентификатор типа комментариев. |
NAME | Наименование типа комментариев. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Запрос в службу поддержки, Отзыв, Авария.
Anchor | ||||
---|---|---|---|---|
|
CURRENCIES — валюты счетов
Необходима хотя бы одна валюта, в которой ведутся расчёты с абонентам.
Столбец | Описание |
---|---|
ID | Идентификатор валюты. |
NAME | Наименование валюты. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Российский рубль, Бонус.
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_GROUPS — группы абонентов
Необходимы хотя бы главные группы абонентов.
Столбец | Описание |
---|---|
ID | Идентификатор группы. |
NAME | Наименование группы. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Физлица МКД, Частники, Бизнес, Бюджетники, Сотрудники.
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_STATUSES — состояния абонентов
Необходимы хотя бы два состояния: для активных и отключенных абонентов.
Столбец | Описание |
---|---|
ID | Идентификатор состояния. |
NAME | Наименование состояния. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Активен, Заблокирован вручную, Отключен.
Anchor | ||||
---|---|---|---|---|
|
EQUIPMENT_TYPES — типы абонентского и операторского оборудования
Необходим хотя бы один тип абонентского оборудования (точки оказания услуги).
Укажите только типы абонентского оборудования, если не выгружаете его связи с операторским.
Столбец | Описание |
---|---|
ID | Идентификатор типа оборудования. |
NAME | Наименование типа оборудования. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Оконечное оборудование, ТВ-приставка, Eltex LTP-8X.
Anchor | ||||
---|---|---|---|---|
|
FIRMS — фирмы
Оставьте таблицу пустой, если в вашей Гидре всего одна фирма.
...
Примеры: Оффлайн Телеком, Cloud Express.
Anchor | ||||
---|---|---|---|---|
|
NETWORK_SERVICES — сетевые службы
Необходим хотя бы личный кабинет абонента.
Столбец | Описание |
---|---|
ID | Идентификатор службы. |
NAME | Наименование службы. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Личный кабинет, PPPoE, SIP-телефония, Смотрёшка, SMS-уведомления.
Anchor | ||||
---|---|---|---|---|
|
PAYMENT_TYPES — типы платежей
Оставьте таблицу пустой, если не выгружаете историю платежей совсем или выгружаете только реальные платежи и хотите разделять их по типам (будет использован общий тип из настроек миграции).
...
Примеры: Наличные (реальный), Платёжная система (реальный), Перерасчёт (виртуальный), Бонусы (виртуальный).
Anchor | ||||
---|---|---|---|---|
|
PHONE_TYPES — виды телефонов физлиц и юрлиц
Оставьте таблицу пустой, если не выгружаете контактные телефонные номера физлиц и юрлиц в отдельную таблицу CUSTOMER_PHONES.
Столбец | Описание |
---|---|
ID | Идентификатор вида телефонов. |
NAME | Наименование вида телефонов. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Мобильный, Домашний, Для уведомлений, Рабочий.
Anchor | ||||
---|---|---|---|---|
|
PRODUCTS — тарифные планы, услуги и корректировки
Необходимы хотя бы текущие тарифные планы и периодические услуги абонентов, если не выгружаете историю начислений.
Столбец | Источник значений | Описание |
---|---|---|
ID | Идентификатор услуги. | |
NAME | Наименование услуги. | |
TYPE | Y для тарифных планов, N — для всего остального. | |
UNIT_ID | UNITS.ID | Идентификатор единицы измерения для услуг с количеством из таблицы UNITS. Должна соответствовать единице измерения услуги в номенклатуре Гидры. Если в номенклатуре единица не задана (прочерк), оставляйте поле пустым. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Безлимитный Космос (тарифный план), Аренда ТВ-приставки (услуга), Перерасчёт (корректировка).
Anchor | ||||
---|---|---|---|---|
|
PROVIDER_EQUIPMENT — операторское оборудование
Оставьте таблицу пустой, если не выгружаете его связи абонентского оборудования с операторским для технического учёта или управления доступом (например IPoE с DHCP Option 82).
Столбец | Источник значений | Описание |
---|---|---|
ID | Идентификатор оборудования. | |
EQUIPMENT_TYPE_ID | EQUIPMENT_TYPES.ID | Идентификатор типа оборудования. |
CODE | Код оборудования. | |
IP | Фактический IPv4 адрес оборудования. Может использоваться для автоматического сопоставления вместо кода. | |
FIRM_ID | FIRMS.ID | Идентификатор фирмы для многофилиальной Гидры. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: olt-ш.Космонавтов-д25, switch-T3KZ1C7001304.
Anchor | ||||
---|---|---|---|---|
|
STREET_ADDRESS_PURPOSES — виды обычных адресов физлиц, юрлиц и абонентского оборудования
Оставьте таблицу пустой, если не выгружаете адреса в отдельные таблицы CUSTOMER_STREET_ADDRESSES и EQUIPMENT_STREET_ADDRESSES.
Столбец | Описание |
---|---|
ID | Идентификатор вида адреса. |
NAME | Наименование вида адреса. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: Фактический адрес, Адрес постоянной регистрации, Юридический адрес, Адрес обслуживания.
Anchor | ||||
---|---|---|---|---|
|
UNITS — единицы измерения количества услуг
Оставьте таблицу пустой, если не выгружаете услуги, для которых имеет указывается количество.
Столбец | Описание |
---|---|
ID | Идентификатор единицы измерения. |
NAME | Наименование единицы измерения. |
REMARK | Примечание для правильного выбора соответствия. |
...
Примеры: штука, метр, мегабайт, минута, мегабит в секунду.
Anchor | ||||
---|---|---|---|---|
|
Мигрируемые данные абонентов
...
Info |
---|
Если описанной промежуточной схемы недостаточно для переноса в Гидру всех необходимых данных, по согласованию с ответственным за миграцию инженером Латеры в выгрузку могут быть добавлены как дополнительные столбцы в стандартные таблицы, так и дополнительные таблицы. |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMERS — абоненты и базовые субъекты
...
Столбец | Источник значений | Описание |
---|---|---|
ID |
| |
STATUS_ID | CUSTOMER_STATUSES.ID |
|
PARENT_ID | CUSTOMERS.ID | Идентификатор базового субъекта при раздельной выгрузке.
|
CODE |
| |
ORGANIZATION | ||
NAME |
| |
SECOND_NAME |
| |
SURNAME |
| |
ADDRESS | Фактический адрес физического или юридического лица в формате Если каких-то данных не хватает, оставьте только запятые, например: Номер дома может быть дополнен номером корпуса:
| |
ADDRESS_REMARK | Примечание к фактическому адресу.
| |
AUTH_DOC_TYPE_ID | AUTH_DOC_TYPES.ID |
|
AUTH_DOC_SERIAL |
| |
AUTH_DOC_NUMBER |
| |
AUTH_DOC_DATE |
| |
AUTH_DOC_ISSUING_AUTHORITY |
| |
BIRTH_DATE |
| |
BIRTH_PLACE |
| |
TAX_ID_NUMBER |
| |
LEGAL_FORM_CODE | Код или наименование организационно-правовой формы. Например: ИП или Индивидуальный предприниматель, ООО или Общество с ограниченной ответственностью. Все значения должны быть указаны в Гидре: Справочники → Базовые → Организационно-правовые формы предприятий.
| |
W_PHONE | Контактный рабочий телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры.Можно указать несколько номеров, разделив их запятыми.
| |
H_PHONE | Контактный домашний телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.
| |
M_PHONE | Контактный мобильный телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.
| |
| ||
FIRM_ID | FIRMS.ID | Идентификатор фирмы для многофилиальной Гидры.
|
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_GROUP_BINDS — участие абонентов в группах
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
GROUP_ID | CUSTOMER_GROUPS.ID | |
PRIMARY |
Главная группа у каждого абонента должна быть только одна. | |
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_COMMENTS — расширенные комментарии к абонентам
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
COMMENT_TYPE_ID | COMMENT_TYPES.ID | |
COMMENT_TEXT |
| |
CREATED_DATE | ||
REMINDER_DATE | ||
EXECUTION_DATE |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_MAPPINGS — соответствие выгруженных абонентов уже имеющимся в Гидре
...
Столбец | Источник значений | Описание |
---|---|---|
CUSTOMER_ID | CUSTOMERS.ID |
Первичный ключ в данной таблице: для одного выгруженного абонента здесь возможна только одна запись. |
CUSTOMER_DST_CODE | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_PHONES — контактные телефоны физлиц и юрлиц
...
Если примечания не нужны и достаточно стандартных видов: Рабочий, Домашний и Мобильный — оставьте эту таблицу пустой и заполните столбцы W_PHONE, H_PHONE и M_PHONE в таблице CUSTOMERS.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID |
При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта. |
PHONE_TYPE_ID | PHONE_TYPES.ID | |
PHONE | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_STREET_ADDRESSES — структурированные обычные адреса физлиц и юрлиц
...
Если достаточно одного фактического адреса, оставьте эту таблицу пустой и заполните столбцы ADDRESS и ADDRESS_REMARK в таблице CUSTOMERS.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID |
При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта. |
ADDRESS_PURPOSE_ID | STREET_ADDRESS_PURPOSES.ID |
|
DISTRICT | ||
CITY | ||
CITY_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
STREET | ||
STREET_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
HOUSE | Эти четыре столбца совокупно определяют здание:
| |
BUILDING | ||
CONSTRUCT | ||
OWNERSHIP | ||
ENTRANCE | ||
FLOOR | ||
FLAT | ||
INTERCOM_CODE | ||
CUSTOM_ADDRESS | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
ACCOUNTS — cчета абонентов и базовых субъектов
...
Столбец | Источник значений | Описание |
---|---|---|
ID |
| |
CUSTOMER_ID | CUSTOMERS.ID |
|
ACCOUNT_NUMBER |
| |
ACCOUNT_TYPE_ID | ACCOUNT_TYPES.ID |
|
CURRENCY_ID | CURRENCIES.ID |
|
BANK_ID | BANKS.ID |
|
BALANCE |
| |
CREDIT |
| |
CREDIT_END_DATE |
| |
BALANCE_DATE |
Мигрированный итоговый баланс будет отличаться на разницу платежей из PAYMENTS и начислений из CHARGES, произошедших позже указанной даты. | |
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CONTRACTS — договоры на оказание услуг
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
CONTRACT_NUMBER | ||
SIGNATURE_DATE | ||
START_DATE | ||
END_DATE | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
EQUIPMENT — абонентское оборудование (точки оказания услуг)
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
EQUIPMENT_TYPE_ID | EQUIPMENT_TYPES.ID | |
PROVIDER_EQUIPMENT_ID | PROVIDER_EQUIPMENT.ID |
Оставьте пустым, если привязка не требуется. |
PROVIDER_EQUIPMENT_PORT_CODE |
Оставьте пустым, если привязка нужна к самому оборудованию, а не к его компоненту. | |
PROVIDER_EQUIPMENT_PORT_TYPE |
Оставьте пустым, если у оборудования коды компонентов уникальны. | |
CODE | ||
MAC |
Можно указать несколько адресов, разделив их запятыми. | |
IP |
Можно указать несколько адресов и подсетей, разделив их запятыми. | |
IP6 |
Можно указать несколько подсетей, разделив их запятыми. | |
PHONE |
Можно указать несколько номеров, разделив их запятыми. | |
VLAN | ||
ADDRESS | Адрес обслуживания в формате Если каких-то данных не хватает, оставьте только запятые, например: Номер дома может быть дополнен номером корпуса:
| |
ADDRESS_REMARK | Примечание к адресу обслуживания.
| |
REMARK |
Anchor | ||||
---|---|---|---|---|
|
EQUIPMENT_COMMENTS — расширенные комментарии к абонентскому оборудованию
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
EQUIPMENT_ID | EQUIPMENT.ID | |
COMMENT_TYPE_ID | COMMENT_TYPES.ID | |
COMMENT_TEXT |
| |
CREATED_DATE | ||
REMINDER_DATE | ||
EXECUTION_DATE |
Anchor | ||||
---|---|---|---|---|
|
EQUIPMENT_STREET_ADDRESSES — структурированные обычные адреса абонентского оборудования
...
Если достаточно одного адреса обслуживания, оставьте эту таблицу пустой и заполните столбцы ADDRESS и ADDRESS_REMARK в таблице EQUIPMENT.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
EQUIPMENT_ID | EQUIPMENT.ID |
|
ADDRESS_PURPOSE_ID | STREET_ADDRESS_PURPOSES.ID | |
DISTRICT | ||
CITY | ||
CITY_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
STREET | ||
STREET_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
HOUSE | Эти четыре столбца совокупно определяют здание:
| |
BUILDING | ||
CONSTRUCT | ||
OWNERSHIP | ||
ENTRANCE | ||
FLOOR | ||
FLAT | ||
INTERCOM_CODE | ||
CUSTOM_ADDRESS | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CUSTOMER_NET_SERVICE_BINDS — доступы к ЛК и подписки на сетевые службы
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
NETWORK_SERVICE_ID | NETWORK_SERVICES.ID | |
EQUIPMENT_ID | EQUIPMENT.ID | Идентификатор абонентского оборудования.
|
LOGIN | Логин (имя пользователя). Должен быть уникален в пределах службы (приложения).
| |
PASSWORD | Пароль открытым текстом. В тестовых выгрузках для безопасности можете для всех указать одинаковое значение.
| |
PASSWORD_HASH_TYPE | ||
REMARK |
Anchor | ||||
---|---|---|---|---|
|
SUBSCRIPTIONS — подписки абонентов на периодические услуги
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
ACCOUNT_ID | ACCOUNTS.ID | |
CONTRACT_ID | CONTRACTS.ID | |
PRODUCT_ID | PRODUCTS.ID |
В подписках могут участвовать только периодические услуги. |
EQUIPMENT_ID | EQUIPMENT.ID | Идентификатор абонентского оборудования — точки оказания услуги. Необходимо указывать для всех услуг, управляемых Гидрой.
|
START_DATE | ||
END_DATE | Дата и время окончания подписки в формате ДД.ММ.ГГГГ чч:мм:сс — когда оказание услуги должно завершиться.
| |
QUANTITY | Количество заказанной услуги в единице измерения PRODUCTS.UNIT_ID. Является множителем к её цене: например для аренды двух телефонных линий по 100 ₽ укажите 2 — тогда абонентская плата составит 2 × 100 ₽ = 200 ₽.
| |
BILLING_DATE | Фиксированный расчётный день месяца — натуральное число от 1 до 28. Для абонентов-юрлиц как правило 1 — расчётные периоды строго привязаны к календарным месяцам.
| |
REMARK |
Anchor | ||||
---|---|---|---|---|
|
CHARGES — история начислений и текущие расчётные периоды
Note |
---|
Заполнение данной таблицы не является критичным для миграции, но как правило в ней ожидаются хотя бы текущие расчётные периоды абонентов по всем услугам. Для корректного формирования актуальных актов начислений необходимо наличие подписок на услуги в таблице SUBSCRIPTIONS: с теми же лицевым счётом, договором, услугой, оборудованием и с подходящим периодом действия. Если выгрузить эти данные невозможно, обязательно обсудите варианты выставления первых актов начислений в Гидре с ответственным за миграцию инженером Латеры. По умолчанию Гидра при запуске периодических заданий после миграции начнёт оказание услуг на основании подписок с текущего момента. |
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
ACCOUNT_ID | ACCOUNTS.ID | |
CONTRACT_ID | CONTRACTS.ID | |
CHARGE_DATE |
Как правило совпадает с датой начала или окончания расчётного периода, но не должна выходить за пределы этого периода. | |
PRODUCT_ID | PRODUCTS.ID |
|
EQUIPMENT_ID | EQUIPMENT.ID | Идентификатор абонентского оборудования. Для текущих расчётных периодов должен совпадать с указанным для этой услуги в SUBSCRIPTIONS.EQUIPMENT_ID.
|
AMOUNT |
Для корректировок баланса допустимы отрицательные значения, увеличивающие баланс лицевого счёта, — возвраты средств. | |
CHARGING_PERIOD_START_DATE |
Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE. | |
CHARGING_PERIOD_END_DATE |
Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE. | |
QUANTITY | Количество оказанной услуги в единице измерения PRODUCTS.UNIT_ID, умноженное на 100.
| |
REMARK |
Anchor | ||||
---|---|---|---|---|
|
PAYMENTS — история платежей
...
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
ACCOUNT_ID | ACCOUNTS.ID | |
BANK_ID | BANKS.ID | |
TRANSACTION_DATE | ||
PAYMENT_AMOUNT | ||
PAYMENT_TYPE_ID | PAYMENT_TYPES.ID | Идентификатор типа платежа.
|
REMARK |
...