管理包要求

概述

RPA 之旅始于 Studio，即工作流和活动领域。在设计工作流时，开发者可以使用各种对象，这些对象通常使用文件夹从 Orchestrator 进行集中管理，这使您能够对自动化和关联的对象进行精细控制。

这些对象对于成功执行流程至关重要。缺少任何指定的对象都会导致流程无法成功执行。

“包要求”选项卡允许您识别缺少的对象并在流程级别手动添加它们。这有助于：

• 向用户介绍有关流程依赖项的信息，
• 减少手动工作流调试，
• 无需在 Studio 和 Orchestrator 用户界面之间切换即可识别缺少的对象。
  图 1. “包要求”页面
  

  

  
  

备注：

• 此功能与使用 Studio 版本 2021.10 及更高版本以及活动包版本 2021.10 及更高版本创建的流程兼容。
• 对于工作流开发者指定了连接用途的连接等对象，此信息显示在依赖项网格中的“描述”字段中。例如，一个工作流可能使用两个 Outlook 365 连接，一个用于下载电子邮件，另一个用于发送电子邮件自动回复。在这种情况下，开发者可以使用“描述”字段将连接标记为“下载电子邮件”和“发送电子邮件”。

包要求的工作原理

创建流程时，Orchestrator 会检查基础包及其所有组件 .xaml 文件，并聚合其内部对象，例如：

• 存储桶
• 资产
• 队列
• 队列、时间和事件触发器
• 其他流程
• 操作目录
• 连接
• 业务规则

根据是否有检测到相应的对象，有两个“包要求”选项卡行为：

• 选项卡变为红色 - 工作流具有一些 Orchestrator 中不存在的依赖项，因此您需要添加它们。

• 选项卡为空，显示“此包版本不包含任何要求”。 - 上传的包没有任何要求。

  注意：Orchestrator 不会自动检测存储在外部订阅源中的包的要求。

流程类型

您可以使用“类型”下拉列表筛选包类型：

• 全部：所有包均可见。
• 未知：仅显示未知包类型。
• 队列：仅显示队列。
• 资产：仅显示资产。
• 存储桶：仅显示存储桶。
• 流程：仅显示流程。
• 操作目录：仅显示操作目录。
• 实体：仅显示实体。
• 连接：仅显示连接。
• 事件触发器：仅显示事件触发器。
• 时间触发器：仅显示时间触发器。
• 队列触发器：仅显示队列触发器。
• 应用程序触发器：仅显示应用程序触发器。
• 活动：仅显示活动。
• 业务规则：仅显示业务规则。
• 索引：仅显示索引。
• 应用程序：仅显示应用程序。
• 智能提取处理 (IXP)：仅显示 IXP 流程。
• MCP 服务器：仅显示 MCP 服务器。

包要求状态

常规状态

• 可用 - 对象存在于 Orchestrator 中。无需进一步操作。

• 缺少 - 对象不在 Orchestrator 的当前文件夹中。如果您具有适当的权限，则可以将其链接或添加到相应的 Orchestrator 文件夹中。

• 未找到文件夹 - 对象本应存在于活动的“文件夹路径”字段中引用的 Orchestrator 文件夹中，但：

  • 该文件夹在 Orchestrator 中不存在。您应该在 Orchestrator 中添加文件夹，使用与“文件夹路径”列中指示的相同的名称，然后为其分配用户。

  • 您无权访问该文件夹。您应该请求访问“文件夹路径”列中指定的 Orchestrator 文件夹。

• 未知 - 无法确定对象名称。没有可执行的操作。有几种情况可能会导致“未知”状态：

  • 您没有为该类型的对象设置正确的权限；

  • 例如，工作流活动引用了无法链接到其队列的队列项目。

    注意：对象的未知状态不会阻止流程成功执行。

• 筛选器无效 - 未配置连接的筛选器。

注意：对象的未知状态不会阻止流程成功执行。

触发器状态

除了常规状态外，触发器还显示以下状态：

