配接器作業概觀

本主題涵蓋建立原始碼配接器、將它透過配接器鏈結連接至專案,並在測試模式中執行與配接器鏈的專案時,所需要的一切作業。

選取範本,以建立配接器

如果要選取範本來建立配接器,請執行下列動作:

  1. 選取專案 → 配接器。
  2. 按一下新增配接器
  3. 在「名稱」處,輸入配接器的唯一名稱。配接器名稱在整個配接器集中必須是唯一的,並且不能包含空格。
  4. 在「類型」處,選取配接器類型。
  5. 在「範本」處選取範本。清單會包含和 Build Forge 產品一起安裝的配接器範本。ClearCase 和 ClearQuest 配接器不需要個別的授權金鑰。其他配接器會經由 Adaptor Toolkit 個別授權。
  6. 在「存取」處,選取存取群組。只有群組成員才能檢視或編輯配接器。
  7. 按一下儲存配接器

建立空的環境

如果要建立空的環境,請執行下列動作:

  1. 選取專案 → 環境。
  2. 按一下新增環境
  3. 在「名稱」處,輸入環境名稱。指派一個名稱,以說明環境的目的。
  4. 在「存取」處,選取存取群組。只有這些群組成員才能檢視或編輯環境。
  5. 按一下儲存環境

將配接器新增至專案

如果要將配接器新增至專案,請執行下列動作:

  1. 選取專案 → 配接器鏈結。
  2. 按一下新增配接器鏈結
  3. 在「配接器」處,選取您所建立的配接器(和配接器範本)。
  4. 在「專案」處,選取專案。清單會顯示尚未鏈結至配接器的專案。
  5. 在「狀態」處,選取作用中
  6. 在「環境」處,選取您為配接器鏈結所建立的空環境。
  7. 在「將資料輸入環境」處,選取。配接器範本中的應用程式環境變數會新增至環境。
  8. 按一下儲存,將配接器鏈結至專案。配接器和專案會新增至配接器鏈結的清單中。

編輯環境變數

如果要編輯環境變數,請執行下列動作:

  1. 選取環境。
  2. 針對您所建立的環境,按一下編輯圖示「編輯」圖示,是一枝鉛筆。此畫面會顯示自動新增至環境的配接器環境變數。
  3. 檢視配接器範本所提供之環境變數的預設值。
  4. 請視需要變更原始碼應用程式的預設值,以執行配接器專案。

condition 屬性

condition 屬性容許您使用 Perl 比較運算子,將條件套用至某些配接器內容。字串文字、數字或變數可在比較時使用。

condition 屬性的語法如下所示:

condition="true(<lvalue> <operator> <rvalue>)"
condition="false(<lvalue> <operator> <rvalue>)"
condition="hastext(variable)"
condition="isempty(variable)"

指定下列四種類型之一:

類型 說明
true 如果 lvalue 等於 rvalue,則求值成功。
false 如果 lvalue 不等於 rvalue,則求值成功。
hastext 如果值長度大於 0,則求值成功。
isempty 如果值長度為 0,則求值成功。
lvalue 和 rvalue 可以是字串、數字,或內含字串或數字的變數。條件運算子是指任何與 Perl 相容的條件運算子。以下是字串和數字條件運算子。您必須使用適當的運算子,否則,將會收到無法預期的結果。
字串運算子 數值運算子
eq ==
ne !=
gt >
lt <
ge >=
le <=

數值運算子搭配字串使用時,不會傳回正確的結果,而在數值中使用字串比較運算子,也是同理可證。

例如:condition="true("PASS"=="FAIL")

上述條件一律傳回 true,這是不正確的。

條件範例:
  • condition="true($BF_SERVER eq "TEST_BOX") - 只有在建置伺服器變數包含 TEST_BOX 時,才會執行項目。
  • condition="false($BF_BID <=141) - 只有在建置標籤大於或等於 141 時,才會執行建置。
支援這些條件的配接器內容如下所示:
  • adduser
  • bom
  • run
  • setenv
仔細檢查 DTD 中 Build Forge 的現行安裝,以取得有關哪些內容支援 condition 屬性的最新資訊。

就支援條件的內容來說,您會看到類似下列的項目:

<!ATTLIST adduser condition CDATA #IMPLIED>

配接器 DTD 位於 %BF_HOME%\interface(若為 Windows)和 $BF_HOME/Platform/interface(若為 UNIX)中,其檔名為 interface.dtd。

在測試模式下執行配接器

如果要在測試模式下執行配接器,請執行下列動作:

  1. 選取管理 → 系統。
  2. 在系統配置參數清單中,選取鏈結除錯模式
  3. 在「鏈結除錯模式」中,選取
  4. 按一下儲存
  5. 選取工作 → 啟動。
  6. 在專案清單中,選取您在「啟動專案」頁面所建立的與配接器鏈的專案。
  7. 按一下執行

檢視工作狀態和日誌

如果要檢視配接器專案的工作狀態和日誌資訊:
  1. 開啟工作
  2. 在專案清單中,找到與配接器鏈的專案,以檢視工作成功/失敗狀態。
  3. 如果要檢視工作日誌:
    • 選取配接器專案的「標籤名稱」以存取工作日誌資訊。
    • 選取「資料清單」以存取 BOM 報告。

意見