步骤 4：在 Automation Suite 中合并组织

迁移工具输入

运行 UiPath.OrganizationMigrationApp 工具时，您必须提供以下详细信息：

• 独立产品组织 ID 列表

• Automation Suite 的组织 ID 列表

有关更多详细信息，请参阅迁移工具参数。

备注：

确保使用与步骤 1：将 Identity 组织数据从独立移动到 Automation Suite 中标识的组织 ID 相同的组织 ID。

适用于 Linux

备注：

请务必遵循所选 Shell 工具的一般转义说明。 例如，在 Bash 中，您必须在特殊字符之前添加 \ 。

要在 Automation Suite 中合并组织，请运行以下命令：

./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s '<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>' -d '<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>'

备注：

• 确保为输入中的源 SQL 连接和目标 SQL 连接字符串添加 TrustServerCertificate=True。

• 如果您要合并多个组织对，请确保独立产品的组织 ID 序列与 Automation Suite 的组织 ID 序列匹配。

• 如果您将一个独立租户迁移到所有租户的 Automation Suite 组织，则可针对所有迁移运行一次命令。 但是，如果您将多个独立租户迁移到一个 Automation Suite 组织，则您必须单独为每个租户运行该命令，因为您可能需要解决租户之间的用户冲突。 以下示例显示了如何单独为每个租户运行命令：

  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

有关在将多个独立租户迁移到单个 Automation Suite 组织时如何解决用户冲突的说明，请参阅解决用户冲突。

。

要在 Automation Suite 中合并组织，请运行以下命令：

./UiPath.OrganizationMigrationApp merge -i "<identity database connection of Automation Suite>" -o "<restored orchestrator DB in Automation Suite connection string>" -s "<list of tenant IDs of the standalone product separated by comma, e.g. tenantID1,tenantID2>" -d "<list of organization IDs of Automation Suite separated by comma, e.g. orgID1,orgID2>"

备注：

• 确保为输入中的源 SQL 连接字符串和目标 SQL 连接字符串添加 TrustServerCertificate=True。
• 如果您将一个独立租户迁移到所有租户的 Automation Suite 组织，则可针对所有迁移运行一次命令。 但是，如果您将多个独立租户迁移到一个 Automation Suite 组织，则您必须单独为每个租户运行该命令，因为您可能需要解决租户之间的用户冲突。 以下示例显示了如何单独为每个租户运行命令：

  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant1' -d 'orgId1'
  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant2' -d 'orgId1'
  ./UiPath.OrganizationMigrationApp merge -i '<identity database connection of Automation Suite>' -o '<restored orchestrator DB in Automation Suite connection string>' -s 'tenant3' -d 'orgId1'

有关在将多个独立产品租户迁移到单个 Automation Suite 组织时如何解决用户冲突的说明，请参阅解决用户冲突。

合并预期

用户

备注：

迁移到 Automation Suite 后，只有来自独立 Orchestrator 的用户才能访问 Orchestrator。

下表提供了对多种迁移方案及其对用户影响的深入了解：

条件	源用户是否提供了电子邮件地址？	目标用户是否拥有电子邮件地址？	源用户的电子邮件地址是否与目标用户的电子邮件地址相同？	源用户名与目标用户名是否相同？	结果
1					源用户已移至目标组织；目标组织用户有权访问独立的 Orchestrator。
2					源用户已移至目标组织；目标组织用户有权访问独立的 Orchestrator。 合并后，两个用户使用相同的用户名，并且他们必须使用电子邮件地址登录。
3				或者	源用户与目标用户合并；目标用户有权访问独立的 Orchestrator。
4			不适用		源用户已移至目标组织；目标组织用户有权访问独立的 Orchestrator。
5			不适用		源用户与目标用户合并；目标用户有权访问独立的 Orchestrator。
6			不适用		源用户已移至目标组织；目标组织用户有权访问独立的 Orchestrator。
7			不适用		您必须手动配置目标用户的电子邮件地址，或删除目标用户。 如果配置电子邮件地址，则源用户将与目标用户合并，并且目标用户有权访问独立的 Orchestrator。 如果删除目标用户，则源用户将移至目标组织，并且目标组织用户有权访问独立的 Orchestrator。
8			不适用		源用户已移至目标组织，而目标组织用户有权访问独立的 Orchestrator。
9			不适用		您必须将目标用户的电子邮件地址配置为空，或删除目标用户。 如果您将电子邮件地址配置为空，则源用户将与目标用户合并，并且目标用户有权访问独立的 Orchestrator。 如果删除目标用户，则源用户将移至目标组织，并且目标组织用户有权访问独立的 Orchestrator。

