订阅

UiPath Orchestrator

UiPath Orchestrator 指南

Migrating from classic to modern folders

本页介绍如何在新式迁移向导的帮助下将部署从使用传统文件夹升级为使用新式文件夹。

 

引入了新式文件夹,以改进和简化自动化的编排,与传统文件夹相比,它具有多项优势。
In Classic folders vs modern folders you can read more about the differences between these types of folders.

📘

传统文件夹计划于 2022 年 10 月弃用

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

 

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

📘

临时可用性

此向导仅适用于计划于 2023 年 4 月删除的功能。

 

迁移流程概述


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

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

  • 将每个传统文件夹重新创建为新式文件夹,以 Migrated <folder name> 的格式命名。
  • 对于每个环境,在目标新式文件夹中创建相应的子文件夹。如果只有一个环境,则不会创建任何子文件夹。
  • 将每个流程重新部署到与其先前文件夹或环境对应的新式文件夹(或子文件夹)。
  • 将资产、队列和触发器从每个传统文件夹迁移到相应的新式文件夹。
  • 将机器人和用户帐户迁移到相应的新式文件夹:
    • 将每个旧式 Attended Robot 映射到用户帐户,并使用个人自动化设置(旧称为“Attended Robot 设置”)设置每个用户帐户,使其有权访问在传统文件夹中运行的 Attended 自动化所需的相应新式文件夹和计算机。
      Grants the Allow to be Automation User role to user accounts to which a classic attended robot was mapped.
    • Maps each classic unattended robot to robot accounts (recommended), unless configured otherwise, and sets up each robot account with access to the corresponding modern folders and machines needed to run the automations that the unattended robot ran in classic folders.
      Grants the Automation User folder-level role to existing robot accounts that are mapped to classic unattended robots.
      New, automatically-generated robot accounts receive the Automation User folder-level role and the Allow to be Automation User tenant-level role.
  • 迁移完成后,即可使用某些包含 Attended 功能的用户许可证。这是因为,在新式文件夹中,每个用户只需要一个用户许可证即可实现个人自动化(旧称为 Attended 自动化)。如果同一用户拥有多个许可证,则他们将保留高级许可证,并释放低级许可证。
    例如,如果用户的一个 Attended Robot 使用 Attended 许可证,另一个使用 Citizen Developer 许可证,则用户保留 Citizen Developer 许可证,并释放 Attended 许可证。

🚧

需要手动操作

虽然向导可以为您大大简化迁移流程,但您需要执行一些迁移后任务,以便自动化正常运行。
在开始迁移之前,请确保您具备所需的知识并分配时间来执行这些任务。

租户设置更改

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

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

  • Interactive sign-in is enforced.
    迁移完成后,用户需要更新其 UiPath Studio 或 UiPath Assistant 连接设置,以从使用计算机密钥切换到使用交互式登录,以便能够在新式文件夹中工作。
  • 传统文件夹及其实体仍然可用。
    您可以保留这些内容,直到验证完成,并在之后进行删除。
  • Account-machine mappings are enabled at the tenant level.

 

先决条件


权限

  • To be able to successfully run the Modern migration wizard, you must be an organization administrator.

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

    • 角色:查看、创建和编辑
    • 设置:查看和编辑
    • 用户:查看、创建和编辑
    • 机器人:查看、创建、编辑和删除
    • 单元:创建和编辑。

数量限制

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

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

 

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


准备迁移

🚧

在迁移完成之前,请勿对传统文件夹设置进行任何配置更改,这一点很重要。
请将迁移前检查和更改限制在下面列出的范围内。

已知问题

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

包含和排除文件夹

在启动向导之前,请将自己添加到要迁移的所有传统文件夹中。
不会迁移未分配给您的文件夹。

包含和排除旧式机器人

在启动向导之前,请检查是否已将要迁移的所有机器人添加到环境中。
假定不属于任何环境的旧式机器人未在使用中,也不作为迁移的目标。

If a robot is not migrated, the asset robot values and process schedules for that robot are not migrated either, unless also used by another robot that is migrated.

防止权限提升

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

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

请务必确保在开始迁移之前没有任何作业正在运行。
如果您有将在迁移期间启动作业的触发器,我们建议您禁用它们,并在迁移完成后重新启用。

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

