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:
"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."
"The shortcut for ""Printing all"" does not work."
"Ref1, Ref2, Ref3"
"To reproduce the error, follow these steps:<CR> 1. Start Explorer.<CR> 2. Click File > Open."
Ein Wagenrücklaufzeichen kann verwendet werden, um Werte in ein mehrzeiliges Feld zu importieren.
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. |