記錄類型

此主題解釋了 ClearQuest 記錄類型的概念。

記錄類型是特定類型的變更要求所用的格式。 它大約類似關聯式資料庫中的表格。每一個記錄類型定義可對一種變更要求類型收集的資料。 個別變更要求的相關資訊稱為記錄,變更要求的相關資料的個別片段稱為欄位。

每一個記錄類型有它自己相關聯的狀態模型、表單及連結鉤,可共同控制該變更要求類型的資料收集及檢視。

7.0 版資料庫可儲存更多記錄。較舊版的 Rational® ClearQuest® 用戶端無法顯示其資料庫ID (DBID) 高於前一個限制的記錄。 如需相關資訊,請參閱使用記錄

如需檢查 Rational ClearQuest 用戶端版本的相關資訊,請參閱 Rational ClearQuest API 參照頁面中的用戶端版本檢查

有狀態和無狀態的記錄類型

支援兩種記錄類型:有狀態和無狀態。

有狀態的記錄類型因為使用者動作的結果,而歷經一連串狀態(例如,已提交、已指派及已解決)。

無狀態的記錄類型保存資料,但不會變更狀態。 範例包括使用者、專案和客戶等記錄類型。 您在無狀態的記錄類型上只能執行「提交」、「修改」、「刪除」及「匯入」動作。

有狀態的記錄可以參照一或多個無狀態的記錄。 例如,使用者可以指派問題報告(有狀態的記錄類型)給專案(無狀態的記錄類型)。

當您將無狀態記錄類型新增至綱目時,必須設定一或多個欄位作為唯一索引鍵。 Rational ClearQuest 軟體會使用這個金鑰來識別此類型的個別記錄。

Rational ClearQuest 軟體維護四種無狀態系統記錄類型:歷程、附件、群組及使用者。您無法刪除系統記錄類型。

建立特定的記錄類型之後,您無法將它變更為其他類型;也就是說,您無法將無狀態記錄類型變更為有狀態記錄類型,反之亦然。

記錄類型顯示名稱和 DBID

記錄類型有顯示名稱和資料庫 ID,它們可用來擷取記錄。

顯示名稱是記錄的可見 ID。 唯一索引鍵與記錄的顯示名稱為相同值。 顯示名稱由記錄類型的唯一索引鍵欄位組成。
  • 對於有狀態的記錄,顯示名稱是資料庫集名稱(例如,RATLC)後面接著 8 位數字的連結,這個數字在有狀態記錄中是唯一的。 顯示名稱是所有有狀態記錄的 ID 欄位。
  • 對於無狀態記錄類型,顯示名稱是由以空格區隔的唯一索引鍵欄位組成。 唯一索引鍵是由綱目開發人員所定義的唯一索引鍵欄位組成。 對於每一個記錄,顯示名稱是該記錄類型的多個唯一索引鍵欄位值的連結(以空格區隔)。 例如:
    • 如果「專案」記錄類型有一個唯一索引鍵欄位叫做「名稱」,則「專案」記錄的唯一索引鍵值就是其「名稱」欄位的值。
    • 如果 CustomerContact 記錄類型有唯一索引鍵欄位 CustomerID、Name 和 Location,則特定 CustomerContact 記錄的唯一索引鍵值是由該記錄的三個欄位值組成的一個字串 - CustomerID/Name/Location - 每一個欄位值之間都有空格。

DisplayNames 在一種(有狀態或無狀態)記錄內是唯一的。

ClearQuest 記錄的資料庫 ID (DBID) 是記錄的內部 ID。 DBID 是循序指派給使用者資料庫中每一個記錄的唯一號碼。 如需相關資訊,請參閱使用記錄

如需使用 ClearQuest API 實作「尋找記錄」公用程式的相關資訊,請參閱 Rational ClearQuest API 參照頁面中的 GetEntityDefOfDbIdGetEntityDefofName 方法。

記錄類型數目

一個綱目可以包含多個記錄類型。 例如,一個綱目可對軟體加強功能和硬體加強功能使用不同的記錄類型。 或者,在爭議、問題報告、變更要求、瑕疵及加強功能要求上各有不同的記錄類型。

當變更要求類型有不同的程序模型或追蹤不同資料時,請建立不同的記錄類型。 例如,如果您的組織對軟體加強功能和硬體加強功能使用不同的程序模型,請為它們各建立不同的記錄類型。 此外,如果軟體和硬體加強功能的程序模型相同,請建立「加強功能」記錄類型,並使用一個欄位指定加強功能的類型。

請審慎考量要建立的記錄類型。 記錄類型愈多,您可以在程序模型中捕捉的變式就愈多;但它也會使得管理更為複雜,並使得要建置包含大量變更要求的查詢和報告更加困難。 您也可以預見,如果有兩種類型的變更要求具有相同的程序模型,但是您預料該模型會變更,則建立兩個記錄類型會比稍後試著將它們分割更容易。

同時,請考量設計關聯式資料庫時會產生的一些相同問題(或者,向熟悉這些問題的資料庫管理請求協助)。 例如,您可以不要在「問題報告」記錄類型中併入提交者、提交者的電子郵件位址和提交者的電話號碼,而是建立「提交者」記錄類型,以包含所有的使用者資訊。此方式可讓使用者每次提交問題報告時只輸入其使用者名稱。 然後您可以使用 REFERENCE 欄位建立「問題報告」與「提交者」記錄類型之間的鏈結,在表單和報告中併入提交者的電子郵件位址和電話號碼。 請參閱鏈結記錄以建立上下代階層

預設記錄類型

每一個綱目都必須有預設記錄類型。 預設記錄類型可以是有狀態或無狀態。 預設記錄類型是用來在 Rational ClearQuest 用戶端中建立捷徑按鈕,以提交該類型的記錄。 未指定其他記錄類型時會使用預設記錄類型。


意見