流程跟踪作用域

 UiPath.Core.Activities.ProcessTracking.ProcessTrackingScope

描述

流程追踪作用域是 UiPath 中的一个系统活动，可用于对工作流中的任务进行详细追踪。

“流程追踪作用域”活动可用于追踪 UiPath Process Mining 中的特定业务序列。作为 RPA 开发者，您可以将这些序列标记为任务，方法是将其包含在“流程追踪作用域”活动中。

追踪与任务

任务表示流程中的特定工作或活动单元。它由工作流中的“流程追踪作用域”活动创建。任务具有开始时间戳（作用域的开始时间）和结束时间戳（作用域的结束时间）。您可以嵌套任务，从而创建父子关系。

追踪是一个概要性概念，它表示一个流程或一系列相关任务的整个执行过程。追踪对属于同一流程执行过程的多个任务进行分组和组织。追踪有其自己的唯一标识符（追踪 ID），可为不同任务在较大流程中的关联方式提供上下文。

在 UiPath Studio 界面中，您可以使用“流程追踪作用域”活动的“如何追踪”属性控制任务与追踪的关系：

“如何追踪”选项	追踪管理	任务管理	注意	示例
在当前追踪中	现有追踪将继续，系统不会新建追踪。 即使在流程追踪作用域完成之后，追踪仍会保持开启状态。 对于包含多个步骤的长时间运行流程非常有用。	作用域开始时，系统将创建新任务。 作用域完成后，任务将自动关闭。 任务的开始时间和结束时间会记录在现有追踪中。	当您要追踪属于同一流程上下文中单个正在进行的流程的顺序操作时，此选项非常有用。 某些活动可能会更改追踪上下文： 获取事务项目/添加事务项目，然后设置事务状态 获取事务项目/添加事务项目，后跟延迟事务项目 等待队列项目然后继续 启动作业或启动作业并获取引用 等待作业然后继续	某电子商务公司有一个处理客户订单的工作流。 系统收到订单时，启动主追踪。 多个流程追踪作用域用于不同的阶段：订单验证、付款处理和发货安排。 这些作用域都使用“在当前追踪中”选项将所有任务保留在同一订单处理追踪中。 这可以让您完整查看整个订单履行流程。
在新追踪中	作用域开始时，将创建具有唯一追踪 ID 的新追踪。 如果追踪上下文在此作用域之前已存在，则将还原为上一个追踪上下文。 需要为新追踪指定流程名称。此名称用于对新追踪进行分组，从而帮助在 Process Mining 中组织和分类不同的流程。	作用域开始时，系统将创建新任务。 作用域完成后，任务将自动关闭。 任务的开始时间和结束时间会记录在现有追踪中。	当您想要开始追踪自动化中新的不同流程或子流程，同时能在需要时返回到上一个追踪上下文时，此选项非常有用。	支持团队使用自动化来处理客户工单。 主工作流接收工单并对其进行分类。 对于每个工单，系统将使用“在新的追踪中”选项创建新的“流程追踪作用域”。 这将为每个客户问题创建单独的追踪，从而单独追踪和分析每个工单的处理方式。 它对于衡量响应时间、解决率以及识别处理特定类型问题的瓶颈非常有用。
在现有追踪中	不创建新追踪，而是连接到先前创建的追踪。 追踪上下文可能会因工作流结构而异。 通常需要通过对象属性（对象 ID、对象类型和对象交互）和流程名称来识别现有追踪。	新创建的任务将添加到现有追踪中，从而在不同自动化之间保持流程的连续性。 作用域结束时，系统将在现有追踪中关闭该任务。	当多个自动化处理相同的业务项目或对象时，此选项非常有用。但是，这些自动化并不通过 UiPath 组件（例如队列或作业）直接连接。它使您可以通过单独执行的不同自动化来维持业务项目旅程的连续追踪。	某大公司拥有涉及多个部门的复杂发票处理系统。 财务部门收到发票时，系统将创建初始追踪。 当发票在不同部门之间转移（例如，验证、批准、付款）时，系统将单独处理每个步骤。 每个部门的自动化都使用“流程追踪作用域”，以及“在现有追踪中”选项。 它们使用发票编号作为对象 ID 来标识现有追踪。 这可以跨不同系统和部门完整地追踪发票旅程，即使它是由单独的自动化处理的。

备注：

• 任务始终在流程追踪作用域开始时创建。

• 无论追踪选项为何，任务始终在作用域完成时关闭。

• 除非显式更改或发生异常，否则默认的任务状态为“成功”。

• 如果要将整个流程标记为完成，则可能需要使用“设置追踪状态”活动显式关闭追踪。

对象

在流程追踪服务的上下文中，对象是指由外部系统处理的业务项目，这是一种在自动化流程的不同部分中标记和关注重要项目的方式。对象有助于连接使用同一业务项目运行的不同自动化。

例如，JIRA 工单可视为此类对象：

