Workflows
规格
| 标签 | 值 |
|---|---|
| 版本 | 0.1.0（更新于 2024-01-13） |
| 开发者 | Labii Inc. |
| 类型 | 章节 |
| 支持配置 | 是 |
概述
Workflows 小插件为预定义的 Labii 工作流程提供记录级启动面板，让用户可以直接从当前查看的记录触发自动化。用户无需前往单独的工作流程管理区域，即可在当前上下文中运行所选工作流程，并从同一章节监控执行历史。它适用于需要从特定记录启动的运营流程，例如创建下游记录、生成分装物，或启动与样本、项目或请求关联的预定义自动化操作。该小插件依赖管理员通过 Workflows 管理指南预先配置的工作流程。
使用场景
- 生成分装物：从来源样本记录启动预定义工作流程，创建多个分装物。
- 生物样本处理：直接从样本记录触发提取物生成或衍生记录工作流程。
- 运营交接：从请求、订单或接收记录启动下游自动化，无需切换界面。
- 标准化记录操作：为可重复的实验室或运营任务复用已批准的自动化工作流程。
- 执行监控：打开执行日志，检查手动启动的工作流程是否成功完成。
界面
只读视图
在只读视图中，小插件将配置中选择的工作流程显示为简单操作列表。每个工作流程显示其名称，并提供执行工作流程或打开执行日志的控件。工作流程在后台运行，并使用当前记录作为触发上下文。
- Workflow List：显示可从此记录使用的预定义工作流程。
- Execution Action：为每个已配置工作流程提供 Execute Workflow 按钮。
- Log Access：提供 View Execution Log 按钮，用于检查以往或当前执行详情。
- Record Context：使用当前记录的数据和变量运行所选工作流程。
只读视图列出已配置的工作流程，并提供执行和查看日志的操作
编辑视图
Workflows 小插件不提供自由格式内容编辑。实际上，编辑模式主要用于配置，即选择应在章节中显示哪些预定义工作流程。配置后，用户通过执行和日志审查控件与这些工作流程交互，而不能在小插件中编辑工作流程定义。
- Input Methods：在小插件配置中选择一个或多个预定义工作流程。
- Formatting Options：没有内容格式选项，因为小插件渲染的是已配置工作流程操作，而非可编辑文本。
- Validation：只能选择现有工作流程；工作流程逻辑本身在管理区域中进行管理。
- Collaboration：权限允许时，多位用户可以从相同记录上下文启动同一项已批准工作流程。
Workflows 小插件运行 Labii 中已有的工作流程，不会在章节内创建或编辑工作流程定义。
配置
必须至少选择一个预定义工作流程，该小插件才有实际用途。工作流程定义由管理员在章节小插件之外创建和管理。
初始设置
必需设置
- Workflows：选择一个或多个要显示并允许用户从此小插件执行的工作流程。
可选设置
除选择要显示的工作流程外，Workflows 小插件没有其他可选设置。
如果未选择工作流程，小插件将没有可执行内容。将该小插件添加到生产记录前，请确认管理员已创建所需工作流程。
其他功能
执行工作流程
点击所列工作流程旁的 Execute Workflow 启动工作流程。工作流程在后台运行，并使用当前记录作为触发上下文，使工作流程变量和下游操作可以基于该记录解析。
查看执行日志
点击 View Execution Log 检查工作流程执行历史。这有助于确认运行是否成功完成或排查工作流程行为问题。
支持管理员定义的工作流程
该小插件用于显示管理员在平台设置中定义的工作流程。使用 Workflows 管理指南创建或管理底层工作流程定义、触发器和操作。
最佳实践
数据组织
- 只添加与当前记录类型相关的工作流程，避免无关自动化选项使用户难以选择。
- 在管理区域中使用清晰的工作流程名称，因为这些名称会直接显示在小插件中。
- 将小插件放在用户决定启动自动化的章节附近，例如样本接收、请求审查或制备步骤。
性能优化
- 工作流程列表应简短且用途明确，使执行选择快速、清晰。
- 如果上次运行状态不明确，请查看执行日志，不要反复重新启动工作流程。
- 每个运营目标使用一个范围明确的工作流程，避免使用难以监控和排查的大型多用途工作流程。
安全与合规
- 仅提供用户有权在当前运营上下文中触发的工作流程。
- 将工作流程公开到生产记录前，先在管理区域验证其操作，尤其是工作流程会创建或修改受监管数据时。
- 自动化操作影响重要下游记录时，将执行日志用于运营审查。
当每项工作流程都有明确的运营目的，并且只在用户确实需要运行它的记录类型中提供时，Workflows 小插件效果最佳。
应避免的常见问题
- 避免向一个小插件添加太多无关工作流程，否则执行选项更难选择，并增加错误启动自动化的风险。
- 避免误以为小插件会定义工作流程逻辑；所有触发器和操作必须已存在于工作流程管理区域。
- 正确做法是让工作流程保持精简、命名清晰，并关联到具体的记录级任务。
维护和故障排除
- 如果工作流程未显示，请确认已在小插件配置中选择该工作流程。
- 如果工作流程运行似乎不完整或不正确，请先打开 View Execution Log，再尝试再次运行。
- 如果用户需要新的自动化路径，请在管理设置中创建或修改工作流程定义，而不要尝试在章节小插件中解决。