系統變數參照

系統定義的變數可以用在變數中。

系統會在工作的每一個步驟中,自動設定下列變數的值。這些變數是唯讀的。其工作值會列在步驟日誌的 ENV 字行中。前四個是專案層次的通知。其他所有 BF_ 變數是在步驟層次使用。

專案層次的變數
BF_D 日期。可用於標籤中。格式由標籤決定:日期格式系統設定。
BF_J 一年中的第幾天。可用於標籤中。
BF_T 時間。可用於標籤中。格式是由標籤決定:時間格式系統設定。
BF_W 星期幾,以 0(星期日)到 6(星期六)的一個數字表示。
步驟層次的變數
BF_D 日期。可用於標籤中。格式由標籤決定:日期格式系統設定。
BF_J 一年中的第幾天。可用於標籤中。
BF_T 時間。可用於標籤中。格式是由標籤決定:時間格式系統設定。
BF_W 星期幾,以 0(星期日)到 6(星期六)的一個數字表示。
BF_AGENT_PLATFORM 這個字串識別正在執行代理程式的作業系統平台。
BF_AGENT_VERSION 現行伺服器的代理程式版本號碼。
B 預設標籤變數,從 1 開始,依每個工作依序增量。可用在以 BF_TAG 表示的標籤中。
BF_BID 工作 ID 號碼,對於相同專案的工作來說是唯一的。
BF_CALLER_ 從呼叫端專案傳遞至鏈結專案的變數所要套用的字首。
BF_CLASS 專案的 Build Forge 類別
BF_ENGINE 用來唯一識別引擎的字串。此值也會儲存在安裝目錄中的下列檔案內:engine.id。例如:D8531015-6C07-1014-8CA0-BD58317220B3。
BF_HOST 邏輯伺服器的主機名稱(TCP/IP 主機名稱)。(這個變數是伺服器環境的一部分。)
BF_ITERATION 步驟在「While 迴圈」中已順利啟動的次數。當步驟的「條件」求值為 true 時,此值會增量。工作重新啟動作業會使用這個變數的值,作為要重新啟動的反覆運算。
BF_ITERATION_MAX 「While 迴圈」所能執行的次數上限。這是在步驟內容中設定的。如果達到這個反覆運算數,則會將 BF_ITERATION_MAX_REACHED 設定為「是」。
BF_ITERATION_MAX_REACHED

依預設,不會建立或設定。當 while 迴圈的反覆運算次數達到 BF_ITERATION_MAX 時,會將「While 迴圈」步驟的步驟唯一 ID (BF_SSID) 附加至這個變數。如果專案中有多個「While 迴圈」步驟達到其 BF_ITERATION_MAX,這個變數會包含多個值,每一個各代表一個達到反覆運算數上限的步驟。

BF_LASTGOODRUN 同一專案最近一項通過工作的日期;如果沒有通過的工作,則為前一個工作的日期。
BF_LASTGOODTAG 最近一項通過工作的標籤(如果同一個專案沒有儲存通過的工作,則為前一個工作)。
BF_LASTGOODUNIX 與 BF_LASTGOODRUN 相同,但它是以 UNIX® 格式來表示日期。
BF_LASTRUN 現行工作前次執行的日期。
BF_LASTTAG 相同專案之前一項工作的標籤字串。
BF_LASTUNIX 與 BF_LASTRUN 相同,但它是以 UNIX 格式來表示日期。
BF_ONFAIL 步驟的「中止/繼續」旗標。
BF_PID 專案 ID 號碼。
BF_PROJECTNAME 工作的專案名稱。
BF_PROJECTNAME_PHYS 用來建立專案目錄的專案名稱。系統建立專案目錄時,會將無效的相對目錄字元系統設定中所指定的字元變更為底線字元。比方說,如果設定包含一個空格,則名為 My Project 的專案,其專案目錄名稱就是 My_Project
BF_ROOT 工作的基本工作目錄,取自工作內容。另請參閱 BF_STEP_ROOT。
BF_SERVER 正在執行現行工作的伺服器名稱(這個變數是伺服器環境的一部分)。
BF_SERVER_ROOT 指派給伺服器內容中之邏輯伺服器的路徑(這個變數是伺服器環境的一部分)。
BF_SID 建置內的步驟結果的序號。
BF_SPID 若有另一項工作已呼叫現行工作,則會包含呼叫端專案 ID。如果沒有值,則和 BF_PID 相同。
BF_STEPNAME 步驟名稱。設定在步驟內容中。
BF_STEP_ROOT 步驟的基本工作目錄,取自步驟內容。另請參閱 BF_ROOT。
BF_SSID 步驟 ID,為現行步驟在專案中的唯一 ID。
BF_TAG 工作的標籤。標籤定義可以包含變數。這個變數含有在工作啟動時因解譯這些變數而產生的值。
BF_TAG_PHYS 工作的標籤,會以底線取代出現在 BF_TAG 值中的任何空格。如果步驟選取了「絕對」選項,則 BF_TAG_PHYS 等同於 BF_TAG。
BF_USER 工作擁有者的使用者名稱。

意見