Zum Hauptinhalt springen

Import & Export

Unter Import / Export bringst du Bestandsdaten in großen Mengen nach Leitstand hinein und holst sie jederzeit wieder heraus – immer als CSV-Datei, kompatibel mit Excel (UTF-8).

Das ist nützlich für den Erststart (eine bestehende Excel-Liste übernehmen), für regelmäßige Backups und für Auswertungen außerhalb von Leitstand.

tipp

Für den allerersten Import beim Einstieg gibt es eine Schritt-für-Schritt-Anleitung unter Bestandsdaten per CSV importieren. Diese Seite beschreibt die Funktion vollständig, inklusive Export.

Daten exportieren​

Im oberen Bereich „Daten exportieren" kannst du deine Inventardaten herunterladen.

Inventardaten als Vollexport (ZIP) herunterladen

Einzelne Objekttypen​

Für jeden Objekttyp gibt es eine eigene Karte mit der Anzahl der Einträge und einer Schaltfläche „CSV Export". Exportierbar sind:

  • Applikationen
  • Infrastruktur
  • Fähigkeiten
  • Projekte
  • Dienstleister

Die Datei ist UTF-8-kodiert und öffnet sich direkt in Excel oder LibreOffice. Listen wie tags, capability_ids oder app_ids sind innerhalb einer Zelle durch Semikolon getrennt.

Der Export der Dienstleister ist ein Report mit deutschsprachigen Spalten (u. a. Anzahl und Namen der zugeordneten Applikationen) und eignet sich nicht für einen erneuten Import.

Alles exportieren (ZIP)​

Mit „ZIP herunterladen" bekommst du ein komplettes Paket: alle Objekte, alle Schnittstellen, die Dienstleister-Zuordnungen und den vollständigen Audit-Log in einer ZIP-Datei.

Das ist der richtige Export für ein vollständiges Backup oder als revisionssicherer Nachweis für ein Audit.

Neben den Rohdaten enthält das ZIP zwei fertige Reports: den DSGVO-Report der externen Schnittstellen (external_interfaces.csv) und den Schnittstellen-Report mit Verbindungsart (interface_connections.csv).

Schnittstellen-Report (CSV)​

Die Karte „Schnittstellen-Report (CSV)" liefert mit „CSV herunterladen" eine Excel-taugliche Liste aller Schnittstellen – App zu App und App zu externem Partner – mit ihrer Verbindungsart: Point-to-Point, über Gateway/ETL (inkl. Name der Gateway-App) oder unbekannt. Spalten und Werte sind deutschsprachig, IDs sind nicht enthalten.

Die Spalten im Detail beschreibt Schnittstellen dokumentieren → Schnittstellen-Report.

Daten importieren​

Der Import läuft als dreistufiger Assistent ab. So wird nie etwas blind überschrieben – du siehst vor dem Speichern genau, was passiert.

Hinweis: Importieren können nur Nutzer mit Schreibrechten (Editor/Admin).

Schritt 1 – Hochladen​

  1. Wähle oben den Objekttyp (z. B. Applikationen)
  2. Lade optional die Vorlage herunter – eine CSV mit den richtigen Spaltenüberschriften
  3. Ziehe deine CSV-Datei in das Feld oder klicke zum Auswählen
  4. Klicke auf „Weiter"

Importierbar sind Applikationen, Fähigkeiten, Infrastruktur, Organisationseinheiten, Projekte und Dienstleister. Organisationseinheiten haben keine eigene Seite in der Oberfläche; sie lassen sich nur per Import (oder über die API) pflegen.

Die Spalten der Datei müssen den Feldnamen der Vorlage entsprechen – eine Zuordnung abweichender Spaltennamen gibt es nicht. Erwartet wird Komma als Trennzeichen; Listen innerhalb einer Zelle (z. B. tags) werden durch Semikolon getrennt. Die Spalten für Applikationen erklärt Bestandsdaten per CSV importieren.

hinweis

Es werden CSV-Dateien (.csv) erwartet. Eine Excel-Datei (.xlsx) speicherst du vorher über Datei → Speichern unter → CSV UTF-8.

Schritt 2 – Prüfen​

Leitstand prüft die Datei und zeigt dir eine Vorschau, bevor etwas gespeichert wird:

  • wie viele Einträge neu angelegt werden
  • wie viele bestehende Einträge aktualisiert werden
  • welche Zeilen Fehler haben (mit Zeilennummer und Grund)

Fehlerhafte Zeilen werden beim Import übersprungen; die gültigen Einträge werden trotzdem importiert. So bleibt ein einzelner Tippfehler nicht der ganzen Datei im Weg.

Schritt 3 – Importieren​

Mit „… Einträge importieren" (davor steht die Anzahl der gültigen Einträge) bestätigst du den Import. Anschließend siehst du unter „Import abgeschlossen" eine Zusammenfassung (angelegt / aktualisiert / übersprungen) und kannst bei Bedarf die Fehlerdetails einblenden. Mit „Neuer Import" startest du den nächsten Durchgang.

Wie Leitstand neue und bestehende Einträge unterscheidet​

Entscheidend ist die Spalte id: Eine Zeile mit id aktualisiert den bestehenden Eintrag mit dieser ID, eine Zeile ohne id legt einen neuen Eintrag an. Ein Abgleich über den Namen findet nicht statt – importierst du eine Datei ohne IDs zweimal, entstehen Dubletten.

Der bequeme Weg, viele Einträge auf einmal zu ändern, ist deshalb: exportieren (der Export enthält die id), in Excel bearbeiten, wieder importieren. Das gilt für Applikationen, Infrastruktur, Fähigkeiten und Projekte; der Dienstleister-Export ist ein Report ohne id (siehe oben).

Häufige Fragen​

Überschreibt der Import meine bestehenden Daten?
Nur die Felder, die in der CSV befüllt sind – leere Zellen ändern nichts. Du siehst in Schritt 2 vorab, welche Einträge angelegt und welche aktualisiert werden – nichts wird ungeprüft gespeichert.

Was ist der Unterschied zwischen Einzelexport und ZIP-Export?
Der Einzelexport liefert eine CSV pro Objekttyp – gut für eine konkrete Auswertung. Der ZIP-Export enthält alles inklusive Schnittstellen und Audit-Log – gut für Backup und Audit.

Kann ich Schnittstellen importieren?
Schnittstellen werden im ZIP-Export mitgeliefert, aber im Import-Assistenten nicht als eigener Objekttyp angeboten. Lege Schnittstellen an der Applikation oder zentral unter Inventar → Schnittstellen an – siehe Schnittstellen dokumentieren.