在 Studio 中使用文件夹级别的实体

Studio Web 和 Studio Desktop 中的文件夹级别 Data Fabric 实体，用于在解决方案中构建工作流。

在解决方案中使用时，文件夹级别的 Data Fabric 实体在 Studio Web 和 Studio Desktop (26.10 LTS) 中可用。在传统活动中，文件夹作用域需要UiPath.DataService.Activities v26.10.0 或更高版本，这已正式发布。本页介绍如何在 Studio 环境中选择和配置实体。有关完整的生命周期（打包、部署、覆盖、升级和卸载），请参阅解决方案中的实体。

选择实体作用域

每个 Data Service 活动都包含一个作用域选取器。作用域决定了哪些实体可用：

• 租户— 显示整个租户中可用的实体。
• 文件夹— 显示您有权访问的所有 Orchestrator 文件夹的树以及每个文件夹中的实体。

备注：

文件夹作用域在任何表面上的本地工作区中均不可用。此功能仅在云端工作区中可用。

架构刷新

实体选取器旁边提供了“刷新”按钮。选择“刷新” ，可在单个操作中更新所选实体及其所有相关实体（子实体）的架构。

根据活动类型，刷新按钮的行为有所不同：

• 连接器活动（Data Fabric 连接器） — “刷新”按钮始终处于启用状态。要在架构更改后查看新添加或删除的字段，请执行以下操作：
  1. 打开实体的“解决方案”资源，然后选择“更新配置” ，以将最新架构拉取到解决方案中。
  2. 返回活动并选择刷新架构以加载更新的字段。
• 传统活动（Data Service 传统包） — 仅在检测到所选实体的架构更改时才会启用“刷新”按钮。选择此选项可直接更新架构。

自动资源包含（预览）

当您在解决方案的 Data Service 活动中使用文件夹级别实体时，该实体会自动添加为解决方案资源。所有依赖项（相关实体、选项集及其嵌套依赖项）都会自动包含在内。您不需要手动添加它们。

Studio Web

• 在活动中选择“文件夹”作用域，以处理文件夹作用域的实体。
• 工作流中使用的文件夹级别实体会自动添加到解决方案中。
• 在调试期间，您可以覆盖实体绑定、使用现有实体或在个人工作区中新建实体。

Studio 桌面

使用解决方案时，桌面版 Studio 26.10 LTS 支持文件夹级别的实体。使用同一作用域选取器在租户实体和文件夹实体之间进行选择。这需要UiPath.DataService.Activities v26.10.0 或更高版本。

备注：

Studio 桌面版支持适用于“解决方案”上下文中使用的文件夹级别实体。

调试和 Runtime 覆盖

实体覆盖可在两个阶段使用：

调试期间— 在“调试配置”窗口中，您可以保留现有实体，将其替换为其他文件夹中的兼容实体，或删除选择以在个人工作区中创建新实体。

运行时— 部署后，通过包要求在 Orchestrator 中更改实体绑定，无需重新发布。

不支持部署时覆盖。

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

备注：

• “覆盖”允许映射到其他文件夹中的兼容实体。不支持跨租户映射。
• 确保替换实体保持兼容的架构关系，以避免不匹配错误。

支持的界面

表面	文件夹范围内的实体
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	❌
本地工作区	❌