maestro
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。
UiPath logo, featuring letters U and I in white
预览

Maestro 用户指南

上次更新日期 2025年3月28日

为简单的流程建模、实施,然后运作

在此示例中,您将实现一个简单的代理流程,了解使用 Maestro 的核心功能来建模、实施、调试、发布、部署和管理流程。此简单流程示例未使用任何其他 UiPath™ 产品。

其目的是构建简单的路由流程,类似于下图中的流程:

注意: “代理流程”项目配置当前与租户绑定。在编辑会话之间,确保您留在同一个租户中。
注意:代理流程项目配置当前仅支持单个业务流程 (BPMN) 文件。尽管可以将多个文件添加到项目中,但这会导致调试和发布出现意外问题。

流程建模

首先,开始对端到端流程进行建模,然后配置组件。
  1. 导航到您的 Automation Cloud™ 租户。
  2. 在左侧栏的产品列表中,选择“Maestro”
  3. Maestro登陆页面上,选择“开始使用”
    提示: 您也可以首先在 Studio 中创建新的 代理流程
    系统将打开新的代理流程。
  4. 从设计界面的左上角,选择“开始使用”
  5. 将项目重命名为“简单项目”,将流程重命名为“简单流程”。


  6. 关闭项目资源管理器。
  7. 在画布上选择开始事件元素以显示元素工具栏。从元素工具栏中选择“添加”:“文本注释”
  8. 选择开始事件元素,然后从元素工具栏中选择“添加:中间事件”
    1. 双击中间元素以将其重命名。将其重命名为“延迟”
      提示: 您还可以通过屏幕右侧“属性” 选项卡中的“名称” 字段重命名元素。
    2. 延迟中间事件更改为计时器中间捕获事件


  9. 选择 “延迟计时器”中间捕获事件,然后选择“添加”: “独占网关”
    1. 将专属网关命名为哪个路径?
  10. 选择“哪个路径?”独占网关,然后选择“添加: 任务”
    1. 将任务命名为A Task
    提示:在您绘制和配置流程时,验证错误将显示在画布上。如果要隐藏这些可视化,请从右上角的“工具”菜单中选择“隐藏验证错误”


  11. 选择“哪个路径?”再次选择独占网关,然后选择“添加: 任务”
    1. 将该任务命名为B 任务


  12. 选择“哪个路径?”专属网关。
    1. 展开“属性” 选项卡中“条件” 部分的第一个条件。
      条件的生成名称以edge_Gateway_{randomcharacters}开头。
    2. 在第一个条件的“标签”字段中键入A
    3. 展开第二个条件。
    4. 在“第二个条件”的“标签”字段中键入B


  13. 选择“任务” ,然后从事件工具栏中选择“添加: 结束事件”
    1. 将结束事件命名为End A
    提示:作为最佳实践,请为流程创建明确的结束时间。快速确定流程遵循的路径,以及每个流程的明确结束路径。
  14. 选择任务 B ,然后从事件工具栏中选择“添加: 结束事件”
    1. 将该结束事件命名为End B。


实施流程

请按照此过程向在流程建模部分中创建的流程添加功能。
  1. 选择“开始”事件元素,并将其重命名为“手动开始”
  2. 从“属性” 选项卡的“输入” 部分选择“新增”


  3. 按如下方式创建新变量:
    • 名称:路径
    • 类型:字符串
    • 值: A


  4. 选择“保存”
    系统随即会创建新变量。
  5. 选择“延迟计时器中间捕获”事件。
  6. 转到“属性” 选项卡中的“计时器” 部分,并添加以下值:
    • 类型:持续时间
    • “值”:在值配置的基础上增加5 秒


  7. 选择“哪个路径?”专属网关。
  8. 展开“属性” 选项卡中“条件” 部分中的条件。
  9. 配置第一个条件。
    1. 为第一个条件选择“打开表达式编辑器”


    2. 使用插入变量查找并插入手动启动输出变量path
    3. 将值设置为"A"
    4. 选择“保存”


  10. 配置第二个条件。
    1. 对于第二个条件,选择“打开表达式编辑器”
    2. 使用插入变量查找并插入手动启动输出变量path
    3. 将值设置为"B"
    4. 选择“保存”


    提示:或者,您可以将以下表达式复制并粘贴到表达式编辑器中:
    • 表达式Avars.path == "A"
    • 表达式Bvars.path == "B"

调试流程

首先,您将直接运行流程,以确保流程配置正确。由于path变量的默认值设置为A ,因此流程应流向任务 A结束任务 A。
将光标悬停在元素的左上角,然后选择“单击以添加断点”以配置断点。目前,只能在开始调试流程后设置断点。但是,它们将在运行之间保留。

  1. 选择“测试”以调试流程。


    每个步骤执行时都会有一段动画运行。您可以与图表进行交互。有关其他详细信息,请查看“执行跟踪”“全局变量”选项卡。

  2. 选择“返回设计模式”以退出调试。
  3. 选择“逐步测试”以操作path变量以测试路由B
  4. 选择“下一步”以移至延迟计时器中间捕获事件执行。
  5. 全局变量 选项卡将path 变量的 手动起始值 更新为 B。


    注意:由于一个已知问题,没有可视化指示器可用于帮助在调试时区分具有相同名称的输入和输出变量。当两者都在列表中时,输入将排在输出之前。您应该编辑第一个变量,即输入,而不是输出,输出的值将为 null。
  6. 在对话框中选择“更新 1 变量” ,然后选择“更新变量”以提交更改。
  7. 选择“继续”以完成执行。
    每个步骤执行时都会有一段动画运行。您可以与图表进行交互。有关其他详细信息,请查看“执行跟踪”“全局变量”选项卡。这次,流程遵循 B 路线。

  8. 选择“返回设计模式”以退出调试。