• 待创建 - 添加触发器需要将其与现有流程相关联。创建流程时，触发器位于 Orchestrator 内存中，并在创建流程后变为活动状态。当触发器处于此状态时，您可以从“包要求”选项卡编辑触发器。之后，您可以选择在“触发器”页面编辑触发器。

• 配置无效 - 所选运行时不可用。

• 名称重复 - 触发器名称重复。

权限

要管理包要求，您需要以下权限：

我想...	我需要...	我需要的文件夹访问权限...
...查看可用的包	查看包权限（租户级别）	不适用，因为包权限是在租户级别设置的。
...上传包	创建包权限（租户级别）	不适用，因为包权限是在租户级别设置的。
...查看可用对象	查看指定对象的权限	获取对包含对象的文件夹的访问权限。
...添加对象	创建特定类型对象的权限	访问要添加对象的文件夹。
...从其他文件夹导入对象	创建和查看特定类型对象的权限	可以访问： 要从中导入的文件夹，以及 要导入对象的文件夹。

管理缺少的对象

对于每个缺少的对象（操作目录和连接除外），您可以选择添加或将其导入当前文件夹，前提是您具有必要的权限。

注意：您无法从 Orchestrator 的“包要求”选项卡中添加操作目录和连接，而只能从 Action Center 和 Integration Service 中分别添加。

添加缺少的对象

先决条件：确保您具有特定对象的“创建”权限，并有权访问要将对象添加到的文件夹。

1. 要添加缺少的对象，请单击相应的“添加”按钮。系统将打开“创建 [对象]”页面。
2. 根据需要配置对象。
   名称字段已预填充缺少的对象名称，并且无法编辑。此限制适用于工作流中使用的对象名称。

导入缺少的对象

如果您怀疑缺少的对象存在于当前租户中，但位于其他文件夹中，则可以将其导入当前文件夹。

先决条件：确保您具有特定对象的“查看”和“创建”权限，并有权访问要从中导入数据的文件夹和要将对象导入到的文件夹。

1. 要从其他文件夹导入对象，请单击相应的“导入”按钮。系统将打开“从其他文件夹链接 [对象]”页面，并显示两个选项卡：
2. 如果对象存在于其他文件夹中，则该对象将显示在“选择 [对象]”选项卡上。选中它。
3. 单击“继续”以导航至“文件夹验证”选项卡。

   选择对象后，“文件夹验证”选项卡将显示您可以从中导入的源文件夹。

4. 如果对象存在于多个文件夹中，并且您在上一步中选择了所有副本，则系统现在会提示您仅保留一个源文件夹。
5. 删除与不需要从中导入的文件夹关联的对象副本。
6. 单击“链接”以将对象导入到“文件夹路径”列中指定的文件夹。
7. 添加或导入对象后，系统会将您重定向到“包要求”选项卡，以继续添加或导入缺少的对象。请注意，已添加或导入的对象的状态已更改。

重要提示：

对于多层流程依赖项，Orchestrator 仅检测并显示给定流程的第一级依赖项。

例如，流程 A 需要启动流程 B，而流程 B 需要启动流程 C。依赖项层次结构为 A > B > C。在这种情况下，检查流程 A 的包要求时，Orchestrator 会检测并显示其第一级依赖项，即流程 B。如果缺少流程 B，您可以从“包要求”选项卡开始添加它，但如果缺少流程 C，则需要自己将其标识为缺少并手动添加。

添加操作目录

Orchestrator 会检测执行流程所需的操作目录，但您无法从“包要求”选项卡中添加缺少的目录，因为操作目录是可通过 Action Center 配置的对象。

先决条件：确保您具有特定对象的“创建”权限，并有权访问要将对象添加到的文件夹。

继续执行以下步骤：

1. 前往相应的 Action Center 实例。
2. 访问“管理员设置”页面。
3. 选择流程文件夹。
4. 单击“添加新目录”。确保使用在“包要求”选项卡中检测到的缺失名称。
5. 单击“创建”。

添加时间和队列触发器

添加时间或队列触发器时，系统会使用 RPA Developer 在设计时的关联触发器活动中设置的值预填充“创建触发器”页面上的字段。您可以在触发器处于“待创建”状态或更高状态时从“编辑触发器”页面编辑这些值。“待创建”状态意味着系统会将触发器存储在临时内存中，直到创建所需的流程为止。

