建立模板時,您可以使用已發布的鏈作為其基礎,也可以從頭開始建立新的命令和事件序列。
然後,這些模板將允許您建立預先建立的命令和事件序列,以便在其他鏈中使用。例如,使用模板,您可以:
- 為簡化鏈建立提供先機。
- 標準化常見工作流程,例如從記錄系統中提取資料。
注意: 您可以在 Chain Builder中使用具有多個鏈、工作區和環境的範本。
從現有鏈建立模板
從現有鏈建立模板具有許多好處:
- 您可以使用第一個鏈作為建立其他鏈的起點。
- 您可以使用 Chain Builder與其他人共享鏈—包括其他組織的組織,例如 Workiva 社區。
若要從現有鏈建立範本:
- 從 Chains中,按一下 Chain Builder。
- 選 擇 Chains 選項卡,然後為該鏈選 擇 Edit 。
- 從右上角鏈的三點選單中,選擇 建立模板。
- 輸入唯一的名稱和描述以幫助識別模板。
- 在 資料夾下,選擇儲存範本的位置。
- 按一下「儲存」(Save)。
- 如果鏈有任何變量,請設定每個模板變數:
- 輸入模板變數的預設名稱。
提示: 為了幫助識別與變數一起使用的值,我們建議您在其名稱中加上前綴。例如,
WSV-
表示工作區變量,CV-
表示鏈變量,DCV-
表示動態鏈變量,或Resource-
表示工作區資源。 - 為了方便移植和重複使用,請刪除預設值。
- 選擇動態鏈變數或工作區資源是否將提供該值。
注意: 如果鏈結變數、工作區變數或執行時間變數提供值,則既不要選擇 Dynamic 也不要選擇 Resource。
- 輸入模板變數的預設名稱。
- 按一下「儲存」(Save),然後「發佈」(Publish)。
從頭開始建立模板
若要建立新的命令和事件序列作為鏈的可重複使用框架,請遵循以下步驟序列。
第 1 步:新增模板
- 在 Chain Builder中,從 Templates 標籤中,按一下右上角的 Create => Template 。
- 若要在 預設 資料夾之外的位置建立模板,請按一下其資料夾的 編輯
- 輸入唯一的名稱和描述以幫助識別模板及其意圖。
提示: 若要協助辨識範本是否提供完整鍊或部分鏈的序列,請在其名稱中包含前綴。例如,
Full-
表示完整鏈,或Part-
表示部分鍊或片段。
第 2 步:設定模板的變數
為了簡化自訂和重複使用,範本包含變數作為其命令變數或工作區資源所需值的佔位符。當您從模板建立鏈時,鏈的變數和資源將取代模板的變數。
對於要包含在模板中的每個變數:
- 在 模板變數下,按一下 新增。
- 輸入變數的名稱和預設值。
提示: 為了幫助識別與模板變數一起使用的值,我們建議您在其名稱中添加前綴。例如,
WSV-
表示工作區變量,CV-
表示鏈變量,DCV-
表示動態鏈變量,或Resource-
表示工作區資源。 - 在 Type下,選擇動態鏈變數或工作區資源將提供變數的值。
注意: 如果鏈結變數、工作區變數或執行時間變數提供值,則既不要選擇 Dynamic 也不要選擇 Resource。
為模板新增所有變數後,按一下 儲存。
注意: 要從範本中刪除變量,請按一下 [] 操作 下的 X。
步驟3:定義範本的節點
當您建立模板時,按其順序設定並連結節點:
- 指令 由從範本建立的鏈執行的任務,例如與 Workiva 平台或其他資料來源互動。
- 範本內發生的事件 ,例如啟用審核工作流程或手動上傳檔案。
- 觸發事件,例如 運行時輸入 用於在執行從模板建立的鏈時設定變數(例如特定帳戶、區域或時間段),或 自動啟動鏈 基於連接來源的變化。
注意: 為了實現自訂和重複使用,模板的命令不使用鍊或工作區中設定的連接、運行器或變數;當您從模板建立鏈時,您將指定這些。
當您新增節點時,將其移動到序列中出現的位置,並將其連結到其下一個和上一個步驟。
- 若要新增模板的第一個節點,請將其移至 Start。
- 若要將節點新增為邏輯樹新分支的起點,請將範本中的上一個步驟連結到多個分支的第一個節點。
- 要相互並行運行命令或作為串行過程的一部分一起運行命令, 創建一個命令組 作為步驟。
注意: 預設情況下,當連結的前一個節點成功時,該節點就會運作。若要啟用條件邏輯,例如僅在前一個節點失敗時運行節點,請雙擊連結並選擇其條件 - success
、 failure 、 warning 或任何 。定義 好模板的節點後,點選【發布】 。
編輯模板的設定
若要調整模板的名稱或描述,或管理其變數:
- 在 Chain Builder中,從 Templates 標籤中,按一下範本的名稱和 Template Settings。
- 根據需要編輯模板的名稱、描述或變數。
- 按一下「儲存」(Save),然後「發佈」(Publish)。
查看使用模板的鏈
若要查看從範本建立的鏈,請前往Templates
選項卡,然後按一下 [ Chains using下的 View 範本。從 In Use 面板中,將顯示從範本建立的鏈。若要開啟鏈,請按一下其名稱。
提示:要尋找特定鏈,請按其名稱進行搜尋。
複製模板
若要將模板用作新模板的起點,請建立它的副本。在 Chain Builder中,從 Templates
標籤中,按一下範本的 Copy 。與他人分享模板
為了幫助其他人創建鏈,您可以使用 Chain Builder與其他人共享已發布模板的鏈接,包括其他組織的鏈接,例如 Workiva Community中的組織。
- 在 Chain Builder中,從 Templates
- 按一下 複製到剪貼簿 和 關閉。
- 根據需要貼上連結並與其他人分享。
請記住,範本依賴可以存取相同連接器和命令的兩個工作區。與其他工作區共用範本時,除非啟用所有必要的連接器,否則匯入的鏈將無法運作。
導入鏈時,您將有機會設定任何缺少的連接器:
撤銷共用範本的存取權限
若要撤銷其他人對共用範本的存取權限,請刷新其 URL 以建立新連結:
- 在 Chain Builder中,從 Templates 標籤中,按一下範本的 Getshareablelink 。
- 按一下 重新產生令牌 和 關閉。
檔案模板
如果您不再需要模板,可以將其存檔。在 Chain Builder中,按 Templates
,然後按一下範本的 Archive 。