規劃同步化規則

在建立同步化規則之前,您必須先分析要與 Rational Team Concert™ 工作項目同步化的一或多個 ClearQuest® 記錄類型,並建立一份將記錄類型欄位對映至工作項目內容的計劃。
執行這項作業的原因和時機
理想上,規劃及建立同步化規則的人應該是建立及維護 ClearQuest 綱目的人。 您也應該對 Jazz™ 有基本的認識,且熟悉專案區域和工作項目。

將每個記錄類型都對映至工作項目類型,並不實際。 這兩個類型的目的、必要欄位及狀態轉移模型應該是類似的。 請複查您要連接至 Jazz 專案區域之使用者資料庫的綱目中所定義的所有記錄類型,然後識別哪些記錄類型是好的同步化候選項。

您可以使用「ClearQuest Connector 設定精靈」來建立同步化規則的起始版本,但您需要編輯這些規則來指定其他對映詳細資料。您至少必須編輯同步化規則,來指定如何設定工作項目的「種類」內容。

當您逐步完成下列規劃步驟時,請將記錄類型的相關資訊記錄在隨附的工作表中。 針對您規劃要同步化的每個記錄類型各建立一份工作表。 當您開始建立或編輯同步化規則時,請使用這份工作表。 如果您使用「ClearQuest Connector 設定精靈」來建立同步化規則的起始版本,請在「同步化規則」編輯器中開啟這些同步化規則、比較對映詳細資料與規劃工作表中的需求,並且識別任何差異。

