Описание формата файла для загрузки операторского оборудования из файла. Версия 1.2
Формат: CSV
Кодировка: UTF8
Разделитель полей: «;» (точка с запятой)
Разделитель текста: не использовать
Описание полей: (см. таблицу)
№ п/п | Наименование поля | Обязательность | Описание |
|---|---|---|---|
1 | Внешний идентификатор | Да | ID во внешней системе для поиска оборудования |
2 | Тип оборудования | Да | Код типа оборудования из номенклатуры. Для каждого типа нужно ввести в номенклатуре позицию и полностью описать её состав по портам и их количеству. |
3 | Код оборудования | Да | Код создаваемой в Гидре единицы оборудования |
4 | Адрес оборудования |
| Адрес в формате <Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира> |
5 | Нестандартный адрес |
|
|
6 | IP-адрес для управления |
| Указывается только для управляемого оборудования |
7 | VLAN |
| Указывается только для управляемого оборудования |
8 | Тип управления |
| Указывается только для управляемого оборудования (SNMP, SNMPv2 и т.д.). |
9 | Логин |
| Указывается только для управляемого оборудования (для SNMP пустой) |
10 | Пароль |
| Указывается только для управляемого оборудования (пароль для управления по ssh, telnet или комьюнити для snmp) |
11 | Состояние | Да | Активный (введен в эксплуатацию), Неактивный |
12 | Серийный номер |
|
|
Пример:
1234;D-Link DES3526;DES-001;Москва г,Тверская ул, 23,7,1,;;198.18.58.12;;SNMP v2c;;DLink3526;Активный;
| Info |
|---|
This article in English: Loading Provider Equipment from a File |
| Tip |
|---|
Загрузку оборудования можно выполнить в Офисе оператора связи через меню Обработки → Загрузка оборудования. Если хотите сделать это самостоятельно, рекомендуем сначала попробовать на тестовом экземпляре Гидры. |
Формат файла
Формат содержимого файла — CSV.
Для текста используется кодировка UTF-8.
Разделитель текста (обрамление значений кавычками) не используется.
Поля (столбцы) разделяются точкой с запятой — ;
Разделитель полей в значениях не допускается. Если в значениях необходима точка с запятой, можно использовать другой печатный символ в качестве разделителя полей.Заголовочная строка с названиями полей рекомендуется для упрощения проверки файла внешними средствами, но не обязательна.
Описание полей
| Note |
|---|
Заголовочная строка с названиями полей при загрузке не используется (может быть пропущена) — важен порядок полей. |
| Info |
|---|
Обязательные для заполнения поля в описании отмечены знаком Поля, которые для упрощения можно оставить пустыми, отмечены знаком |
Номер | Наименование | Описание |
|---|---|---|
| 1 |
| Уникальный идентификатор оборудования. В текущей версии не используется. |
| 2 |
| Код типа оборудования в Гидре — модель устройства. В Гидре: Справочники → Номенклатура → ТМЦ. Для каждого типа перед загрузкой нужно завести в номенклатуре позицию и описать её спецификацию (типы и количество портов). |
| 3 |
| Код оборудования — уникальное краткое наименование данного экземпляра. |
| 4 |
| Адрес размещения оборудования в формате:
Если каких-то данных нет, оставьте только запятые. Если адрес не нужен совсем, оставьте поле пустым. |
| 5 |
| Неструктурированная часть адреса размещения оборудования, например: чердак, третья дверь налево. |
| 6 |
| IPv4 адрес оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82). |
| 7 |
| VLAN ID оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82). Поддерживается как простой номер (например 1234), так и Q-in-Q в формате |
| 8 |
| Наименование типа управления в Гидре: Справочники → Базовые → Типы управления/авторизации. Например: SSH, SNMP v2c, Telnet. |
| 9 |
| Логин (имя пользователя) для управления, например по SSH |
| 10 |
| Пароль для управления по SSH и Telnet, или community string для SNMP. |
| 11 |
| Состояние оборудования, например: Активный (эксплуатируется), Неактивный (ещё не установлено), Снят с учёта (выведено из эксплуатации). В Гидре: Справочники → Базовые → Статус объектов учета. |
| 12 |
| Серийный номер оборудования. |
| 13 |  MAC-адрес | Адрес оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82) в формате XX-XX-XX-XX-XX-XX или XX:XX:XX:XX:XX:XX. Должен быть индивидуальным (юникастовым). |
| 14 | Примечание к адресу | Краткий комментарий к размещения этого оборудования. |
| 15 | Примечание к оборудованию | Краткий комментарий к данному экземпляру оборудования. |
| 16 | Наименование оборудования | Полное наименование этого оборудования. |
| 17 | Номер порта для управления | TCP/UDP-порт для управления оборудованием, числовое значение. |
Пример
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
ID;TypeCode;Code;StreetAddress;CustomStreetAddress;ManagementIPv4;VLAN;ManagementType;ManagementLogin;ManagementPassword;Status;SerialNumber;MAC;StreetAddressRemark;Remark;Name;ManagementPortNumber
123;Edge-Core ES3528M;SW-Edge.Core.ES3528M-123;Москва,г.,Тверская,ул.,д. 23 корп. 5,2,,;технический этаж, возле электрощитовой;128.66.125.125;123:321;SSH;admin;secret;Активный;F567G78;00-00-5E-11-22-33;Гостиница, ключи у администратора;Автономность около 2 часов;Коммутатор Edge-Core ES3528M №123;2022
321;DES1024D;SW-DES1024D-321;;;;;;;;Снят с учета;;;;Списан 31.12.2023;; |