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

引入了新式文件夹，以改进和简化自动化的编排，与传统文件夹相比，它具有多项优势。

注意：传统文件夹不再是管理自动化的标准，取而代之的是新式文件夹，这是一种更好、功能更丰富的替代方案。出于这个原因，我们已经删除了创建新传统文件夹的选项，并且从 2022 年 10 月开始，我们将弃用传统文件夹。

为帮助您过渡到新式文件夹，您可以使用 新式迁移 向导轻松重新创建传统文件夹层次结构和新式文件夹中的实体，同时保留所有依赖项。

迁移流程概述

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

以下是迁移向导在迁移期间和迁移后所执行操作的概述：

• 将每个传统文件夹重新创建为新式文件夹，以 Migrated <folder name> 的格式命名。
• 对于每个环境，在目标新式文件夹中创建相应的子文件夹。如果只有一个环境，则不会创建任何子文件夹。
• 将每个流程重新部署到与其先前文件夹或环境对应的新式文件夹（或子文件夹）。
• 将资产、队列和触发器从每个传统文件夹迁移到相应的新式文件夹。
• 将每个 Test Suite 实体迁移到与其先前所属的传统文件夹环境相对应的新式子文件夹。

• 将机器人和用户帐户迁移到相应的新式文件夹：

  • 将每个旧式 Attended Robot 映射到用户帐户，并使用个人自动化设置（旧称为“Attended Robot 设置”）设置每个用户帐户，使其有权访问在传统文件夹中运行的 Attended 自动化所需的相应新式文件夹和计算机。就角色而言，可能会出现两种情况：

    • 如果在开始迁移时未将传统有人值守机器人映射到的用户帐户分配给租户，则该帐户会自动包含在租户中，并被授予 Allow to be Automation User 租户级别角色。
    • 如果已将传统有人值守机器人映射到的用户帐户分配给租户，则其角色不会更改，因此您需要手动向其授予“ 允许成为自动化用户 ”租户级别角色。 这可以防止自动化中断。

  • 除非另有配置，否则将每个旧式 Unattended Robot 映射到机器人帐户（推荐），并设置每个机器人帐户，使其有权访问 Unattended Robot 在传统文件夹中运行的自动化所需的相应新式文件夹和计算机。

    向映射到旧式 Unattended Robot 的现有机器人帐户授予 Automation User 文件夹级别角色。

    自动生成的新机器人帐户会接收 Automation User 文件夹级别角色和 Allow to be Automation User 租户级别角色。

• 迁移完成后，即可使用某些包含 Attended 功能的用户许可证。这是因为，在新式文件夹中，每个用户只需要一个用户许可证即可实现个人自动化（旧称为 Attended 自动化）。如果同一用户拥有多个许可证，则他们将保留高级许可证，并释放低级许可证。

  例如，如果用户的一个 Attended Robot 使用 Attended 许可证，另一个使用 Citizen Developer 许可证，则用户保留 Citizen Developer 许可证，并释放 Attended 许可证。

  重要提示：

  虽然向导可以为您大大简化迁移流程，但您需要执行一些迁移后任务，以便自动化正常运行。

  在开始迁移之前，请确保您具备所需的知识并分配时间来执行这些任务。

租户设置更改

运行新式迁移向导后，某些租户级别的设置会自动发生更改。这些更改为使用新式文件夹的必要项。

成功迁移所有传统文件夹后，系统将应用以下更改：

• 已强制执行交互式登录 。

  迁移完成后，用户需要更新其 UiPath Studio 或 UiPath Assistant 连接设置，以从使用计算机密钥切换到使用交互式登录，以便能够在新式文件夹中工作。

• 传统文件夹及其实体仍然可用。

  您可以保留这些内容，直到验证完成，并在之后进行删除。

• 帐户-计算机映射 在租户级别启用。

先决条件

权限

• 为了能够成功 运行 新式迁移 向导，您必须是 组织管理员。

