Étape 4 : Fusion des organisations dans Automation Suite

Entrée de l'outil de migration

Lors de l'exécution de l'outil UiPath.OrganizationMigrationApp, vous devez fournir les détails suivants :

• La liste des ID d'organisation pour le produit autonome
• La liste des ID d'organisation pour Automation Suite

Pour plus de détails, consultez Paramètres de l’outil de migration.

Remarque :

Veillez à utiliser les mêmes ID d’organisation que ceux identifiés à l’Étape 1 : Déplacement des données d’organisation depuis une version autonome d’Identity vers Automation Suite.

pour Linux

Remarque :

Assurez-vous de suivre les instructions d'échappement générales de l'outil Shell de votre choix. Par exemple, dans Bash, vous devez ajouter \ avant les caractères spéciaux.

Pour fusionner des organisations dans Automation Suite , exécutez la commande suivante :

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

Remarque :

• Assurez-vous d’ajouter TrustServerCertificate=True pour les connexions SQL source et de destination dans l’entrée.
• Si vous devez fusionner plusieurs paires d’organisation, veillez à ce que la séquence d’ID d’organisation du produit autonome corresponde à la séquence d’ID d’organisation d’Automation Suite.
• Si vous migrez un locataire autonome vers une organisation Automation Suite pour tous les locataires, vous pouvez exécuter la commande une fois pour toutes les migrations. Cependant, si vous migrez plusieurs locataires autonomes vers une seule organisation Automation Suite, vous devrez peut-être exécuter la commande séparément pour chaque locataire, car vous devrez peut-être résoudre les conflits utilisateur entre les locataires. L'exemple suivant montre comment exécuter la commande séparément pour chaque locataire : affectation

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

Pour obtenir des instructions sur la résolution des conflits d'utilisateurs lors de la migration de plusieurs locataires autonomes vers une seule organisation Automation Suite, consultez Résoudre les conflits utilisateur.

pour Windows

Pour fusionner des organisations dans Automation Suite , exécutez la commande suivante :

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

Remarque :

• Assurez-vous d’ajouter TrustServerCertificate=True pour les chaînes de connexion SQL source et de destination dans l’entrée.
• Si vous migrez un locataire autonome vers une organisation Automation Suite pour tous les locataires, vous pouvez exécuter la commande une fois pour toutes les migrations. Cependant, si vous migrez plusieurs locataires autonomes vers une seule organisation Automation Suite, vous devrez peut-être exécuter la commande séparément pour chaque locataire, car vous devrez peut-être résoudre les conflits utilisateur entre les locataires. L'exemple suivant montre comment exécuter la commande séparément pour chaque locataire : affectation

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

Pour obtenir des instructions sur la résolution des conflits d’utilisateurs lors de la migration de plusieurs locataires de produits autonomes vers une seule organisation Automation Suite, consultez la section Résoudre les conflits d’utilisateurs.

Fusionner les attentes

Utilisateurs

Remarque :

Seuls les utilisateurs qui sont à l'origine d'une installation autonome d'Orchestrator ont accès à Orchestrator après leur migration vers Automation Suite.

La table suivante donne des informations sur plusieurs scénarios de migration et sur leur impact sur les utilisateurs :

Condition	L'utilisateur source a-t-il une adresse e-mail ?	L'utilisateur cible dispose-t-il d'une adresse e-mail ?	L’e-mail de l’utilisateur source est-il le même que celui de l’utilisateur cible ?	Le nom d’utilisateur source est-il le même que le nom d’utilisateur cible ?	Résultat
1	✅	✅	❌	❌	L'utilisateur source est déplacé vers l'organisation cible ; l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.
2	✅	✅	❌	✅	L'utilisateur source est déplacé vers l'organisation cible ; l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator. Après la fusion, deux utilisateurs ont le même nom d'utilisateur et doivent utiliser l'adresse e-mail pour se connecter.
3	✅	✅	✅	✅ ou ❌	L'utilisateur source est fusionné avec l'utilisateur cible ; l'utilisateur cible a accès à l'installation autonome d'Orchestrator.
4	❌	❌	S/O	❌	L'utilisateur source est déplacé vers l'organisation cible ; l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.
5	❌	❌	S/O	✅	L'utilisateur source est fusionné avec l'utilisateur cible ; l'utilisateur cible a accès à l'installation autonome d'Orchestrator.
6	✅	❌	S/O	❌	L'utilisateur source est déplacé vers l'organisation cible ; l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.
7	✅	❌	S/O	✅	Vous devez configurer manuellement l'adresse e-mail pour l'utilisateur cible ou supprimer l'utilisateur cible. Si vous configurez l'adresse e-mail, l'utilisateur source est fusionné avec l'utilisateur cible et l'utilisateur cible a accès à l'installation autonome d'Orchestrator. Si vous supprimez l'utilisateur cible, l'utilisateur source est déplacé vers l'organisation cible et l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.
8	❌	✅	S/O	❌	L'utilisateur source est déplacé vers l'organisation cible et l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.
9	❌	✅	S/O	✅	Vous devez configurer l'adresse e-mail pour qu'elle soit vide pour l'utilisateur cible ou supprimer l'utilisateur cible. Si vous configurez l'adresse e-mail comme vide, l'utilisateur source est fusionné avec l'utilisateur cible et l'utilisateur cible a accès à l'installation autonome d'Orchestrator. Si vous supprimez l'utilisateur cible, l'utilisateur source est déplacé vers l'organisation cible et l'utilisateur de l'organisation cible a accès à l'installation autonome d'Orchestrator.

