为了使我们的连接能够逐季度、逐年地保持可用状态,而无需对查询进行调整,必须使用参数。在本关联学习路径中,我们将学习如何更新我们的链,以使用连接 ID 刷新 Workiva 平台和 Wdata 查询之间的参数连接。
| 主要业务用例 | Workiva 和 Wdata 之间的数据连接 |
| 主要学习目标 | 了解如何刷新带有参数的连接,并在链运行时设置参数值。 |
| 先决条件 |
配置 Workiva 连接器 完成 CLP | 使用 ID刷新连接 为关联的 Workiva OAuth 授权用户授予对电子表格的权限 |
| 支持模板 | CLP | 使用参数刷新连接 |
步骤 1:复制现有查询
首先,我们需要一个带参数的查询。我们将复制现有的查询,并添加一个参数,以便我们决定要查看哪个国家的员工总数。
- 在 Wdata 主页中,找到“查询 CLP 员工详细信息查询 ” ,然后打开菜单。
- 选择复制
- 将查询名称更新为 按国家/地区查询 CLP 员工详细信息
- 点击 保存查询
- 在查询编辑屏幕中,单击最右侧面板上的 “参数 ”图标
- 点击 添加参数 并选择 创建新参数
- 参数名称: 国家/地区
- 将选择列表切换为启用 状态
- 在“列表选项”框中,列出以下国家/地区,每个国家/地区占一行:
- 澳大利亚
- 巴西
- 意大利
- 肯尼亚
- 美国
- 更新默认值为 无
- 单击创建
- 为了使参数能够控制查询结果,我们需要使用筛选器将参数连接到源数据中的列。导航至查询中的“筛选器”选项卡。
- 在左侧的“源数据”中找到 “国家/地区 ”列,然后单击并将其拖动到左侧的筛选器区域。
- 单击显示“空字符串”的筛选值,即可填充筛选值。
- 在筛选值字段右侧,单击参数按钮
- 选择 国家
- 点击“申请”
-
- 现在您已创建了一个包含国家/地区参数的查询。单击“运行查询”后,系统会询问您希望查询结果显示哪个国家/地区。
- 点击 保存
步骤 2:创建入站连接
为了学习如何使用链刷新连接,我们首先需要建立 Wdata 查询和电子表格之间的连接。
- 导航至 CLP 员工概览 电子表格
- 点击添加新工作表
- 重命名为 CLP 员工按国家/地区详情
- 在“按国家/地区划分的 CLP 员工详细信息”表中添加入站连接:
- 点击右侧的 “连接”图标,打开“连接 ”面板
。
- 在“传入连接”选项卡上,选择 添加连接
- 选择 Wdata 查询
- 选择 按国家/地区查询 CLP 员工详细信息
- 将国家/地区参数设置为 澳大利亚
- 点击 连接
- 点击右侧的 “连接”图标,打开“连接 ”面板
- CLP员工概览电子表格中现在有两个包含“传入连接”的工作表。
步骤 3:编辑现有链
- 导航至链构建器并找到链 CLP | 使用 ID刷新连接
- 点击铅笔按钮编辑链条
- 点击右上角的 链设置
- 重命名链: CLP | 使用参数刷新连接
- 拯救链条
步骤 4:运行时输入
我们使用运行时输入命令来启动链。这样,我们就可以在链运行时指定要刷新哪个连接,以及要更新哪个参数的值。
- 双击命令来编辑运行时输入链事件
- 单击 添加输入 按钮两次,并添加以下输入:
- 输入 1:
- 类型: 文本框
- 显示名称: 参数名称:
- 必填: 未选中
- 输入 2:
- 类型: 文本框
- 显示名称: 参数值:
- 必填: 未选中
- 输入 1:
- 保存命令
步骤 5:刷新连接
为了考虑新增的参数,我们需要更新刷新连接命令,以便将参数和值传递给查询。
- 双击命令编辑 刷新连接
- 连接 ID:继续使用运行时输入中的 连接 ID 变量。
- 添加参数
- 由于我们的参数保存在源端(查询中),因此我们需要在源端填充参数。点击 源参数旁边的 ] + 按钮
- 参数名称:使用运行时输入中的 参数名称 变量 - 这允许我们将链运行时指定的参数名称值传递给刷新连接命令。
- 单击 参数名称 字段
- 在左侧面板中,展开“触发器”下拉菜单
- 展开 “运行时输入 ”下拉菜单
- 选择 参数名称 变量
- 参数值:使用运行时输入中的 参数值 变量 - 这允许我们将链运行时指定的参数值传递给刷新连接命令。
- 单击 参数名称 字段
- 在左侧面板中,展开“触发器”下拉菜单
- 展开 “运行时输入 ”下拉菜单
- 选择 参数值 变量
- 保存命令
步骤 6:测试练习
现在链式循环已经完成,测试结果
- 发布 链
- 点击 执行 ,然后选择 使用输入运行
- 查找 连接 ID
- 导航至 CLP 员工概览电子表格
- 在“连接”面板中,找到 CLP 按国家/地区查询员工详细信息连接 ,然后单击向上箭头。下拉菜单出现后,选择 查看属性
- 复制连接 ID - 请确保不要遗漏任何字符或添加任何空格。
- 返回链构建器,并将连接 ID 粘贴到“连接 ID 运行时输入”中。
- 填写参数输入
- 参数名称: 查询中参数的名称 - 在本练习中,参数名称为 国家
- 参数值: 查询需要筛选的值 - 在本练习中,我们将筛选为 巴西
- 注意:选择与电子表格中已存储的值不同的参数值将覆盖电子表格,我们将看到数据从澳大利亚变为巴西。
- 点击开始
- 链式交易完成后,返回电子表格,查看连接是否已成功刷新!
链式运行成功:
连接刷新成功:
要了解有关使用链刷新连接的更多信息,请完成以下路径: 刷新连接列表!