1. 转到“自动化”>“流程”，然后单击“添加流程”。
2. 选择包含时间触发器活动的包。
3. 输入所需的运行时参数，然后单击“下一步”。
4. “包需求”页面显示“缺失”状态下的时间触发器。选择“添加触发器”按钮，以配置时间触发器。
5. 按照“创建时间触发器/创建队列触发器”页面上的说明配置触发器属性。时间/队列触发器状态已变更为“待创建”。
6. 选择“下一步”以继续配置流程，然后选择“创建”。
   创建流程后，时间/队列触发器将显示在 Orchestrator 的“时间/队列触发器”网格中。

   在创建缺失队列触发器期间，您可以选择添加队列。 请注意，这样做会限制您在创建触发器之前将 SLA 添加到队列中。

   图 2。 从“队列触发器创建”页面添加队列
   

   

   
   

配置已连接的事件触发器

1. 在文件夹上下文中，导航到“自动化”，然后依次选择“流程”和“添加流程”。
2. 选择包含事件触发器活动的包。
3. 选择入口点并输入所需的 runtime 参数，然后选择“下一步”。
4. “包需求”页面显示在包中识别的事件连接。选择连接或添加新连接。有关详细信息，请参阅配置连接。
5. 事件触发器在相应的连接下显示，状态为“待创建”。要编辑事件触发器，请选择铅笔图标。此时会打开“编辑事件触发器”页面。
   注意：此步骤为可选步骤。如果跳过此步骤，将应用默认选择。
6. 在“名称”字段中输入触发器的唯一名称。如果触发器名称已存在，您将收到一条错误消息，并必须更改名称。
7. 从“作业优先级”下拉菜单中，选择作业的优先级。默认值为“继承”，意味着作业优先级与为选定流程定义的作业优先级相同。
8. 从“runtime 类型”下拉菜单中，选择用于执行触发器启动的作业的 runtime。如果要使用 Unattended runtime，建议不要将连接设置为“可由用户配置”。
9. 在“执行目标”部分中，要选择作业终止策略，请启用“计划结束作业执行”切换开关。
   备注：

   即使作业已排队，您指定的时间仍会按照您的要求计算。例如，如果您将某个作业计划为在下午 1 点运行，并将其设置为在 20 分钟后停止，则即使该作业一直停留在队列中，直到下午 1:15 才开始，也会在下午 1:20 停止。

   此外，如果您选择在两小时后停止待处理或正在运行的作业，并在三小时后终止同一作业，该作业将在五小时后终止。发生这种情况的原因是，首先，Orchestrator 会在两小时后收到作业已停止的信号。收到信号后，Orchestrator 会为在三小时后执行终止操作计时，因此总时长为五小时。

   可用的选项如下：

   • 从下拉菜单中选择“停止”：当作业在您设置的时长内处于“待处理”或“正在运行”状态时，此选项会尝试正常结束作业执行。您可以将最小间隔设置为 1 分钟，将最大间隔设置为 10 天、23 小时和 59 分钟。
   • 从下拉菜单中选择“终止”：当作业在您设置的时长内处于“待处理”或“正在运行”状态时，此选项会尝试强制结束作业执行。您可以将最小间隔设置为 1 分钟，将最大间隔设置为 10 天、23 小时和 59 分钟。
   • 从下拉菜单中选择“停止”，然后启用“如果作业未停止，则终止作业”选项。如果作业在您为停止操作设置的时长内一直处于“待处理”或“正在运行”状态，此选项会尝试正常结束作业执行。如果上述尝试导致作业保持“正在停止”状态，Orchestrator 会在您为终止操作设置的时长后尝试强制终止作业。您可以将最小间隔设置为 1 分钟，将最大间隔设置为 10 天、23 小时和 59 分钟。
