Документация по АСР «Гидра»
Page tree
Skip to end of metadata
Go to start of metadata

This article in English: Loading Provider Equipment from a File

Загрузку оборудования можно выполнить в Офисе оператора связи через меню Обработки → Загрузка оборудования. Если хотите сделать это самостоятельно, рекомендуем сначала попробовать на тестовом экземпляре Гидры.

Формат файла

  • Формат содержимого файла — CSV.

  • Для текста используется кодировка UTF-8.

  • Разделитель текста (обрамление значений кавычками) не используется.

  • Поля (столбцы) разделяются точкой с запятой — ;
    Разделитель полей в значениях не допускается. Если в значениях необходима точка с запятой, можно использовать другой печатный символ в качестве разделителя полей.

  • Заголовочная строка с названиями полей рекомендуется для упрощения проверки файла внешними средствами, но не обязательна.

Описание полей

Заголовочная строка с названиями полей при загрузке не используется (может быть пропущена) — важен порядок полей.

Обязательные для заполнения поля в описании отмечены знаком (warning)

Поля, которые для упрощения можно оставить пустыми, отмечены знаком (green star)

Номер

Наименование

Описание

1

(green star) Внешний идентификатор

Уникальный идентификатор оборудования. В текущей версии не используется.

2

(warning) Тип оборудования

Код типа оборудования в Гидре — модель устройства. В Гидре: Справочники → Номенклатура → ТМЦ.

Для каждого типа перед загрузкой нужно завести в номенклатуре позицию и описать её спецификацию (типы и количество портов).

3

(warning) Код оборудования

Код оборудования — уникальное краткое наименование данного экземпляра.

4

(green star) Адрес оборудования

Адрес размещения оборудования в формате: <название населённого пункта>,<тип населённого пункта>,<название улицы>,<тип улицы>,<здание>,<подъезд>,<этаж>,<квартира>.

  1. Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ульяновск.
  2. Полное или краткое наименование типа населённого пункта. Например: г. или Город, пос. или Посёлок.
    (warning) Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
    (green star) Если не указано, используется тип Город.
  3. Название улицы. В справочнике регионов Гидры — код региона. Например: Ленина.
  4. Полное или краткое наименование типа улицы. Например: ул. или Улица, наб. или Набережная.
    (warning) Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
    (green star) Если не указано, используется тип Улица.
  5. Здание может быть представлено в двух видах:
    • Расширенный — д. <дом> корп. <корпус> стр. <строение> вл. <владение>
      (info) Указывайте только нужные части здания, сохраняя их краткие обозначения: например корп. 25 стр. 2
    • Простой — только номер дома (если начинается с цифр) или только корпус (если начинается не с цифр).
  6. Номер подъезда.
  7. Номер этажа, числовое значение.
  8. Номер квартиры или иного помещения.

Если каких-то данных нет, оставьте только запятые. Если адрес не нужен совсем, оставьте поле пустым.

5

(green star) Нестандартный адрес

Неструктурированная часть адреса размещения оборудования, например: чердак, третья дверь налево.

6

(green star) IPv4-адрес

IPv4 адрес оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82).

7

(green star) Номер VLAN

VLAN ID оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82). Поддерживается как простой номер (например 1234), так и Q-in-Q в формате <внешний>:<внутренний> (например 123:321).

8

(green star) Тип управления

Наименование типа управления в Гидре: Справочники → Базовые → Типы управления/авторизации. Например: SSH, SNMP v2c, Telnet.

9

(green star) Логин для управления

Логин (имя пользователя) для управления, например по SSH

10

(green star) Пароль для управления

Пароль для управления по SSH и Telnet, или community string для SNMP.

11

(warning) Состояние

Состояние оборудования, например: Активный (эксплуатируется), Неактивный (ещё не установлено), Снят с учёта (выведено из эксплуатации).

В Гидре: Справочники → Базовые → Статус объектов учета.

12

(green star) Серийный номер

Серийный номер оборудования.

13(green star) MAC-адресАдрес оборудования для управления или авторизации абонентов (например по IPoE DHCP Option 82) в формате XX-XX-XX-XX-XX-XX или XX:XX:XX:XX:XX:XX. Должен быть индивидуальным (юникастовым).
14(green star) Примечание к адресуКраткий комментарий к размещения этого оборудования.
15(green star) Примечание к оборудованиюКраткий комментарий к данному экземпляру оборудования. 
16(green star) Наименование оборудованияПолное наименование этого оборудования.
17(green star) Номер порта для управленияTCP/UDP-порт для управления оборудованием, числовое значение.

Пример

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;;


 

  • No labels