维护 Wdata 参数模板允许您通过链式更新 Wdata 参数选择列表的值来维护该列表。
提示： 参数值 在运行时指定，用于动态筛选查询结果。选择列表会强制执行这些值，但必须在运行查询之前定义这些值——当这些值经常更改时，这就带来了挑战。此模板允许您以编程方式维护这些值。
要求
- 要使用此模板，您必须有一个 Workiva 电子表格或查询，其中包含您需要添加到参数选择列表中的值列表。
- 您必须生成一个 OAuth 令牌 ，并将客户端 ID 和客户端密钥存储为工作区变量。请确保客户端密钥工作区变量已加密。
- 必须在工作区中配置以下连接器：
构建您的模板
“维护 Wdata 参数”模板位于“模板”屏幕的 Workiva Chains 部分。
以下是查找方法：
- 在 Chain Builder中，转到 Templates 选项卡。
- 从顶部菜单中选择 Workiva Chains 。
- 在右上角搜索 维护 Wdata 参数并打开模板。
找到模板后，使用下面列出的运行时输入将其配置到您的工作区。
注： 有关如何从模板创建链的详细说明，请参阅 创建和管理链 文章。
变量
| 变量类型 | 变量名 | 变量用途 |
| 链 | cv-Wdata 参数项列表限制 | 存储下拉列表项数量的 Wdata 限制。创建此变量是为了适应未来任何限制变更。 |
| 工作区变量 | wsv_API 基本 URL - IAM | IAM API 的根路径。您可以在我们的 API开发者文档中找到此值。 |
| 工作区变量 | wsv_API 基本 URL - Wdata | Wdata API 的根路径。您可以在我们的 API开发者文档中找到此值。 |
| 工作区变量 | wsv_客户端 ID | 您的 OAuth 授权客户端 ID。 |
| 工作区变量 | wsv_Client Secret | 您的 OAuth 授权客户端密钥。输入该变量后，请确保对其进行加密。 |
配置您的链
以下各节将帮助您识别此链中的可配置元素及其功能。
运行时输入
| 运行时输入 | 类型 | 目的 |
| 参数名称 | 文本 | 指定此链将更新其值的 Wdata 参数。 |
| 更新类型 | 下拉菜单 | 可以选择向现有列表添加新值，或者用要添加的值替换所有值。 |
| 需要添加的值 | 文件 | 一个包含要添加为行的值的单列文件。此文件需要包含标题行。该文件可以由 Workiva 电子表格、Wdata 查询或任何其他可以生成所需格式文件的来源创建。 |
| 参数类型 | 下拉菜单 | 可指定参数是在工作区内全局定义还是在查询内局部定义。 |
| 查询 ID | 文本 | 如果参数类型为本地参数，则此参数为必填项。此函数用于查找与分配给查询的参数关联的选择列表 ID。 |
子链
- 维护 Wdata 参数 | 添加值：部署主链时，此链会自动部署。
注意： 请确保在执行主链之前发布此子链。
可配置节点
您可以根据业务需求修改用于消息传递的字段：
- 主链：渲染文本模板 - 无效的查询 ID
- 主链：设置链结果 - 警告（查询未找到）
- 主链：渲染文本模板 - 参数无效
- 主链：设置链结果 - 警告（参数无效）
- 子链（添加值）：渲染文本模板 - 未提供参数 ID
- 子链（添加值）：设置链结果 - 警告（参数 ID）
- 子链（添加值）：渲染文本模板 - 参数模式类型
- 子链（添加值）：设置链结果 - 警告（参数类型）
- 子链（添加值）：渲染文本模板 - 信息：无新项
- 子链（添加值）：渲染文本模板 - 警告：项目过多
- 子链（添加值）：设置链结果 - 警告（替换）
- 子链（添加值）：设置链结果 - 警告（添加）
- 子链（添加值）：渲染文本模板 - 状态报告