記錄類型的匯入檔案是一份含定界字元並以雙引號括住的字串清單,其結尾為換行字元。最常見的檔案格式是以逗點定界,但您也可以使用冒號、分號、管線符號 (|) 或 Tab。
匯入檔案的第一列包含所要匯出的欄位名稱清單。後續的列包含個別記錄的欄位值,並依第一列的欄位名稱順序來排序。在匯入作業期間,每一個欄位的值會轉換成定義在綱目中對應的欄位類型。例如:
"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."
「狀態」欄位的值決定記錄在匯入時的現行狀態。會驗證所匯入記錄的欄位的資料類型,但不會驗證要達到特定狀態所需的動作。
將匯入檔案格式化時,請記住這些考量:
"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."
回車字元可用來匯入值至多行欄位中。
匯入檔案中的欄位值會根據對 Rational ClearQuest 綱目中的對應欄位所定義的資料類型來解譯。下表列出支援的資料類型及這些值的解譯方式。
資料類型 | 說明 | 行為 |
---|---|---|
ATTACHMENT_LIST | 「附件」類型的欄位清單 | 解譯為附件的路徑名稱清單。 |
DATE_TIME | SQL 日期和時間 | 轉換成日期 / 時間。 |
INT | SQL 整數 | 轉換成整數 |
MULTILINE_STRING | 無限制大小的可變長度字串 | 如現狀插入綱目中,但不超出此類型的長度上限。 |
REFERENCE | 在有狀態或無狀態的記錄類型中的顯示名稱的參照 | 解譯為無狀態記錄類型的索引鍵。 |
REFERENCE_LIST | 在有狀態或無狀態的記錄類型中的顯示名稱的多個參照 | 解譯為參照清單。 |
SHORT_STRING | 長度上限為 254 個字元的可變長度字串 | 如現狀插入。 |
STATE | 保留給系統欄位 | 會驗證欄位值,但不觸發要達到該狀態所需的動作。 |