创建模板时,您可以以已发布的链为基础,也可以从头开始构建新的命令和事件序列。
这些模板将允许您创建预先构建的命令和事件序列,以便在其他链中使用。例如,使用模板,您可以:
- 提供先机,便于连锁反应的形成。
- 规范常用工作流程,例如从记录系统中提取数据。
注: 您可以在 链构建器中使用包含多个链、工作区和环境的模板。
从现有链创建模板
基于现有链条构建模板具有诸多优势:
- 你可以以第一条链为起点创建其他链。
- 您可以使用 Chain Builder与他人共享该链——包括其他组织中的人员,例如 Workiva Community中的人员。
要从现有链创建模板:
- 从 链中,单击 链生成器。
- 选择 链 选项卡,然后选择编辑 链。
- 从右上角的连锁店三点菜单中,选择 创建模板。
- 输入唯一的名称和描述,以便识别模板。
- 在 文件夹下,选择模板的保存位置。
- 点击 保存。
- 如果链式结构包含任何变量,请设置每个模板变量:
-
输入模板变量的默认名称。
提示: 为了帮助识别要与变量一起使用的值,我们建议您在其名称前添加一个前缀。例如,
WSV-表示工作区变量,CV-表示链变量,DCV-表示动态链变量,Resource-表示工作区资源。 - 为了便于移植和重用,删除默认值。
-
选择是由动态链变量还是工作区资源提供该值。
注: 如果链变量、工作区变量或运行时变量提供了值,则既不要选择 动态 ,也不要选择 资源。
-
- 点击 保存 和 发布。
从头开始创建模板
要构建一个新的命令和事件序列,作为可重用的链式框架,请按照以下步骤顺序操作。
步骤 1:添加模板
- 在 Chain Builder中,从 Templates 选项卡,单击右上角的 Create => Template 。
- 要在 默认 文件夹以外的位置创建模板,请单击 以选择要保存模板的文件夹,然后单击 移动。
-
输入唯一的名称和描述,以帮助识别模板及其用途。
提示: 为了帮助识别模板提供的是完整链还是部分链的序列,请在其名称前加上前缀。例如,
Full-表示完整的链,Part-表示部分链或片段。
步骤 2:设置模板变量
为了方便自定义和重用,模板包含变量作为其命令变量或工作区资源所需值的占位符。当您从模板创建链时,链的变量和资源将替换模板的变量。
模板中要包含的每个变量:
- 在 模板变量下,单击 添加。
-
请输入变量名称和默认值。
提示: 为了帮助识别模板变量要使用的值,我们建议您在其名称前添加一个前缀。例如,
WSV-表示工作区变量,CV-表示链变量,DCV-表示动态链变量,Resource-表示工作区资源。 -
在 类型下,选择动态链变量还是工作区资源将提供变量的值。
注: 如果链变量、工作区变量或运行时变量提供了值,则既不要选择 动态 ,也不要选择 资源。
添加完模板的所有变量后,点击 保存。
注: 要从模板中移除变量,请点击其在[ ] 操作下的 X 。
步骤 3:定义模板的节点
构建模板时,请按顺序设置并链接节点:
- 由模板创建的链执行的命令或任务,例如与 Workiva 平台或其他数据源进行交互。
- 模板内发生的事件 ,例如启用审批工作流程或手动上传文件。
- 触发事件,例如 运行时输入 ,以便在执行从模板创建的链时设置变量(例如特定帐户、区域或时间段),或者 根据连接源的变化自动启动链 。
注: 为了便于自定义和重用,模板的命令不使用链或工作区中设置的连接、运行器或变量;您需要在从模板创建链时指定这些内容。
添加节点
添加节点时,将其移动到序列中出现的位置,并将其链接到其后续步骤和上一步。
- 要添加模板的第一个节点,请将其移动到 开始。
- 要添加一个节点作为逻辑树新分支的起点,请将模板中的上一步链接到多个分支的第一个节点。
- 要并行运行命令或作为串行进程的一部分一起运行命令, 请创建 命令组作为步骤。
注: 默认情况下,当链接的前一个节点成功时,该节点才会运行。要启用条件逻辑,例如仅当前一个节点失败时才运行下一个节点,请双击链接并选择其条件——成功 、失败 、警告 或任意
。定义模板节点后,单击 发布。
编辑模板设置
要调整模板的名称或描述,或管理其变量:
- 在 Chain Builder中,从 Templates 选项卡中,单击模板名称和 Template Settings。
- 根据需要编辑模板的名称、描述或变量。
- 点击 保存 和 发布。
使用模板的视图链
要查看哪些链是由模板创建的,请转到模板 选项卡,然后单击 使用链 下的模板的 [] 查看 。
从 “使用中 ”面板中,可以看到由模板创建的链。要打开一个链条,请点击其名称。
提示:要查找 特定连锁店,请按其名称搜索
。复制模板
要使用模板作为新模板的起点,请创建该模板的副本。在 Chain Builder中,从 Templates 选项卡中,单击 Copy 模板。
与他人分享模板
为了帮助其他人创建链,您可以使用 Chain Builder与其他人分享已发布模板的链接——包括其他组织中的组织,例如 Workiva Community中的组织。
- 在 Chain Builder中,从 Templates 选项卡中,单击其 Get shareable link 。
- 单击 复制到剪贴板 和 关闭。
- 根据需要粘贴并与他人分享此链接。
请注意,模板的正常运行取决于两个工作区是否都拥有相同的连接器和命令。当与其他工作区共享模板时,除非启用所有必需的连接器,否则导入的链将无法工作。
导入链条时,您可以设置任何缺失的连接器:
撤销对共享模板的访问权限
要撤销他人对共享模板的访问权限,请刷新其 URL 以创建新链接:
- 在 Chain Builder中,从 Templates 选项卡中,单击模板的 Get shareable link 。
- 点击 重新生成令牌 和 关闭。
存档模板
如果不再需要模板,可以将其存档。在 Chain Builder中,单击 Templates ,然后单击 Archive 获取模板。