您必須針對要對映至 Rational Team Concert™ 項目的 ClearQuest® 記錄類型,建立同步化規則。
開始之前
您可以使用「ClearQuest Connector 設定精靈」,來建立同步化規則或同步化規則的範本。不過,使用此精靈來產生同步化規則之後,您仍然需要檢閱並修改規則,然後才能開始使用。
這個主題說明如何使用 Rational Team Concert Eclipse 用戶端的「同步化規則」編輯器,來建立和修改規則。
如果要建立、修改和刪除同步化規則,您必須被指派「開發人員用戶端存取授權」或「ClearQuest Connector 用戶端存取授權」。
此外,專案區域也必須配置成對您的使用者角色授與許可權。
如果要設定許可權,請開啟專案區域,按一下程序配置標籤,按一下,選取一個角色,然後在允許的動作清單中選取項目連接器。
在建立同步化規則之前,請務必先啟動「ClearQuest 閘道」,否則,不會在「同步化規則」編輯器清單中移入 ClearQuest 記錄類型的欄位。
執行這項作業的原因和時機
在建立同步化規則之前,請參閱
規劃同步化規則,以取得建立規劃工作表的詳細資料。
除了這一節的各個主題,請參閱
https://jazz.net/wiki/bin/view/Main/WritingSyncRules,以取得 ClearQuest 記錄欄位類型對映至
Rational Team Concert 項目內容的範例。
如果要建立同步化規則,請執行下列動作:
- 登入 Rational Team Concert 用戶端。
- 在團隊構件視圖中,用滑鼠右鍵按一下儲存庫連線,選取。
在同步化規則視圖中,用滑鼠右鍵按一下專案區域,選取。如果要編輯現有的同步化規則,請展開專案區域節點來查看同步化規則。
按兩下規則,讓它在「同步化規則」編輯器中開啟。
- 在「同步化規則」編輯器的名稱內容中,輸入規則的唯一名稱。採用類似於 Java™ 套件的命名慣例,有助於確保命名的唯一性。
例如:com.sapphire.clearquest.SchemaName.RecordType,其中 SchemaName 是 ClearQuest 綱目的名稱,RecordType 是這個綱目中要同步化的記錄類型名稱。
- 在類型對映區段中,選取要與 ClearQuest 記錄類型同步化的項目類型。
「項目管理程式」內容設為建立所選項目類型並加以同步化的管理程式。
在外部儲存庫欄位中,選取處理這個同步化規則時,所要使用的外部儲存庫連線。
選取 ClearQuest 管理程式(非使用者記錄)作為所有非使用者記錄類型的外部管理程式。
在使用者記錄類型中,選取 ClearQuest 管理程式(使用者記錄)。 附註:由於 Rational Team Concert 使用者項目不屬於某一專案區域,因此,每部 Jazz™ Team Server 的使用者記錄類型只能有一項同步化規則。在外部類型欄位中,選取您要與 Rational Team Concert 項目同步化的 ClearQuest 記錄類型。
當建立新的工作項目時,它的類型欄位是必要的。
您建立將記錄類型對映至工作項目的同步化規則,必須指出如何設定工作項目「類型」欄位的值。
請參閱將記錄類型對映至工作項目類型,以取得詳細資料。
- 在已啟用的團隊區域區段中,選取及取消選取團隊區域以限制同步化規則的範圍。
依預設,當專案區域具有同步化規則時,與它相關聯的所有 Rational Team Concert 項目都是要送出同步化的候選項。
您有可能只想建立特定團隊區域之相關項目的 ClearQuest 記錄。
如果已選取某個母項團隊區域,也會選取它的所有子項團隊區域。
您可以只選取子項團隊區域,而不選取它的母項團隊區域。
- 利用循環計數上限欄位來指定 ClearQuest Connector 嘗試多少次同步化循環之後,同步化作業便告失敗。
當寫入有狀態記錄類型的同步化規則時,請選取同步化所有項目狀態。
如果是無狀態記錄類型,請勿選取同步化所有項目狀態。
- 在內容對映區段中,指定哪些工作項目內容對映至哪些 ClearQuest 記錄類型欄位。
按一下新增來建立對映。
請選取項目內容及對應的外部內容(ClearQuest 記錄類型欄位)。
如果要對映工作項目關係,請選取下列項目內容之一:Related、Blocks、DependsOn、Parent 或 Children。
然後選取參照相關 ClearQuest 記錄的外部內容。 您可以按一下起始設定,建立一組基於相符(或局部相符)內容名稱的起始對映,不需要每次新增一項對映。
之後,您可以瀏覽這份清單,依照需要來移除或編輯對映。
對映詳細資料區段顯示「內容對映」表格中所選取之對映的詳細資料。
如果要清除項目內容或外部內容欄位中的項目,請在「項目內容」或「外部內容」之下選取無。
請利用「同步化」欄位來指定同步化方向。
輸入/輸出會啟用雙向同步化。
輸入只會啟用從 ClearQuest 使用者資料庫至 Rational Team Concert 項目的同步化。
輸出只會啟用從 Rational Team Concert 項目至 ClearQuest 使用者資料庫的同步化。
當利用這個內容作為將項目對映至 ClearQuest 記錄的查閱索引鍵時,選取項目 ID。
當利用 ClearQuest 欄位作為將 ClearQuest 記錄對映至 Rational Team Concert 項目的查閱索引鍵時,會選取外部 ID。
一般而言,您應該不需要設定「項目 ID」或「外部 ID」欄位。
假設「ClearQuest 閘道」在執行中,必要之時,「同步化規則」編輯器會設定這兩個欄位。
依預設,當 ClearQuest 記錄的變更與 Rational Team Concert 項目同步化時,會利用「ClearQuest 閘道」在登入 Jazz 儲存庫時所用的 Jazz 使用者帳戶,來執行更新作業。外部修飾元欄位可讓您配置同步化規則,以便在進行變更的使用者環境定義中記錄變更。
請參閱配置外部使用者的同步化規則,以取得詳細資料。
如果內容值是一項參照,指向另一個定義了同步化規則的物件,請在參照同步化規則清單中選取這個同步化規則。
比方說,如果 ClearQuest 的「問題報告」記錄類型所包含的某個欄位含有指向使用者記錄類型的參照,請選取使用者記錄類型的同步化規則。
在同步化期間,會處理這個同步化規則,且會建立一個從 Rational Team Concert 項目到 Jazz 使用者的參照。
如果這個內容是指向另一個工作項目的參照,您指定哪個工作項目同步化規則來作為參照同步化規則,並無關緊要。
同步化作業在判斷所參照物件的類型時,會使用正確的同步化規則。
例如,假設「問題報告」和「加強功能」工作項目類型都含有 DuplicateOf 內容,它是一個指向另一個工作項目的參照。
「問題報告」同步化規則中 DuplicateOf 的內容對映將「問題報告」同步化規則指定為參照同步化規則。
同樣地,「加強功能」同步化規則中 DuplicateOf 的內容對映也將「加強功能」同步化規則指定為參照同步化規則。
如果同步化作業判斷某「問題報告」標示為「加強功能」的重複項,它會使用「加強功能」同步化規則。
請利用值轉換器區段,來指定在 Rational Team Concert 項目與 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 記錄附註。 |
| 工作項目標籤轉換器 |
將工作項目中的標籤轉換成 ClearQuest 記錄中的關鍵字。 |
部分值轉換器可能需要其他內容,才能轉換資料。
必要的話,請按一下設定轉換器所需要的其他輸入內容,然後在「必要的內容」對話框中選取內容。
請利用值對映區段來指定從項目對映至記錄的值。
按一下新增。輸入項目值和對應的 ClearQuest 記錄欄位值。
如果沒有所有值的一至一對映,請指定一個作為預設值。
例如,ClearQuest 的「優先順序」欄位可能有四個值(1、2、3 和 4),Team Concert 的「優先順序」內容可能有三個值(高、中、低)。
如果您將「高」對映至 1 和 2,請選取 1 或 2 作為「預設外部值」。
如果要指定 ClearQuest 記錄欄位為空白值,請將值保留空白。
您可以按一下起始設定,建立一組基於相符(或局部相符)值名稱的起始對映,不需要每次新增一項值對映。
之後,您可以瀏覽這份清單,依照需要來移除或編輯值對映。
Rational ClearQuest 和 Rational Team Concert 可讓您分別識別重複的記錄和項目。如果要同步化重複項目,請將 DuplicateOf 這個「項目內容」對映至 original 這個「外部內容」。
在「參照同步化規則」欄位中,選取工作項目所用的同步化規則。
- 按一下儲存來儲存您的工作。
下一步
每次新增同步化規則,或新增或移除查詢時,您都必須停止再重新啟動「ClearQuest 閘道」,ClearQuest Connector 才會使用新的同步化準則。