自動化連線刷新對於簡化資料集中和移動到 Workiva 平台是非常重要的,尤其是當存在多個連線時。在此 Connected Learning Path 中,我們將學習如何使用 Spreadsheet ID 創建一個 Chain 來刷新 Wdata 和 Workiva 平台之間的連線清單。此鏈路將在單一 Spreadsheet 上產生連線清單,然後為我們提供這些連線的 ID 清單,以便我們可以自動刷新 Spreadsheet 中的每個連線。
| 主要業務使用個案 | Workiva 和 Wdata 之間的資料連接 |
| 主要學習目標 | 學習如何使用 Chains 更新連線清單 |
| 次要學習目標 | 學習群迭代器的要點 |
| 必要條件 |
為相關的 OAuth 授權使用者提供權限給試算表 |
| 支援範本 | CLP | 更新連線清單 |
步驟 1:建立鏈條
- 新增連結
- 命名連鎖:CLP | 重新整理連線清單
- 儲存連線
步驟 2:運行時輸入
我們使用 Runtime Inputs 指令啟動連線。這可讓我們指定要刷新所有連線的 Spreadsheet。
- 從啟動節點的 Chain Trigger Events 新增Runtime Inputs Chain Event。
- 按兩下指令,編輯 Runtime Inputs Chain Event。
- 類型:TextField文字欄位
- 顯示名稱:試算表 ID
- 需要:已勾選
- 儲存指令
步驟 3:列出連線
我們將使用 List Connections 指令擷取與試算表 ID 相關聯的連線 ID 清單。List Connections 指令的輸出將會是一個 JSON 檔案,包含 Spreadsheet 中的每個連線,以及與連線相關的詳細資訊,包括連線 ID。
- 從Workiva Connector 新增List Connections Command 到 Chain canvas。
- 將Runtime Inputs 指令連接至List Connections 指令
- 按兩下指令進行設定
- 目的地類型:試算表
- 目的地 ID:使用 Runtime Inputs 中的Spreadsheet ID 變數 - 這允許我們將在 Chain 執行時指定的值推送到 Refresh Connections 指令。
- 按一下目的地 ID 欄位
- 在左側面板中,展開觸發器 下拉選項
- 展開Runtime Inputs 下拉選項
- 選擇試算表 ID 變數
- 儲存指令
步驟 4:指令群組
我們將使用指令群組 來啟用每個連線的迭代。Group Iterator 會將 Spreadsheet 上的每個 Connection 逐一推進以下步驟。
- 在 Chain canvas 上新增指令群組
- 將List Connections 指令連接至In 段落中的指令群組
- 雙擊指令以設定它
- 命名小組:連線迭代
- 導航至「迭代器」索引標籤
- 啟用Iterations 切換,並按一下Iterations 欄位
- 在Select a Variable 面板內,按一下向下箭頭以展開List Connections
- 選擇連線輸出
- 啟用Iterations 切換,並按一下Iterations 欄位
- 儲存指令群組
步驟 5:刷新連線
我們將使用「刷新連線」指令,使用迭代中的連線 ID 來刷新連線。
- 從Workiva Connector 新增Refresh Connection Command 到 Chain canvas。
- 將Start 節從群組迭代器連接到更新連線 指令
- 連線 ID:使用群組迭代器 - 連線迭代器中的 連線 ID 。
- 連線 ID:使用群組迭代器 - 連線迭代中的連線 ID 。這可讓我們將當前迭代的 ID 推送至「刷新連線」指令。
- 按一下連線 ID 欄位
- 在左側面板中,展開群組迭代器 下拉選項
- 展開連線迭代 下拉選項
- 選擇ConnectionId 變數
- 使用先前的來源參數:已勾選
- 這允許我們使用來自來源的先前參數值來刷新連線 - 在我們的例子中,具有國家參數的查詢仍會以巴西作為篩選值來刷新。
- 連線 ID:使用群組迭代器 - 連線迭代中的連線 ID 。這可讓我們將當前迭代的 ID 推送至「刷新連線」指令。
步驟 6:測試練習
現在 Chain 已完成,請測試結果
- 發佈 鏈
- 按一下執行 ,然後選擇Run With Inputs
- 尋找試算表 ID
- 導覽至中電員工總覽試算表
- 在 URL 中,選擇試算表 ID,該 ID 位於 "spreadsheet/「 之後、」/sheet" 之前。
- 例如,試算表 ID 在此以粗體標示:app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- 導航回 Chain Builder 並將試算表 ID 貼到試算表 ID 欄位中
- 按一下開始
- 連鎖完成後,回到試算表,看到兩個連線都已成功刷新!
成功執行連鎖,有兩次迭代:
成功刷新連線:
要瞭解有關使用 Chains 簡化資料收集的更多資訊,請查看Data Centralization Paths 的其他內容!