Utilisateurs de robots

Si les noms d'utilisateur des Robots source et cible sont les mêmes, l'utilisateur du Robot source se voit ajouter l'ID utilisateur et est déplacé vers l'organisation cible.

Développer la table

Nom d'utilisateur du robot source	Nom d'utilisateur du robot cible	Nom d'utilisateur du robot source déplacé
mêmeRobot	mêmeRobot	sameRobot_47a26d4a-2180-4fdd-8e1e-2379300a1162

Groupes

Si les noms de groupe du robot source et cible sont les mêmes, l'utilisateur du robot source se voit ajouter une chaîne et est déplacé vers l'organisation cible.

Développer la table

Nom du groupe source	Nom du groupe cible	Nom d'utilisateur du groupe source déplacé
MêmeGroupe	MêmeGroupe	sameGroup_db39a5c6-f73c-4011-b40e-4ea620fe3d01

Paramètres

Si les paramètres source et les paramètres cible ont le même nom, la valeur de paramètre de la cible est utilisée.

Activation d’Insights après la fusion des organisations

Si vous migrez Insights, connectez-vous à chaque organisation après avoir terminé la fusion et activez Insights pour chaque locataire pour lequel Insights était auparavant activé dans l'environnement autonome.

Cette étape est requise car la base de données Insights utilisée par Automation Suite après la migration a déjà activé Insights. Si vous ignorez cette étape, Automation Suite peut entrer dans un état où Insights semble être activé pour un locataire, mais la plate-forme ne dispose pas de l'instance Insights correspondante enregistrée.

Remarque :

Activez Insights dans chaque locataire avant de mettre à jour la chaîne de connexion. Cela permet de s'assurer qu'Insights est correctement lié à la base de données migrée et d'éviter les incohérences de configuration.

Résolution des conflits d'utilisateurs

La migration de plusieurs locataires autonomes vers une seule organisation Automation Suite peut entraîner des conflits d'utilisateurs. L’exemple suivant montre un message d’erreur pour un tel conflit :

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

Vous pouvez résoudre les conflits d'utilisateurs de deux manières :

• Tapez n pour mettre fin au processus de fusion, puis supprimez les utilisateurs en conflit dans l'organisation Automation Suite et réexécutez la commande de fusion. En choisissant cette option, vous perdez les informations utilisateur supprimées.
• Tapez y pour poursuivre le processus de fusion. En choisissant cette option, vous remplacez tous les ID d'utilisateurs source par des ID d'utilisateurs cibles. Si un produit exécuté dans Automation Suite, tel qu'Insights, a une référence à un ID utilisateur, vous perdez les données pour tout utilisateur fusionné à partir de l'environnement autonome. Par exemple, imaginons deux utilisateurs :
  • un utilisateur avec le nom d'utilisateur user1 et l'adresse e-mail [e-mail], à partir de tenant1 dans un environnement autonome.
  • une autre utilisation avec le même nom d'utilisateur et la même adresse e-mail, à partir de tenant2 dans un environnement autonome.

Si vous fusionnez d'abord tenant1 à une organisation dans Automation Suite, aucun conflit ne se produit. Cependant, si vous fusionnez ensuite tenant2 avec la même organisation Automation Suite, un conflit se produit car deux utilisateurs ont la même adresse e-mail, [e-mail]. Si vous saisissez y pour poursuivre le processus de fusion, vous perdez les données utilisateur vers lesquelles le produit a une référence pour l'utilisateur à partir de tenant2.

En cas d'échec de la fusion de l'organisation

Si la fusion des organisations a échoué, consultez les journaux. Selon que la migration d'Identity ou Orchestrator a échoué, procédez comme suit :

Échec de la migration de l'identité

Si la migration d'identité a échoué, vous pouvez simplement corriger l'erreur et exécuter à nouveau la commande de fusion d'organisation. Cela annulerait toutes les modifications puisque nous avons défini une transaction pour les opérations pour l’identité.

Échec de la migration d'Orchestrator

Si la migration Orchestrator échouait, la base de données Orchestrator était restaurée, mais pas la base de données Identité (Identity). Par conséquent, vous devez restaurer la sauvegarde de la base de données Identité (Identity) et remplacer la chaîne de connexion pour utiliser la nouvelle base de données. Après avoir corrigé l'erreur, exécutez à nouveau la commande de fusion d'organisation.

Si la migration d'Orchestrator a échoué, procédez comme suit :

1. Restaurez la sauvegarde de la base de données Identité (Identity).

   1. Cliquez avec le bouton droit sur le répertoire de la base de données et sélectionnez Importer l'application de niveau Données.

      

   2. Sélectionnez le fichier de la base de données de sauvegarde.

      

   3. Saisissez le nom de la base de données de sauvegarde.

      

   4. Attendez que le processus se termine.

      

2. Remplacez la chaîne de connexion d'identité.

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

3. Corrigez l'erreur et utilisez la nouvelle chaîne de connexion de la plate-forme pour exécuter à nouveau la commande de fusion.