Wdata 查询中的参数使得查询具有动态性，并可在不同的报告周期内使用。在这个关联学习路径中，我们将通过添加参数来修改我们的查询，使其成为动态的，然后编辑我们的链以考虑该参数。然后我们将查询结果导出到 Workiva 电子表格中。
| 主要业务用例 | 对存储在 Wdata 中的数据进行报告 |
| 主要学习目标 | 使用链中的参数执行查询 |
| 次要学习目标 | 在查询中创建参数 |
| 先决条件 |
确定 CLP 员工详细信息查询的查询 ID （可选）指定要将结果写入的现有电子表格的 URL |
| 支持模板 | CLP | 运行带参数的查询 |
步骤 1：编辑现有查询
首先，我们需要编辑 CLP 员工详细信息查询，添加一个参数。我们将创建一个参数，用于决定要查看哪个国家/地区的员工总数。
- 在 Wdata 中，打开“查询 CLP 员工详细信息查询 ”进行编辑。
- 按照 CLP | 创建带有计算字段的查询 的步骤创建查询
- 在最右侧面板中，单击“参数”图标
- 点击 添加参数 并选择 创建新参数
- 参数名称： 国家/地区
- 将选择列表切换为启用 状态
- 在“列表选项”框中，列出以下国家/地区，每个国家/地区占一行：
- 澳大利亚
- 巴西
- 意大利
- 肯尼亚
- 美国
- 更新默认值为 无
- 点击 创建
- 为了使参数能够控制查询结果，我们需要使用筛选器将参数连接到源数据中的列。导航至查询中的“筛选器”选项卡。
- 在左侧的“源数据”中找到 “国家/地区 ”列，然后单击并将其拖动到左侧的筛选器区域。
- 单击显示“空字符串”的筛选值，即可填充筛选值。
- 在筛选值字段右侧，单击参数按钮
- 选择 国家
- 点击 应用
-
- 现在您已创建了一个包含国家/地区参数的查询。单击“运行查询”后，系统会询问您希望查询结果显示哪个国家/地区。
- 点击 保存
步骤 2：编辑现有链
- 导航至链构建器并找到链 CLP | 运行查询并导出结果
- 点击铅笔按钮编辑链条
- 点击右上角的 链设置
- 重命名链： CLP | 运行查询并带参数
- 拯救链条
步骤 3：运行时输入
我们使用运行时输入链事件来启动链。这样我们就可以提示用户输入要执行的查询的 ID、其参数的值以及要将结果写入的现有电子表格的 URL。电子表格 URL 字段为可选字段；如果留空，则会创建一个新的电子表格。
- 双击命令来编辑运行时输入链事件
- 点击 添加输入 按钮，并添加以下输入：
- 类型： 文本框
- 显示名称： 查询参数值：
- 必填： 已勾选：
- （可选）拖放此新输入框，使其显示在“查询 ID”输入框之后、“电子表格 URL”输入框之前。
- 保存命令
步骤 4：运行查询
为了检索最新数据，首先需要运行查询。查询成功运行后，我们可以导出查询结果，以便后续用于生成报告或发送到其他外部系统。我们将使用运行查询命令来执行 Wdata 查询。
- 双击“运行查询命令”进行配置
- 点击 “ 参数 ”部分中的“添加 ”按钮
- 在 “名称 ”字段中，输入查询参数的名称，在本例中，我们的参数名为 “国家/地区”。
- 在 “类型 ”字段中，选择查询参数类型，在本例中，参数类型为 “文本”。
- 点击 值 字段
- 在左侧的“变量”面板中，单击向下箭头展开“触发器”。
- 点击向下箭头展开运行时输入
- 点击 查询参数值
- 保存命令
步骤 5：测试练习
现在链式流程已完成，请测试结果。
- 发布 链
- 点击 执行 ，然后选择 使用输入运行
- 为运行时输入添加值
- 查询 ID - Wdata 中 CLP 员工详细信息查询的 ID
- 查询参数值 - 您希望查询筛选出的值
- 在这个例子中，我们将数据筛选为 巴西
- 电子表格 URL - 您要将查询结果导出到的电子表格的完整 URL
- 链式流程成功完成后，请查看电子表格以验证结果。
- 该流程应该已成功运行查询并将结果导出到电子表格。
- 您可以通过访问表格 URL 来验证数据是否已导出到您的电子表格并已正确筛选。
要了解有关使用 Chains 简化数据集中化的更多信息，请查看其余的 数据收集路径！