从传统文件夹迁移到新式文件夹

升级现有的 Orchestrator 实例后，所有实体都将迁移到文件夹上下文中，可以是单个文件夹（默认），也可以是使用中的每个先前组织单元的文件夹。这些实体可以像以前一样继续使用，而后向兼容性或性能不变。

要利用新式文件夹提供的功能，您必须使用 UiPath.System.Activities v19.10.1 或更高版本重新编译使用 Orchestrator 活动或直接 HTTP 调用 Orchestrator API 的现有工作流。 您还必须重新配置新式文件夹结构中的所有其他现有实体，以下实体除外：

• 机器人 - 因为系统会为有权访问新的新式文件夹的用户自动配置机器人；
• 环境 - 因为在新式文件夹的上下文中不使用这些环境。

请参阅此处，了解有关新式文件夹附加功能的更多信息。

重要提示：将现有实体升级到新式模型将消除所有向后兼容性。重新编译的工作流只能由 2019.10+机器人执行。

迁移到新式文件夹

要全部或部分转换您当前的部署，以利用新式文件夹，您必须重新部署某些实体，并完全重建其他实体。

总体而言，迁移过程如下：

• 如果未使用任何组织单位，则每个先前的组织单位或租户将成为一级文件夹。升级 Orchestrator 实例时，系统会自动执行此操作。
• 如果要完全隔离每个环境中的用户和流程，则每个环境都将成为一个单独的子文件夹，或者成为其自己的第一级文件夹。
• 必须使用当前活动重新编译每个包的工作流，然后重新发布或上传到 Orchestrator。
• 使用新编译的程序包，必须将每个流程重新部署到与其先前环境相对应的文件夹（或子文件夹）。
• 必须将每个用户添加到与他们需要访问的流程相对应的文件夹。

对于您的用户而言，这种迁移可以是无缝的。当用户继续使用分配给他们的传统文件夹中的现有实体时，管理员使用相同的 domain\username 创建两个机器人，一个机器人在传统文件夹中，另一个在新式文件夹中，并且用户只能看到并执行他们可用的传统流程。在 Orchestrator 管理员创建并添加了整个新式文件夹结构和所需的实体，然后删除机器人之后，新式机器人将接管并执行这些相同流程的新式版本，而用户的体验则保持不变。

注意：必须手动删除传统机器人才能完成迁移。如果传统机器人与新式文件夹中的用户具有相同的 domain/username，则用户只能访问传统机器人和相关流程。

使用 Orchestrator 管理器协助迁移

为了简化迁移到新式文件夹的过程，可以使用 UiPath Orchestration Manager。这是一个 Studio 项目，使用 Orchestrator API 基于 Microsoft Excel 工作簿操作实体。有关如何使用它进行迁移的说明，请参阅产品文档。

跨文件夹工作

使用新式文件夹，从某个文件夹执行的自动化工作流可以使用 Orchestrator 活动的 FolderPath 参数访问另一个文件夹中的资源。

FolderPath 参数支持相对文件夹路径，如下所示：

• 以 / 开头的路径 - 从环境文件夹所在的树的 root 文件夹开始。
• 以 . 开头的路径 - 从环境文件夹开始。
• 以 .. 开头的路径 - 路径中的每个 .. 表示在环境文件夹的层次结构中向上一层（例如 ../ 表示向上一层，../../ 表示向上两层）。

请注意，不应包含尾随斜杠。