Workiva 支援中心

CLP - 使用參數刷新連線

CLP - 使用參數刷新連線

上次更新時間： 2026年04月01日 10:07

為了讓我們的「連線」在不調整查詢的情況下，可以逐季或逐年使用，必須使用參數。在此 Connected Learning Path 中，我們將學習如何更新我們的 Chain，以使用 Connection ID 在 Workiva Platform 和 Wdata Query 之間刷新帶有參數的連接。

主要業務使用個案	Workiva 和 Wdata 之間的資料連線
主要學習目標	學習如何使用參數刷新連線，在 Chain 執行時設定參數值
必要條件	設定Workiva Connector 完成CLP \| 使用 ID 更新連接為相關的 Workiva OAuth 授權使用者提供權限給試算表
支援範本	CLP \| 使用參數刷新連接

步驟 1：複製現有查詢

首先，我們需要一個有參數的查詢。我們將建立現有查詢的副本，並加入一個參數，讓我們決定要查看哪個國家的僱員總人數。

從 Wdata 首頁，找到查詢CLP Employee Detail Query 並開啟功能表。
- 選取「複製」。

更新查詢名稱為按國家查詢中電員工詳細資料

按一下「儲存查詢」(Save Query)。
從查詢編輯畫面，按一下最右側面板上的參數圖示

按一下新增參數 並選擇建立新參數
- 命名參數：國家
- 將選取清單切換為已啟用
- 在清單選項方塊中，列出下列國家/地區，每個國家/地區獨立一行：
  - 澳洲
  - 巴西
  - 義大利
  - 肯亞
  - 美國
- 更新預設為無
- 按一下「建立」
若要使用參數控制查詢結果，我們需要使用篩選器連接參數與來源資料中的欄位。導航至查詢中的篩選器索引標籤。
- 從左側的原始資料找到Country 欄，然後按一下並將其拖曳到左側的篩選器區域
- 在篩選值欄位的右邊，按一下參數按鈕。
  - 在篩選值欄位的右邊，按一下參數按鈕
  - 選擇國家......
  - 按一下「套用」

- 現在您有了一個帶有國家參數的查詢，當您點擊執行查詢時，系統會詢問您希望查詢結果顯示哪個國家。

按一下「儲存」。

步驟 2：建立傳入連接

為了學習如何使用 Chain 更新 Connection，我們首先需要在 Wdata Query 和 Spreadsheet 之間建立連線。

導覽到中電員工總覽 試算表
按一下新增工作表
- 將其重新命名為「按國家劃分的中電員工詳情」工作表
在「按國家/地區劃分的 CLP 僱員詳細資料」工作表中添加傳入連接：
- 按一下「連線」圖示，開啟「連線」面板 （位於右側）。
- 在「傳入連接」標籤上，選擇添加連接
  - 選取 Wdata 查詢
  - 選擇CLP Employee Detail by Country Query
  - 將國家參數設定為澳洲
  - 按一下「連結」。

在「中電員工總覽試算表」中，現在有兩張工作表顯示「傳入連線」。

步驟 3：編輯現有連結

導航至 Chain Builder 並找到 ChainCLP | 使用 ID 更新連線
按一下鉛筆按鈕編輯 Chain
按一下右上方的「連線設定」
- 重新命名連鎖：CLP | 使用參數刷新連線
儲存連線

步驟 4：運行時輸入

我們使用 Runtime Inputs 指令啟動 Chain。這可讓我們指定要在 Chain 執行時刷新的連線，以及要更新值的參數。

在指令上按兩下以編輯運行時間輸入連鎖事件
按兩下Add Input 按鈕，並新增下列輸入：
- 輸入 1：
  - 類型：TextField文字欄位
  - 顯示名稱：參數名稱
  - 必須填寫：未勾選
- 輸入 2：
  - 類型：文字欄位
  - 顯示名稱：參數值參數值
  - 需要：未選取
儲存指令

步驟 5：重新整理連線

為了記錄新增的參數，我們需要更新「刷新連線」指令，以記錄應該推送到查詢的參數和值。

編輯Refresh Connection ，方法是在 Command 上按兩下。
- 連線 ID：繼續使用 Runtime Inputs 中的Connection ID 變數
- 新增參數
  - 由於我們的參數儲存於來源（在查詢中），因此我們要在來源填入參數。按一下原始參數旁邊的+ 按鈕
  - 參數名稱：使用 Runtime Inputs 中的Parameter Name 變數 - 這允許我們將 Chain 執行時指定的 Parameter Name 值推送到 Refresh Connections Command。
    - 按一下參數名稱 欄位
    - 在左側面板中，展開觸發器下拉選項
    - 展開Runtime Inputs 下拉選項
    - 選擇參數名稱 變數
  - 參數值：使用 Runtime Inputs 中的Parameter Value 變數 - 這允許我們將 Chain 執行時指定的 Parameter Value 推送到 Refresh Connections Command。
    - 按一下參數名稱 欄位
    - 在左側面板中，展開觸發器下拉選項
    - 展開Runtime Inputs 下拉選項
    - 選擇參數值 變數
儲存指令

步驟 6：測試練習

現在 Chain 已完成，請測試結果

發佈鏈
按一下執行，然後選擇Run With Inputs
尋找連線 ID
- 導覽至中電員工總覽試算表
- 在 Connections 面板中，找到CLP Employee Detail by Country Query Connection ，然後按向上箭頭。出現下拉式選單後，選擇檢視內容

複製連線 ID - 確保沒有遺漏任何字元或新增任何空格

導航回 Chain Builder 並將連線 ID 貼到連線 ID Runtime 輸入中
輸入參數
- 參數名稱: 查詢中參數的名稱 - 在本練習中，參數名稱為國家
- 參數值: 查詢需要篩選的值 - 在本練習中，我們將篩選巴西
  - 注意：選擇與已儲存在試算表中的參數值不同的參數值將會覆寫試算表，我們將會看到資料從澳洲變更為巴西。
按一下開始
一旦 Chain 完成，導航回到 Spreadsheet，即可看到連線已成功刷新！

成功執行連鎖：

成功刷新連線：

完成下一個路徑，瞭解更多關於使用 Chains 來刷新連線的資訊：刷新連線清單！