When the migration starts, all jobs that are not in a final state are terminated. If a terminated job does not reach the stopped status by the time the migration concludes, the migration fails with a related error.

 

使用向导

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

  1. 转到“租户”>“设置”。
    设置页面将在“常规”选项卡上打开。
  2. 在“传统文件夹”部分中,单击“开始迁移”。
    新式迁移向导将在“入门”步骤中打开。
  3. 查看信息,然后在“摘要”部分下,单击“复制上面的摘要”,然后保存该信息以供记录。
    摘要会列出了要迁移实体的类型和数量。
    注意:
    • 只有您有权访问的传统文件夹才会成为迁移目标。不会迁移未将您加入其中的文件夹。
    • 假定未添加到环境中的旧式机器人未在使用中,并且不将其作为迁移的目标。
  4. 准备就绪后,单击“下一步”继续执行“Attended User”步骤。

Attended User

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

Attended User 页面列出了在目标传统文件夹中找到的所有 Attended Robot 及其详细信息。
在“目标用户帐户”列中,对于找到的每个 Attended Robot,您必须根据其他列中的信息选择使用 Attended Robot 的用户的帐户。

If you do not set an account for a robot, that robot is not migrated. The processes associated with that robot will no longer be able to run.

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

 

Attended Robot 的映射规则

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

  • 必须将具有相同用户名(显示在 Attended User 页面上)的机器人映射到相同的目标用户帐户。
    同样,必须将具有不同“用户名”值的机器人映射到不同的目标用户帐户。

  • 如果您与外部用户目录集成,则在将机器人映射到目录用户帐户时,机器人的用户名值必须与目标用户帐户的电子邮件地址或用户名相符。
    您可以在“租户”>“管理访问权限”>“分配角色”页面上查看用户帐户的电子邮件地址和用户名。

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

    • 如果对租户强制执行交互式登录,则可以将任何旧式机器人映射到任何用户。
    • If the tenant-level robot authentication setting is set to Hybrid and the target user account has personal automation enabled, the Username value for the robot must match user's Domain\Username value, as shown on the user's Personal automations setup page.
    • If the tenant-level robot authentication setting is set to Hybrid, the target user account has personal automation enabled, and the option Inherit license from user's group is set in user's Personal automations setup page, then the user has a generated personal automation username which is not shown, but is required to match the Username of the robot, otherwise mapping is not allowed.

When multiple attended robots are mapped to the same target account, the robot username in the modern folder will be one of the usernames of the migrated robots, at random. This can result in access problems when trying to connect to machines.

 

无人值守用户

For unattended robots, you must map them to new or existing robot accounts. Robot accounts are designed for running unattended automations and we recommend using them instead of user accounts.

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

  1. 在右上角的“批量操作”下,选择您希望向导如何处理未映射目标机器人帐户的传统 Unattended Robot:
    • 推荐:如果要迁移列出的所有 Unattended Robot,并希望允许向导为其创建新的机器人帐户,请选择“自动生成机器人帐户”。详细信息...
    • 不推荐:如果您只想迁移找到的部分传统 Robot,请选择“忽略”。
  2. 查看“目标机器人帐户”列,确保所有现有映射均正确无误。
    • 如果您选择了“自动生成机器人帐户”,请跳过此步骤。
    • 如果选择了“忽略”,则必须通过单击“目标机器人帐户”列中的“分配”,仅手动将要迁移的那些传统 Unattended Robot 映射到目标机器人帐户。如有需要,您此时也可以创建新的机器人帐户。
      任何未映射到目标机器人帐户的旧式机器人都不会迁移到新式文件夹。
  3. 准备就绪后,单击“下一步”以继续执行最后一步。
    完成页面随即打开。

 

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

选择此选项后,在迁移时,向导会尝试自动映射每个旧式机器人,如下所示:
i. 查找 Unattended 用户名相符的现有用户或机器人帐户。
如果找到,则将 Unattended Robot 映射到该现有帐户。如果未找到匹配项,则转到下一步。
ii. 查找具有相同用户名且已映射到帐户的其他旧式 Unattended Robot。
如果找到,则会将此机器人映射到同一帐户。如果未找到匹配项,则会为旧式机器人创建一个新的机器人帐户。
Migrated folderName_robotName 格式为向导创建的新机器人帐户命名。