现在,您已经完全调试了第一个流程。

发布、部署和启动流程

  1. 选择“发布”以发布代理流程。
    1. 从“位置” 字段中选择“Orchestrator 个人工作区订阅源” 。
    2. 选择 “发布”


    注意:系统会自动部署发布到 Orchestrator 个人工作区订阅源的流程,但发布到租户或文件夹订阅源的流程仍必须作为单独的步骤在 Orchestrator 中进行部署。
  2. 导航到Orchestrator
  3. 前往“我的工作区”
  4. 转到“自动化” 选项卡,然后在“流程” 列表中找到“Simple.Process”


  5. 为 Simple.Process 条目选择“启动作业” 。
  6. 选择“开始”。


您现在已完全发布、部署并启动了第一个流程。

管理代理流程

  1. 导航到Maestro服务。
  2. 在流程列表中选择“简单流程” ,以打开流程的“所有实例”视图。
    提示:如果需要,您还可以使用搜索字段来筛选列表。
  3. 选择最新实例以打开实例查看器。
    您可以通过每个步骤查看实时执行的流程。

    选择模型背景以查看全局变量操作历史记录,以及执行历史记录。在模型或执行追踪中选择一个步骤,以检查该执行步骤的详细信息变量

现在,您已完全管理第一个流程。

中断和修复流程

在此过程中,我们将导致执行失败,以便使用实例管理进行恢复。
  1. 导航到Orchestrator
  2. 导航到Orchestrator
  3. 前往“我的工作区”
  4. 转到“自动化” 选项卡,然后在“流程” 列表中找到“Simple.Process”


  5. 为 Simple.Process 条目选择“启动作业” 。
  6. path变量的值更改为C


  7. 选择“开始”。
  8. 导航到Maestro
  9. 在流程列表中选择“简单流程” ,以打开流程的“所有实例”视图。
  10. 选择最新实例以打开实例查看器。
    该流程在“哪个路径?”中处于失败状态。专属网关。



  11. 选择“哪个路径?”互斥网关:检查“网关无传出流”错误的步骤。
    由于path == "C"没有配置,因此会出现此错误。

  12. “状态和步骤”面板中选择第一步,以查看全局变量


  13. path变量的第二个手动启动输出值(第二行)更新为A ,以遵循配置的条件。


  14. 选择“更新 1 变量”以更新变量。
  15. 出于审核目的,在“注释”字段中添加注释。


  16. 选择“重试”
  17. 添加注释,然后选择“重试实例”以使用新变量重试步骤并完成实例。


  18. 检查“操作历史记录”选项卡,以查看更改的审核追踪。
您已成功修复损坏的实例。

在流程版本之间迁移

当前的流程流逻辑不够强大,无法管理所有路径场景。您正在通过发布新版流程来解决此问题。此更新版本不仅将有效适应新的流程实例,还将纠正现有的有问题的实例。为确保有效处理path不等于A所有情况,请将B路由修改为非 A路由。

在此过程中,您将导致执行失败,以便使用新版本修复它。

  1. 导航到Orchestrator
  2. 前往“我的工作区”
  3. 转到“自动化” 选项卡,然后在“流程” 列表中找到“Simple.Process”
  4. 为 Simple.Process 条目选择“启动作业” 。
  5. path变量的值更改为C


  6. 选择“开始”。
  7. 导航至Studio并打开“简单流程”
  8. 选择“哪个路径?”专属网关。
  9. B标签更改为Not A ,并将条件更改为vars.path != A


  10. B Task任务名称更改为Not A Task
  11. “结束 B”结束事件更改为“结束非 A”
  12. 选择“发布”以发布项目。
    1. 从“位置” 字段中选择“Orchestrator 个人工作区订阅源” 。
    2. 选择 “发布”
  13. 导航到Maestro
  14. 在流程列表中选择“简单流程” ,以打开流程的“所有实例”视图。
  15. 选择最新实例以打开实例查看器。
    该流程在“哪个路径?”中处于失败状态。专属网关。
  16. 选择“迁移”以迁移流程。
    1. 为刚才发布的流程选择“目标” 版本
      在此示例的上下文中,应为1.0.1
    2. 提供注释。
    3. 选择“迁移实例”


  17. 选择“重试” ,以使用新变量重试步骤。
    1. 提供注释。
    2. 选择“重试实例”


  18. 检查“操作历史记录”选项卡,以查看更改的审核追踪。
您已成功将损坏的实例迁移到新版本的流程。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
© 2005-2025 UiPath。保留所有权利。