Erste Schritte

12 Min. Lesezeit Veröffentlicht am 06/01/2026

Erster Datenimport

Migrieren Sie Ihre bestehenden Assets, Mitarbeiter und Verträge zu KaliaOps

Auf einen Blick

KaliaOps bietet CSV-Import-Tools für die schnelle Migration Ihrer bestehenden Daten. Importieren Sie Ihre Assets, Anwendungen, Mitarbeiter, Organisationen und Verträge mit wenigen Klicks. Das System validiert Daten automatisch, erkennt Duplikate und erstellt einen detaillierten Fehlerbericht. Behalten Sie eine vollständige Import-Historie für Audit und Nachverfolgung.

Importierbare Entitäten

KaliaOps ermöglicht den Import folgender Entitäten über CSV-Dateien:

CMDB

Assets: Server, Arbeitsplatzrechner, Netzwerkgeräte, Drucker, Peripheriegeräte. Enthält Inventarinformationen, IP-Adressen, Seriennummern und Standort.
Anwendungen: Geschäftssoftware, Cloud-Dienste, Datenbanken. Mit Version, Kritikalität, technischem Verantwortlichen und Abhängigkeiten.
Verträge: Wartungsverträge, Softwarelizenzen, Lieferanten-SLAs. Enthält Daten, Beträge und Verlängerungsbedingungen.
Lieferanten: Lieferanten und Dienstleister mit Kontaktdaten, Ansprechpartnern und rechtlichen Informationen.

Organisation

Organisationen: Rechtliche Einheiten, Tochtergesellschaften, Abteilungen, Divisionen. Hierarchische Struktur mit Verantwortlichen.
Standorte: Physische Standorte: Büros, Rechenzentren, Lager. Mit Adressen und Zeitzonen.
Teams: Funktions- oder Projektteams, einer Organisation zugeordnet.
Mitarbeiter: Mitarbeiter mit Position, Vorgesetztem, Team und Kontaktdaten.

Dateien vorbereiten

Erforderliches CSV-Format

Ihre Dateien müssen folgende Spezifikationen erfüllen:

Kodierung: UTF-8 (erforderlich für Sonderzeichen)
Trennzeichen: Komma (,) standardmäßig (RFC 4180)
Kopfzeilen: Erste Zeile mit Spaltennamen
Anführungszeichen: Werte mit Trennzeichen in doppelten Anführungszeichen
Maximale Größe: 10 MB pro Datei

Beispiel Asset-Datei

name;asset_type;serial_number;ip_address;site_code;status
"SRV-PROD-01";server;"ABC123456";192.168.1.10;"BERLIN-DC";active
"PC-BUCHHALTUNG-001";desktop;"DEF789012";192.168.2.50;"BERLIN-HQ";active

Pflichtfelder pro Entität

Entität	Pflichtfelder
Assets	name, type, organization_id
Anwendungen	name, organization_id
Mitarbeiter	code, first_name, last_name, email
Organisationen	name
Standorte	name, city, country
Teams	name, organization_id
Verträge	name, supplier_id, type, start_date, end_date
Lieferanten	name

Tipp: Exportieren Sie zuerst einige Datensätze aus KaliaOps, um eine CSV-Vorlage mit den richtigen Spaltenüberschriften zu erhalten.

Import-Prozess

Import-Tool aufrufen

Klicken Sie im Seitenmenü auf Administration → Importe. Wählen Sie den Entitätstyp aus, den Sie importieren möchten.

Datei hochladen

Klicken Sie auf «Datei auswählen» oder ziehen Sie Ihre CSV-Datei per Drag & Drop. Das System erkennt automatisch Kodierung und Trennzeichen. Eine Vorschau der ersten 5 Zeilen wird angezeigt.

Zuordnung konfigurieren

KaliaOps bietet automatische Zuordnung basierend auf Spaltennamen. Überprüfen und passen Sie bei Bedarf an:

Ordnen Sie jede CSV-Spalte einem KaliaOps-Feld zu
Markieren Sie zu ignorierende Spalten
Definieren Sie Standardwerte für fehlende Felder

Validieren und Import starten

Klicken Sie auf «Validieren», um die Daten zu prüfen. Das System zeigt eine Zusammenfassung:

Anzahl der zu erstellenden Zeilen
Anzahl der zu aktualisierenden Zeilen (wenn Schlüssel existiert)
Zeilen mit Fehlern (Details verfügbar)

Wenn das Ergebnis zufriedenstellend ist, klicken Sie auf «Importieren».

Bericht überprüfen

Am Ende des Imports zeigt ein detaillierter Bericht:

Erfolgreich erstellte Zeilen
Aktualisierte Zeilen
Übersprungene Zeilen (Duplikate)
Zeilen mit Fehlern und dem Grund

Feldzuordnung

Automatische Zuordnung

KaliaOps erkennt automatisch gängige Kopfzeilen und ordnet sie entsprechenden Feldern zu:

