Wdata Queries 中的參數使 Queries 成為動態，並可跨報告期間使用。在本連線學習路徑中，我們將透過新增一個參數來修改我們的查詢，使其動態，然後編輯我們的連線以計入參數。然後，我們會將 Query 結果匯出至 Workiva Spreadsheet。
| 主要業務使用個案 | 報告 Wdata 中儲存的資料 |
| 主要學習目標 | 使用鏈中的參數執行查詢 |
| 次要學習目標 | 在查詢中建立參數 |
| 必要條件 |
確定中電員工詳細資料查詢的查詢 ID 選項 - 確定要寫入結果的現有試算表的 URL |
| 支援範本 | CLP | 使用參數執行查詢 |
步驟 1：編輯現有查詢
首先，我們需要編輯 CLP Employee Detail Query 以新增參數。我們將建立一個參數，讓我們決定要查看哪個國家的員工總數。
- 從 Wdata 開啟查詢CLP Employee Detail Query 來編輯它。
- 按照CLP | 使用計算字段創建查詢 來創建查詢
- 在最右側面板中，按一下參數圖示
- 按一下新增參數 並選擇建立新參數
- 命名參數：國家
- 將選取清單切換為已啟用
- 在清單選項方塊中，列出下列國家/地區，每個國家/地區獨立一行：
- 澳洲
- 巴西
- 義大利
- 肯亞
- 美國
- 更新預設為無
- 按一下建立。
- 若要使用參數控制查詢結果，我們需要使用篩選器連接參數與來源資料中的欄位。導航至查詢中的篩選器索引標籤。
- 從左側的原始資料找到Country 欄，然後按一下並將其拖曳到左側的篩選器區域
- 在篩選值欄位的右邊，按一下參數按鈕。
- 在篩選值欄位的右邊，按一下參數按鈕
- 選擇國家......
- 按一下「套用」
-
- 現在您有了一個帶有國家參數的查詢，當您點擊執行查詢時，系統會詢問您希望查詢結果顯示哪個國家。
- 按一下「儲存」。
步驟 2：編輯現有連結
- 導覽到 Chain Builder 並找到 ChainCLP | 執行查詢和匯出結果
- 按一下鉛筆按鈕編輯 Chain
- 按一下右上方的鏈設定
- 重新命名連鎖：CLP | 使用參數執行查詢
- 儲存連鎖
步驟 3：運行時輸入
我們使用 Runtime Inputs Chain Event 來啟動 Chain。這允許我們提示要執行的查詢的 ID、其參數的值，以及要寫入結果的現有試算表的 URL。Spreadsheet URL 欄位為選項；如果留空，則會建立新的 Spreadsheet。
- 按兩下指令來編輯運行時間輸入鏈事件
- 按一下新增輸入 按鈕，並新增下列輸入：
- 類型：TextField文字欄位
- 顯示名稱：查詢參數值
- 必須填寫：已勾選
- 可選擇拖放此新輸入，使其出現在查詢 ID 輸入之後、試算表 URL 輸入之前
- 儲存指令
步驟 4：執行查詢
為了擷取最新的資料，首先需要執行查詢。一旦查詢成功執行，我們就可以匯出查詢結果，用於下線報告或傳送至其他外部系統。我們將使用 Run Query Command 執行 Wdata Query。
- 按兩下執行查詢指令以設定它
- 按一下參數 區段中的ADD 按鈕
- 在Name 欄位中，輸入查詢參數的名稱，在此例中，我們的參數名稱為：Country
- 在Type 欄位中，選擇查詢參數類型，在本例中，我們的參數類型是 文字
- 按一下Value 欄位
- 在左側變數面板中，按一下向下箭頭以展開觸發器
- 按一下向下箭頭以展開「運行時輸入」。
- 按一下查詢參數值
- 儲存指令
步驟 5：測試練習
現在 Chain 已經完成，請測試結果。
- 發佈 鏈
- 按一下執行 ，然後選擇以輸入執行
- 為您的運行時間輸入添加值
- 查詢 ID- Wdata 中中電員工詳細資料查詢的 ID
- 查詢參數值 - 您希望查詢過濾到的值
- 在此範例中 - 我們過濾資料至巴西
- 試算表網址- 您希望將查詢結果匯出至試算表的完整網址
- 連鎖成功完成後，檢視試算表以確認結果
- 連鎖應已成功執行查詢，並將結果匯出至試算表
- 您可以瀏覽工作表 URL，確認資料已匯出至試算表，並已正確篩選。
要瞭解有關使用 Chains 簡化資料集中的更多資訊，請查看Data Collection Paths 的其他內容！