本主題涵蓋建立原始碼配接器、將它透過配接器鏈結連接至專案,並在測試模式中執行與配接器鏈的專案時,所需要的一切作業。
選取範本,以建立配接器
如果要選取範本來建立配接器,請執行下列動作:
- 選取
- 按一下新增配接器。
- 在「名稱」處,輸入配接器的唯一名稱。配接器名稱在整個配接器集中必須是唯一的,並且不能包含空格。
- 在「類型」處,選取配接器類型。
- 在「範本」處選取範本。清單會包含和 Build Forge 產品一起安裝的配接器範本。ClearCase 和 ClearQuest 配接器不需要個別的授權金鑰。其他配接器會經由 Adaptor Toolkit 個別授權。
- 在「存取」處,選取存取群組。只有群組成員才能檢視或編輯配接器。
- 按一下儲存配接器。
建立空的環境
如果要建立空的環境,請執行下列動作:
- 選取
- 按一下新增環境。
- 在「名稱」處,輸入環境名稱。指派一個名稱,以說明環境的目的。
- 在「存取」處,選取存取群組。只有這些群組成員才能檢視或編輯環境。
- 按一下儲存環境。
將配接器新增至專案
如果要將配接器新增至專案,請執行下列動作:
- 選取
- 按一下新增配接器鏈結。
- 在「配接器」處,選取您所建立的配接器(和配接器範本)。
- 在「專案」處,選取專案。清單會顯示尚未鏈結至配接器的專案。
- 在「狀態」處,選取作用中。
- 在「環境」處,選取您為配接器鏈結所建立的空環境。
- 在「將資料輸入環境」處,選取是。配接器範本中的應用程式環境變數會新增至環境。
- 按一下儲存,將配接器鏈結至專案。配接器和專案會新增至配接器鏈結的清單中。
編輯環境變數
如果要編輯環境變數,請執行下列動作:
- 選取
- 針對您所建立的環境,按一下編輯圖示
。此畫面會顯示自動新增至環境的配接器環境變數。
- 檢視配接器範本所提供之環境變數的預設值。
- 請視需要變更原始碼應用程式的預設值,以執行配接器專案。
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 時,才會執行建置。
支援這些條件的配接器內容如下所示:
仔細檢查 DTD 中 Build Forge 的現行安裝,以取得有關哪些內容支援 condition 屬性的最新資訊。
就支援條件的內容來說,您會看到類似下列的項目:
<!ATTLIST
adduser condition CDATA #IMPLIED>
配接器 DTD 位於 %BF_HOME%\interface(若為 Windows)和 $BF_HOME/Platform/interface(若為 UNIX)中,其檔名為 interface.dtd。
在測試模式下執行配接器
如果要在測試模式下執行配接器,請執行下列動作:
- 選取
- 在系統配置參數清單中,選取鏈結除錯模式。
- 在「鏈結除錯模式」中,選取是。
- 按一下儲存。
- 選取
- 在專案清單中,選取您在「啟動專案」頁面所建立的與配接器鏈的專案。
- 按一下執行。
檢視工作狀態和日誌
如果要檢視配接器專案的工作狀態和日誌資訊:
- 開啟工作。
- 在專案清單中,找到與配接器鏈的專案,以檢視工作成功/失敗狀態。
- 如果要檢視工作日誌:
- 選取配接器專案的「標籤名稱」以存取工作日誌資訊。
- 選取「資料清單」以存取 BOM 報告。