机器人用户

如果源机器人和目标机器人用户名相同，则源机器人用户将附加用户 ID，并移至目标组织。

源机器人用户名	目标机器人用户名	已移动源机器人用户名
同一机器人	同一机器人	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

组

如果源机器人组名称和目标机器人组名称相同，则系统会向源机器人用户附加一个字符串，并将其移至目标组织。

源组名称	目标组名称	已移动源组用户名
同一组	同一组	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

设置

如果源设置和目标设置具有相同名称，则使用目标的设置值。

解决用户冲突

将多个独立租户迁移到单个 Automation Suite 组织可能会导致用户冲突。 以下示例显示了此类冲突的错误消息：

[03:18:08 WRN] We found users in the target organization have the same email as those from the source organization. If you continue, we will keep the users in the target organization, but none of the application data for the source organization users will be moved.
The format is orgId -> list of emails.
[03:18:08 WRN] 3d8d01e6-3300-4988-87db-071bd8c8e786 -> [e-mail],[e-mail],[e-mail],[e-mail]
[03:18:08 WRN] We found users without emails in the target organization have the same username with the users without emails from the source organization.If you continue, we will keep the users in the target organization, but none of the application data for the source organization users will be moved.
The format is orgId -> list of usernames.
[03:18:08 WRN] 3d8d01e6-3300-4988-87db-071bd8c8e786 -> user1
[03:18:08 INF] Do you want to continue? Type (y/n)

您可以通过两种方式解决用户冲突：

• 输入n以结束合并过程，然后删除 Automation Suite 组织中存在冲突的用户，并再次运行合并命令。 选择此选项后，您将丢失已删除用户的信息。
• 输入“ y ”以继续合并过程。 通过选择此选项，您可以将所有源用户 ID 替换为目标用户 ID。 如果在 Automation Suite 中运行的产品（例如 Insights）引用了用户 ID，则您将丢失独立环境中任何合并用户的数据。 例如，假设有两个用户：

  • 一位来自独立环境中的tenant1的用户名为user1 ，电子邮件地址为[e-mail]的用户。
  • 另一个用户在独立环境中的tenant2中使用相同的用户名和电子邮件地址。
  如果您首先将tenant1合并到 Automation Suite 中的组织，则不会发生冲突。 但是，如果您随后将tenant2合并到同一个 Automation Suite 组织中，则会发生冲突，因为两个用户具有相同的电子邮件地址[e-mail] 。 如果键入y以继续合并过程，您将丢失产品从tenant2中引用的用户数据。

如果组织合并失败

如果组织合并失败，请检查日志。 根据身份迁移或 Orchestrator 迁移是否失败，请执行以下步骤：

身份迁移失败

如果身份迁移失败，您只需修复错误并再次执行组织合并命令。 这将回滚所有更改，因为我们已为 Identity 的操作设置事务。

Orchestrator 迁移失败

如果 Orchestrator 迁移失败，则 Orchestrator 数据库将回滚，但身份数据库不会回滚。 因此，您必须还原身份数据库的备份并替换连接字符串才能使用新数据库。 修复错误后，再次运行组织合并命令。

如果 Orchestrator 迁移失败，请执行以下步骤：

1. 还原身份数据库的备份。

   1. 右键单击数据库目录，然后选择“ 导入数据层应用程序”。

      
   2. 选择备份数据库文件。

      
   3. 输入备份数据库名称。

      
   4. 等待流程完成。

      

2. 替换身份连接字符串。

   `"platform": {
       "sql_connection_str": "<dotnet connection string>",   (added line)
       "enabled": true, 
   },`

3. 修复错误，然后使用新的平台连接字符串再次运行合并命令。