10. 要在作业处于“待处理”或“已恢复”状态一段时间后接收警示，请启用“在作业一直处于‘待处理’或‘已恢复’状态时生成警示”切换开关，并为作业保持“待处理”或“已恢复“状态设置可接受的持续时间。可配置的最短持续时间为 1 分钟，最长持续时间为 11 天。如果作业超出配置的持续时间，系统将弹出错误严重性-警示窗口，并显示以下文本：“#process {process_number} 的 N 个作业处于‘待处理’或‘已恢复’状态的时间已超过 X 小时 Y 分钟。”其中：
    • N 是触发警报的作业数量。
    • {process_number} 是流程标识符。
    • X 是作业处于“待处理”或“已恢复”状态超出的小时数配置。天数将转换为小时数。
    • Y 是作业处于“待处理”或“已恢复”状态超出的分钟数配置。
11. 要在作业未在设置的时间间隔内完成时接收警示，请启用“在作业已启动但尚未完成时生成警示”切换开关，并设置作业完成前可接受的持续时间。可配置的最短持续时间为 1 分钟，最长持续时间为 11 天。如果作业超出配置的持续时间，系统将弹出一个错误-严重性警示窗口，并显示以下文本：“#process {process_number} 的作业已运行超过 X 小时 Y 分钟。”其中：
    • {process_number} 是流程标识符。
    • X 是未完成作业超出的小时数配置。天数将转换为小时数。
    • Y 是未完成作业超出的分钟数配置。
12. 要保留为启动作业而配置的相同帐户/计算机上下文，请选择“在作业恢复时保留用户/计算机分配”。选择此选项可优化您的许可证和资源利用率。
13. 在“runtime 参数”部分中，从下拉菜单中选择一个入口点，为流程参数提供适当的值，然后选择“更新”以保存事件触发器配置。
14. 要继续配置流程，请选择“下一步”。完成后，选择“创建”。

备注：

基于执行的触发器禁用仅适用于从 Studio Web 发布到个人工作区的事件触发器。

默认情况下，会在执行连续失败 5 次后禁用触发器。您可以通过编辑以下租户级执行设置来更新配置：

• 触发器 - 已连接的触发器 - 任务执行计数失败时禁用

• 触发器 - 已连接的触发器 - 任务执行计数持续失败的宽限期 (天)

创建流程后，事件触发器将在“事件触发器”网格中显示，“已连接”值在“类型”列中显示。

配置连接

注意：此功能仅在个人工作区中可用。

Orchestrator 允许在创建新流程或编辑现有流程时指定连接中使用的帐户。

管理员可以在用户的个人工作区中为其配置连接，前提是您拥有以下权限集：

• 针对“连接”的查看权限

• 个人工作区的“查看”、“编辑”权限

• 针对资源覆盖的“查看”、“编辑”权限

1. 转到个人工作区中的“自动化”>“流程”。系统将显示“流程”页面。
2. 选择流程旁边的“更多操作”>“编辑”，以对其进行编辑。此时显示“编辑流程”窗口。
3. 在“流程配置”选项卡上，根据需要配置流程的常规详细信息。
4. 转到“包要求”选项卡，以查看基础自动化项目使用的对象。在这里，您应该可以看到在设计时已添加到自动化项目中的所有连接。连接会将已配置为使用连接的所有活动分组。系统会显示以下选项之一：

   连接选项	行为	注意
   现有连接	为选定的共享连接执行活动。	可用连接在其容器文件夹下进行组织。
   可由用户配置	允许用户在 UiPath Assistant 的运行时中选择自己的连接。	不要为 Unattended 运行时选择此选项。
   没有权限或缺少连接	在包含所需连接的文件夹中检查“查看”权限。	您可以通过单击齿轮图标 >“添加连接”，在当前文件夹中添加缺少的连接。 单击齿轮图标 >“管理连接”，系统会将您重定向到“Integration Service”界面，您可以在其中创建新的连接器和连接。

