Daten importieren

Der Import-Assistent führt Sie in Schritten durch Datei, Inhalt, Zuordnung, Abgleich mit bestehenden Knoten, aktualisierbare Felder, Regeln und Vorschau. Im Schritt Datei wählen Sie eine Datei oder legen sie auf die Upload-Schaltfläche, die Blatt-/CSV-/ReqIF-Liste oder irgendwo sonst in diesem Schritt. So sehen Sie vor dem Speichern, was neu angelegt, was aktualisiert und was übersprungen wird.

Unterstützte Formate

Format	Typische Datei	Mehrere Knotentypen
CSV	.csv oder .zip	Ja, eine Datei pro Typ im ZIP
Excel	.xlsx oder .zip	Ja, ein Tabellenblatt pro Typ
JSON	.json oder .zip	Ja, mehrere Typen in einer Datei
ReqIF	.reqif oder .reqifz	ReqIF-Typen werden zugeordnet

Neue Anhänge brauchen das vollständige Export-ZIP (mit Ordner attachments/). Eine einzelne CSV- oder Excel-Datei enthält nur Pfade, keine Dateiinhalte. Im Assistenten können Sie Anhänge optional mit importieren: Bei Updates werden Dateien übersprungen, die am gematchten Knoten schon existieren; neue Dateien brauchen das Paket-ZIP.

Während Sie die Vorschau prüfen, hält der Server Anhangspakete kurz bereit (etwa 15 Minuten). Schließen Sie den Assistenten ohne Import, wird diese Zwischenablage freigegeben; nach einem erfolgreichen Import wird sie sofort gelöscht.

Knotentyp: Wer braucht type_slug?

Jeder importierte Knoten braucht einen gültigen Knotentyp aus Ihrem Projekt. Woher der Typ kommt, hängt vom Format ab.

CSV und Excel

Sie müssen den Typ nicht zwingend in der Datei haben.

Bei einer Datei oder einem Blatt wählen Sie den Knotentyp im Assistenten (Schritt Inhalt). Alle Zeilen werden diesem Typ zugeordnet.

Bei mehreren Dateien oder Blättern ordnen Sie im Schritt Inhalt jede Datei bzw. jedes Blatt einem Typ zu. Auch hier reicht die Auswahl im Assistenten.

Nur wenn verschiedene Typen in derselben Tabelle stehen sollen, braucht jede Zeile eine Spalte type_slug.

JSON

Jeder Knoten im JSON muss ein Feld type_slug haben. Anders als bei CSV oder Excel gibt es beim JSON-Import keinen Typ-Picker im Assistenten.

JSON setzt schema-bewusste Daten voraus

JSON ist das Round-Trip-Format für Automation: OakCore-Exporte zurück importieren, CI/CD-Pipelines oder eigene Tools, die OakCore-Feldnamen direkt schreiben. Property-Keys müssen zu Ihren Knotentypen passen — es gibt keinen Spalten-Mapping-Schritt wie bei CSV oder Excel.

Typische Anwendungsfälle:

• Re-Import eines OakCore-Exports (gleiches oder anderes Projekt)
• Automatisierter Datenaustausch zwischen Systemen
• Integration mit Skripten, die OakCore-kompatibles JSON erzeugen

Feldverhalten im Assistenten:

• Bekannte Felder (title, notes, benutzerdefinierte Attribute am Typ) werden automatisch importiert
• Unbekannte Attribute: überspringen oder neues Feld anlegen (Schritt Felder)
• Strukturelle Fehler (type_slug fehlt oder unbekannt, ungültiger Identifier, ungültiger Werttyp) blockieren den Import

Harte Vorgaben:

• Jedes Knoten-Objekt braucht einen type_slug, der zu einem aktivierten Typ in Ihrem Projekt passt
• Property-Keys müssen bereits OakCore-Feldnamen sein — es gibt keinen Mapping-Schritt
• Fehlender oder unbekannter type_slug blockiert den Import; unbekannte Zusatzattribute können im Schritt Felder übersprungen oder angelegt werden
• Für Tabellen mit fremden Spaltennamen verwenden Sie CSV oder Excel

Mehrere Typen in einer Datei sind möglich, wenn jeder Eintrag seinen eigenen type_slug mitbringt. Fehlt das Feld oder passt der Wert nicht zu einem Typ in Ihrem Projekt, wird der Import blockiert.

ReqIF

ReqIF-Dateien enthalten keine OakCore-type_slug. Sie wählen im Assistenten, welcher Requirement-Typ in Ihrem Projekt die importierten Objekte werden.

ReqIF-Attributtypen (String, XHTML, Enumeration, Integer, Real, Boolean, Date) werden beim Import beibehalten, soweit sie zu OakCore-Feldtypen passen.

Weitere Optionen im Assistenten

Abgleich: Sie legen fest, ob importierte Zeilen bestehende Knoten aktualisieren oder immer neu angelegt werden. Für einen OakCore-Round-Trip verwenden Sie die stabile exchange_id; für neue Lieferungen aus DOORS, Excel oder anderen Quellen wählen Sie ein stabiles ID-Feld der Quelle, zum Beispiel ext_id. OakCore gleicht immer nur über den ausgewählten Identifier ab und wechselt nicht unbemerkt auf ein anderes Feld.

Aktualisierbare Felder: Wenn bestehende Knoten aktualisiert werden können, wählen Sie je Knotentyp explizit aus, welche Felder die Datei verändern darf. Die Feldliste hat eine Kopf-Checkbox, die alle Felder dieses Typs auswählt oder leert. Bei einem RFQ können Sie beispielsweise nur Bewertung und Lieferantenkommentar freigeben, während Anforderungstext und Titel geschützt bleiben. Neue Knoten erhalten weiterhin alle zugeordneten gültigen Felder.

Relationen (nur ReqIF): Optional können Verknüpfungen aus einer ReqIF-Datei mit importiert werden, wenn beide Enden im Projekt gefunden werden.

Anhänge: Optional können Dateien aus einem OakCore-Exportpaket auf die passenden Knoten hochgeladen werden. Bereits vorhandene Dateien mit gleichem Namen, gleicher Größe und gleichem Dateityp werden übersprungen.

Container: Der Pfad in container_path legt die Ablage im Projektbaum fest. Fehlt er, landen neue Knoten in der Inbox.

Import-Historie

Nach einem erfolgreichen Import speichert OakCore einen Import-Lauf für das Projekt: Dateiname, wer importiert hat, wann, und Zähler (neu, aktualisiert, unverändert). Unter Import → Import-Historie sehen Sie, welche Knoten Teil eines Laufs waren, filtern nach Ergebnis und öffnen einen Knoten für Feld-Diffs im Reiter Historie. Änderungen aus einem Import verweisen in der Knotenhistorie zurück auf diesen Lauf.

Die Import-Historie wird so lange aufbewahrt wie die Bearbeitungshistorie aktiver Knoten (Settings → Data retention → Node edit and import history retention).

OakCore-Export zurück importieren

Wenn Sie eine Datei aus demselben oder einem anderen OakCore-Projekt importieren, erkennt der Assistent das oft anhand der Metadaten. JSON-, CSV- und Excel-Exporte enthalten in der Regel bereits type_slug, exchange_id und den exportierten Revisionsstand. Damit kann OakCore die passenden Knoten finden und bei einem Rückimport in das Ursprungsprojekt auf parallele Änderungen hinweisen.

Zurück zur Übersicht: Import und Export.