Datensätze aus CSV importieren

Der CSV-Importer wandelt eine Tabelle in Datensätze um – einen Datensatz pro Zeile. Sie finden ihn unter Datensätze → Datensätze importieren. Er führt Sie durch die Auswahl einer Vorlage, die Zuordnung von Spalten zu Feldern, die Auswahl eines Ziel-Ordners und die Ausführung des Imports mit Live-Fortschrittsanzeige.

CSV-Format

Bereiten Sie eine Kopfzeile und einen Datensatz pro Zeile vor und halten Sie eine Spalte für den Namen des Datensatzes bereit. Der Bereich CSV-Format in der Seitenleiste schlägt Beispielspalten vor (Name, Beschreibung, Status, Eigentümer), und über Beispiel-CSV herunterladen erhalten Sie eine Ausgangsdatei. Es werden ausschließlich .csv-Dateien akzeptiert („Nur CSV-Dateien“), und „dieser Importer erwartet, dass jede Zeile in der CSV-Datei einen einzelnen Datensatz darstellt“.

Zwei weitere Hinweise zum Format:

Eine Spalte liefert den Namen des Datensatzes und muss in jeder Zeile, die Sie importieren möchten, einen Wert enthalten. DICE schlägt eine Spalte Name/Titel vor, wenn eine gefunden wird, und wählt andernfalls die erste Spalte aus.
Die Spaltentypen (Text, Datum, Zahl) werden beim Erstellen einer Vorlage automatisch aus den Daten erkannt. Halten Sie deshalb die Werte innerhalb jeder Spalte konsistent.

Importmodus auswählen

Der Abschnitt Importmodus bietet zwei Möglichkeiten:

Neue Vorlage erstellen und importieren — „Laden Sie eine CSV-Datei hoch, lassen Sie automatisch eine Vorlage erstellen, prüfen Sie sie und importieren Sie anschließend.“ Dies eignet sich am besten für einen erstmaligen Import: DICE leitet aus Ihren Spalten eine Vorlage ab.
In eine vorhandene Vorlage importieren — „Wählen Sie zuerst eine Vorlage aus, ordnen Sie anschließend Felder zu und importieren Sie Datensätze.“ Diese Option ist verfügbar, sobald Sie mindestens eine Vorlage haben. Beispieldatei herunterladen erzeugt eine CSV-Datei, die den Feldern der ausgewählten Vorlage entspricht.

Mit einer neuen Vorlage importieren

CSV hochladen — klicken Sie zum Hochladen oder ziehen Sie die Datei per Drag-and-drop in den Bereich. Die Datei wird direkt verarbeitet und die Anzahl der Zeilen wird angezeigt („N Zeilen bereit für die Zuordnung“).
Vorlagenerstellung prüfen — die abgeleitete Vorlage wird mit einem aus dem Dateinamen vorausgefüllten Vorlagennamen und einer Vorlagenbeschreibung sowie den erkannten Datenfeldern angezeigt.
Bestätigen Sie unter Name und Beschreibung des Datensatzes die Namensspalte und optional die Beschreibungsspalte. Diese Spalten werden unter Datenfelder als Datensatzname beziehungsweise Datensatzbeschreibung aufgeführt und mit Wird nicht als Feld erstellt gekennzeichnet, da jeder Datensatz diese Angaben bereits enthält.
Klicken Sie auf Vorlage erstellen. Die Vorlage wird in Ihrem Team gespeichert und Sie gelangen zur Auswahl des Ziels und zum Import („Vorlage erstellt. Fahren Sie mit der Auswahl des Ziels und dem Import fort.“).

Da die Vorlage aus Ihrer CSV-Datei erstellt wurde, wird die Spaltenzuordnung automatisch angewendet („Diese Vorlage wurde aus der hochgeladenen CSV-Datei erstellt, daher wird die Feldzuordnung automatisch angewendet.“). Der Bereich Automatische Spaltenzuordnung zeigt erneut die Quellen für Name und Beschreibung an. Verwenden Sie Zurück zur Vorlage, um diese zu ändern.

In eine vorhandene Vorlage importieren

Wählen Sie unter Vorlage auswählen die Vorlage aus, in welche die importierten Zeilen übernommen werden sollen.
CSV hochladen — „Laden Sie eine CSV-Datei hoch, um mit der Zuordnung und dem Import zu beginnen.“ Der Bereich zeigt Ihre CSV-Zeilen neben den Vorlagenfeldern der ausgewählten Vorlage an.
Klicken Sie auf Weiter zur Feldzuordnung.

Ziel und Feldzuordnung

Im Schritt Ziel und Feldzuordnung legen Sie fest, was erstellt wird:

