系統定義的變數可以用在變數中。
系統會在工作的每一個步驟中,自動設定下列變數的值。這些變數是唯讀的。其工作值會列在步驟日誌的 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 | 依預設,不會建立或設定。當 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 | 工作擁有者的使用者名稱。 |