更新 ClearQuest 建置記錄

您可以將系統與 Rational ClearQuest 整合,以便自動建立並更新 ClearQuest 資料庫內部的建置記錄。

系統可以在 IBM Rational® ClearQuest® 資料庫中自動建立建置記錄,包含與日誌資料的鏈結。另外,當工作通過時,系統就能更新 ClearQuest 資料庫,以註明工作已經完成,並記錄結束時間以及所完成的步驟摘要。這項特性需要 Rational ClearQuest 7.0 版或更新版本。

註: 為了順利建立建置記錄,並在其中移入建置的相關資訊,您必須先開啟 ClearQuest 的「維護工具」,並設定通往資料庫的連線。
當您配置專案以更新 ClearQuest 資料庫時,系統會執行下列作業:
工作開始
當系統啟動工作時,系統就會建立 ClearQuest 建置記錄。建置記錄會是「已提交」狀態,並且包含工作日誌 URL、開始時間、版次名稱和 ID,以及指出「建置 XYZ 已啟動」的日誌項目。如果來源控制配接器取消工作(例如,因為找不到來源變更),則不會建立 ClearQuest 建置記錄。
註: 如果專案與其他專案鏈結,則新專案會取得專屬的唯一 ClearQuest 建置 ID。
工作通過/失敗
當工作通過或失敗時,系統會將 ClearQuest 內的建置狀態變更為「已完成」或「失敗」,再設定建置的結束時間,然後將工作步驟的摘要儲存在 ClearQuest 建置日誌中。摘要包含每個步驟的名稱、結果狀態與伺服器。
工作重新啟動
當工作重新啟動時,系統會將 ClearQuest 內的建置狀態變更為「已送出」,並建立 ClearQuest 建置日誌項目,指出「建置 XYZ 已重新啟動。」

您將透過特殊的環境變數來配置 ClearQuest 整合。若要將專案鏈結至 ClearQuest 資料庫,請確定下表內的變數已併入專案的環境中。

註: 這些變數必須呈現在專案環境中。光是將它們新增至步驟是不夠的。但是,您可以使用設定為「併入」類型的變數,經由另一個環境來併入這些變數。此外,由於 CQ_RELEASE_NAME 值是唯一可能會依專案而有所不同的值,您可能會想建立一個內含其他變數的環境,然後使用「併入」類型的變數將該環境併入在專案環境中,而在專案環境中,您也可以將 CQ_RELEASE_NAME 指定為專案特有的環境變數。
表 1. 進行 Rational ClearQuest 整合所需的環境變數

變數

說明

CQ_DBNAME

您要更新的 ClearQuest 資料庫名稱。

CQ_INTERACTION

如果您的專案環境已定義了正確的環境變數,以允許建立 ClearQuest 建置記錄,但是您並不要建立建置記錄,請將此變數設定為 OFF 以停止建立建置記錄。

如果要啟用建置記錄的建立,請將這個環境變數設定為 ON。

註: 如果您正使用其中一個 ClearQuest 配接器,請將這個環境變數設定為 OFF。

CQ_USER

登入 ClearQuest 資料庫時所要使用的使用者名稱。

CQ_RELEASE_NAME

在您要更新的 ClearQuest 資料中的版次名稱。

CQ_PASSWORD

登入 ClearQuest 資料庫時所要使用的密碼。不是必要的;預設為空白。

CQ_DBSET

ClearQuest 資料庫設定值。不是必要的;預設為空白。


意見