Importdateiformat für Satztypen

Die Importdatei für einen Satztyp ist eine Liste mit in doppelte Anführungszeichen gesetzten Zeichenfolgen, die durch Begrenzer getrennt sind. Die Liste endet mit einem Zeilenvorschubzeichen. Das gebräuchlichste Dateiformat verwendet Kommata als Begrenzer, allerdings können auch Doppelpunkte, Semikola, Pipe-Zeichen oder Tabulatorzeichen verwendet werden.

Die erste Zeile der Importdatei enthält eine Liste der Feldnamen, die exportiert werden. Die nachfolgenden Zeilen enthalten die Feldwerte für die einzelnen Datensätze in der gleichen Reihenfolge wie die Feldnamen in der ersten Zeile. Bei der Importoperation wird der Wert für jedes Feld in den entsprechenden Feldtyp, der im Schema definiert ist, umgewandelt. Beispiel:

 "id","state","submitdate","severity","priority","summary","description"
 "1","Submitted","4/11/00 7:00:00","3-Workaround","3","The shortcut for "
"Printing"" is grayed out","See summary --John"
 "2","Opened","4/14/00 11:32:00","1-Crash","1","Can't log in to the system",
"I typed my login and the hourglass sign appears, but after 15 
 minutes, I still can't type my password. There's an infinite loop 
 somewhere."
 

Der Wert im Feld "State" legt den aktuellen Status des Datensatzes beim Importieren fest. Die Datentypen der Felder in importierten Datensätzen werden geprüft, nicht jedoch die zum Erreichen eines bestimmten Status erforderlichen Aktionen.

Beim Formatieren einer Importdatei sind folgende Punkte zu beachten:

Unterstützte Datentypen

Die Werte für die Felder in der Importdatei werden entsprechend dem Datentyp interpretiert, der im Rational-ClearQuest-Schema für das entsprechende Feld definiert ist. Die folgende Tabelle listet die unterstützten Datentypen auf und beschreibt, wie die Werte interpretiert werden.

Datentyp Beschreibung Verhalten
ATTACHMENT_LIST Eine Liste der Felder vom Typ "Attachment" Wird als Liste der Pfadnamen für Anhänge interpretiert.
DATE_TIME SQL - Datum und Zeit Wird in Datum/Zeit umgewandelt.
INT SQL - ganze Zahl Wird in eine ganze Zahl umgewandelt
MULTILINE_STRING Eine Zeichenfolge variabler Länge mit unbegrenzter Größe Wird bis zur maximalen Länge unverändert in das Schema für diesen Typ eingefügt.
REFERENCE Ein Verweis auf einen Anzeigenamen in einem statusabhängigen oder -unabhängigen Satztyp Wird als Schlüssel für einen statusunabhängigen Satztyp interpretiert.
REFERENCE_LIST Mehrere Verweise auf Anzeigenamen in einem statusabhängigen oder -unabhängigen Satztyp Wird als Verweisliste interpretiert.
SHORT_STRING Eine Zeichenfolge variabler Länge mit maximal 254 Zeichen Wird unverändert eingefügt.
STATE Für Systemfelder reserviert Der Feldwert wird geprüft, die Aktionen, die für das Erreichen des Status erforderlich sind, werden jedoch nicht ausgelöst.

Feedback