工作流
在构建器可用时创建、测试、部署和审查可重用的项目工作流。
工作流将可重复的流程转变为连接的步骤,Runner 可以使用相同的输入和规则再次运行。
条件: 工作流界面存在,但当前标准项目导航不会显示工作流条目。仅在 Runner 为您的工作区显示已批准的工作流条目或 Runner 支持提供已批准的路径时使用。不要猜测或编辑 URL 来访问它。如果您的计划仅允许预览,Runner 可以显示该页面,同时保持其控件被阻止。
入口路径
仅在 Runner 在您的工作区中显示工作流条目时打开它。该页面列出当前项目的工作流。如果没有条目,请使用功能可用性或联系支持,而不是尝试直接 URL。
开始前
- 工作流访问权限取决于当前功能推出和计划。
- 在测试或部署工作流之前,确认项目和连接的服务。
- 预览或保存的草稿不是活跃的;部署和激活是分开的重要操作。
工作流列表
当没有工作流时,选择创建工作流。当列表中已有项目时,使用新建工作流。
| 控件 | 选择后会发生什么 |
|---|---|
| 创建工作流或新建工作流 | 打开创建工作流。 |
| 空白 | 创建无标题工作流并打开其构建器。 |
| 模板卡片 | 从该模板创建工作流并打开其构建器。如果模板加载失败,重试会再次请求它们。 |
| 工作流名称 | 在构建器中打开该工作流。 |
| 重命名 | 使名称可编辑。输入或点击其他地方保存;Escape 取消编辑。 |
| 固定到顶部 / 取消固定 | 将工作流移入或移出固定组。它不会运行工作流。 |
| 复制 | 创建副本并在构建器中打开副本。 |
| 导出 | 将工作流下载为 JSON 文件。它不会部署或运行任何内容。 |
| 删除 | 打开确认。确认会永久删除该工作流,无法撤销。 |
使用每行的更多菜单查找重命名、固定到顶部或取消固定、复制、导出和删除。
行标签还可以显示版本是否为活跃、有草稿待处理、公开端点,或绑定到计划或事件。暂停或计划阻止标签意味着自动触发当前不活跃。
处理多个工作流
选择一行或多行旁边的复选框。选择栏显示选择了多少个,并提供:
- 导出以下载选定的工作流。
- 删除以打开批量确认。确认会永久删除每个选定的工作流。
- 清除以移除选择而不更改任何工作流。
全选选择当前列表中显示的工作流。在批量删除前始终重新检查计数。
构建和保存
构建器画布是您添加步骤、连接它们以及配置每个步骤接收和执行的操作的地方。添加组件打开可搜索的组件库。画布控件可缩放、缩小、使工作流适应屏幕,并自动排列连接的步骤。
更改会自动保存;没有单独的保存按钮。返回箭头在返回工作流列表前完成待处理的保存。
| 保存状态 | 要做什么 |
|---|---|
| 保存中… | 在关闭页面或部署前等待。 |
| 已保存 | 最新的画布更改已存储。 |
| 保存失败 | 检查连接后选择重试。 |
| 冲突 — 您的更改未被保存 | 另一个保存的版本更新。重新加载会丢弃冲突的本地编辑并加载保存的版本。 |
下面板包含游乐场和历史记录。在游乐场中,在运行前完成必需的文本、产品或媒体输入。当缺少必需的输入时,运行控件保持不可用。结果显示在输出区域。
构建器的更多菜单还提供导出 JSON 和导入 JSON…。导出下载当前画布。导入立即替换当前画布并触发自动保存,无需确认,因此导出备份并在导入前检查选定的文件。
选择正确的测试
测试可能有非常不同的后果。
| 控件 | 选择后会发生什么 |
|---|---|
| 模拟而不调用 API | 打开模拟对话框。使用生成的示例数据或粘贴 JSON,然后选择运行模拟。写入端操作(如电子邮件、Slack 帖子和存储更改)被存根化。 |
| 实时测试 — 真实副作用,标记为 isTest | 打开实时测试对话框。使用生成的数据、粘贴的 JSON 或可用的最近事件。运行实时测试进行真实的 API 调用,可以发送消息或更改连接的服务。运行在历史记录中标记为测试。 |
| 跳过等待 | 在实时测试期间,跳过配置的等待期,以便测试可以更快继续。它不会移除其他真实效果。 |
| 运行工作流 | 立即启动配置的工作流并打开历史记录。其步骤可能有真实效果;首先审查每个步骤和输入。 |
| 停止执行 | 请求当前运行停止。已完成的工作不会被反转。 |
| 缓存 | 在重新运行时,跳过输入未更改的符合条件的节点,以便您可以专注于更改的下游工作。 |
使用模拟检查分支和数据流。仅在连接账户中真实副作用可接受时使用实时测试。
审查运行历史记录
在下面板中打开历史记录以查看以前的运行。使用实时、测试或全部过滤列表,然后选择运行以检查其节点结果、输出、时间和错误。状态包括已完成、失败、运行中和已取消。
如果列表显示尚无运行,当前工作流没有记录的执行。启动另一个运行不是修复失败运行的方法;首先打开失败的运行并阅读其错误。
一些符合条件的失败节点提供从"节点"重试。这会立即启动新尝试,无需另一个确认。下游操作可以再次运行,因此首先检查失败运行已产生的消息或存储更改。
部署和激活
选择部署打开部署工作流。在继续前审查更改摘要、API 合同兼容性、验证结果和可选的更改日志。
您可以选择将部署的工作流绑定到计划或事件。一次只能选择其中一种触发类型。
- 部署使用选定的设置发布版本。
- 激活并部署在新的计划或事件绑定会使自动化活跃时出现。确认它会发布版本并允许未来的触发器使用真实效果自动运行。
保存错误、未解决的冲突或验证问题可能会阻止部署。解决它而不是重复选择部署。
部署后,生产状态可以显示未部署、草稿待处理或活跃,加上绑定的无触发器、活跃或暂停。打开现有绑定提供重要控件:
- 暂停停止自动触发但保持工作流和绑定。
- 恢复允许保留的绑定再次触发。
- 移除永久删除绑定但不删除工作流。
每个操作打开确认并可以包括原因。在部署期间从现有绑定中移除检查会暂停该绑定而不是永久删除它。
版本历史记录和回滚
选择版本历史记录打开版本历史记录面板。
| 操作 | 结果 |
|---|---|
| 回滚 | 打开回滚到此版本?。确认使选定的部署版本取代当前部署版本。这可以改变未来运行的操作,但它不会替换当前的草稿画布。 |
| 恢复在草稿历史记录中 | 在确认后用选定的保存草稿替换当前画布。未保存或更新的画布更改可能会丢失。 |
添加可选的回滚原因,以便其他工作区成员理解更改。在启动另一个运行前审查恢复的画布和部署状态。
安全操作检查清单
- 确认您在正确的项目和工作流中。
- 在测试或部署前等待已保存。
- 完成并审查每个必需的输入。
- 尽可能从运行模拟开始。
- 仅在其连接服务效果可接受时使用实时测试或运行工作流。
- 在部署前检查历史记录和输出。
- 将激活并部署、回滚、恢复和删除视为需要最终审查的重要操作。
故障排除
| 问题 | 下一步 |
|---|---|
| 没有工作流条目可见 | 这在标准导航中是预期的。不要猜测 URL;请参阅功能可用性或询问 Runner 支持您的工作区是否有已批准的条目。 |
| 控件被计划预览阻止 | 按照屏幕上的计划消息或询问工作区所有者关于访问权限。 |
| 模板列表失败 | 选择重试或创建空白工作流。 |
| 运行按钮不可用 | 完成每个必需的输入并修复任何无效值。 |
| 出现保存冲突 | 在选择重新加载前决定保存的版本是否应该获胜,因为本地冲突编辑会被丢弃。 |
| 运行失败 | 在历史记录中打开它,保持可见的错误和输入,并避免重复启动相同的运行。 |
| 部署被阻止 | 解决部署对话框中显示的保存、冲突、合同或验证消息。 |