Unattended Robot 的映射规则

当您尝试将旧式 Unattended Robot 映射到机器人或用户帐户时,以下规则适用。
如果您选择手动将机器人映射到机器人帐户(不推荐),而不是允许向导创建新的机器人帐户,则必须遵循这些规则。

i. 查找所用凭据与旧式 Unattended Robot 相同的现有机器人帐户。
如果找到匹配项,向导则会要求您将旧式 Unattended Robot 映射到现有机器人帐户。如未找到,则转到下一步。
ii. 查找所用凭据与要映射的旧式机器人相同的另一个旧式 Unattended Robot。如果找到对应项且该项已映射到目标帐户,向导则会要求您将当前机器人映射到同一目标帐户。

If you map multiple robots with different credentials to the same robot account, after migration the robot account uses the credentials of one of the classic robots, at random. There is a risk that these credentials do not work on all of the target machines and, after migration, can result in a failure to connect to machines.

 

开始迁移

  1. 准备就绪后,单击“执行迁移”,启动该流程。
    打开确认对话框。
  2. 单击“执行”以开始迁移。
    页面将刷新以显示每个文件夹的迁移进度。
    如果发生任何故障,请检查显示的错误消息。解决每个传统文件夹中的问题后,您可以重新启动或重试迁移。
  3. 单击“关闭”以退出向导。

Next steps: If migration was successful, continue with Post-migration setup.

 

故障排除

作业尚未进入最终状态

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

If this happens, after 24 hours, we automatically set Terminating jobs to Stopped status. At this point, you can restart the migration.

 

重新启动或重试迁移

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

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

  1. 查看每个文件夹的错误消息,然后检查传统文件夹设置以解决错误。
  2. 解决所有错误后,转到“租户”>“设置”>“开始迁移”。
    向导将在最后一页打开。
  3. 要重新运行迁移,请执行以下操作:
    • 如果要使用以前的设置重新运行迁移,请单击迁移失败的文件夹所在行右侧的“重试”图标 ()。此选项将按照之前的设置重新启动迁移,但不会提供更改映射的选项。
      (可选)如果要删除迁移失败的文件夹的任意部分迁移数据,请选中“重试前清理”复选框。如果未选中此复选框,则仅对先前无法迁移的实体执行迁移。
    • 如果要重做 Attended Robot 和 Unattended Robot 的映射,请单击右下角的“重新启动”。此选项将带您返回到向导的第一步。请按照使用向导中的说明再次完成设置。

 

步骤 2:迁移后设置


迁移后,您必须执行以下手动步骤来解决向后兼容性问题:

  1. 重新编译使用 Orchestrator 活动或对 Orchestrator API 发起直接 HTTP 调用的现有工作流,以对 UiPath.System.Activities 使用 2019.10 或更高版本。
  2. 在相应的新式文件夹中重新配置所有其他现有实体,包括:
    • 操作目录
    • 对于测试(如有):测试集、测试计划、测试数据队列。
      您无需重新配置 Attended 和 Unattended Robot(系统会自动为有权访问新的新式文件夹的用户配置)和环境(不用于新式文件夹)。
  3. 更新 UiPath Apps 中使用的传统文件夹流程,以使用新迁移的新式文件夹流程。
  4. 更新以下工作流:
    • 在旧文件夹路径中存在依赖项
    • 使用“启动作业”活动。在传统文件夹中,您以前使用的是 processName_envName,现在,对于新式文件夹,需将其更改为 processName
  5. 如果尚未启用,请为租户启用交互式登录。这是在新式文件夹中执行作业的必要项。
  6. 在 Orchestrator 中使用“启动作业”运行 Unattended 流程,以在新式设置中对其进行测试。

📘

迁移完成后,请等待 10 分钟,以便向导禁用已迁移的传统文件夹中的机器人。此为必要操作,以便发布许可证并可以在新式文件夹中使用。

  1. 升级最终用户工作站以使用 2019.10 或更高版本的 UiPath Robot。
  2. (可选)删除现在未使用的传统文件夹。

 

恢复到传统文件夹


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

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

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

约一个月前更新


Migrating from classic to modern folders


本页介绍如何在新式迁移向导的帮助下将部署从使用传统文件夹升级为使用新式文件夹。

建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。