Перейти к основному содержимому

Импорт / экспорт

OpSee поддерживает массовый импорт и экспорт данных оборудования через файлы Excel (.xlsx). Это полезно для первичной настройки, миграции из других систем, резервного копирования и массовых обновлений.

Доступ к импорту / экспорту​

В панели инструментов сетки оборудования доступны две кнопки:

КнопкаИконкаОписание
ИмпортЗагрузитьОткрывает диалог импорта для загрузки файла Excel
ЭкспортСкачатьОткрывает диалог экспорта для скачивания оборудования как Excel

Кнопки «Импорт/Экспорт» в панели инструментов

Экспорт оборудования​

Шаги​

  1. Нажмите кнопку Экспорт в панели инструментов
  2. В диалоге экспорта настройте параметры:
    • Имя файла — имя по умолчанию заполнено переведённым именем; настройте при необходимости
    • Включить отключённые — переключатель для включения неактивного оборудования в экспорт (по умолчанию выключен)
  3. Нажмите Экспорт

Файл Excel загружается в ваш браузер со всем оборудованием, соответствующим выбранным параметрам.

Диалог экспорта

Экспортируемые столбцы​

Файл Excel содержит следующие столбцы:

СтолбецОписание
IDID оборудования (только чтение, используется для обновлений)
НазваниеНазвание оборудования
ОписаниеОписание оборудования
ID родителяID родительского оборудования
ID типаID типа оборудования
Название типаНазвание типа оборудования (только чтение, для справки)
ИконкаИдентификатор иконки (например, mdi:cog)
ЦветШестнадцатеричный код цвета (например, #1976d2)
ВключеноСостояние активности (true/false)
подсказка

Экспортируйте текущее оборудование перед массовыми изменениями. Это даёт вам резервную копию, к которой вы можете вернуться при необходимости.

Импорт оборудования​

Шаги​

  1. Нажмите кнопку Импорт в панели инструментов
  2. В диалоге импорта загрузите файл Excel (.xlsx)
  3. OpSee проверяет файл и показывает предварительный просмотр данных
  4. Просмотрите предварительный просмотр и подтвердите импорт
  5. Элементы оборудования создаются или обновляются на основе данных

Формат файла​

Файл импорта должен следовать той же структуре столбцов, что и экспорт. Самый простой способ получить правильный формат — это сначала экспортировать, изменить файл и переимпортировать.

Поведение импорта​

СценарийПоведение
Строка без IDСоздаётся новое оборудование
Строка с существующим IDСуществующее оборудование обновляется
Строка с неизвестным IDДля этой строки сообщается об ошибке
Обязательное поле (Название) пустоеДля этой строки сообщается об ошибке

Валидация​

Перед обработкой OpSee проверяет:

  • Обязательные поля — название должно присутствовать
  • Ссылки на родителя — ID родителя должны ссылаться на существующее оборудование
  • Ссылки на тип — ID типа должны ссылаться на существующие типы оборудования
  • Обнаружение дубликатов — предупреждает, если импорт создаст дубликаты
к сведению

Операции импорта регистрируются в Журнале аудита. Каждое созданное или обновлённое оборудование генерирует запись аудита с пользователем, временной меткой и старыми/новыми значениями.

Шаблон​

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

IDНазваниеОписаниеID родителяID типаНазвание типаИконкаЦветВключено
Линия розлива 1Главная линия розлива15Установкаmdi:cog#1976d2true
Миксер AОсновной миксер15Установкаmdi:mixer#2e7d32true
подсказка

Оставьте столбец ID пустым для нового оборудования. OpSee назначит ID автоматически. Столбец Название типа игнорируется при импорте — используется только ID типа.

Очистка дубликатов​

Если импорт создаёт дублирующее оборудование (одинаковое название, родитель и тип), используйте кнопку Очистить дубликаты в панели инструментов. Этот инструмент:

  1. Группирует оборудование по названию, ID родителя и ID типа
  2. Идентифицирует группы с более чем одной записью
  3. Сохраняет самый старый элемент (с наименьшим ID) и навсегда удаляет остальные
  4. Сообщает, сколько дубликатов было удалено
внимание

«Очистить дубликаты» выполняет жёсткое удаление дублирующихся записей. Это нельзя отменить. Всегда сначала экспортируйте оборудование как резервную копию перед запуском этого инструмента.

Лучшие практики​

  1. Экспортируйте перед импортом — всегда создавайте резервный экспорт перед массовым импортом.
  2. Используйте экспорт как шаблон — экспортируйте существующее оборудование, чтобы получить правильную структуру файла, затем добавьте новые строки.
  3. Малые партии — для крупных предприятий импортируйте партиями (например, по зонам), чтобы упростить просмотр и устранение неполадок.
  4. Проверяйте ID родителей — убедитесь, что родительское оборудование существует перед импортом дочерних элементов. Сначала импортируйте элементы верхнего уровня, затем дочерние.
  5. Очищайте после импорта — запускайте инструмент «Очистить дубликаты» после массовых импортов, чтобы поймать случайные дубликаты.

Предварительные требования​

Следующие шаги​

Связанное​