维 护 Wdata 参数 模板允许您通过链更新其值来维护 Wdata 参数选择列表。
提示： 参数值 是在运行时指定的，用于动态过滤查询结果。选择列表强制执行这些值，但必须在运行查询之前定义 - 当这些值定期更改时，这会带来挑战。该模板允许您以编程方式维护这些值。
要求
- 要使用此模板，您必须有一个 Workiva 电子表格或查询，其中包含需要添加到参数选择列表的值列表。
- 您必须生成一个 OAuth 令牌 并将客户端 ID 和客户端机密存储为工作区变量。确保客户端机密工作区变量已加密。
- 必须在您的工作区中配置以下连接器：
构建模板
维护 Wdata 参数 模板位于模板屏幕的 Workiva 链部分。
查找方法如下：
- 在 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_客户端秘密 | 您的 OAuth 授予的客户端密钥。输入后请确保该变量已被加密。 |
配置你的链
以下部分将帮助您识别此链的可配置元素及其功能。
运行时输入
| 运行时输入 | 类型 | 目的 |
| 参数名称 | 文本 | 指定此链将更新其值的 Wdata 参数。 |
| 更新类型 | 下拉列表 | 选择将新值添加到现有列表或用将要添加的值替换所有值。 |
| 增加价值 | 文件 | 包含要作为行添加的值的单列文件。此文件需要一个标题行。该文件可以从 Workiva 电子表格、Wdata 查询或任何其他生成所需格式文件的源创建。 |
| 参数类型 | 下拉列表 | 用于指定参数是在工作区内全局定义还是在查询内本地定义的选项。 |
| 查询 ID | 文本 | 如果参数类型是本地的，则必需。这用于查找与分配给查询的参数关联的选择列表 ID。 |
子链
- 维护Wdata参数 | 添加值: 部署主链时会自动部署此链。
注意： 请确保在执行主链之前发布此子链。
可配置节点
您可以根据需要修改用于消息传递目的的字段以支持您的业务需求：
- 主链：渲染文本模板 - 无效查询 ID
- 主链：设置链结果 - 警告（未找到查询）
- 主链：渲染文本模板 - 无效参数
- 主链：设置链结果 - 警告（无效参数）
- 子链（添加值）：渲染文本模板 - 未提供参数 ID
- 子链（添加值）：设置链结果 - 警告（参数 ID）
- 子链（添加值）：渲染文本模板 - 参数模式类型
- 子链（添加值）：设置链结果 - 警告（参数类型）
- 子链（添加值）：渲染文本模板 - 信息：无新项目
- 子链（添加值）：渲染文本模板 - 警告：项目过多
- 子链（添加值）：设置链结果 - 警告（替换）
- 子链（添加值）：设置链结果 - 警告（添加）
- 子链（添加值）：渲染文本模板 - 状态报告