Zum Hauptinhalt springen

Import / Export

OpSee unterstützt den Massenimport und -export von Ausrüstungsdaten über Excel-Dateien (.xlsx). Das ist nützlich für die Ersteinrichtung, die Migration aus anderen Systemen, Sicherungen und Massenaktualisierungen.

Import / Export aufrufen​

In der Symbolleiste des Ausrüstungsrasters stehen zwei Schaltflächen zur Verfügung:

SchaltflächeSymbolBeschreibung
ImportierenHochladenÖffnet den Importdialog zum Hochladen einer Excel-Datei
ExportierenHerunterladenÖffnet den Exportdialog zum Herunterladen der Ausrüstung als Excel

Import-/Export-Schaltflächen in der Symbolleiste

Ausrüstung exportieren​

Schritte​

  1. Klicken Sie in der Symbolleiste auf Exportieren
  2. Konfigurieren Sie im Exportdialog die Optionen:
    • Dateiname – der Standardname ist mit einer übersetzten Bezeichnung vorausgefüllt; bei Bedarf anpassen
    • Deaktivierte einbeziehen – Schalter, um inaktive Ausrüstung in den Export einzuschließen (standardmäßig aus)
  3. Klicken Sie auf Exportieren

Eine Excel-Datei wird in Ihren Browser heruntergeladen, mit allen zur gewählten Option passenden Anlagen.

Exportdialog

Exportierte Spalten​

Die Excel-Datei enthält folgende Spalten:

SpalteBeschreibung
IDAusrüstungs-ID (schreibgeschützt, für Aktualisierungen verwendet)
NameName der Ausrüstung
BeschreibungBeschreibung der Ausrüstung
Eltern-IDID der übergeordneten Ausrüstung
Typ-IDID des Ausrüstungstyps
TypnameName des Ausrüstungstyps (schreibgeschützt, zur Referenz)
SymbolSymbol-Bezeichner (z. B. mdi:cog)
FarbeFarb-Hex-Code (z. B. #1976d2)
AktiviertAktivstatus (true/false)
tipp

Exportieren Sie Ihre aktuelle Ausrüstung vor jeder Massenänderung. So haben Sie eine Sicherung, auf die Sie bei Bedarf zurückgreifen können.

Ausrüstung importieren​

Schritte​

  1. Klicken Sie in der Symbolleiste auf Importieren
  2. Laden Sie im Importdialog eine Excel-Datei (.xlsx) hoch
  3. OpSee validiert die Datei und zeigt eine Vorschau der Daten an
  4. Prüfen Sie die Vorschau und bestätigen Sie den Import
  5. Ausrüstungselemente werden anhand der Daten erstellt oder aktualisiert

Dateiformat​

Die Importdatei muss derselben Spaltenstruktur wie der Export entsprechen. Der einfachste Weg zum richtigen Format ist, zuerst zu exportieren, die Datei zu bearbeiten und sie wieder zu importieren.

Importverhalten​

SzenarioVerhalten
Zeile ohne IDEin neues Ausrüstungselement wird erstellt
Zeile mit vorhandener IDDie bestehende Ausrüstung wird aktualisiert
Zeile mit unbekannter IDFür diese Zeile wird ein Fehler gemeldet
Pflichtfeld (Name) leerFür diese Zeile wird ein Fehler gemeldet

Validierung​

Vor der Verarbeitung prüft OpSee:

  • Pflichtfelder – Name muss vorhanden sein
  • Eltern-Referenzen – Eltern-IDs müssen auf vorhandene Ausrüstung verweisen
  • Typ-Referenzen – Typ-IDs müssen auf vorhandene Ausrüstungstypen verweisen
  • Duplikatserkennung – warnt, falls der Import Duplikate erzeugen würde
info

Importvorgänge werden im Audit-Trail protokolliert. Jede erstellte oder aktualisierte Anlage erzeugt einen Audit-Eintrag mit Benutzer, Zeitstempel sowie Alt-/Neuwerten.

Vorlage​

Wenn Sie ohne vorhandene Ausrüstung zum Exportieren bei Null beginnen, können Sie eine leere Excel-Datei mit den korrekten Spaltenüberschriften erstellen:

IDNameBeschreibungEltern-IDTyp-IDTypnameSymbolFarbeAktiviert
Abfülllinie 1Hauptabfülllinie15Einheitmdi:cog#1976d2true
Mischer AHauptmischer15Einheitmdi:mixer#2e7d32true
tipp

Lassen Sie die Spalte ID für neue Ausrüstung leer. OpSee vergibt die IDs automatisch. Die Spalte Typname wird beim Import ignoriert – nur die Typ-ID wird verwendet.

Duplikate bereinigen​

Wenn ein Import doppelte Ausrüstung erzeugt (gleicher Name, Eltern und Typ), verwenden Sie die Schaltfläche Duplikate bereinigen in der Symbolleiste. Dieses Werkzeug:

  1. Gruppiert Ausrüstung nach Name, Eltern-ID und Typ-ID
  2. Identifiziert Gruppen mit mehr als einem Eintrag
  3. Behält das älteste Element (niedrigste ID) und löscht die übrigen endgültig
  4. Meldet, wie viele Duplikate entfernt wurden
warnung

Duplikate bereinigen führt eine endgültige Löschung der doppelten Einträge durch. Dies kann nicht rückgängig gemacht werden. Exportieren Sie Ihre Ausrüstung immer zuerst als Sicherung, bevor Sie dieses Werkzeug ausführen.

Bewährte Praktiken​

  1. Vor dem Import exportieren – legen Sie vor jedem Massenimport eine Sicherung als Export an.
  2. Export als Vorlage – exportieren Sie die vorhandene Ausrüstung, um die richtige Dateistruktur zu erhalten, und fügen Sie dann neue Zeilen hinzu.
  3. Kleine Stapel – importieren Sie in großen Werken stapelweise (z. B. pro Bereich), um Prüfung und Fehlersuche zu erleichtern.
  4. Eltern-IDs prüfen – stellen Sie sicher, dass die übergeordnete Ausrüstung existiert, bevor Sie die untergeordneten Elemente importieren. Importieren Sie zuerst die obersten Elemente, dann die Kinder.
  5. Nach dem Import bereinigen – führen Sie nach Massenimporten das Werkzeug Duplikate bereinigen aus, um versehentliche Duplikate aufzuspüren.

Voraussetzungen​

Nächste Schritte​

Verwandt​