Paso 4: Fusionar organizaciones en Automation Suite

Fusione organizaciones de productos independientes en Automation Suite utilizando la herramienta UiPath.OrganizationMigrationApp.

Entrada de la herramienta de migración

Al ejecutar la herramienta UiPath.OrganizationMigrationApp, debe proporcionar los siguientes detalles:

• La lista de ID de la organización para el producto independiente
• La lista de ID de la organización para Automation Suite

Para obtener más información, consulta Parámetros de la herramienta de migración.

Nota:

Asegúrate de utilizar los mismos ID de la organización que los identificados en el paso 1: mover los datos de la organización de Identity de forma independiente a Automation Suite.

para Linux

Nota:

Asegúrese de seguir las instrucciones de escape generales para la herramienta Shell de su elección. Por ejemplo, en Bash debe agregar \ antes de caracteres especiales.

Para fusionar organizaciones en Automation Suite , ejecuta el siguiente comando:

./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>'

Nota:

• Asegúrate de añadir TrustServerCertificate=True tanto para la conexión SQL de origen como de destino en la entrada.
• Si tienes varios pares de organizaciones para fusionar, asegúrate de que la secuencia de ID de la organización para el producto independiente y la secuencia de ID de la organización para Automation Suite coinciden.
• Si migras un tenant independiente a una organización de Automation Suite para todos los tenants, puedes ejecutar el comando una vez para todas las migraciones. Sin embargo, si migras varios tenants independientes a una organización de Automation Suite, debes ejecutar el comando por separado para cada tenant, ya que es posible que tengas que resolver los conflictos de usuario entre los tenants. El siguiente ejemplo muestra cómo ejecutar el comando por separado para cada tenant:

./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'

Para obtener instrucciones sobre cómo abordar los conflictos de usuario al migrar varios tenants independientes a una única organización de Automation Suite, consulta Resolución de conflictos de usuario.

para Windows

Para fusionar organizaciones en Automation Suite , ejecuta el siguiente comando:

./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>"

Nota:

• Asegúrate de añadir TrustServerCertificate=True tanto para las cadenas de conexión SQL de origen como de destino en la entrada.
• Si migras un tenant independiente a una organización de Automation Suite para todos los tenants, puedes ejecutar el comando una vez para todas las migraciones. Sin embargo, si migras varios tenants independientes a una organización de Automation Suite, debes ejecutar el comando por separado para cada tenant, ya que es posible que tengas que resolver los conflictos de usuario entre los tenants. El siguiente ejemplo muestra cómo ejecutar el comando por separado para cada tenant:

./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'

Para obtener instrucciones sobre cómo abordar los conflictos de usuario al migrar varios tenants de productos independientes a una única organización de Automation Suite, consulta Resolución de conflictos de usuario.

Fusionar expectativas

Usuarios

Nota:

Solo los usuarios que son originalmente de Orchestrator independiente tienen acceso a Orchestrator después de migrar a Automation Suite.

La siguiente tabla proporciona información sobre varios escenarios de migración y cómo afectan a los usuarios:

Condición	¿El usuario de origen tiene una dirección de correo electrónico?	¿El usuario de destino tiene una dirección de correo electrónico?	¿El correo electrónico del usuario de origen es el mismo que el del usuario de destino?	¿El nombre de usuario de origen es el mismo que el nombre de usuario de destino?	Resultado
1	✅	✅	❌	❌	El usuario de origen se mueve a la organización de destino; el usuario de la organización de destino tiene acceso a Orchestrator independiente.
2	✅	✅	❌	✅	El usuario de origen se mueve a la organización de destino; el usuario de la organización de destino tiene acceso a Orchestrator independiente. Después de la fusión, dos usuarios tienen el mismo nombre de usuario y deben utilizar la dirección de correo electrónico para iniciar sesión.
3	✅	✅	✅	✅ o ❌	El usuario de origen se fusiona con el usuario de destino; el usuario de destino tiene acceso a Orchestrator independiente.
4	❌	❌	N/D	❌	El usuario de origen se mueve a la organización de destino; el usuario de la organización de destino tiene acceso a Orchestrator independiente.
5	❌	❌	N/D	✅	El usuario de origen se fusiona con el usuario de destino; el usuario de destino tiene acceso a Orchestrator independiente.
6	✅	❌	N/D	❌	El usuario de origen se mueve a la organización de destino; el usuario de la organización de destino tiene acceso a Orchestrator independiente.
7	✅	❌	N/D	✅	Debes configurar manualmente la dirección de correo electrónico para el usuario de destino o eliminar el usuario de destino. Si configuras la dirección de correo electrónico, el usuario de origen se fusiona con el usuario de destino, y el usuario de destino tiene acceso a Orchestrator independiente. Si eliminas el usuario de destino, el usuario de origen se traslada a la organización de destino, y el usuario de la organización de destino tiene acceso a Orchestrator independiente.
8	❌	✅	N/D	❌	El usuario de origen se mueve a la organización de destino y el usuario de la organización de destino tiene acceso a Orchestrator independiente.
9	❌	✅	N/D	✅	Debes configurar la dirección de correo electrónico para que esté vacía para el usuario de destino o eliminar el usuario de destino. Si configuras la dirección de correo electrónico como vacía, el usuario de origen se fusiona con el usuario de destino, y el usuario de destino tiene acceso a Orchestrator independiente. Si eliminas el usuario de destino, el usuario de origen se traslada a la organización de destino, y el usuario de la organización de destino tiene acceso a Orchestrator independiente.

