使用控制表是存储单个工作流程中使用的不同变量的最有效方法。控制表对于允许最终用户指定链的输入而无需编辑链本身非常有价值。要使用控制表,我们首先需要了解如何构建控制表以及如何从控制表中读取数据。在本关联学习路径中,我们将设置一个控制表,并使用 Workiva 命令从控制表中检索数据。
| 主要业务用例 |
从集中位置协调报告工作流程 简化最终用户的工作流程管理 |
| 主要学习目标 | 学习如何构建控制表以及如何使用链式结构从控制表中检索数据 |
| 先决条件 |
配置 Workiva 连接器 完成 CLP | 刷新连接列表 为关联的 Workiva API 授予用户对电子表格的权限 |
| 支持模板 | CLP | 从控制表中读取数据 |
步骤 1:创建控制表
我们将创建一个 控制表,用于存储将数据上传到 Wdata 表的变量,然后刷新该数据的连接。与其在每次链运行时将这些变量指定为 运行时输入 ,不如将变量添加到链将在整个运行过程中读取和使用的控制表中。
虽然此控制表演示了如何将多个文件上传到单个 Wdata 表并刷新单个电子表格上的连接,但只需将表或电子表格的唯一 ID 添加到控制表中,即可将该过程扩展到包含多个表和电子表格。
- 前往 Workiva 平台创建新电子表格
- 点击 创建 并选择 电子表格
- 表格名称: CLP 控制表
- 第一个工作表名称: 主控制表
- 在主控表中,创建以下标题
- 活动标志
- 此列指定是否需要针对控制表中的该行运行工作流。
- 文件名
- 此列指示数据集在 Wdata 表中的显示名称。
- 表ID
- Wdata 中要上传数据的表的 ID
- 表格ID
- 要刷新数据的电子表格的 ID
- 文件位置
- 待下载文件的位置
- 活动标志
- 请在表格中填写以下值,并用方括号 填充。<TableID>列 包含 CLP 员工详细信息表 [ 的 ID 和 <SpreadsheetID>列 包含 CLP 员工概览电子表格的 ID,这些 ID 是在之前的关联学习路径中创建的,请参阅先决条件以查看所需的关联学习路径。
ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID> ,<SpreadsheetID> ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02, , ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03, ,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv
步骤二:更新电子表格权限
为确保 Workiva 命令与电子表格之间有效通信,生成的 API 授权 必须与拥有电子表格所有者或编辑权限的用户关联。
- 在 CLP 控制表 电子表格中,单击顶部功能区中的 文件 。
- 点击 权限,然后点击 电子表格
- 在 Workiva Connection 中,向与已配置的 API 授权关联的任何 Workiva 用户提供访问权限。
步骤 3:创建链
为了使用我们在控制表中创建的变量,我们将创建一个从中读取数据的链。由于我们将始终使用同一个电子表格和工作表,我们将设置链变量来存储这些详细信息,以便进行一致的访问。
- 导航至链式构建器
- 创建一个新的链
- 命名链: CLP | 从控制表中读取
- 在“链式变量”下,单击两次加号 (+) 创建两个链式变量,并按如下方式配置它们:
- 变量 1:
- 类型:链式变量(CV)
- 姓名: 简历 -控制电子表格 ID
- 值:输入 CLP 控制电子表格的 ID
- 要查找电子表格 ID,请导航至 CLP 控制表电子表格
- 在网址中,选择位于“spreadsheet/”之后、“/sheet”之前的电子表格 ID。
- 例如,此处以粗体显示的是电子表格 ID:app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- 要查找电子表格 ID,请导航至 CLP 控制表电子表格
- 变量 2:
- 类型:链式变量(CV)
- 名称: cv-控制表名称
- 值: 主控制表
- 变量 1:
- 拯救链条
步骤 4:获取工作表数据
我们使用“获取工作表数据”命令来启动该流程。这样我们就可以从控制表中检索信息并提供给供应链。
- 从 Workiva连接器向链起始 区域添加 “获取工作表数据 ”命令
- 双击命令进行配置
- 点击电子表格 ID 字段
- 在 “选择变量 ”面板中,单击向下箭头展开 “链”。
- 选择 cv-Control 电子表格 ID 链变量
- 单击“工作表 ID/名称”字段
- 在 “选择变量 ”面板中,单击向下箭头展开 “链”。
- 选择 cv-控制表名称链变量
- 地区:请随意指定地区。如果保留“:”,该命令将检索整个电子表格中的数据。
- 点击电子表格 ID 字段
- 保存命令
步骤 5:测试练习
现在链式流程已完成,请测试结果。
- 发布 链
- 点击 执行 ,然后选择 运行链
- 链式操作完成后,点击 获取表格数据 节点以验证是否成功
- 该命令应生成一个包含指定工作表数据的 .csv 文件,您可以通过点击眼睛图标查看该文件。
要了解有关使用控制表的更多信息,请完成以下路径: 使用控制表中的值!