記錄類型的匯入檔案格式

此主題提供了記錄類型匯入檔案的準則。

記錄類型的匯入檔案是一份含定界字元並以雙引號括住的字串清單,其結尾為換行字元。最常見的檔案格式是以逗點定界,但您也可以使用冒號、分號、管線符號 (|) 或 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." 
 

「狀態」欄位的值決定記錄在匯入時的現行狀態。會驗證所匯入記錄的欄位的資料類型,但不會驗證要達到特定狀態所需的動作。

將匯入檔案格式化時,請記住這些考量:

支援的資料類型

匯入檔案中的欄位值會根據對 Rational ClearQuest 綱目中的對應欄位所定義的資料類型來解譯。下表列出支援的資料類型及這些值的解譯方式。

資料類型 說明 行為
ATTACHMENT_LIST 「附件」類型的欄位清單 解譯為附件的路徑名稱清單。
DATE_TIME SQL 日期和時間 轉換成日期 / 時間。
INT SQL 整數 轉換成整數
MULTILINE_STRING 無限制大小的可變長度字串 如現狀插入綱目中,但不超出此類型的長度上限。
REFERENCE 在有狀態或無狀態的記錄類型中的顯示名稱的參照 解譯為無狀態記錄類型的索引鍵。
REFERENCE_LIST 在有狀態或無狀態的記錄類型中的顯示名稱的多個參照 解譯為參照清單。
SHORT_STRING 長度上限為 254 個字元的可變長度字串 如現狀插入。
STATE 保留給系統欄位 會驗證欄位值,但不觸發要達到該狀態所需的動作。

意見