如果您有可创建 JIRA 工单的自动化 (A1)，您可以使用“追踪对象”活动来定义工单详细信息，例如：

• 对象 ID — JIRA 标识符，例如“DOC-1234”。

• 对象类型 —“JIRA 工单”。

• 对象交互 — 自动化如何与 JIRA 工单交互，在本例中交互为“已创建”，因为自动化创建了工单。

• 对象属性 — JIRA 工单的属性，格式如下：

   {
    "XUiPathConnectorKey": "",  // for example, "uipath-jira"
    "XUiPathConnectorName": "",  // for example, "JIRA"
    "XUiPathObjectDisplayName": "",  // for example, "Issue"
    "XUiPathObjectName": ""  // for example, "curated_issue"
  }

重要提示：

当其他自动化 (A2) 需要使用由自动化 A1 创建的相同对象时，请使用“在现有追踪中”选项对自动化 A2 启用“流程追踪”。提供相同的对象详细信息以维持自动化之间的连接，以便自动化 A2 可以找到并处理自动化 A1 创建的工单。

通过追踪对象，您可以在自动化流程中关注特定业务项目的整个旅程，从而为流程优化和分析提供宝贵的见解。

功能

在工作流中添加流程追踪作用域：

• 在作用域开始时（开始时间戳）启动任务。

• 在作用域结束时（结束时间戳）结束追踪。

• 支持嵌套的流程追踪作用域。

• 流程追踪服务中的内部作用域会生成子任务，从而维护在流程图的分层 Process Mining 中可见的父子关系。

• 处理隐式和显式任务状态：

  • 隐式任务状态：

    • 默认状态为“成功”。

    • 如果发生未捕获的异常，则自动设置为“失败”。

    • 流程优化应用程序中提供异常的详细信息。

  • 显式任务状态：

    • 使用“设置任务状态”活动指定任务的结束方式。

    • 可能的值：成功、失败和取消。

• 处理显式追踪状态：

  • 使用“设置追踪状态”活动指定追踪的结束方式

    可能的值：成功、失败。

• 通过“如何追踪”属性提供三种任务追踪行为：

  • 在当前追踪中（默认行为）：

    • 追踪当前追踪中的新任务。

    • 使用当前作用域生成的追踪的 ID。

  • 在新追踪中：

    • 为追踪生成新 ID。

    • 在新追踪中追踪任务。

    • 需要指定分组的“流程名称”。

    • 作用域结束后，还原到上一个追踪上下文。

  • 在现有追踪中：

    • 将任务添加到预先存在的追踪中。

    • 用于链接单独的自动化流程。

    • 需要按对象详细信息和流程名称识别追踪。

为现有自动化启用流程追踪

要为序列启用流程追踪，请执行以下操作：

1. 选择工作流中的“序列”。

2. 在“属性”面板中，选中“流程追踪”复选框。

激活“流程追踪”后，“流程追踪作用域”活动将自动围绕“序列”。

项目兼容性

Windows | 跨平台

Windows、跨平台配置

流程跟踪

可选。如果选中，则系统为作用域内的序列启用流程追踪。

任务名称

可选。可用于为此作用域创建的任务指定名称。默认情况下，它使用包含的序列的名称。

如何跟踪

必填。确定任务如何与追踪相关联。可选择以下选项：

在当前追踪中

默认选项。将“流程追踪作用域”活动创建的任务添加到现有追踪。要在同一流程上下文中继续追踪时，此选项很有用。当作用域完成时，此作用域创建的任务将关闭，而现有追踪保持开启状态并继续运行。我们建议对属于单个正在进行的流程的顺序操作使用此选项。

在新追踪中

专门为此任务以及作用域内的任何子任务新建追踪。当您要启动新的不同流程或子流程时，此选项非常有用。新追踪具有其唯一的追踪 ID。作用域完成后，新的追踪上下文将还原到之前的上下文，并且系统将关闭关联的任务，这表示所追踪活动已结束。选择此项后，系统将显示“流程名称”字段：

• 流程名称 — 指定要在新追踪中启动的流程。

在现有追踪中

将任务添加到预先存在的追踪中。当通过“追踪对象”活动连接可能不按顺序的自动化的不同部分时，此选项非常有用。需要按对象详细信息和流程名称识别追踪。作用域完成时，系统将关闭在指定的现有追踪中创建的任务，而现有追踪保持开启状态并继续运行。选择此项后，系统将显示以下用于追踪识别的字段：

• 流程名称 — 指定要在现有追踪中启动的流程。

• 对象 ID — 指定与当前任务关联的对象 ID。您可以将其作为任务的一部分来跟追踪对象。此信息还可以帮助您在其他自动化中继续追踪。

• 对象类型 — 指定对象类型，以识别要切换到哪个追踪 ID。

• 对象交互 — 选择任务与对象的交互方式。

重要提示：虽然任务会在作用域完成时自动关闭，但如果要将整个流程标记为完成，则可能需要使用“设置追踪状态”活动显式关闭追踪。