Ordner — der Zielordner für jeden importierten Datensatz. Die Auswahl ist mit Ihrem zuletzt verwendeten Ordner vorausgefüllt. Vor dem Import müssen Sie einen Ordner auswählen.
Feldzuordnung — „Ordnen Sie jedes Vorlagenfeld der CSV-Spalte zu, deren Wert es erhalten soll.“ Vorgeschlagene Zuordnungen werden anhand übereinstimmender Spaltennamen angewendet. Felder, für die Keine Spalte ausgewählt ist, werden einfach nicht befüllt. (Dieser Schritt wird übersprungen, wenn die Vorlage automatisch aus der CSV-Datei erstellt wurde.)
Name und Beschreibung des Datensatzes — die CSV-Spalte, aus der jeder Datensatz seinen Namen bezieht (erforderlich), und optional seine Beschreibung. Dies sind Eigenschaften des Datensatzes, daher werden die Spalten nicht als Felddaten gespeichert.
Diese Spalten zusätzlich als Felder speichern — standardmäßig deaktiviert. Aktivieren Sie diese Option, um die Werte für Name und Beschreibung zusätzlich in den Felddaten jedes Datensatzes zu speichern. Bei einem zugeordneten Feld, das übersprungen wird, wird dies unter seinem Namen angegeben – auch bei einem erforderlichen Feld –, da stattdessen der Name und die Beschreibung des Datensatzes selbst den Wert enthalten.

Unterhalb der Zuordnung zeigt die Vorschau der importierten Datensätze die ersten Zeilen so an, wie sie importiert werden, einschließlich einer Bereitschaftsangabe („N Zeilen bereit zum Importieren“). Außerdem werden Zeilen gekennzeichnet, deren Import fehlschlagen würde („N Zeilen schlagen derzeit fehl“) – typischerweise Zeilen, in denen ein erforderlicher Wert fehlt. Korrigieren Sie die CSV-Datei oder die Zuordnung, bis die für Sie relevanten Zeilen als Bereit angezeigt werden.

Jede Vorschauzeile entspricht dem Aufbau der späteren Datensatzseite: Name, Vorlage und Beschreibung, gefolgt von Organisation, Team und Ordner, zu denen der Datensatz gehören wird. Es lohnt sich, diese letzte Zeile vor dem Import zu prüfen: Ein für Sie freigegebener Ordner gehört einem anderen Team, und darin erstellte Datensätze gehören diesem Team, nicht Ihrem.

Import ausführen

Klicken Sie auf N Datensätze importieren. Der Import erfolgt stapelweise mit einem Live-Importstatus („X von Y Zeilen werden verarbeitet. Stapel A von B.“). Anschließend wird eine Zusammenfassung angezeigt: „N Datensätze importiert.“ und, falls zutreffend, „N Zeilen fehlgeschlagen.“

Bei einem erfolgreichen Import wird außerdem für jeden Datensatz eine Aktivitätsgruppe Datensatz importiert im Aktivitätsfeed erfasst. Die erstellte Vorlage bleibt für zukünftige Importe verfügbar.

Ein Baugruppenpaket importieren

Unabhängig vom CSV-Import kann DICE ein Baugruppen-Importpaket importieren – eine JSON-Datei, die Datensätze, Baugruppen, Bauteilanhänge und Beziehungslinks in einer einzigen Struktur beschreibt. Sie finden diese Funktion unter Baugruppen → Baugruppenpaket importieren.

Fügen Sie den JSON-Inhalt des Pakets ein oder wählen Sie Datei laden.
Klicken Sie auf Paket validieren. Das Paket wird in einem Probelauf in einen Importplan überführt: Dieser enthält die Anzahl der zu erstellenden Datensätze, Baugruppen, Datensätze ohne Baugruppe, Datensatzanhänge und Datensatzlinks sowie mögliche blockierende Probleme und Warnungen. Referenzierte Ordner, Kategorien und Beziehungen werden mit den bereits vorhandenen abgeglichen und als Vorhandenes wiederverwenden oder Neu erstellen gekennzeichnet beziehungsweise bei Mehrdeutigkeit markiert.
Wenn im Plan „Dieses Paket ist bereit für den Import.“ angezeigt wird, klicken Sie auf Import bestätigen.

Anders als der CSV-Import ist der Import eines Baugruppenpakets transaktional: „Es wird nichts geschrieben, bis Sie den Import bestätigen, und der Import folgt dem Alles-oder-nichts-Prinzip.“ Beheben Sie vor der Bestätigung alle blockierenden Probleme. Unter Baugruppen erfahren Sie mehr über Baugruppen und Bauteile.

DatensätzeVorlagen und Felder, die durch Importe befüllt werden.

OrdnerZielorte für importierte Datensätze.

BaugruppenBaugruppen, Bauteile und Positionen.

Ein Problem mit der Dokumentation melden