BuildForge 可以搭配 Rational ClearQuest 使用來更新建置記錄。
Build Forge 與 ClearQuest 有兩項整合:
這些功能彼此完全獨立。特別是,配接器會與針對其建立的環境相關聯。該環境中的變數與設定來啟動自動建置記錄的變數無關。
系統可以在 IBM Rational® ClearQuest® 資料庫中自動建立建置記錄,包含與日誌資料的鏈結。另外,當工作通過時,系統就能更新 ClearQuest 資料庫,以註明工作已經完成,並記錄結束時間以及所完成的步驟摘要。這項特性需要 Rational ClearQuest 7.0 版或更新版本。
您會透過特殊環境變數來配置自動更新建置記錄。若要將專案鏈結至 ClearQuest 資料庫,請確定下表內的變數已併入專案的環境中。
為了啟動自動更新 Build Forge 工作的建置記錄,必須為專案設定下列環境變數。這些變數不會於步驟層次上作用。
變數 |
說明 |
---|---|
CQ_DBNAME |
(必要)。您要更新的 ClearQuest 資料庫名稱。 |
CQ_DBSET |
ClearQuest 資料庫設定值。非必要。預設值為空白。 |
CQ_INTERACTION |
如果您的專案環境已定義了正確的環境變數,以允許建立 ClearQuest 建置記錄,但是您並不要建立建置記錄,請將此變數設定為 OFF 以停止建立建置記錄。 如果要啟用建置記錄的建立,請將這個環境變數設定為 ON。 註: 如果您正使用其中一個 ClearQuest 配接器,請將這個環境變數設定為 OFF。配接器會與建置記錄直接互動。
|
CQ_PASSWORD |
(必要)。登入 ClearQuest 資料庫時所要使用的密碼。不是必要的;預設為空白。 |
CQ_RELEASE_NAME |
(必要)。在您要更新的 ClearQuest 資料中的版次名稱。 |
CQ_USER |
(必要)。登入 ClearQuest 資料庫時所要使用的使用者名稱。 |
ClearQuest 配接器範本範例,提供在 ClearQuest 中掃描 ClearCase 及更新建置記錄的方法。這通常關係到在 Build Forge 中執行的建置是成功還是失敗。請參閱配接器需求以取得一般需求。此外,還需要完成下列配置。
請執行下列動作:
您不需要安裝代理程式。ClearQuest 配接器會透過用戶端,利用 ClearQuest Perl API 與 ClearQuest 直接通訊。
所提供的配接器範本範例如下所示。
配接器範本中定義的變數:
配接器範本中定義的變數:
配接器範本中定義的變數:
這份表格是配接器範本之變數清單的參照。
變數 |
說明 |
---|---|
ACTIVITIES | 如果是使用 ClearQuestClearCaseByActivity 配接器,即為以空格區隔的活動 ID 集。範例:SAMPL0001@\ProjectVob |
BFSERVER | 將這個變數設為 Build Forge 主控台的主機名稱。 |
CQ_PASSWORD |
(必要)。登入 ClearQuest 資料庫時所要使用的密碼。不是必要的;預設為空白。 |
CQ_USER |
(必要)。登入 ClearQuest 資料庫時所要使用的使用者名稱。 |
CurDate | 利用 .date 指令產生日期,來提供目前日期給配接器。請勿變更此值。 |
LAST_RUN | 若為 ByDate 配接器,系統會使用此值來判斷是否發生任何變更;此值是前次順利執行的日期。您可以在測試配接器時操作此值,挑選在某些變更發生之前的日期,以強迫配接器執行。如果配接器容許繼續執行,它會自動將此值更新為現行日期。預設值為 1-Jan-05.00:00:00。 |
UNIXCLIENT | 用來設定平台專用的資訊。如果用戶端是在 Windows 上執行,請設為 0。如果用戶端是在 UNIX 或 Linux 上執行,請設為 1。 |
VIEW | 將這個變數設為您要搭配配接器使用的 ClearCase 視圖名稱。 |
VOB_PATH | 將這個值設為元件 VOB 的名稱及其子目錄(後者為選用)。請使用逗點區隔的清單來指定多個名稱。 |
_CHAR_NATIVE | 供內部使用且一律設為 1。 |
若要啟用重新啟動,您必須使用 ClearQuest 設計程式工具來編輯 ClearQuest 綱目。必須修改「建置」記錄的工作流程,才能將「已完成」的狀態轉移為「提交」。