Usuarios de robots

Si los nombres de usuario del robot de origen y destino son los mismos, al usuario del robot de origen se le adjunta el ID de usuario y se mueve a la organización de destino.

Nombre de usuario del robot de origen	Nombre de usuario del robot de destino	Nombre de usuario del robot de origen movido
mismo Robot	mismo Robot	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

Grupos

Si los nombres de los grupos de robots de origen y destino son los mismos, al usuario del robot de origen se le añade una cadena y se mueve a la organización de destino.

Nombre del grupo de origen	Nombre del grupo de destino	Nombre de usuario del grupo de origen movido
mismoGrupo	mismoGrupo	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

Configuración

Si la configuración de origen y la configuración de destino tienen el mismo nombre, se utiliza el valor de configuración del destino.

Habilitar Insights después de fusionar organizaciones

Si migras Insights, inicia sesión en cada organización después de completar la fusión y habilita Insights para cada tenant que previamente tenía Insights habilitado en el entorno independiente (MSI).

Este paso es necesario porque la base de datos de Insights que Automation Suite utiliza después de la migración ya tiene Insights habilitado. Si omite este paso, Automation Suite puede entrar en un estado en el que Insights parece estar habilitado para un tenant, pero la plataforma no tiene registrada la instancia de Insights correspondiente.

Nota:

Habilita Insights en cada tenant antes de actualizar la cadena de conexión. Esto garantiza que Insights esté correctamente vinculado a la base de datos migrada y evita inconsistencias en la configuración.

Resolver conflictos de usuario

La migración de varios tenants independientes a una única organización de Automation Suite puede dar lugar a conflictos de usuarios. El siguiente ejemplo muestra un mensaje de error para un conflicto de este tipo:

[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)

Puedes resolver los conflictos de usuario de dos maneras:

• Escribe n para finalizar el proceso de fusión, luego elimina los usuarios con conflictos en la organización de Automation Suite y vuelve a ejecutar el comando de fusión. Al elegir esta opción, se pierde la información de usuario eliminada.

• Escribe y para continuar con el proceso de fusión. Al elegir esta opción, se reemplazan todos los ID de usuario de origen por los ID de usuario de destino. Si un producto que se ejecuta en Automation Suite, como Insights, tiene una referencia a un ID de usuario, se pierden los datos de cualquier usuario combinado del entorno independiente. Por ejemplo, supongamos dos usuarios:

  • un usuario con el nombre de usuario user1 y la dirección de correo electrónico [e-mail], de tenant1 en un entorno independiente.
  • otro usuario con el mismo nombre de usuario y dirección de correo electrónico, desde tenant2 en un entorno independiente.

  Si primero fusionas tenant1 con una organización en Automation Suite, no se produce ningún conflicto. Sin embargo, si luego fusionas tenant2 con la misma organización de Automation Suite, se produce un conflicto, ya que dos usuarios tienen la misma dirección de correo electrónico, [e-mail]. Si escribes y para continuar con el proceso de fusión, perderás los datos de usuario a los que el producto tiene una referencia para el usuario de tenant2.

Si la fusión de la organización falló

Si la fusión de la organización falló, compruebe los registros. Dependiendo de si se produjo un error en la migración de Identity u Orchestrator, siga estos pasos:

Migración de identidad fallida

Si la migración de identidad falló, puedes corregir el error y ejecutar de nuevo el comando de fusión de la organización. Esto revertiría todos los cambios, ya que hemos establecido una transacción para operaciones para Identity.

Migración de Orchestrator fallida

Si la migración de Orchestrator fallaba, la base de datos de Orchestrator se revertiría, pero la base de datos de Identity no. Como resultado, debes restaurar la copia de seguridad de la base de datos de identidad y reemplazar la cadena de conexión para usar la nueva base de datos. Después de corregir el error, ejecuta de nuevo el comando de fusión de la organización.

Si la migración de Orchestrator falló, siga los siguientes pasos:

1. Restaure la copia de seguridad de la base de datos de identidad.

   1. Abre el menú contextual para el directorio de la base de datos y selecciona Importar aplicación de nivel de datos.

      

   2. Seleccione el archivo de la base de datos de la copia de seguridad.

      

   3. Introduce el nombre de la base de datos de la copia de seguridad.

      

   4. Espera a que se complete el proceso.

      

2. Reemplaza la cadena de conexión de identidad.

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

3. Corrija el error y use la cadena de conexión de la nueva plataforma para volver a ejecutar el comando de fusión.