本主題說明如何使用以 Eclipse 技術為基礎的 Rational® ClearQuest® Designer,將 Rational ClearQuest OSLCLinks 套件 1.0 或 1.1 版套用至您的綱目。
關於這項作業
如果您執行 ClearQuest 7.1.2 版,請套用 OSLCLinks 套件 1.0 版。如果您執行 ClearQuest 7.1.2.1 版,請套用 OSLCLinks 套件 1.1 版。
程序
- 在 ClearQuest Designer 中,用滑鼠右鍵按一下要套用套件的綱目版本,然後選取。這時會開啟「套件精靈」。
- 在套件清單中展開 OSLCLinks 節點,然後選取 1.0 版或 1.1 版。按下一步。
- 選取要套用套件的記錄類型。
- 選用項目:如果您已套用 OSLCLinks 套件 1.1 版,並且想要使用狀態述詞支援,將 ClearQuest 狀態對映至 OSLC 狀態,則必須新增名稱為 OSLC_CQ_State_Mapping 的廣域 Perl Script,並提供實作:
- 導覽至(與綱目相關聯),再按一下滑鼠右鍵,然後選取新增。
- 在連結鉤名稱欄位中輸入下列文字,然後按一下確定: OSLC_CQ_State_Mapping
- 將連結鉤程式碼新增至 OSLC_CQ_State_Mapping Script。
- 按一下完成。
此時會將 OSLCLinks 套件套用至您選取的綱目。在綱目中尋找新的 OSLCLink Stateless 記錄類型,以驗證套件安裝。
如需套用套件的相關資訊,請參閱套用套件說明。
範例
本節提供範例來說明將 OSLCLinks 套件 1.1 版套用至 DefectTracking 綱目,以及啟用套件來支援 Defect 記錄類型。
- 在 ClearQuest Designer 中,用滑鼠右鍵按一下要套用套件的綱目版本,然後選取。這時會開啟「套件精靈」。
- 在套件清單中展開 OSLCLinks 節點,選取 1.1 版,然後按下一步。
- 啟用 OSLCLinks 套件來支援 Defect 記錄類型。
- 新增名稱為 OSLC_CQ_State_Mapping 的廣域 Perl Script,並提供實作。
- 導覽至(與綱目相關聯),再按一下滑鼠右鍵,然後選取新增。
- 在連結鉤名稱欄位中輸入下列文字,然後按一下確定:OSLC_CQ_State_Mapping
- 將連結鉤程式碼新增至 OSLC_CQ_State_Mapping Script。例如:
sub OSLC_CQ_State_Mapping { my ($myentity, $hook_type) = @_; my $state = $myentity->GetFieldStringValue("State");
if ($hook_type eq "Validation") {
if (($state eq "Assigned") || ($state eq "Opened")) { $myentity->SetFieldValue("oslc_cm-inprogress", "1"); } else { $myentity->SetFieldValue("oslc_cm-inprogress", "0"); }
if ($state eq "Closed") { $myentity->SetFieldValue("oslc_cm-closed", "1"); } else { $myentity->SetFieldValue("oslc_cm-closed", "0"); }
}
}
Defect 記錄的 OSLC_State_Predicates 動作的起始設定及驗證連結鉤,會呼叫此 Script。此 Script 有兩個參數:現行實體和連結鉤類型。視您的需求而定,您可以根據連結鉤類型參數的值來新增不同的程式碼。範例 Script 顯示一個驗證連結鉤。
- 按一下完成。此時會移入綱目修訂。
- 升級使用者資料庫。
- 驗證綱目變更:
- 請使用您的 ClearQuest 用戶端來登入使用者資料庫。
- 編輯「所有問題」查詢,並新增下列顯示欄位:oslc_cm-inprogress 和 oslc_cm-closed。
- 執行「所有問題」查詢。
- 在查詢結果中選取處於「已提交」狀態的問題。
- 關閉問題,並確認 oslc_cm-closed 等於 1,而其他以 oslc_cm 為名稱字首的欄位等於 0。
- 重新開啟問題,並確認 oslc_cm-inprogress 等於 1,而其他以 oslc_cm 為名稱字首的欄位等於 0。