要為重複出現在多個鏈或單個鏈中的命令的輸入設置值,可以使用變量 。與其在多個鏈或命令中輸入相同的值,您可以將其定義為變量,並在一個位置管理其值。
- 工作區變數 定義在多個鏈中出現的值。
- 連鎖變數 定義在連鎖的多個指令中出現且可能經常改變的值。
- 動態變數 定義要在鏈執行時或鏈執行過程中設定的值,例如基於先前命令的輸出。
可提供的其他訓練
您可透過 Workiva Learning Hub 中的自定步調課程學習鏈的功能。這個全面的課程將指導您從頭到尾完成建立鏈結的流程,提供實踐經驗和對鏈結產生器平臺的深刻理解。
造訪 Workiva 學習中樞
管理您工作區的變數
在工作區中,您可以定義多個鏈使用的變量:
- 在Chain Builder 中,選擇左上方的Settings 。
- 在變數 的右側,按一下新增 。
- 輸入變數名稱,必要時輸入預設值和說明。稍後可以針對個別鏈自訂這些預設值。
- 為了增加安全性,請選擇Encrypt - 這將隱藏任何敏感值,例如密碼。
- 按一下「儲存」(Save)。
在工作區中新增變數後,可視需要編輯變數的名稱、值或加密方式。要從工作區移除變數,請按一下刪除 。
管理連鎖的變數
對於在連鎖中的多個指令中出現且經常改變的值,請將它們新增為連鎖的變數。連鎖中的變數數目並沒有硬性限制,但是當連鎖中的變數數目達到 1000 個時,就會出現反應能力降低的情況。
- 在鏈結中按一下「鏈節設定」(Chain Settings).
- 在變數 下,按一下新增 。
- 輸入唯一的名稱和說明,以協助識別變數及其用途。
- 輸入變數的預設值。
- 若要僅允許管理員檢視變數的值,例如密碼,請選擇Encrypt 。
- 按一下「儲存」(Save)。
要更新變數,點擊編輯 變數鏈,並調整變數 下的值。
要移除不再需要的變數,請按一下刪除 。
管理連鎖的動態變數
若要在連鎖執行時設定值,或以其他指令的輸出為基礎,請將它們新增為連鎖的動態變數。
備註: 為了方便連續執行,動態變數會保留連鎖上次執行時設定的值。
- 在鏈結中按一下「鏈節設定」(Chain Settings).
- 在動態變數 下,按一下新增 。
- 輸入唯一的名稱,以協助識別變 數及其目的。
註: 此處不適用初始值欄位,應留空。
- 按一下「儲存」(Save)。
備註: 若要在連鎖開始執行時設定動態變數值,請使用aRuntime Inputs 啟動事件 。若要暫停連鎖以定義動態變數的值,然後再進行下一步,請新增a設定動態連鎖變數 事件 。
要移除不再需要的變數,請按一下刪除 。
使用變數作為指令輸入
將變數作為指令的文字輸入:
- 從連線中,選擇要使用變數的命令。
- 在以文字為基礎的輸入中使用變數,按一下變數 ,然後選擇變數。
註記: 要在輸入中連結多個變數,請選擇要使用的變數,然後輸入任何文字出現在每個變數之前或之後。
- 按一下「儲存」(Save)。
註: 要修改或格式化變數以用作命令輸入,應用變數變換 。
運行時間變數
若要包含與連鎖執行時間相關的資料,您可以使用數個執行時變數。
| 變數 | 描述 |
|---|---|
| Chain.Environment | 當前執行鏈的環境 |
| Chain.ExecutionDateTime | 連鎖開始的日期和時間 |
| Chain.ExecutorId | 目前正在執行的連鎖的數字 ID |
| Chain.Id | 非執行中 狀態的鏈的數字 ID |
| Chain.Name | 目前執行中的連鎖名稱 |
| Chain.PreviousExecutionDateTime | 鏈上次執行的日期和時間 |
| Chain.URL | 目前執行的連鎖的唯一 URL |
| Chain.Workspace | 目前執行鏈的工作區 |
| Command.ExecutorId | 目前正在執行的命令的數字 ID |
| Command.Id | 非執行中 狀態的命令的數字 ID |
| Command.Name | 目前正在執行的指令名稱 |
| Command.URL | 當前執行指令的唯一 URL |
| Runner.InstallationDirectory | 連鎖的 GroundRunner 安裝目錄;如果使用 CloudRunner,則為 null |
| System.Date | 目前的系統日期 |
| System.DateTime | 目前的系統日期和時間 |
| User.Email | 執行連鎖的合作者的電子郵件地址 |
| User.Id | 執行連鎖的合作者的 ID |
| User.Name | 執行連鎖的合作者名稱 |