關於「環境」畫面

您可以使用「環境」畫面來建立及管理專案的環境。若要檢視畫面,請選取環境

「環境」畫面中顯示的環境清單

在「環境」畫面中,您也可以按一下某個環境,以顯示和編輯其變數。

「詳細資料」標籤

環境內容

請指定下列環境內容:

名稱
環境的名稱。
存取
可以使用這個環境之使用者的存取群組。

變數內容

在「環境」畫面中,選取變數來檢視「變數」畫面。您可以使用「變數」畫面來指定下列內容:

名稱
變數名稱只能在名稱中使用英數字元 (a-z、A-Z、0-9)和底線字元 ( _ )。長度上限為 255 個位元組:
  • 單位元組字集:255 個字元
  • 雙位元組字集:127 個字元
變數值具有下列性質:
  • 長度:值的長度不拘(若有作業系統限制,則以其為上限)。
  • 特殊字元:對於預先剖析器(對作業系統求值之前)以及作業系統上的求值,%、$、[、]、{、}、\、" 和 ' 等字元都有其特殊的意義。請避免使用它們。在傳遞時,請使用反斜線讓它們跳出。請參閱解譯步驟中的變數

    如果用單引號括住值,就會依照字面來傳遞變數名稱,不進行解譯。例如,MyEnv='$env' 這項變數指派會將 $env 字串指派給 MyEnv,而不是指派 $env 變數的值。

  • 值中的變數:如果變數值中有變數,則會在執行使用該變數的步驟時,解譯該變數。
  • 下拉值:如果要指定下拉變數的項目,請將變數類型設定為「下拉清單」、儲存變數,然後進行編輯。請按一下「下拉選項」標籤,將項目新增至下拉清單中。請參閱建立變數的下拉清單
  • 以點指令作為值:某些點指令可以作為環境變數的值;在這些情況下,系統會以其他的值取代點指令。請參閱在變數中使用點指令
  • 回車字元:變數不會儲存回車字元。您可以指派一個多行值給變數,如下例所示。將 text.txt 檔的內容指派給 test 變數:
    .bset env "test = `type text.txt`"
    檔案中的字行是連續的。例如,假設檔案內容如下所示:
    A first line
    And a second line
    則變數值將變成下面這一行:
    A first lineAnd a second line
類型
指派給變數的類型可為下列其中一項:
  • 標準 - 預設值。可指派一個值與動作給變數。
  • 併入 - 變數值指向另一個要併入的環境。該環境中的所有變數都會併入。
    註: 「併入」變數類型取代了舊版提供的 .include 功能。
  • 下拉清單 - 變數含有一組可供使用者挑選的值。建立下拉清單變數之後,您可以選取它,並按一下下拉選項標籤以新增值。
動作

下列其中一項:

  • 設定:預設選項。將指定的值指派給變數。如果變數不存在,則會加以建立。
  • 設定(如果沒有設定的話):只有在變數已無任何值時,這個動作才會指派值給該變數。請參閱關於變數
  • 附加:將值附加到變數的現行值後面。值之間會加上作業系統特有的「路徑」定界字元:
    • Windows:分號 (;)
    • UNIX 或 Linux:冒號 (:)
  • 置前:將值插入現行值前面。值之間會加上作業系統特有的「路徑」定界字元:
    • Windows:分號 (;)
    • UNIX 或 Linux:冒號 (:)
  • 清除:將值設為空字串。如果「值」內容含有一值,則不會採用。
  • 刪除/取消設定:將變數從現行套用的環境中刪除。如果「值」內容含有一值,則不會採用。
  • 隱藏指派:由系統指派變數,但在日誌中隱藏該值,而只顯示為 "*****"。使用此選項可隱藏變數值,不讓執行專案的使用者看見。
    重要: 如果您將機密性資訊儲存在隱藏變數中,請小心使用。隱藏變數的值可以透過檢查資料庫或利用 API 用戶端來讀取。對於密碼之類的機密性資訊而言,它們並不安全。

    依預設,「指派隱藏」變數是受到保護而無法編輯的。使用者若沒有「編輯隱藏標籤」權限,就不能編輯這些值。不過,如果他們具有那些權限,則他們可以刪除再重建這些值。使用者若具有「編輯隱藏標籤」權限,就可以直接編輯這些值,但是必須重新鍵入要使用的值。此行為可防止使用者將「隱藏指派」變數的類型變更為「設定」以顯示其值。

    註: 如果步驟中的某個變數設為「隱藏指派」,則會將該步驟中的所有變數都視為已設為「隱藏指派」。
    註: 「隱藏指派」變數僅適用於專案。如果將「隱藏指派」變數傳給「配接器」,此變數就不再維持隱藏。

    系統通常會將指令行中的變數語法,變更為適合您作業系統的格式(如果是 Windows® 系統,則為 %VAR%;如果是 Linux® 與 UNIX® 系統,則為 $VAR)。它不會對隱藏的變數執行這個動作。 變數會直接傳給伺服器,由伺服器的作業系統環境來解譯變數。

    因此,請勿使用任何一個作業系統可能剖析的變數名稱。範例:
    • $name:如果這個變數設為「隱藏指派」,當在 UNIX 或 Linux 系統上解譯這個變數時,作業系統會試圖在它的環境中,而不是在 Build Forge 環境中加以解析。
    • %address%。如果這個變數設為「隱藏指派」,當在 Windows 系統上解譯這個變數時,作業系統會試圖在它的環境中,而不是在 Build Forge 環境中加以解析。
於專案
定義當您手動啟動工作時,要如何使用變數。這個內容只會影響指派給該專案的環境中所用的變數。當工作在執行中時,此內容不會影響變數。值可為下列其中一項:
  • 一般:當將變數指派給專案時,變數的行為如常。
  • 必要:變數必須有值存在。使用這種內容的變數,會在「啟動」畫面中強調顯示。定義在變數定義中的值便已夠用。如果沒有定義值,工作就無法快速啟動或啟動。

    如果是排程器而不是使用者啟動了含有「必要」變數的工作,若變數目前有值,變數會維持不變,若沒有值,便保留空白。

  • 唯讀:值無法變更。
  • 抑制顯示:此變數不會顯示在「啟動工作」畫面上。不過,變數仍在,並且可在步驟中使用。
  • 必須變更:變數值必須變更。在「啟動」畫面中會強調顯示具有此內容的最上層變數;若未輸入新的值,即無法快速啟動或啟動工作。
    註: 如果含有「必須變更」變數的工作是由排程器啟動,而非由使用者啟動,則變數值會維持不變。若含有「必須變更」變數的工作由類別內容啟動,變數值也會維持不變。類別內容包含「清除時啟動」、「進入時啟動」及「結束時啟動」。

Snapshot 標籤

環境 Snapshot 是環境的實例。Snapshot 標籤提供了 Snapshot 的名稱。請使用這個標籤來檢視或變更 Snapshot 名稱以及 Snapshot 的相關註解。


意見