• 如要打开新式迁移向导，您需要以下权限：

  • 角色：查看、创建和编辑
  • 设置：查看和编辑
  • 用户：查看、创建和编辑
  • 机器人：查看、创建、编辑和删除
  • 文件夹：创建和编辑。

数量限制

新式迁移 向导不适合需要专用迁移工具和策略的大型部署。

我们建议您不要对所包含的旧式机器人数超过 2,000 的文件夹使用迁移向导。这可能会导致出现性能问题，并可能导致迁移失败。

步骤 1：使用新式迁移向导

准备迁移

重要提示：

在迁移完成之前，请勿对传统文件夹设置进行任何配置更改，这一点很重要。

请将迁移前检查和更改限制在下面列出的范围内。

已知问题

开始迁移后，您将无法再编辑传统文件夹中的队列触发器。如果出现任何需要编辑队列触发器的问题，则在迁移开始到迁移成功完成之间，您将无法使用有故障的队列触发器。

包含和排除文件夹

在启动向导之前，请将自己添加到要迁移的所有传统文件夹中。

不会迁移未分配给您的文件夹。

包含和排除旧式机器人

在启动向导之前，请检查是否已将要迁移的所有机器人添加到环境中。

假定不属于任何环境的旧式机器人未在使用中，也不作为迁移的目标。

重要提示：如果某个机器人未迁移，则该机器人的资产机器人值和流程计划也不会迁移，除非另一个已迁移的机器人也使用该机器人。

防止权限提升

迁移后，系统会自动在文件夹级别（在迁移时分配到的相应文件夹中）为 Attended User 和机器人帐户分配自动化用户角色。如果您已为此组自定义服务级别角色或许可证分配规则，我们建议您在继续迁移之前从此组中删除任何已提升权限的角色或额外的许可证。

检查是否没有作业正在运行

请务必确保在开始迁移之前没有任何作业正在运行。

如果您有将在迁移期间启动作业的触发器，我们建议您禁用它们，并在迁移完成后重新启用。

在开始迁移之前，您可以从要迁移的每个传统文件夹的“文件夹”>“监控”页面检查作业状态。

重要提示：迁移开始时，所有未处于最终状态的作业都将终止。如果已终止的作业在迁移结束时未达到已停止状态，则迁移将失败并显示相关错误。

使用向导

要将租户的传统文件夹迁移到新式文件夹，请执行以下操作：

1. 转到“租户”>“设置”。

   “设置”页面将在“常规”选项卡上打开。

2. 在“传统文件夹”部分中，单击“开始迁移”。

   “新式迁移”向导将在“入门”步骤中打开。

3. 查看信息，然后在“摘要”部分下，单击“复制上面的摘要”，然后保存该信息以供记录。

   摘要会列出了要迁移实体的类型和数量。

   备注：

   • 只有您有权访问的传统文件夹才会成为迁移目标。不会迁移未将您加入其中的文件夹。
   • 假定未添加到环境中的旧式机器人未在使用中，并且不将其作为迁移的目标。
4. 准备就绪后，单击“下一步”继续执行“Attended User”步骤。

为有人值守用户使用向导

由于在新式文件夹中，我们以不同方式管理用户和机器人之间的关系，并且我们会自动创建用户的机器人，因此您需要将每个旧式 Attended Robot 映射到使用它的用户的帐户。

Attended User 页面列出了在目标传统文件夹中找到的所有 Attended Robot 及其详细信息。

在“目标用户帐户”列中，对于找到的每个 Attended Robot，您必须根据其他列中的信息选择使用 Attended Robot 的用户的帐户。

重要提示：

• 如果没有为机器人设置帐户，则不会迁移该机器人。与该机器人关联的流程将无法再运行。
• 如果迁移中涉及的 Attended Robot 的用户名不包含 @ 字符，则迁移将不会成功。要解决此问题，需要将本地用户转换为目录用户。只要受影响的用户至少登录一次 Orchestrator，此操作就会在安装或升级期间自动完成。如果不支持，您可以使用此脚本进行转换：

  DECLARE @domain VARCHAR(100) = 'your-domain-name-here'
  UPDATE u
  SET
      u.[UserName] = CONCAT(u.[UserName], '@', lower(@domain)),
      u.[Type] = 2
  FROM
      [dbo].[Users] u
      JOIN [dbo].[UserLogins] l ON u.[Id] = l.[UserId]
  WHERE 
      u.[Type] = 0
      AND l.[LoginProvider] = 'Windows'
      AND u.[IsDeleted] = 0

