Импорт камер из файла конфигурации

Cписок камер с настройками можно загрузить из файла формата *.xlsx. В результате импорта камеры автоматически подключаются к Insentry с настройками, указанными в файле.

Файл импорта должен содержать листы Cameras, Profiles, Recordings и Tags. Первые строки листов содержат названия столбцов и могут быть произвольными. Импорт производится в разделе Управление → Импорт/Экспорт → Импорт. Там же можно скачать шаблон для заполнения списка камер.

Формат листа Cameras

На листе Cameras обязательные для заполнения столбцы:

  • Название
  • Хост
  • Логин

Если хотя бы один из них не заполнен, вся строка будет считаться комментарием, а не информацией о камере.

Остальные столбцы заполнять необязательно. Пустые столбцы будут интерпретироваться со значениями по умолчанию.

Столбец Описание Формат Значение по умолчанию, если ячейка не заполнена
Название Название камеры Текстовое поле длиной от 1 до 250 символов. Допустимы символы кириллицы, все печатные символы ASCII Поле обязательно для заполнения
Хост Адрес камеры IPv4 адрес или доменное имя камеры, порт — целое число от 1 до 65535, согласно спецификации Поле обязательно для заполнения
Логин Логин доступа к камере От 1 до 50 символов, допустимы все печатные символы ASCII Поле обязательно для заполнения
Пароль Пароль доступа к камере От 1 до 50 символов, допустимы все печатные символы ASCII Пусто
Описание Описание камеры Текстовое поле длиной от 0 до 250 символов. Допустимы символы кириллицы, все печатные символы ASCII Пусто
Вендор Производитель камеры Текстовое поле, значение должно содержать название одного из [поддерживаемых вендоров] либо значение Other Onvif
Модель Модель камеры Модель камеры. Если модель неизвестна, напишите Other model или Other PTZ-model
Канал Канал (для импорта камер с регистратора) Целое число Пусто
Поддержка PTZ Идентификатор поворотной камеры 1 — да, 0 — нет 0
Поддержка омывателя Наличие на камере омывателя 1 — да, 0 — нет 0
Поддержка стеклоочистителя Наличие на камере омывателя 1 — да, 0 — нет 0
Использовать TCP Eсли переключатель включен, то для получения потоков используется протокол TCP 1 — использовать TCP, 0 — использовать UDP 0
RTSP-порт Номер порта для передачи данных по протоколу RTSP 554 Целое число от 1 до 65535, согласно спецификации 554
HTTP-порт Номер порта для передачи данных по протоколу HTTP Целое число от 1 до 65535, согласно спецификации 80
Onvif-порт Номер порта для передачи данных по протоколу Onvif Целое число от 1 до 65535, согласно спецификации 80
Набор профилей Идентификатор набора профилей Указанный в листе Profiles либо пустой Пусто
Набор записей Ссылка на идентификатор набора записей в листе Recordings Указанный в листе Recordings либо пустой Пусто
UUID Уникальный идентификатор UUID, который записывается в логах работы системы. Может пригодиться при обращении в техподдержку Согласно спецификации. Если UUID задан и камера с таким UUID уже есть, то её настройки будут обновлены Будет сгенерирован новый UUID
ECHDID Числовой идентификатор камеры в ЕЦХД. Если значение задано, то на камере включается [трансляция в ЕЦХД] Целое число Пусто
Транслировать в облако Включение трансляции в облако 1 — вкл, 0 — выкл 0
Теги Теги, присвоенные камере Перечисление идентификаторов тегов, присвоенных камере. Разделитель — пробел. Идентификаторы обычных тегов задаются с префиксом # «решётка» (#ptz), а тегов расположения — с префиксом @ «собака» (@main). Идентификатор вложенного тега указывается через точку после идентификатора вышестоящего тега, например: #schedule.night, @main.gate. Тег расположения может быть присвоен только один, обычных тегов — несколько. Теги должны быть указаны на листе Tags Пусто
Широта Координаты камеры — широта Градусы от -90.0 до 90.0 в виде десятичной дроби. Разделитель — точка Пусто
Долгота Координаты камеры — долгота Градусы от -180.0 до 180.0 в виде десятичной дроби. Разделитель - точка Пусто
Направление Направление объектива камеры в градусах Значение от 0 до 359, где 0° — на восток, 90° — на север, 180° — на запад, 270° — на юг Пусто
План Идентификатор плана этажа Текстовая строка Пусто
Аудио Разрешение трансляции аудио 1 — да, 0 — нет 0

