套用 OSLCLinks 套件的程序

本主題說明如何使用以 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 版。

程序

  1. 在 ClearQuest Designer 中,用滑鼠右鍵按一下要套用套件的綱目版本,然後選取套件 > 套用套件。這時會開啟「套件精靈」。
  2. 在套件清單中展開 OSLCLinks 節點,然後選取 1.0 版或 1.1 版。按下一步
  3. 選取要套用套件的記錄類型。
  4. 選用項目:如果您已套用 OSLCLinks 套件 1.1 版,並且想要使用狀態述詞支援,將 ClearQuest 狀態對映至 OSLC 狀態,則必須新增名稱為 OSLC_CQ_State_Mapping 的廣域 Perl Script,並提供實作:
    1. 導覽至廣域 Script > Perl 節點(與綱目相關聯),再按一下滑鼠右鍵,然後選取新增
    2. 連結鉤名稱欄位中輸入下列文字,然後按一下確定 OSLC_CQ_State_Mapping
    3. 將連結鉤程式碼新增至 OSLC_CQ_State_Mapping Script。
  5. 按一下完成

    此時會將 OSLCLinks 套件套用至您選取的綱目。在綱目中尋找新的 OSLCLink Stateless 記錄類型,以驗證套件安裝。

    如需套用套件的相關資訊,請參閱套用套件說明。

範例

本節提供範例來說明將 OSLCLinks 套件 1.1 版套用至 DefectTracking 綱目,以及啟用套件來支援 Defect 記錄類型。

  1. 在 ClearQuest Designer 中,用滑鼠右鍵按一下要套用套件的綱目版本,然後選取套件 > 套用套件。這時會開啟「套件精靈」。
  2. 在套件清單中展開 OSLCLinks 節點,選取 1.1 版,然後按下一步
  3. 啟用 OSLCLinks 套件來支援 Defect 記錄類型。
  4. 新增名稱為 OSLC_CQ_State_Mapping 的廣域 Perl Script,並提供實作。
    1. 導覽至廣域 Script > Perl 節點(與綱目相關聯),再按一下滑鼠右鍵,然後選取新增
    2. 連結鉤名稱欄位中輸入下列文字,然後按一下確定OSLC_CQ_State_Mapping
    3. 將連結鉤程式碼新增至 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 顯示一個驗證連結鉤。

  5. 按一下完成。此時會移入綱目修訂。
  6. 升級使用者資料庫。
  7. 驗證綱目變更:
    1. 請使用您的 ClearQuest 用戶端來登入使用者資料庫。
    2. 編輯「所有問題」查詢,並新增下列顯示欄位:oslc_cm-inprogressoslc_cm-closed
    3. 執行「所有問題」查詢。
    4. 在查詢結果中選取處於「已提交」狀態的問題。
    5. 關閉問題,並確認 oslc_cm-closed 等於 1,而其他以 oslc_cm 為名稱字首的欄位等於 0。
    6. 重新開啟問題,並確認 oslc_cm-inprogress 等於 1,而其他以 oslc_cm 為名稱字首的欄位等於 0。

意見