1. 对于每个不正确或未设置的目标帐户，您必须手动设置该帐户：
   1. 单击“目标用户帐户”列中的“分配”。
   2. 在“搜索用户”字段中，开始键入要搜索的内容，然后从结果中选择用户。
   3. 单击右下角的“保存”，设置目标帐户并返回到上一页面。
      有关如何将机器人映射到用户帐户的信息，请参阅 Attended Robot 的映射规则。
2. 准备就绪后，单击“下一步”以转到“Unattended 用户”步骤。

Attended Robot 的映射规则

当您尝试将旧式 Attended Robot 映射到其用户时，我们使用以下规则来验证您的选择。

• 必须将具有相同用户名（显示在 Attended User 页面上）的机器人映射到相同的目标用户帐户。

  同样，必须将具有不同“用户名”值的机器人映射到不同的目标用户帐户。

• 如果您与外部用户目录集成，则在将机器人映射到目录用户帐户时，机器人的用户名值必须与目标用户帐户的电子邮件地址或用户名相符。

  您可以在“租户”>“管理访问权限”>“分配角色”页面上查看用户帐户的电子邮件地址和用户名。

• 将机器人映射到本地用户帐户时：

  • 如果对租户强制执行交互式登录，则可以将任何旧式机器人映射到任何用户。
  • 如果将租户级别的机器人身份验证设置设为“ 混合 ”，并且目标用户帐户启用了 个人自动化 ，则机器人的“ 用户 名”值必须与用户的“ 域\用户 名”值匹配，如用户的“ 个人自动化设置 ”页面上所示。
  • 如果将租户级别的机器人身份验证设置设为“ 混合式”，为目标用户帐户启用 个人自动化 ，并且在用户的“ 个人自动化设置 ”页面中设置了“从用户组继承许可证”选项，则用户将拥有一个已生成的个人自动化用户名，即未显示，但必须与机器人的 用户 名匹配，否则不允许映射。

重要提示：当多个 Attended Robot 映射到同一个目标帐户时，新式文件夹中的机器人用户名将随机成为已迁移机器人的用户名之一。这可能会导致尝试连接到计算机时出现访问问题。

使用无人值守用户向导

对于 Unattended Robot，您必须将其映射到新的或现有的机器人帐户。机器人帐户专为运行 Unattended 自动化而设计，我们建议使用机器人帐户而不是用户帐户。

Unattended 用户页面列出了在传统文件夹中找到的所有 Unattended Robot。

1. 在右上角的“批量操作”下，选择您希望向导如何处理未映射目标机器人帐户的传统 Unattended Robot：

   • 推荐：如果要迁移列出的所有 Unattended Robot，并希望允许向导为其创建新的机器人帐户，请选择“ 自动生成机器人帐户 ”。 详细信息…

   • 不推荐：如果您只想迁移找到的部分传统 Robot，请选择“忽略它们”。

2. 查看“目标机器人帐户”列，确保所有现有映射均正确无误。
   • 如果您选择了“自动生成机器人帐户”，请跳过此步骤。

   • 如果选择了“忽略它们”，则必须通过单击“目标机器人帐户”列中的“分配”，仅手动将要迁移的那些传统 Unattended Robot 映射到目标机器人帐户。如有需要，您此时也可以创建新的机器人帐户。

     重要提示：任何未映射到目标机器人帐户的旧式机器人都不会迁移到新式文件夹。
3. 准备就绪后，单击“下一步”以继续执行最后一步。

   完成页面随即打开。

自动生成机器人帐户的作用

选择此选项后，在迁移时，向导会尝试自动映射每个旧式机器人，如下所示：

