链模板旨在提供有关链环境中的链和链运行的全面信息。它可作为监控日志的有益补充,提供有关 Chain 活动的更多见解。
- 库存和跟踪: 它简化了库存流程,使用户能够快速识别未充分利用或需求量高的链条。这有助于更好地分配资源,提高效率。
- 详细报告: 用户可以生成报告,详细说明 ID、日期、名称等重要元数据,这对于文档记录和分析非常重要。
- 清理过程: 该模板对于识别和删除使系统混乱的测试链或过时的链非常有价值,使维护更加容易。
- 多链构建器优化:在有多个链开发人员的环境中,此模板提供了链使用情况的清晰视图,有助于协调和优化工作,以消除不必要的链。
总体而言,该模板增强了对监控链和链运行的控制,使用户能够就其管理和维护做出明智的决策。
介绍
链模板检索工作区内一个或多个链环境的链和链运行(执行)列表,并在执行该模板。在运行时,通过指定报告电子表格来选择要分析的环境、链和链运行。
注意: 此模板仅适用于已部署工作区中存在的链式环境。
该模板收集 链 的数据,并将其加载到每个指定环境的链列表 Wdata 表中。针对每条产业链收集的信息包括:
- 链 ID
- 链名
- 创建日期
- 更新日期
- 链式URL
- 工作区 ID
- 工作区名称
- 环境 ID
- 环境名称
此外,它还会收集环境中的 链运行 数据,并将其加载到链运行 Wdata 表中。每次连锁运行收集的信息包括:
- 链 ID
- 工作区 ID
- 环境 ID
- 执行人
- 从……开始
- 结束于
- 状态
- 发射类型
- 运行 ID
一旦所有链数据收集完毕并加载到 Wdata 表中,模板将继续验证“自上次运行以来的天数”查询中的 选择列表 是否缺少任何新的环境。如果发现任何新的环境,则相应地更新选择列表。
模板的最后一步是执行 刷新连接 以使用模板收集的最新信息更新已连接的工作表。关联的工作表会根据“使用天数查询”生成的输出结果进行更新。
要求
- 必须在您的工作区中启用并配置以下模板:
- 必须在工作区中启用并配置以下连接器:
部署链
链条使用情况跟踪器模板位于 模板 屏幕的 Workiva 链条部分。
以下是查找方法:
- 在链式构建器中,转到 模板 选项卡
- 从顶部菜单中选择 Workiva Chains
- 在右上角搜索 “链条使用情况跟踪器 ” ,然后打开模板
-
找到模板后,点击 新建链 将其部署到您的工作区。
- 请按照下方“配置模板 ”部分中的步骤配置模板。
配置模板
- 下载文件 Chain User Tracker.cb 并将其 导入到您的工作区
- 下载文件 Chain Usage Tracker.tar.gz 并将其导入到您的工作区中。此导入操作将创建必要的 链条使用情况跟踪器 电子表格
- 文件导入成功后,找到并打开“链条使用情况跟踪电子表格”。
- 在 “参数 ”工作表中,根据需要将单元 格 B1中的 “使用天数 ”阈值更新为大于或等于 -1的值。
注: 值为 -1 将检索所有数据
- 使用 “流程跟踪 ”表来监控模板执行状态
- 要使模板能够处理特定的 链环境,请在 环境 工作表下添加一个或多个子工作表。删除或重命名“链环境表占位符表”
- 确保每个子工作表的 名称与对应的 链式环境的名称完全 一致,包括名称的大小写
。
- 从 “使用天数 ” Wdata 查询创建 传入 连接,并配置 “使用天数 ”和 “环境 ”参数
。注: DEV、Demo 和 SSC 是示例链环境名称。这些环境名称可能与您的环境名称不匹配。根据需要编辑“使用 查询参数 以来的天数”。该模板使用 维护 Wdata 参数 来维护值
变量
| 变量类型 | 变量名 | 变量用途 |
| 链变量 | 链表 ID | Wdata 表用于存储有关链的数据 |
| 链变量 | 链运行表 ID | Wdata 表用于存储有关链运行的数据 |
| 链变量 | 查询参数名称 | “使用天数查询”中配置的“环境”参数的名称 |
| 链变量 | 状态表名称 | 报告电子表格中状态表的名称或 ID |
| 链变量 | 参数表名称 | 报告电子表格中参数表的名称或 ID |
注: 请参阅 查找 Workiva 文件和项目的 ID 以获取查找 ID 的帮助
运行时输入
| 输入类型 | 姓名 | 目的 |
| 文本字段 | 报告电子表格 ID | 输入报告电子表格的 ID |
注: 请参阅 查找 Workiva 文件和项目的 ID 以获取查找 ID 的帮助
运行模板
- 点击 执行 按钮
- 点击 使用输入运行 按钮
- 在“报告电子表格 ID”运行时输入字段中输入 “链使用情况跟踪器电子表格 ID ”
。
- 点击 开始 按钮
- 模板运行时,导航至“链条使用情况跟踪器”电子表格,并查看 “流程跟踪 ”工作表以监控运行状态。
- 等待模板完成,即可查看“环境”子工作表中的数据。
执行结果
以下是“输出到链条使用情况跟踪器电子表格”的示例:
已完成的链条:
疑难解答
- 确保子链 更新状态、 将数据加载到 Wdata和 维护 Wdata 参数 均已发布
- 请确认已指定正确的ID。如需帮助在 Workiva 中查找 ID,请参阅 查找 Workiva 文件和项目的 ID
- 验证 Chain User Tracker.cb 和 Chain User Tracker.tar.gz 文件是否已成功导入。请参阅 “导入 Wdata 文件 ”和 “导入 Workiva 文件 ”帮助文章
- 验证 “ Days Since Use ”查询中链列表表和链运行表的表 ID 是否正确。
- 请确认参数表中 “使用天数 ”的值大于或等于 -1。
- 确认“环境”工作表存在于“报告”电子表格中,并且“链式环境”子工作表的名称正确无误。
- 如果您重命名了“环境”工作表,请调整“使用天数”查询,使其使用工作表的自定义名称。
- 如果您重命名了状态表和/或参数表名称,并在链变量中引用了这些名称,请确保它们的自定义名称已反映在链变量的值中。
- 如果您在“使用天数”查询中重命名了“环境”参数,请确保已更新“查询参数链”变量以使用您的参数自定义名称。
- 验证 Workiva连接器 是否具有在所选环境中执行命令所需的权限。