如果要規劃您的同步化規則,請執行下列動作:

  1. 利用 Rational Team Concert 的「腳本」工作項目類型來開發使用案例,以說明團隊計劃在 Rational Team Concert 中的運作方式。這個「腳本」應該指出程序(如 Scrum)、工作項目類型,以及團隊想要使用的工作流程。
  2. 根據「腳本」來識別哪個或哪些 ClearQuest 記錄類型要與哪些工作項目類型同步化。如果沒有立即可用的 Rational Team Concert 工作項目類型完全符合您想要同步化的 ClearQuest 記錄類型,您可以建立一個工作項目類型來對應至該記錄類型。
  3. 您可以將單一 ClearQuest 記錄類型對映至多個工作項目類型。 例如,您的記錄類型可能是一般性記錄類型(如「變更要求」),且含有一個欄位將它定義為「錯誤」或「版本需求」。 在這個狀況之下,請指出您用來定義記錄類型的 ClearQuest 欄位名稱,並列出欄位值及其對應工作項目類型。
  4. 定義記錄類型和工作項目類型之間的同步化方向。 如果您計劃將 ClearQuest 使用者資料庫中的一組記錄匯入至 Jazz 儲存庫中,您的團隊便只能在 Rational Team Concert 中工作,同步化方向只能是「輸入」。 如果您想要同時在 Rational Team ConcertRational® ClearQuest 中工作,同步化便是「輸入」和「輸出」。
  5. 在 ClearQuest 記錄類型和對應的工作項目類型中,識別出必要的欄位集。 如果您使用 Scrum 程序,「問題報告」和「作業」工作項目類型只需要「摘要」和「歸類依據(種類)」欄位中的項目。在「工作項目」編輯器的「概觀」頁面上,必要欄位含有星號。

    如果要查看 ClearQuest 記錄類型的必要欄位,請在 ClearQuest Designer 中開啟綱目。 按一下開始 > 所有程式 > IBM Rational > IBM Rational ClearQuest > ClearQuest Designer。 在「開啟綱目」精靈中,選取要同步化之記錄類型的綱目。 在導覽窗格中,循序展開記錄類型資料夾、特定記錄類型資料夾,以及狀態和動作資料夾。 按兩下行為。 「行為」矩陣將必要欄位識別為強制

  6. 對於每個必要的 ClearQuest 欄位,請在工作項目類型中,識別 ClearQuest 欄位所能對映的欄位。 同樣地,對於每個必要的工作項目類型欄位,也請識別對應的 ClearQuest 欄位。 選擇適當的對映欄位時,請考量欄位的意義及欄位類型。 如果要查看 ClearQuest 記錄類型的欄位類型,請在 ClearQuest Designer 中,開啟記錄類型的綱目。 在導覽窗格中,循序展開記錄類型資料夾、特定記錄類型資料夾,然後按兩下欄位來開啟「矩陣」矩陣。

    如果要查看 Rational Team Concert 中的欄位類型,請登入 Rational Team Concert 用戶端。在團隊構件視圖中,按兩下專案區域,將它開在「專案區域」編輯器中。 按一下程序配置標籤。 循序展開專案配置配置資料工作項目。 按一下編輯器呈現。 選取您在同步化之工作項目類型的編輯器呈現。 在編輯器呈現區域中,展開各個標籤和區段來查看呈現(欄位)清單。 在每個欄位名稱後面,會用括弧來括住類型。

  7. 如果工作項目類型沒有適當的欄位可對映至某些必要的 ClearQuest 記錄類型欄位,請在工作項目類型中建立新欄位。 在專案配置頁面上,循序展開專案配置配置資料工作項目。 按一下類型。 選取工作項目類型種類。 在自訂屬性區域中,按一下新增。 輸入欄位的名稱,然後選取相容於對應 ClearQuest 欄位類型的類型。 按一下確定。按一下儲存來儲存您的工作項目類型變更。
  8. 如果記錄類型沒有適當的欄位可對映至某些必要的工作項目類型欄位,請在「欄位」矩陣中新增列,以在記錄類型中建立新欄位。
  9. 在送入同步化期間,必須設定工作項目的種類內容,因為工作項目是根據其種類而關聯於團隊區域。 您可以採用下列方式在 Rational Team Concert 中提供種類資訊:
    • 將無狀態 ClearQuest 記錄和種類連接起來
    • 將一或多個 ClearQuest 記錄字串值欄位對映至種類
    • 將空的外部值對映至固定的種類值
    • 將一或多個 ClearQuest 記錄對映於種類,而非連接於種類

    請參閱編輯同步化規則來指定種類,以取得這些方法的詳細資料,然後選用其中一個方法。

  10. 識別您想要與工作項目欄位同步化的任何其他非必要的 ClearQuest 記錄欄位。 識別對應的工作項目欄位。 必要的話,請新增自訂屬性,以在工作項目類型中建立欄位。
  11. 識別您想要顯示在工作項目中,但不要與工作項目欄位同步化的任何 ClearQuest 記錄欄位。
  12. 是否有任何您想要同步化的欄位含有值選項清單(如「優先順序」或「嚴重性」欄位)? 請識別每個這類欄位從 ClearQuest 記錄欄位至工作項目欄位的值對映。 如果沒有所有值的一至一對映,請指定一個作為預設值。
  13. 是否有任何您想要同步化的欄位需要轉換值的特殊處理,然後其值才能傳送給對應的工作項目欄位或 ClearQuest 記錄欄位?

    ClearQuest Connector 提供了下列值轉換器。

    表 1. ClearQuest Connector 轉換器
    轉換器名稱 說明
    將欄位連接至自訂屬性轉換器 將工作項目的自訂屬性值對映至 ClearQuest 記錄中的欄位,而該欄位參照另一項記錄中的欄位。
    貢獻者詳細資料轉換器 目前並未搭配 ClearQuest Connector 一起使用。
    在自訂屬性轉換器中,顯示所參照的記錄欄位 將所參照 ClearQuest 記錄的內容對映至工作項目自訂屬性,以便在工作項目編輯器中顯示這些內容。
    專案區域轉換器 目前並未搭配 ClearQuest Connector 一起使用。
    時間戳記/天數轉換器 將 ClearQuest 記錄中識別天數的字串轉換成毫秒數,時間戳記便用它來判斷時間。
    工作項目動作轉換器 計算送入同步化期間,在狀態之間轉移時所採取的動作。如果 Rational Team Concert 項目工作流程定義包含語意不明的狀態轉移,使得在兩個狀態之間轉移時有多個可能的動作,就必須如此做。

    不同於 Rational ClearQuest 記錄類型,在狀態轉移期間,Rational Team Concert 工作項目類型容許採取多個動作。如果您未利用「工作項目動作轉換器」來同步化含有多個狀態轉移動作的項目,狀態轉移之後的同步化作業會產生一則錯誤,指出 ClearQuest 記錄無法轉移至另一個狀態。

    工作項目附件轉換器 Rational Team Concert 附件轉換成 ClearQuest 記錄附件。
    工作項目種類轉換器 當值是路徑時,維護對映至 ClearQuest 記錄的 Rational Team Concert 種類階層式結構。
    工作項目註解轉換器 Rational Team Concert 註解轉換成 ClearQuest 記錄附註。您必須使用 Rational ClearQuest 所提供的標準 Notes 套件。
    工作項目標籤轉換器 將工作項目中的標籤轉換成 ClearQuest 記錄中的關鍵字。

    識別任何需要轉換的欄位,列出需要的轉換。

  14. 如果記錄類型包含附件,您可以建立一個同步化規則,以便在 ClearQuest 記錄與工作項目同步化時,也將記錄與工作項目的任何附件同步化。 請指出您是否規劃將附件同步化。
  15. 在您規劃要同步化的 ClearQuest 記錄欄位中,識別任何參照類型欄位。 您必須建立這些欄位所參照之記錄類型的同步化規則。
  16. 在您規劃要同步化的 ClearQuest 記錄欄位中,是否有任何欄位含有連結鉤,建立了與其他欄位的相依關係? 例如,一個欄位的相關連結鉤可以利用使用者輸入這個欄位的值來決定如何設定另一欄位的值。 在這個實務中,您必須識別應執行鏈結鉤的順序,以確保 ClearQuest 記錄欄位會設成正確的值。

    cqconnector.properties 檔包含一個 cq.orderedProperties.record-type 參數,供您指定應設定 ClearQuest 記錄欄位值的順序。 在指定的欄位處理完之後,才會處理所有未以 cq.orderedProperties.record-type 來指定的欄位。

    另一個指定順序的方式是在 ClearQuest Designer 的表單定義中,對各欄位使用 Web 相依欄位內容。如果您同時指定了「Web 相依欄位」內容和 cq.orderedProperties 參數,ClearQuest Connector 會使用 cq.orderedProperties 參數所指定的順序。


意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