的 Maintain Wdata Parameters 範本允許您通過鏈更新 Wdata 參數選取清單的值來維護 Wdata 參數選取清單。
提示： 參數值 在運行時指定，用於動態篩選查詢結果。選擇清單強制執行這些值，但必須在運行查詢之前定義 -- 當這些值定期更改時，這會帶來挑戰。此範本允許您以程式設計方式維護這些值。
要求
- 要使用此範本，您必須有一個 Workiva 電子表格或查詢，其中包含您需要添加到參數選取清單中的值清單。
- 您必須生成 OAuth 令牌 並將用戶端 ID 和用戶端金鑰儲存為工作區變數。確保 client secret workspace 變數已加密。
- 必須在您的工作區中設定以下連接器：
構建您的範本
Maintain Wdata Parameters 範本位於 Templates 螢幕的 Workiva Chains 部分。
以下是找到它的方法：
- 在 Chain Builder 中，轉到 Templates 選項卡。
- 從 頂部的功能表中選擇 Workiva Chains 。
-
搜索右上角的Maintain Wdata Parameters並打開範本。
找到範本后，使用下面列出的運行時輸入將其配置為工作區。
注意： 有關從範本創建鏈的詳細說明，請參閱 創建和管理鏈 一文。
變數
| 變數類型 | 變數名稱 | 可變用途 |
| 鏈 | cv-wdata 參數項清單限制 | 存儲選取清單項數量的 Wdata 限制。這是作為變數創建的，以允許將來的任何限制更改。 |
| 工作區變數 | wsv_API 基 URL - IAM | IAM API 的根路徑。您可以在我們的 API 開發人員文件中找到此值。 |
| 工作區變數 | wsv_API 基 URL - Wdata | Wdata API 的根路徑。您可以在我們的 API 開發人員文件中找到此值。 |
| 工作區變數 | wsv_客戶端 ID | OAuth 授權的用戶端ID。 |
| 工作區變數 | wsv_客戶端秘密 | OAuth 授權的用戶端密鑰。確保此變數在輸入后已加密。 |
配置您的鏈
以下部分將幫助您識別此鏈的可配置元素及其功能。
運行時輸入
| 運行時輸入 | 類型 | 目的 |
| 參數名稱 | 文字 | 指定 Wdata 參數，其值將由此鏈更新。 |
| 更新類型 | 下拉 | 將新值添加到現有清單或將所有值替換為將要添加的值的選項。 |
| 要添加的值 | 檔案 | 包含要添加為行的值的單列檔。此檔中需要標題行。此檔可以從 Workiva 電子表格、Wdata 查詢或生成所需格式檔的任何其他源創建。 |
| 參數類型 | 下拉 | 用於指定參數是在工作區中全域定義還是在查詢中本地定義的選項。 |
| 查詢ID | 文字 | 如果參數類型為local，則為必需。這用於查找與分配給查詢的參數關聯的選擇清單ID。 |
子鏈
- 維護 wdata 參數 |Add Values：當您部署主鏈時，此鏈會自動部署。
注意： 確保在執行主鏈之前發佈此子鏈。
可配置的節點
您可以根據需要修改用於消息收發目的的欄位，以支援您的業務需求：
- 主鏈：渲染文本範本 - 查詢 ID 無效
- 主鏈：設置鏈結果 - 警告（未找到查詢）
- Primary Chain：渲染文字範本範本 - 參數無效
- Primary Chain：設置鏈結果 - warn（參數無效）
- 子鏈（添加值）：渲染文本範本 - 未提供參數ID
- 子鏈（添加值）：設置鏈結果 - 警告（參數ID）
- 子鏈（添加值）：渲染文字範本範本 - 參數模式類型
- 子鏈（添加值）：設置鏈結果 - 警告（參數類型）
- 子鏈（添加值）：渲染文本範本 - 資訊：無新項
- 子鏈（添加值）：渲染文本範本 - 警告：專案過多
- 子鏈 （添加值）：設置鏈結果 - 警告 （替換）
- 子鏈（添加值）：設置鏈結果 - 警告（添加）
- 子鏈（添加值）：渲染文本範本 - 狀態報告