从传统文件夹迁移到新式文件夹
引入了新式文件夹，以改进和简化自动化的编排，与传统文件夹相比，它具有多项优势。
在此期间，您可以期待这些变化。
为帮助您过渡到新式文件夹，您可以使用 新式迁移 向导轻松重新创建传统文件夹层次结构和新式文件夹中的实体，同时保留所有依赖项。
要全部或部分转换当前部署以利用新式文件夹，必须重新部署某些实体，而必须完全重新创建其他实体。
以下是迁移向导在迁移期间和迁移后所执行操作的概述：
- 将每个传统文件夹重新创建为新式文件夹，以
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 自动化）。如果同一用户拥有多个许可证，则他们将保留高级许可证，并释放低级许可证。
例如，如果用户的一个有人值守机器人使用有人值守许可证，另一个使用 Citizen Developer 许可证，则用户保留 Citizen Developer 许可证，并释放有人值守许可证。
- 为了能够成功运行“新式迁移”向导，您必须是 Automation Cloud 中的组织管理员。
-
如要打开新式迁移向导，您需要以下权限：
- 角色：查看、创建和编辑
- 设置：查看和编辑
- 用户：查看、创建和编辑
- 机器人：查看、创建、编辑和删除
- 文件夹：创建和编辑
在迁移完成之前，请勿对传统文件夹设置进行任何配置更改，这一点很重要。
请将迁移前检查和更改限制在下面列出的范围内。
已知问题
开始迁移后，您将无法再编辑传统文件夹中的队列触发器。如果出现任何需要编辑队列触发器的问题，则在迁移开始到迁移成功完成之间，您将无法使用有故障的队列触发器。
包含和排除文件夹
在启动向导之前，请将自己添加到要迁移的所有传统文件夹中。
不会迁移未分配给您的文件夹。
包含和排除旧式机器人
在启动向导之前，请检查是否已将要迁移的所有机器人添加到环境中。
假定不属于任何环境的旧式机器人未在使用中，也不作为迁移的目标。
-
如果某个机器人未迁移，则该机器人的资产机器人值和流程计划也不会迁移，除非另一个已迁移的机器人也使用该机器人。
-
已迁移到新式文件夹框架的传统文件夹不支持传统机器人。
设置权限
迁移后，系统会自动在文件夹级别（在迁移时分配到的相应文件夹中）为 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] = 0DECLARE @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
- 对于每个不正确或未设置的目标帐户，您必须手动设置该帐户：
- 单击“目标用户帐户”列中的“分配”。
- 在“搜索用户”字段中，开始键入要搜索的内容，然后从结果中选择用户。
- 单击右下角的“保存”，设置目标帐户并返回上一页面。有关如何将机器人映射到用户帐户的信息，请参阅 Attended Robot 的映射规则。
- 准备就绪后，单击“下一步”以转到“Unattended 用户”步骤。
Attended Robot 的映射规则
当您尝试将旧式 Attended Robot 映射到其用户时，我们使用以下规则来验证您的选择。
-
必须将具有相同用户名（显示在 Attended User 页面上）的机器人映射到相同的目标用户帐户。
同样，必须将具有不同“用户名”值的机器人映射到不同的目标用户帐户。
-
如果您与外部用户目录集成，则在将机器人映射到目录用户帐户时，机器人的用户名值必须与目标用户帐户的电子邮件地址或用户名相符。
您可以在“租户”>“管理访问权限”>“分配角色”页面上查看用户帐户的电子邮件地址和用户名。
-
将机器人映射到本地用户帐户时：
- 如果对租户强制执行交互式登录，则可以将任何旧式机器人映射到任何用户。
- 如果将租户级别的机器人身份验证设置设为“混合式”，并且目标用户帐户启用了个人自动化，则机器人的“用户名”值必须与用户的“域\用户名”值相符，如用户的“个人自动化设置”页面上所示。
- 如果已将租户级别的机器人身份验证设置设为“混合式”，为目标用户帐户启用了个人自动化，并且在用户的“个人自动化设置”页面中设置了“从用户组继承许可证”选项，则用户将具有尚未显示的由系统生成的个人自动化用户名，但该用户名必须与机器人的用户名相符，否则不允许映射。
对于 Unattended Robot，您必须将其映射到新的或现有的机器人帐户。机器人帐户专为运行 Unattended 自动化而设计，我们建议使用机器人帐户而不是用户帐户。
Unattended 用户页面列出了在传统文件夹中找到的所有 Unattended Robot。
自动生成机器人帐户的作用
选择此选项后，在迁移时，向导会尝试自动映射每个旧式机器人，如下所示：
-
查找 Unattended 用户名相符的现有用户或机器人帐户。如果找到，则将 Unattended Robot 映射到该现有帐户。如果未找到匹配项，则转到下一步。
-
查找具有相同用户名且已映射到帐户的其他旧式 Unattended Robot。如果找到，则会将此机器人映射到同一帐户。如果未找到匹配项，则会为旧式机器人创建一个新的机器人帐户。
Migrated_{ClassicFolderName}_{ClassicRobotName} 格式为向导创建的新机器人帐户命名。
已知问题：已迁移的旧式机器人名称的最大长度限制为 64 个字符。如果超出此限制，则必须手动创建机器人帐户并进行映射。
Unattended Robot 的映射规则
当您尝试将旧式 Unattended Robot 映射到机器人或用户帐户时，以下规则适用。
如果您选择手动将机器人映射到机器人帐户（不推荐），而不是允许向导创建新的机器人帐户，则必须遵循这些规则。
-
查找所用凭据与旧式 Unattended Robot 相同的现有机器人帐户。如果找到匹配项，向导则会要求您将旧式 Unattended Robot 映射到现有机器人帐户。如未找到，则转到下一步。
-
查找所用凭据与要映射的旧式机器人相同的另一个旧式 Unattended Robot。如果找到对应项且该项已映射到目标帐户，向导则会要求您将当前机器人映射到同一目标帐户。
如果您运行了迁移向导，但自动化未在新式文件夹中正常运行，则可以 临时 重新启用传统文件夹设置，以便继续运行自动化，直到解决迁移问题并成功移至新式文件夹。
要在运行迁移后临时恢复为使用传统文件夹，请执行以下操作：
- 将租户的机器人身份验证设置重新设置为混合式。
- 启用所有旧式机器人。
- 在传统文件夹中启用触发器。
- 删除新式文件夹。
- 删除新的机器人帐户。
- 调查传统文件夹设置中导致自动化失败的原因，并可能清理传统文件夹。
- 再次运行迁移。
UiPath.System.Activities v19.10.1 或更高版本重新编译使用 Orchestrator 活动或对 Orchestrator API 发起直接 HTTP 调用的工作流。您还必须重新配置新式文件夹结构中的所有其他现有实体，但以下对象除外：机器人，因为系统会自动为有权访问新式文件夹的用户配置这些实体；环境，因为在新式文件夹的上下文中不会使用该实体。
将现有实体升级到新式模型将消除所有向后兼容性。重新编译的工作流只能由 2019.10+ 机器人执行。
迁移到新式文件夹
要全部或部分转换您当前的部署，以利用新式文件夹，必须重新部署某些实体，而其他实体则必须完全重新创建。 迁移过程大概如下所示：
-
如果要完全隔离每个环境中的用户和流程，则每个环境都将成为一个单独的子文件夹，或者成为其自己的第一级文件夹。
-
必须使用当前活动重新编译每个包的工作流，然后重新发布或上传到 Orchestrator。
-
使用新编译的程序包，必须将每个流程重新部署到与其先前环境相对应的文件夹（或子文件夹）。
-
必须将每个用户添加到与他们需要访问的流程相对应的文件夹。
domain\username 的机器人，一个在传统文件夹中，一个在新式文件夹中，并且用户只能看到并执行他们可用的传统流程。删除传统机器人后，新式机器人将接管并执行这些流程的新创建和添加的新式版本，不会影响用户的体验。
domain/username，则用户只能访问传统机器人和相关流程。为了使有人值守的机器人在新式环境中工作，必须停用传统的浮动机器人。迁移成功通过测试和审核后，即可安全删除传统机器人。
使用 Orchestrator 管理器协助迁移
为了简化迁移到新式文件夹的过程，可以使用 UiPath Orchestration Manager。这是一个 Studio 项目，使用 Orchestrator API 基于 Microsoft Excel 工作簿操作实体。有关如何使用它进行迁移的说明，请参阅产品文档。
