在 Maestro 流程中处理文件

UiPath Maestro™ 支持在运行时处理文件附件的两种方式：

• 作业附件（由 UiPath™ Orchestrator 管理）：默认且建议使用。
• Data Fabric 文件字段：支持的替代选项。

这两种方法都允许您在流程中下载、传递和使用文件。 区别在于它们的治理方式以及所需的设置。

概述：两个附件模型

Use case	推荐方法
将电子邮件附件传递给 RPA 流程	作业附件
将文档发送给智能体进行处理	作业附件
仅在执行期间使用的临时文件	作业附件
与长效业务记录绑定的文件	Data Fabric
在多个流程中重用的文件	Data Fabric

作业附件（默认）

作业附件是由 UiPath Orchestrator 管理并与流程执行（作业）关联的文件。

• 无需启用和设置 Data Fabric
• 默认启用
• 由 Orchestrator 保留策略进行监管
• 非常适合临时的流程作用域文件

这是在 Maestro 中处理文件的推荐方式。

工作方式

使用作业附件，文件将作为流程级别的附件处理：

1. 连接器下载或生成文件。
2. 该文件作为作业附件引用返回。
3. 该引用会传递给下游任务（智能体、RPA 和连接器）。
4. Orchestrator 根据您配置的保留策略存储和管控文件。

您不会显式配置存储。 Maestro 和 Orchestrator 会自动处理此问题。

示例：下载电子邮件附件并将其传递给其他任务

步骤 1：下载文件

1. 添加“发送”任务。
2. 在“操作”中，选择执行连接器活动。
3. 选择连接器（例如，Microsoft Outlook 365 或 Box）。
4. 选择您的连接。
5. 选择下载附件的活动“下载文件”。
6. 选择所需的文件。
7. 请注意，在“输出”部分中，“文件资源”字段会自动填充响应。 无需其他配置。

步骤 2：将文件传递给其他任务

1. 添加“发送”任务。
2. 将操作设置为执行连接器活动。
3. 选择 Microsoft Outlook 365 作为连接器。
4. 选择您的连接。
5. 选择“发送电子邮件”活动。
6. 配置收件人电子邮件地址、主题和正文。
7. 在“附件”字段中，选择托管文件的引用。

文件通过引用传递。不会将任何文件内容复制到变量中。

调试后，您可以选中“实例管理”中的“变量”选项卡以查看输出，其中包含引用 UiPath Orchestrator 中附件 ID 的 ID。

这使文件生命周期管理与其他 Orchestrator 资源（例如作业和日志）保持一致。

保留和监管

作业附件存储在 Orchestrator 中，并遵循：

• Orchestrator 保留策略
• 租户或文件夹级别的监管
• 基于配置的自动清理

Data Fabric 附件（可选）

Data Fabric 附件将文件存储在 Data Fabric 实体字段中。

• 需要启用 Data Fabric 并获得许可
• 文件作为业务记录的一部分持久化
• 适用于必须长期重用、查询或审核文件的情况

此模型仍然受到完全支持，但大多数场景不再需要此模型。

先决条件

在 Maestro 中使用文件之前，请确保：

• 您的组织或租户中已启用 Data Fabric。
• 已配置拥有文件支持字段的实体。

创建记录时，除了 Data Fabric 自动填写的字段外，不需要其他字段。

工作方式

在 Maestro 中文件支持的原始实施中，文件存储在 Data Fabric 实体中。

1. 连接器会下载文件。
2. 您指定：
   • 实体名称
   • 记录 ID
   • 文件字段
3. 存储的文件会在 Data Fabric 中引用。
4. Maestro 会将 Data Fabric 引用传递给下游任务。

示例：从 Data Fabric 下载文件并将其传递给其他任务

步骤 1：下载文件

1. 添加“发送”任务。
2. 在“操作”中，选择执行连接器活动。
3. 选择连接器（例如，Microsoft Outlook 365 或 Box）。
4. 选择您的连接。
5. 选择下载附件的活动“下载文件”。
6. 选择所需的文件。
7. 在“输出”部分中的“文件资源”字段中，选择调节菜单，然后选择 Data Fabric。
8. 在 Data Fabric 编辑器提示词中，填写“实体”和“字段”。

步骤 2：将文件传递给其他任务

1. 添加“发送”任务。
2. 将操作设置为执行连接器活动。
3. 选择 Microsoft Outlook 365 作为连接器。
4. 选择您的连接。
5. 选择“发送电子邮件”活动。
6. 配置收件人电子邮件地址、主题和正文。
7. 在“附件”字段中，从调节菜单中选择 Data Fabric。

8. 在 Data Fabric 编辑器提示词中，填写实体、要获取的记录 (RecordId) 和字段。

   

调试后，您可以选中“实例管理”中的“变量”选项卡以查看输出，其中包含引用新文件的记录 ID。

文件通过引用传递。不会将任何文件内容复制到变量中。此方法仍然有效，并受到完全支持。

当 Data Fabric 有意义时

当文件必须满足以下条件时，使用 Data Fabric：

• 与业务实体关联
• 可在多个流程实例中重用
• 独立于流程执行而持久化
• 参与数据查询或分析

有关更多详细信息，请参阅《Data Fabric 用户指南》。

重要行为说明

• 文件永远不会存储在变量中
• 文件按引用传递，而非按值传递
• 作业附件和 Data Fabric 引用不可互换
• 默认行为倾向于作业附件