1. 查找 Unattended 用户名相符的现有用户或机器人帐户。

   如果找到，则将 Unattended Robot 映射到该现有帐户。如果未找到匹配项，则转到下一步。

2. 查找具有相同用户名且已映射到帐户的其他旧式 Unattended Robot。

   如果找到，则会将此机器人映射到同一帐户。如果未找到匹配项，则会为旧式机器人创建一个新的机器人帐户。

以 Migrated folderName_robotName 格式为向导创建的新机器人帐户命名。

Unattended Robot 的映射规则

当您尝试将旧式 Unattended Robot 映射到机器人或用户帐户时，以下规则适用。

如果您选择手动将机器人映射到机器人帐户（不推荐），而不是允许向导创建新的机器人帐户，则必须遵循这些规则。

1. 查找所用凭据与旧式 Unattended Robot 相同的现有机器人帐户。

   如果找到匹配项，向导则会要求您将旧式 Unattended Robot 映射到现有机器人帐户。如未找到，则转到下一步。

2. 查找所用凭据与要映射的旧式机器人相同的另一个旧式 Unattended Robot。如果找到对应项且该项已映射到目标帐户，向导则会要求您将当前机器人映射到同一目标帐户。

重要提示：如果您将具有不同凭据的多个机器人映射到同一个机器人帐户，则在迁移后，机器人帐户将随机使用其中一个旧式机器人的凭据。这些凭据可能无法在所有目标计算机上使用，并且在迁移后可能导致无法与计算机相连。

开始迁移

1. 准备就绪后，单击“执行迁移”，启动该流程。

   打开确认对话框。

2. 单击“执行”以开始迁移。

   页面将刷新以显示每个文件夹的迁移进度。

   注意：如果发生任何故障，请检查显示的错误消息。解决每个传统文件夹中的问题后，您可以重新启动或重试迁移。
3. 单击“关闭”以退出向导。

后续步骤：如果迁移成功，请继续进行 迁移后设置。

故障排除

作业尚未进入最终状态

迁移开始时，向导会自动终止所有正在运行的作业，以便迁移运行。如果在迁移完成时，已终止的作业仍处于“正在终止”状态，并且未达到“已停止”状态，则迁移将失败。

如果发生这种情况，我们会在 24 小时后自动将“正在终止的作业”状态设置为“已停止”。此时，您可以重新开始迁移。

重新启动或重试迁移

如果部分或所有文件夹的迁移失败，您可以在解决导致错误的错误配置后重试。

要重新启动或重试失败的迁移，请执行以下操作：

1. 查看每个文件夹的错误消息，然后检查传统文件夹设置以解决错误。
2. 解决所有错误后，转到“租户”>“设置”>“开始迁移”。

   向导将在最后一页打开。

3. 要重新运行迁移，请执行以下操作：

   • 如果要使用以前的设置重新运行迁移，请单击迁移失败的文件夹所在行右侧的“重试”图标。此选项将按照之前的设置重新启动迁移，但不会提供更改映射的选项。

     （可选）如果要删除迁移失败的文件夹的任意部分迁移数据，请选中“重试前清理”复选框。如果未选中此复选框，则仅对先前无法迁移的实体执行迁移。

     提示：如果迁移因 测试数据队列 或 测试数据队列 项目错误而失败，请在重新开始迁移 之前选中“重试前清理” 复选框。 这可以防止新式文件夹中出现重复的 测试数据队列 项目。

   • 如果要重做 Attended Robot 和 Unattended Robot 的映射，请单击右下角的“ 重新启动 ”。 此选项将带您返回到向导的第一步。 请按照 使用向导 中的说明再次完成设置。

步骤 2：迁移后设置

迁移完成后，您必须执行以下手动步骤来解决向后兼容性问题：

