CSV-Dateiformat mit Beispielen

Stellen Sie vor dem Importieren einer Datei mit durch Kommas getrennten Werten (CSV-Datei) sicher, dass die Datei das CSV-Format hat. Außerdem müssen CSV-Dateien wie auch Arbeitsblattdateien den Inhaltsregeln für Zeilen und Spalten folgen und in UTF-8 codiert sein.

CSV-Format

IBM® Engineering Requirements Management DOORS® Next, implementiert das CSV-Format, wie es im RFC 4180-Dokument der Network Working Group der Internet Society spezifiziert ist. Allgemeine Informationen über das CSV-Dateiformat finden Sie unter Comma-separated values auf der RFC Editor-Website.

Inhaltsregeln für CSV-Dateien und Arbeitsblattdateien

Damit eine CSV-Datei oder Arbeitsblattdatei erfolgreich importiert werden kann, muss der Inhalt den folgenden Regeln entsprechen:
Zeilen
Jede Zeile in der Datei muss dieselbe Anzahl von Zellen enthalten. Dies gilt auch für die Kopfzeile.
Kopfzeile
Die erste Zeile muss Spaltenüberschriften enthalten. Diese Überschriften dürfen keine Escape-Zeichen oder Hochkommata enthalten.
Spalten der ersten Zeile
In der folgenden Tabelle sind die Anforderungen für die Spalten der ersten Zeile aufgeführt. Sie können so viele Spalten verwenden, wie benötigt werden, damit sie den Feldern in einem Artefakttyp entsprechen. Der Artefakttyp, dem die Spalten zugeordnet werden, wird in jeder Inhaltszeile durch den Eintrag in der Spalte 'Typ' festgelegt.
Tabelle 1 Inhaltsregeln für Zeilen und Spalten: Spalten der ersten Zeile
Spaltenname Vorhandensein
Artefakttyp Erforderlich. Jede Zeile der CSV-Datei muss in dieser Spalte einen Eintrag für einen Artefakttyp des Systems enthalten.
Ihren Namen Erforderlich, wenn der Primärtext fehlt. Standardmäßig hat jedes Artefakt im System ein Feld vom Typ Name. Die Daten in diesem Feld werden angezeigt, wenn Sie die Ordnerhierarchien oder Such- und Filterergebnisse aufrufen.
Primärtext Erforderlich, wenn der Name fehlt. Jeder textbasierte Artefakttyp des Systems enthält ein Feld vom Typ Primärtext für den primären Inhalt des Artefakts. Handelt es sich bei dem Artefakt beispielsweise um eine Anforderung, besteht der zugehörige Primärtext aus der eigentlichen Anforderung. Beispiel: 'Das Fahrzeug muss zwei Räder haben.'
Beschreibung Empfohlen. Standardmäßig hat jedes Artefakt im System ein Feld vom Typ Beschreibung. Die Beschreibung wird in einer QuickInfo angezeigt, wenn Sie den Mauszeiger über einen Titel bewegen.
Das folgende Beispiel zeigt einen CSV-Eintrag für ein Artefakt mit dem angepassten Artefakttyp MyRequirementType:
Artifact Type, Primary Text, Name, Description, Owner
MyRequirementType, "The vehicle must have two wheels.", "Vehicle wheels", "This requirement defines the rules for vehicles", "Joe Blogs"
Informationen zum Erstellen eines benutzerdefinierten Artefakttyps finden Sie unter Erstellen von Anforderungsartefakttypen.
In der exportierten Datei werden Links in Linkspalten durch eine Markup ähnlich wie im folgenden Beispiel dargestellt:
{LINK id=3129 uri=https://server/rm/resources/_abaf26f172a149b2aaf8f22933be1661}
Links in der Spalte zum Primärtext sehen ähnlich wie im folgenden Beispiel aus:
"The text contains a link:{LINK id=3129 title=""3129: AMR Information Architecture"" uri=https://server/rm/resources/_abaf26f172a149b2aaf8f22933be1661}."
Abbildungen und integrierte Artefakte sehen ähnlich wie in den folgenden Beispielen aus:
{EMBEDDED id=3498 title=""new requirement"" uri=https://server/rm/resources/_klHmkbljEeWqUL0WZ--HjQ}
{IMAGE id=3496 title=""watson-analytics-logo.png"" uri=https://server/rm/wrappedResources/_dyVrMLljEeWqUL0WZ--HjQ}
Inhaltszeilen
Nach der Kopfzeile kann eine CSV-Datei mehrere Zeilen enthalten. Jede Zeile entspricht einem zu erstellenden Artefakt. Der Eintrag in der Spalte 'Typ' gibt den im System zu erstellenden Artefakttyp an. Die übrigen Zellen der Zeile repräsentieren die passenden Felder des Artefakts.
Wichtig: Wenn eine Zelle, die Inhalt für eine Spalte enthält, nicht mit dem angegebenen Artefakttyp übereinstimmt, wie durch den Typwert angegeben, wird die Zelle ignoriert. Auch wenn ein CSV-Import abgeschlossen wurde, wurden möglicherweise bestimmte Daten nicht importiert, weil die entsprechenden Spalten für einen Artefakttyp nicht vorhanden sind. Um diese Situation zu vermeiden, importieren Sie den Inhalt nach Artefakttyp. Sie können beispielsweise verschiedene Artefakttypen getrennt voneinander importieren. In dem Fall enthalten alle Zeilen in der Spalte 'Typ' denselben Wert.
Nicht unterstützte Felder
Die folgenden Felder werden vom System verwaltet und werden nicht von der CSV-Importfunktion unterstützt: Wenn Sie eine CSV-Datei mit solchen Feldern importieren, werden diese Felder beim Import ignoriert.
  • Kennung
  • Ersteller
  • Erstellt von
  • Erstellt am
  • Beitragender
  • Geändert von
  • Änderungsdatum
Anmerkung: Sie haben die Möglichkeit, die Spalte 'Teameigentumsrecht' zu einer Ansicht hinzuzufügen. Der Export von Informationen zum Teameigentumsrecht wird jedoch derzeit nicht unterstützt. Wenn Sie die Spalte in eine Exportoperation einbeziehen, bleibt das Feld 'Teameigentumsrecht' in der entstehenden CSV- oder Arbeitsblattdatei leer.
Datumsformate
Mehrere Datumsformate werden für alle Ländereinstellungen unterstützt. Sie sind in der Regel nach verschiedenen Normen wie ANSIC, XSD, RFC822 und RFC3339 normiert. Die Datumsformate werden bei Szenarien angegeben, in denen CSV-Dateien programmgesteuert generiert werden. Beispiele:
2011-08-01T10:54:12+01002011-08-01T10:54:12.203Z
2011-08-01T10:54:12Z
Mon, 01 Aug 2011 10:54:12 BST
Monday, 01-Aug-11 10:54:12 BST
Aug 01, 2011 10:54:12 AM BST
2011-08-01T10:54:12
Mon Aug 1 10:54:12 2011
2011-08-01
10:54:12 AM BST
10:54:12
Zusätzlich werden Lang-, Mittel- und Kurzformen unterstützt, die durch die International Components for Unicode (ICU) definiert sind. In diesem Beispiel sind die Langformen für die Ländereinstellungen in Berlin dargestellt:
de_DE Montag, 1. August 2011 11:58:36 Deutschland
de_DE Montag, 1. August 2011 11:58:36 MESZ
de_DE Montag, 1. August 2011 11:58:36
de_DE Montag, 1. August 2011 11:58
de_DE 1. August 2011 11:58:36 Deutschland
de_DE 1. August 2011 11:58:36 MESZ
de_DE 1. August 2011 11:58:36
de_DE 1. August 2011 11:58
de_DE 01.08.2011 11:58:36 Deutschland
de_DE 01.08.2011 11:58:36 MESZ
de_DE 01.08.2011 11:58:36
de_DE 01.08.2011 11:58
de_DE 01.08.11 11:58:36 Deutschland
de_DE 01.08.11 11:58:36 MESZ
de_DE 01.08.11 11:58:36
de_DE 01.08.11 11:58
In diesem Beispiel sind die Langformen für die Ländereinstellungen in Chicago dargestellt:
en_US Monday, August 1, 2011 5:08:17 AM CT
en_US Monday, August 1, 2011 5:08:17 AM CDT
en_US Monday, August 1, 2011 5:08:17 AM
en_US Monday, August 1, 2011 5:08 AM
en_US August 1, 2011 5:08:17 AM CT
en_US August 1, 2011 5:08:17 AM CDT
en_US August 1, 2011 5:08:17 AM
en_US August 1, 2011 5:08 AM
en_US Aug 1, 2011 5:08:17 AM CT
en_US Aug 1, 2011 5:08:17 AM CDT
en_US Aug 1, 2011 5:08:17 AM
en_US Aug 1, 2011 5:08 AM
en_US 8/1/11 5:08:17 AM CT
en_US 8/1/11 5:08:17 AM CDT
en_US 8/1/11 5:08:17 AM
en_US 8/1/11 5:08 AM