Если на листе Cameras хотя бы у одной камеры заполнен столбец «Набор профилей», то в файле импорта обязательно должны быть описания этих наборов в листе Profiles.

Если на листе Cameras хотя бы у одной камеры заполнен столбец «Набор записей», то в файле импорта обязательно должны быть описания этих наборов в листе Recordings.

Если на листе в Cameras задан UUID камеры и камера с таким идентификатором уже существует в базе. В этом случае:

  1. Согласно листу Recordings добавляются правила записи по тем профилям камеры, по которым они отсутствуют.
  2. По тем профилям, для которых уже существуют правила записи и для которых на листе Recordings найдена соответствующая запись, в существующих правилах записи обновляется глубина хранения и режим записи (включена или выключена).
  3. Удаляются правила записи по тем профилям камеры, для которых отсутствует информация на листе Recordings (только в том случае, если на вкладке Cameras для камеры задан Recording set).

Формат листа Profiles

На листе Profiles обязательные столбцы:

  • Набор профилей
  • Название
  • RTSP-url

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

Остальные столбцы заполнять необязательно. Пустые столбцы будут интерпретироваться со значениями по умолчанию.

Столбец Описание Формат Значение по умолчанию, если ячейка не заполнена
Набор профилей Идентификатор набора профилей Целое число от 0 до 2 миллиардов Поле обязательно для заполнения
Навзание Название профиля Строка, только латинские символы, нижнее подчёркивание и дефис, максимальная длина 64 символа Поле обязательно для заполнения
RTSP-url URL-путь для получения видеопотока по протоколу RTSP URL-путь Поле обязательно для заполнения
Screen-url URL-путь для получения скриншотов с камеры по протоколу HTTP URL-путь Пусто
Кодек Название кодека Строка не чувствительная к регистру, поддерживается только кодек H264 Пусто
Ширина Ширина потока Целое число от 64 до 16384 Пусто
Высота Высота потока Целое число от 64 до 16384 Пусто
FPS FPS потока Целое число от 0 до 1000 Пусто

Формат листа Recodrings

На листе Recordings обязательные для заполнения столбцы:

  • Набор записей
  • Глубина
  • Статус
  • Ширина и Высота либо Профиль

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

Столбец Описание Формат Значение по умолчанию, если ячейка не заполнена
Набор записей Идентификатор набора записей Целое число Поле обязательно для заполнения
Глубина Глубина хранения архива в днях Целое или дробное число Поле обязательно для заполнения
Статус Статус записи 1 — запись включена, 0 — выключена Поле обязательно для заполнения
Ширина Ширина видеопотока (может отсутствовать, если указан Profile) Целое число от 64 до 16384 Поле обязательно для заполнения, если не заполнено поле Profile
Высота Высота видеопотока (может отсутствовать, если указан Profile) Целое число от 64 до 16384 Поле обязательно для заполнения, если не заполнено поле Profile
Профиль Идентификатор профиля видеопотока (может отсутствовать, если заданы значения Width и Height). Если указан Profile — проверяется его существование у камеры и правило записи создается с этим профилем. Если Profile не указан или у камеры нет такого профиля, а Width и Height не указаны — импорт камеры не производится Целое число Поле обязательно для заполнения, если не заполнены Width и Height

Формат листа Tags

На листе Tags указывается информация о тегах, которые будут добавлены в справочник тегов и расположений. Необходимо заполнить столбцы:

  • Идентификатор;
  • Название.

Идентификаторы обычных тегов задаются с префиксом # («решётка»), а тегов расположения — с префиксом @ («собака»). Идентификатор вложенного тега указывается через точку после идентификатора вышестоящего тега, например: #schedule.night, @main.gate.

Пример заполнения листа Tags: