解决方案中的实体

解决方案中的 Data Fabric 实体生命周期，涵盖自动依赖项包含、安装、升级和卸载管理，以及调试和运行时的实体覆盖。

Data Fabric 实体可以作为资源包含在解决方案中。在属于解决方案的工作流中使用文件夹级别实体时，该实体及其依赖项将作为解决方案生命周期的一部分进行打包、部署和管理。

本页介绍实体在每个阶段的行为 - 从建模到部署、runtime、升级和卸载。

实体如何成为解决方案资源

当您将 Data Service 活动添加到解决方案中的工作流并选择文件夹级别的实体时，该实体将自动注册为解决方案资源。您不需要手动添加。

自动包含依赖项

将实体添加为解决方案资源还添加了该实体的所有依赖项。包含的依赖项因实体类型而异。

原生实体

• 相关实体— 如果实体 A 具有指向实体 B 的关系字段，则两个实体都会添加为解决方案资源。
• 选项集——包括在实体中用作字段类型的任何选项集。
• 嵌套依赖项— 如果实体 B 本身引用了实体 C，则也包含该实体。完整的依赖项链会自动解析。

联合实体

• 连接— 包括联合实体使用的 Integration Service 连接。
• 原生源实体— 如果联合实体引用原生实体作为数据源，则包括该原生实体及其完整依赖项链。

备注：

工作流中使用的租户级别实体不会自动打包。它们必须已存在于目标环境中，才能使已部署的工作流正常运行。仅文件夹级别的实体会包含为解决方案资源。

支持的界面

以下工作流类型支持解决方案中的 Data Fabric 实体：

表面	文件夹范围内的实体	注意
RPA (Studio Web)	✅	全面支持构建、调试、部署
RPA（桌面版 Studio 26.10 LTS）	✅	仅限解决方案上下文。传统活动需要UiPath.DataService.Activities v26.10.0
Maestro BPMN	✅
Maestro 案例	✅
API 工作流	✅
Agents (智能体)	✅（预览版）
Maestro 流程	通过原生实体节点	使用内置节点，而不是连接器活动
Coded Apps	✅
编码智能体	✅
独立的 VB Apps	❌
RPA (UB) Apps	❌

备注：

文件夹范围内的实体不支持通过 Data Service 连接器活动用于本地工作区。文件夹作用域仅在 Cloud WorkSpace 中可用。

生命周期

1. 创建实体并对其进行建模

在 Data Fabric 用户界面中创建文件夹级别的实体。将“位置”设置为“文件夹” ，然后选择目标 Orchestrator 文件夹。您可以同时创建原生实体和联合实体。根据需要添加字段、关系和选项集。

有关关系作用域规则，请参阅创建关系。有关联合实体设置，请参阅虚拟实体。

2. 构建工作流

在Studio Web或 Studio Desktop (26.10 LTS) 中，将 Data Service 活动添加到您的工作流中。每个活动都有一个作用域选取器— 选择“文件夹”以处理文件夹作用域内的实体。

传统活动中的文件夹作用域需要UiPath.DataService.Activities v26.10.0 或更高版本，该功能已正式发布。有关更多信息，请参阅传统活动。

仅显示您有权访问的文件夹中的实体。

3. 调试

在解决方案中调试工作流时， “调试配置”窗口会显示所有解决方案资源，包括实体。

对于每个实体，您可以执行以下操作：

• 使用现有实体— 对当前文件夹中的实体运行调试。
• 使用其他实体覆盖— 从其他文件夹中选择一个兼容的实体。
• 删除选择— 系统将在个人工作区的调试文件夹中创建一个新实体及其依赖项。

覆盖仅适用于直接从活动引用的实体。相关实体（例如，实体 A 通过关系字段引用的实体 B）不可覆盖，除非您添加直接从“平台资源”下引用该实体的单独活动。

备注：

覆盖时，请确保替换实体具有兼容的架构。关系不匹配或缺失字段可能会导致执行期间出错。

4. 发布

从 Studio Web 或 Studio 桌面版发布解决方案。该包包括工作流、实体架构、选项集和关系。仅打包架构，不包含任何数据。

5. 部署（安装）

将包部署到Orchestrator或 Studio Web 中的目标文件夹中。

在部署期间：

• 系统会在目标文件夹中自动创建文件夹级实体。
• 系统将重新创建选项集和关系。
• 工作流已绑定到新创建的实体。

仅创建架构。不会复制现有数据。每个环境都维护自己的数据。

重要提示：

不支持在部署期间创建内联实体。实体根据解决方案包中定义的架构创建。如果您需要在解决方案之外创建实体，请使用 Data Fabric 用户界面。

6. 运行 (runtime)

部署后，从 Orchestrator 运行工作流。自动化将与目标文件夹中的实体交互，就像在开发期间一样。

通过包要求覆盖 runtime

部署解决方案后，您可以更改工作流使用的实体，而无需重新发布。在 Orchestrator 中，导航到已部署的流程，然后打开“包要求”选项卡。将实体替换为同一或不同文件夹中的另一个兼容实体。

替换实体必须具有兼容的架构。工作流使用覆盖的实体运行，但所有逻辑都保持不变。

只有直接从活动引用的实体才会显示在要覆盖的“包要求”中。

备注：

不支持部署时覆盖。可在调试期间和运行时通过包要求使用实体覆盖。

7. 升级

修改实体架构（例如，添加新字段）时，请重新发布解决方案并在 Orchestrator 中升级部署。

升级期间：

• 系统会在目标文件夹中更新实体架构以匹配新版本。
• 现有数据保留 — 不会删除或覆盖任何记录。
• 新字段会添加到架构中。已移除的字段将从架构中删除，但基础数据将保留。
• 如果实体已包含数据，您可以在确认升级之前查看应用了哪些更改。
• 如果架构更改不兼容（例如，字段类型更改），升级时将显示冲突。在重新尝试升级之前，导航至 Data Fabric 用户界面，查看并解决源实体架构和目标实体架构之间的冲突。

8. 卸载

卸载解决方案将从目标文件夹中删除工作流及关联的资源。

卸载期间的实体行为取决于实体是否包含数据：

• 不带数据的实体— 与其选项集和关系一起删除。
• 带有数据的实体— 保留，以防止数据意外丢失。除非删除了该文件夹，否则实体将保留在文件夹中，并且可以直接在 Data Fabric 用户界面中进行管理。

生命周期行为摘要

操作	实体架构	实体数据	选项集	关系
安装	已在目标文件夹中创建	未复制 — 从空开始	已重新创建	已重新创建
升级	已更新以匹配新版本	保留	已更新	已更新
卸载（无数据）	已删除	不适用	已删除	已删除
卸载（包含数据）	保留	保留	保留	保留

架构刷新

您在活动中选择实体架构后，当该实体架构在 Data Fabric 中发生更改时，请使用 Studio Web 中实体选取器旁边的“刷新”按钮。“刷新”按钮可通过单个操作更新所选实体的架构及其所有相关实体。

• 连接器活动（Data Fabric 连接器） — “刷新”按钮始终处于启用状态。要查看新添加或删除的字段，请先打开实体的解决方案资源，选择“更新配置” ，然后返回活动并选择“刷新架构” 。
• 旧版活动（Data Service 传统包） — 对于原生实体，仅在检测到所选实体的架构更改时才会启用“刷新”按钮。选择此选项可直接更新架构。这些活动不支持联合实体的架构刷新。

跨作用域克隆实体

您可以使用“导出”和“导入”将实体架构从一个作用域复制到另一个作用域。例如，要在文件夹中使用租户级实体设计，您可以从 Data Fabric 用户界面中的租户级导出架构，这会一次导出所有租户级原生实体架构。然后，您在目标文件夹级别导入该文件，选择要带入文件夹的导出实体和选项集。

系统将在目标文件夹中创建具有相同架构的所选实体。不会复制任何数据。有关详细的导出和导入过程，请参阅架构导出和导入。

已知限制

解决方案中的文件夹级别实体在部署时覆盖、跨作用域关系、实体命名和不支持的界面方面存在限制。有关完整列表，请参阅“已知限制” 。