Studio 用户指南

上次更新日期 2026年2月18日

编排流程

长时间运行的工作流是主项目，可在无人值守的环境中支持服务编排、人工干预和长时间运行的事务。

当某些流程在继续执行活动的下一步骤前需要人工输入来处理异常、审批或验证时，则需要人工干预。在这种情况下，系统将会暂停执行流程，并释放机器人，直到人工任务完成。

工作流拆分

长时间运行的工作流包含 UiPath.Persistence.Activities，可以与调用流程和非用户交互活动结合，通过机器人任务编排人工任务。它在会话 0 中运行，从而确保快速执行。请注意，编排流程的调试是在用户会话中完成的。

docs image

长时间运行的工作流可能会编排：

后台流程可能包含执行 API 调用并在会话 0 中运行的活动。可以使用“调用流程”活动调用它们。
用户界面：通过“从 Orchestrator 开始作业”活动调用包含用户交互活动的流程，并在用户会话中运行。
人在回路：用户通过需要在 Orchestrator 中填写表单的任务进行交互。这意味着将“创建表单任务”活动与“等待表单任务然后继续”配对。

编排流程模板

在 Studio 中，转到“主页”>“编排流程”以打开模板，其中包含“流程图”工作流类型中的默认 UiPath.Persistence.Activities 和 UiPath.System.Activities 依赖项。

docs image

模板的 project.json 文件包含 supportsPersistence: true 参数，指示在任务完成后继续执行流程。

requiresUserInteraction: false 参数指示此工作流不包含用户交互活动，类似于后台流程。

不建议手动修改 project.json 文件中的参数。

docs image

通过将“支持持久性”设置切换为“是”，即可从“项目设置”窗口将流程转换为“编排过程”。

编排流程的代码片段

首先，您可以使用“代码片段”面板中提供的一系列工作流代码片段创建“编排流程”。

docs image

构建编排流程

请按照以下步骤将 UiPath.Persistence.Activities 包中的活动配对，并建立自己的编排流程：

使用“添加队列项目并获取引用”活动添加具有 in、 in/out 或 out 参数的队列项目，然后获取对应的队列项目对象。当队列项目被处理时，如果此活动与“等待队列项目并继续”活动配对ItemInformation，则属性中提供的参数会被分配回映射的工作流变量。
“等待队列项目并继续”活动应与“添加队列项目”和“获取引用”活动配对。工作流进入暂停状态，在此活动处释放机器人，等待特定的队列项目完成，然后再进入流程中的下一步。
“开始作业并获取引用”活动通过提供 in、in/out 或 out 类型的参数来调用另一个流程执行后，如果此活动与“等待作业并继续”活动配对，则会将修改后的参数映射回工作流变量。
“等待作业并继续”活动应与“开始作业并获取引用”活动配对，方法是将Job Object后者活动的给定输出作为输出。这将暂时暂停当前流程，并等待引用作业完成，在引用作业将状态更新为“完成”后继续流程。
使用“创建表单任务”活动创建基于表单的可视化任务，用于在工作流中进行人机交互。这些具有相关工作流上下文的表单会呈现给用户，供其做出决策和其他场景。要在此活动中启用表单设计器，您必须安装 UiPath.FormActivityLibrary 包。

备注：
当使用从 2021.4 开始的 Studio 版本以及 1.2.1 之前的 UiPath.Persistence.Activities 和 UiPath.FormActivityLibrary 版本时，“表单设计器”窗口将不占据焦点，并且在打开设计器窗口时可以与 Studio 进行交互。为避免此问题，请确保将程序包更新为最新版本。
“等待表单任务并继续”活动应与“创建表单任务”配对，方法是将其作为输入提供，Task Object以暂停工作流，直到最终用户完成此特定任务。
使用“延迟后继续”活动来暂停工作流的执行，并在指定的日期和时间继续执行。
在 Studio 中执行工作流。每当机器人执行长时间运行的活动时，Studio 都会进入只读状态，同时启用功能区中的“继续”选项。接着，完成底层任务、队列项目或作业，然后单击“继续”。

最佳实践

UiPath.Persistence.Activities 包内长时间运行的活动（“等待并继续”活动）只能用在编排流程的入口点，即标记为 Main.xaml 的文件。
由一个编排流程构建的可重用组件只能在其他编排流程中引用。
如果将长时间运行的工作流附加到队列处理，并且该工作流处于暂停状态，则队列项目即使在 24 小时后仍会保持进行中状态，直到工作流在恢复后设置事务状态。如果队列项目标识符包含在“等待”和“继续”活动的相同作用域中，则这些标识符将成为持久化工作流上下文的一部分。
持久点（“等待”和“继续”活动）不得在“For Each”活动主体中使用，因为它们在执行第一次迭代后会暂停工作流，这可能不是预期的行为。或者，尝试将循环用于暂留活动，例如“并行的遍历循环”活动。请注意，默认情况下，每个作业的继续触发器最大数量限制为 1,000 个。
在编排流程的主工作流中使用时，“延迟”和“重试作用域”活动不受支持且无法正常工作。在这种情况下，应将其放置在“非暂留作用域”活动中。
任何可用的机器人均可恢复长时间运行的工作流，只要该机器人与暂停作业（例如无人值守或非生产）的机器人处于相同环境且类型相同，因此必须还要在暂留点后提供执行所需的本地资源。
在长时间运行的活动作用域中使用的所有变量必须皆可序列化。此页中所列的变量类型皆可序列化：文本、True 或 False、数字、数组、日期和时间。数据表和通用值变量。数据表和通用价值变量。
作用域中使用的不包含长时间运行活动的变量不受序列化要求的约束，因为工作流不会在其作用域中暂停。不可序列化的数据类型可以在同一工作流中的单独序列作用域中使用，也可以通过调用其他文件来使用，前提是这些文件位于等待和继续活动之间，例如等待作业然后继续、等待队列项目然后继续以及等待表单任务然后继续。
请考虑到，无法在“本地设置”面板中评估长时间运行的活动生成的对象的某些属性。
对期望每项作业具有大量操作的工作流实施适当的批处理。请注意，每项作业每次可等待的默认作业量限制为 1,000 项操作（或其他作业触发器）。