1. 重新编译使用 Orchestrator 活动或对 Orchestrator API 发起直接 HTTP 调用的现有工作流，以对 UiPath.System.Activities 使用 2019.10 或更高版本。
2. 在相应的新式文件夹中重新配置所有其他现有实体，例如操作目录。

   您无需重新配置 Attended 和 Unattended Robot（系统会自动为有权访问新的新式文件夹的用户配置）和环境（不用于新式文件夹）。

3. 通过从相应的 Test Manager 项目中删除测试集，取消 测试集 与传统文件夹的链接。
   
   

   

   
   
4. 通过选择描述为 [已迁移] 的 测试集 ，再次链接 测试集 。
   
   

   

   
   
5. 更新 UiPath Apps 中使用的传统文件夹流程，以使用新迁移的新式文件夹流程。
6. 更新以下工作流：
   • 在旧文件夹路径中存在依赖项
   • 使用“启动作业”活动。在传统文件夹中，您以前使用的是 processName_envName，现在，对于新式文件夹，需将其更改为 processName。
7. 如果尚未启用，请为租户启用交互式登录。这是在新式文件夹中执行作业的必要项。
8. 在 Orchestrator 中使用“启动作业”运行 Unattended 流程，以在新式设置中对其进行测试。
   注意：迁移完成后，请等待 10 分钟，以便向导禁用已迁移的传统文件夹中的机器人。此为必要操作，以便发布许可证并可以在新式文件夹中使用。
9. 升级最终用户工作站以使用 2019.10 或更高版本的 UiPath Robot。
10. 删除现在未使用的传统文件夹。

恢复到传统文件夹

如果您运行了迁移向导，但自动化未在新式文件夹中正常运行，则可以 临时 重新启用传统文件夹设置，以便继续运行自动化，直到解决迁移问题并成功移至新式文件夹。

要在运行迁移后临时恢复为使用传统文件夹，请执行以下操作：

1. 将租户的机器人身份验证设置重新设置为混合式。
2. 启用所有旧式机器人。
3. 在传统文件夹中启用触发器。
4. 删除新式文件夹。
5. 删除新的机器人帐户。
6. 调查传统文件夹设置中导致自动化失败的原因，并可能清理传统文件夹。
7. 再次运行迁移。

手动迁移

要利用新式文件夹提供的功能，您必须使用 UiPath.System.Activities v19.10.1 或更高版本重新编译使用 Orchestrator 活动或对 Orchestrator API 发起直接 HTTP 调用的工作流。您还必须重新配置新式文件夹结构中的所有其他现有实体，但以下对象除外：机器人，因为系统会自动为有权访问新式文件夹的用户配置这些实体；环境，因为在新式文件夹的上下文中不会使用该实体。

重要提示：

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

迁移到新式文件夹

要全部或部分转换您当前的部署，以利用新式文件夹，必须重新部署某些实体，而其他实体则必须完全重新创建。 迁移过程大概如下所示：

• 如果要完全隔离每个环境中的用户和流程，则每个环境都将成为一个单独的子文件夹，或者成为其自己的第一级文件夹。

• 必须使用当前活动重新编译每个包的工作流，然后重新发布或上传到 Orchestrator。

• 使用新编译的程序包，必须将每个流程重新部署到与其先前环境相对应的文件夹（或子文件夹）。

• 必须将每个用户添加到与他们需要访问的流程相对应的文件夹。

可以为用户无缝执行此迁移。Orchestrator 管理员创建并添加了整个新式文件夹结构和所需的实体，而用户仍然使用分配给他们的传统文件夹中的现有实体。在此期间，您可以创建两个具有相同 domain\username 的机器人，一个在传统文件夹中，一个在新式文件夹中，并且用户只能看到并执行他们可用的传统流程。删除传统机器人后，新式机器人将接管并执行这些流程的新创建和添加的新式版本，不会影响用户的体验。

重要提示：

如果传统机器人与新式文件夹中的用户具有相同的 domain/username，则用户只能访问传统机器人和相关流程。为了使有人值守的机器人在新式环境中工作，必须停用传统的浮动机器人。迁移成功通过测试和审核后，即可安全删除传统机器人。

使用 Orchestrator 管理器协助迁移

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