Erkannte Kopfzeilen	KaliaOps-Feld
name, nom, bezeichnung	name
code, reference, ref	code
serial, serial_number, seriennummer	serial_number
ip, ip_address, ip_adresse	ip_address
email, mail, e_mail	email
status, statut, zustand	status

Referenzen zwischen Entitäten

Um Entitäten miteinander zu verknüpfen, verwenden Sie den Code der Zielentität:

Mitarbeiter → Team: Spalte team_code mit dem Team-Code
Asset → Standort: Spalte site_code mit dem Standort-Code
Anwendung → Organisation: organization_code

Wenn der referenzierte Code nicht existiert, wird die Zeile als Fehler markiert.

Wichtig: Codes sind groß-/kleinschreibungsempfindlich. «BERLIN-HQ» und «berlin-hq» werden als unterschiedlich betrachtet.

Validierung und Fehler

Automatische Validierungen

Vor dem Import prüft KaliaOps:

Datenformat: Daten im ISO-Format (JJJJ-MM-TT), gültige E-Mails, korrekte IP-Adressen, numerische Werte.
Pflichtfelder: Erforderliche Felder müssen vorhanden und nicht leer sein.
Vorhandene Referenzen: Referenzierte Codes (site_code, team_code usw.) müssen in KaliaOps existieren.
Eindeutigkeit: Eindeutige Codes und Kennungen dürfen nicht dupliziert werden.
Erlaubte Werte: Enum-Felder (status, type, criticality) müssen gültige Werte enthalten.

Häufige Fehlertypen

Fehler	Ursache	Lösung
Reference not found	Referenzierter Code existiert nicht	Zielentität zuerst importieren
Duplicate entry	Code existiert bereits	Code ändern oder aktualisieren
Invalid format	Falsches Datenformat	Format korrigieren (Datum, E-Mail, IP)
Required field missing	Pflichtfeld leer	Wert vervollständigen

Import-Historie

Jeder Import wird in der Historie mit folgenden Informationen aufgezeichnet:

Datum und Uhrzeit des Imports
Benutzer, der den Import durchgeführt hat
Importierter Entitätstyp
Name der Quelldatei
Statistiken: erstellt, aktualisiert, übersprungen, Fehler
Dauer des Imports
Detailliertes Fehlerprotokoll (herunterladbar)

Zugriff auf die Historie

Die Historie ist über Administration → Importe → Historie zugänglich. Sie können nach Entitätstyp, Zeitraum oder Benutzer filtern.

Empfohlene Import-Reihenfolge

Damit Referenzen zwischen Entitäten korrekt funktionieren, befolgen Sie diese Import-Reihenfolge:

Standorte - Physische Standorte (keine Abhängigkeiten)
Organisationen - Können einen Hauptstandort referenzieren
Teams - Referenzieren eine Organisation
Mitarbeiter - Referenzieren Team, Vorgesetzten, Organisation
Lieferanten - Können einen Mitarbeiter referenzieren (Kundenbetreuer)
Anwendungen - Referenzieren Organisation, Lieferant, technischer Verantwortlicher
Assets - Referenzieren Standort, Anwendung, VLAN
Verträge - Referenzieren Lieferant

Tipp: Beginnen Sie mit dem Import von Entitäten ohne Abhängigkeiten (Standorte) und arbeiten Sie sich dann zu den Entitäten vor, die darauf verweisen.

Best Practices

Migration vorbereiten

Bereinigen Sie Ihre Daten vor dem Import: Duplikate entfernen, Formate korrigieren
Testen Sie mit einer Stichprobe: 10-20 Zeilen importieren, um die Zuordnung zu validieren
Dokumentieren Sie Ihre Codes: Etablieren Sie eine konsistente Namenskonvention

Während des Imports

Importieren Sie in mehreren Stapeln statt einer riesigen Datei (max. 5000 Zeilen empfohlen)
Prüfen Sie Fehlerberichte bevor Sie fortfahren
Behalten Sie Quelldateien als Referenz

Nach dem Import

Überprüfen Sie eine Stichprobe der importierten Datensätze
Testen Sie Beziehungen: Zeigt ein Asset auf den richtigen Standort?
Vervollständigen Sie manuell fehlende oder spezifische Daten

Aktualisierungen verwalten

Um bestehende Datensätze per Import zu aktualisieren:

Verwenden Sie denselben Code wie der bestehende Datensatz
Das System erkennt automatisch, dass es sich um eine Aktualisierung handelt
Nur in der CSV vorhandene Felder werden geändert

Wichtige Punkte

CSV-Import für Assets, Anwendungen, Mitarbeiter, Organisationen, Teams, Standorte und Verträge
Automatische Spaltenzuordnung mit manueller Anpassungsmöglichkeit
Echtzeit-Validierung: Formate, Referenzen, Duplikate
Detaillierter Bericht: erstellte, aktualisierte, übersprungene Zeilen und Fehler
Vollständige Import-Historie mit Rollback-Möglichkeit