5. 选择齿轮按钮 ，以管理连接或通过 Integration Service 添加新连接。
   Figure 3. Managing connections
   

   

   
   

   “可由用户配置”选项

   出现以下情况时，默认显示“可由用户配置”选项：

   • 将包发布到个人工作区

   • 连接未共享（位于您无法访问的文件夹中）

   • 连接不存在

   • 权限不足

   如果您手动设置“可由用户配置”选项，则允许用户在 UiPath Assistant 的运行时中选择自己的连接。

   “Integration Service 活动”筛选条件

   Integration Service 中的活动可以包含筛选器。筛选值取决于所使用的连接，并且 UiPath Assistant 的运行时可以将其覆盖。只有具有可覆盖筛选器的活动才会显示为包要求。如果连接设置为“可由用户配置”，则不会显示任何筛选器。

   备注：

   将现有连接更改为“可由用户配置”会重置活动筛选器。该操作使得用户可以配置自己的筛选器。

   使用现有连接以外的其他连接会重置活动筛选器。这样，您就可以为新连接设置新的筛选器。

   要运行 Unattended 自动化，必须设置服务帐户连接。请勿设置“可由用户配置”选项。

自定义用户配置

当事件触发器选择了“可由用户配置”选项时，您的用户可以在运行时在 UiPath Assistant 中设置自己的连接。

“自定义用户配置”页面列出了用户设置的事件触发器配置。

Figure 4. Custom user configurations

作为文件夹管理员，您可以在流程级别或触发器级别覆盖用户的现有配置或添加新配置。

探索用户的个人工作区

• 为用户设置配置意味着探索所选用户的个人工作区。

• 要代表用户添加连接，您需要查看其个人连接，这些连接位于其“个人工作区”文件夹中。

• 每当您开始或结束浏览用户的个人工作区时，用户都会收到警示。

用户配置状态

这些状态可帮助您识别哪些用户的配置有错误：

已配置 - 用户的配置有效。

部分配置 - 用户的配置有误，这可能意味着缺少连接。

访问“自定义用户配置”页面

您可以从“流程”和“事件触发器”页面访问“自定义用户配置”页面。

1. 在所选文件夹中，转到：

   选项	描述
   “自动化”>“触发器”>“事件触发器”	系统将显示所有可用事件触发器的列表。
   “自动化”>“流程”	系统将显示所有可用流程的列表。

2. 对于所需的流程/事件触发器，单击“更多操作”按钮，然后选择“自定义用户配置”。这会将您重定向到“自定义用户配置”页面。

添加新的用户配置

1. 对于所需的流程或事件触发器，请访问“客户用户配置”页面。
2. 在“每个用户帐户的包要求配置”部分中，单击“添加用户配置”。系统将打开“配置用户帐户的流程要求”向导。
3. 从“用户帐户”下拉列表中，选择要为哪些用户配置流程或事件触发器，然后单击“添加用户”。
   备注：

   • 所选用户必须与流程/事件触发器位于同一文件夹中。否则，系统会提示您分配文件夹中的用户。
   • 如果您同时从文件夹中删除用户，则其用户配置将继续显示在列表中。
   • 系统将弹出一条消息，通知您需要探索所选用户的个人工作区。
4. 提供所需的详细信息，例如连接或活动筛选器。
5. 保存配置。

覆盖现有用户配置

1. 对于所需的流程或事件触发器，请访问“客户用户配置”页面。
2. 对于所需的用户帐户，单击“编辑配置”。
3. 修改所需的详细信息，例如连接或数据筛选器。
4. 单击“保存”以更新配置。

   在 Assistant 中，拥有适当“资源覆盖”权限的用户始终可以更新您已配置的设置。

删除用户的事件触发器配置

要删除用户的事件触发器配置，请执行以下操作：

1. 对于所需的流程或事件触发器，请访问“客户用户配置”页面。
2. 对于所需的用户帐户，单击“清除配置”。此操作会清除所选用户的配置。
   如果删除了用户的配置，则该流程可能无法按预期运行。
   备注：

   要在“客户用户配置”页面上进行更改，需要以下权限：

   • 在事件触发器级别，此操作需要对“资源覆盖”的“编辑”权限和对“触发器”的“查看”权限。
   • 在流程级别，此操作需要对“资源覆盖”的“编辑”权限以及对“流程”的“查看”和“编辑”权限。