Migration de dossiers classiques vers des dossiers modernes

Les dossiers modernes ont été introduits pour améliorer et simplifier l'orchestration des automatisations et offrent plusieurs avantages par rapport aux dossiers classiques.

Remarque : les dossiers classiques ne sont plus la norme pour la gestion des automatisations et ont été remplacés par des dossiers modernes, une alternative meilleure et plus riche en fonctionnalités. Pour cette raison, nous avons déjà supprimé l'option de création de nouveaux dossiers classiques et nous rendrons les dossiers classiques obsolètes à partir d'octobre 2022.

Pour vous aider dans la transition vers les dossiers modernes, vous pouvez utiliser l'assistant Migration moderne (Modern migration) pour recréer facilement votre hiérarchie de dossiers classiques et vos entités dans les dossiers modernes, en préservant toutes les dépendances.

Vue d’ensemble du processus de migration

Pour effectuer une conversion complète ou partielle de votre déploiement actuel afin d'utiliser des dossiers modernes, certaines entités doivent être redéployées tandis que d’autres doivent être entièrement recréées.

Voici un aperçu de ce que fait l'assistant de migration pendant et après la migration :

• Il recrée chaque dossier classique en tant que dossier moderne avec un nom au format Migrated <folder name>.
• Pour chaque environnement, il crée un sous-dossier correspondant dans le dossier moderne cible. S'il n'y a qu'un seul environnement, il ne crée aucun sous-dossier.
• Il redéploie chaque processus dans le dossier (ou sous-dossier) moderne qui correspond à son dossier ou environnement précédent.
• Il migre les ressources, les files d'attente et les déclencheurs de chaque dossier classique vers le dossier moderne correspondant.
• Migre chaque entité de Test Suite vers le sous-dossier moderne qui correspond à l'environnement de dossiers classique auquel elle appartenait auparavant.

• Il migre les robots et les comptes d'utilisateurs vers les dossiers modernes correspondants :

  • Il mappe chaque robot assisté (attended) classique à un compte d'utilisateur et configure chaque compte d'utilisateur avec des paramètres d'automatisation personnels (auparavant appelés paramètres de robot assisté (attended)) et l'accès aux dossiers et machines modernes correspondants nécessaires pour exécuter les automatisations assistées (attended) qu'il exécutait dans les dossiers classiques. Deux scénarios peuvent se produire en termes de rôles :

    • Si le compte d'utilisateur auquel un robot Attended classique est mappé n'a pas été affecté au locataire au moment du début de la migration, il est automatiquement inclus dans le locataire et le rôle au niveau du locataire Autoriser à être un utilisateur d'automatisation (Allow to be Automation User ) lui sera accordé.
    • Si le compte d'utilisateur auquel un Robot Attended classique est mappé a déjà été attribué au locataire, ses rôles ne changent pas, vous devez donc lui accorder manuellement le rôle au niveau du locataire Autoriser à être un utilisateur Automation . Cela empêche les automatisations de se briser.

  • Il mappe chaque robot non assisté (unattended) classique aux comptes robot (robot accounts) (recommandé), sauf configuration contraire, et configure chaque compte Robot avec accès aux dossiers et machines modernes correspondants nécessaires pour exécuter les automatisations exécutées par le robot non assisté (unattended) dans les dossiers classiques.

    Accorde le rôle au niveau du dossier Utilisateur d’automatisation (Automation User) aux comptes Robot existants qui sont mappés à des Robots non assistés (unattended) classiques.

    Les nouveaux comptes Robot générés automatiquement reçoivent le rôle au niveau du dossier Utilisateur de l'automatisation (Automation User) et le rôle au niveau du locataire Autoriser à être un utilisateur de l'automatisation (Allow to be Automation User).

• Certaines licences utilisateur qui incluent la fonctionnalité assistée (attended) peuvent être disponibles une fois la migration terminée. En effet, dans les dossiers modernes, chaque utilisateur n'a besoin que d'une seule licence utilisateur pour les automatisations personnelles (auparavant assistées (attended)). Si le même utilisateur avait plusieurs licences, il conserve la licence supérieure et la licence inférieure est libérée.

  Par exemple, si l'un des robots assistés (attended) de l'utilisateur a utilisé une licence assistée (attended) et un autre a utilisé une licence Citizen Developer, l'utilisateur conserve la licence Citizen Developer et la licence assistée (attended) est libérée.

  Important :

  Bien que l'assistant puisse considérablement simplifier le processus de migration pour vous, vous devez effectuer des tâches post-migration pour que vos automatisations puissent fonctionner correctement.

  Assurez-vous de disposer des connaissances requises et de prévoir du temps pour effectuer ces tâches avant de démarrer la migration.

Modifications apportées aux paramètres des locataires

Après avoir exécuté l'assistant Migration moderne (Modern migration), certains paramètres au niveau du locataire sont automatiquement modifiés. Ces modifications sont requises pour les dossiers modernes utilisés.

Les modifications suivantes s'appliquent une fois tous les dossiers classiques migrés avec succès :

• La connexion interactive (Interactive sign-in) est appliquée.

  Une fois la migration terminée, les utilisateurs doivent mettre à jour leurs paramètres de connexion UiPath Studio ou UiPath Assistant pour passer de l'utilisation d'une clé de machine à l'utilisation de la connexion interactive afin de pouvoir travailler dans des dossiers modernes.

• Les dossiers classiques et leurs entités sont toujours utilisables.

  Vous pouvez les conserver jusqu'à ce que la validation soit terminée, après quoi vous pouvez les supprimer.

• Les mappages compte-machine (Account-machine mappings) sont activés au niveau du locataire.

Prérequis

Autorisations

• Pour pouvoir exécuter correctement l'assistant Migration moderne (Modern migration), vous devez être un administrator de l'organisation (organization administrator).

• Pour pouvoir ouvrir l'assistant Migration moderne (Modern migration), vous avez besoin des autorisations suivantes :

  • Rôles : Afficher, Créer et Modifier
  • Paramètres : Afficher et Modifier
  • Utilisateurs : afficher, créer et modifier
  • Robots : Afficher, Créer, Modifier et Supprimer
  • Dossiers (Folders) : Créer et Modifier.

Limitation du volume

L'assistant Migration moderne (Modern migration) ne convient pas aux grands déploiements, qui nécessitent des outils et une stratégie de migration dédiés.

Nous vous recommandons de ne pas utiliser l'assistant de migration sur les dossiers contenant plus de 2 000 robots classiques. Cela peut entraîner des problèmes de performances et entraîner l’échec de la migration.

Étape 1. Utilisation de l'assistant de migration moderne

Préparation de la migration

Important :

Il est important que vous n'apportiez aucune modification de configuration à votre configuration de dossier classique tant que la migration n'est pas terminée.

Veuillez limiter les vérifications et les modifications préalables à la migration à celles décrites ci-dessous.

Problème connu

Une fois la migration démarrée, vous ne pouvez plus modifier les déclencheurs de file d'attente dans les dossiers classiques. En cas de problèmes nécessitant la modification d'un déclencheur de file d'attente, vous ne pourrez pas utiliser le déclencheur de file d'attente défectueux entre le début de la migration et le moment où elle se termine avec succès.

Inclusion et exclusion de dossiers

Avant de démarrer l'assistant, ajoutez-vous à tous les dossiers classiques que vous souhaitez migrer.

Les dossiers qui ne vous sont pas attribués ne sont pas migrés.

Inclusion et exclusion des robots classiques

Avant de démarrer l'assistant, vérifiez que tous les robots que vous souhaitez migrer sont ajoutés à un environnement.

Les robots classiques qui ne font partie d'aucun environnement sont présumés ne pas être utilisés et ne sont pas ciblés pour la migration.

Important : si un robot n'est pas migré, les valeurs du robot d'actif et les planifications de processus de ce robot ne sont pas non plus migrées, à moins qu'elles ne soient également utilisées par un autre robot qui est migré.

Empêcher l’élévation des autorisations

Après la migration, les utilisateurs assistés (attended) et les comptes Robot se voient automatiquement attribuer le rôle Utilisateurs de l'automatisation (Automation Users) au niveau du dossier (dans le dossier correspondant auquel ils sont attribués au moment de la migration). Si vous avez personnalisé les rôles de niveau de service ou la règle d'attribution de licence pour ce groupe, nous vous recommandons de supprimer tous les rôles élevés ou les licences supplémentaires de ce groupe avant de poursuivre la migration.

Vérifier qu'aucune tâche n'est en cours d'exécution

Il est important de s'assurer qu'avant de démarrer la migration, aucune tâche n'est en cours d'exécution.

Si vous avez des déclencheurs qui démarreraient une tâche pendant la migration, nous vous recommandons de les désactiver et de les réactiver une fois la migration terminée.

Avant de commencer la migration, vous pouvez vérifier le statut de la tâche à partir de la page Dossier (Folder) > Surveillance (Monitoring) de chaque dossier classique à migrer.

Important : lorsque la migration démarre, toutes les tâches qui ne sont pas dans un état final sont terminées. Si une tâche terminée n'atteint pas le statut Arrêté au moment où la migration se termine, la migration échoue avec une erreur associée.

Utilisation de l'assistant

Pour migrer les dossiers classiques vers les dossiers modernes d'un locataire :

1. Accédez à Locataire (Tenant) > Paramètres (Settings).

   La page Paramètres (Settings) s'ouvre sur l'onglet Général (General).

2. Dans la section Dossiers classiques (Classic Folders), cliquez sur Démarrer la migration (Start migration).

   L'assistant de Migration moderne (Modern migration) s'ouvre à l'étape Mise en route (Getting started).

3. Passez en revue les informations et, sous la section Résumé (Summary), cliquez sur Copier le résumé ci-dessus (Copy the summary above) et enregistrez ces informations pour vos dossiers.

   Le résumé répertorie les types et le nombre d'entités incluses pour la migration.

   • Seuls les dossiers classiques auxquels vous avez accès sont ciblés pour la migration. Les dossiers dans lesquels vous n'avez pas été ajouté ne sont pas migrés.
   • Les robots classiques qui ne sont pas ajoutés à un environnement sont supposés ne pas être utilisés et ne sont pas ciblés pour la migration.
4. Lorsque vous êtes prêt, cliquez sur Suivant (Next) pour passer à l'étape Utilisateurs assistés (Attended users).

Utilisation de l'assistant pour les utilisateurs assistés

Étant donné que dans les dossiers modernes, nous gérons différemment la relation entre les utilisateurs et les robots et que nous créons automatiquement le robot de l'utilisateur, vous devez mapper chaque robot assisté (attended) classique au compte de l'utilisateur qui l'utilise.

La page Utilisateurs assistés (Attended users) répertorie tous les robots assistés (attended) trouvés dans les dossiers classiques ciblés et leurs détails.

Dans la colonne Compte utilisateur cible (Target user account), pour chaque robot assisté (attended) trouvé, vous devez sélectionner le compte de l'utilisateur qui utilise le Robot assisté (attended) en fonction des informations des autres colonnes.

Important :

• Si vous n’avez pas défini de compte pour un UiPath Robot, ce Robot ne sera pas migré. Les processus associés à ce Robot ne pourront plus s’exécuter.
• Si le nom d’utilisateur d’un Attended Robot concerné par la migration ne contient pas le caractère @, la migration échouera. Pour résoudre ce problème, les utilisateurs locaux doivent être convertis en utilisateurs d’annuaire. Ce processus est automatique au cours de l’installation ou de la mise à niveau, à condition que les utilisateurs impactés se connectent à Orchestrator au moins une fois. Si ce n’est pas le cas, vous pouvez utiliser ce script afin de les convertir :

  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] = 0

1. Pour chaque compte cible incorrect ou non défini, vous devez définir manuellement le compte :
   1. Cliquez sur Affecter (Assign) dans la colonne Compte utilisateur cible (Cible user account).
   2. Dans le champ Rechercher un utilisateur (Search for a user), commencez à taper pour rechercher, puis sélectionnez l’utilisateur dans les résultats.
   3. Cliquez sur Enregistrer (Save) en bas à droite pour définir le compte cible et revenir à la page précédente.
      Pour plus d'informations sur le mappage des robots aux comptes d'utilisateurs, consultez Règles de mappage pour les robots Attended.
2. Lorsque vous êtes prêt, cliquez sur Suivant (Next) pour passer à l'étape Utilisateurs Unattended.

Règles de mappage pour les robots assistés (attended)

Voici les règles que nous utilisons pour valider votre sélection lorsque vous essayez de mapper les robots assistés (attended) classiques à leurs utilisateurs.

• Les Robots portant le même nom d'utilisateur (Username) (affiché sur la page Utilisateurs assistés (Attended users)) doivent être mappés sur le même compte d'utilisateur cible.

  De même, les robots avec une valeur de Nom d'utilisateur (Username) différente doivent être mappés vers différents comptes d'utilisateurs cibles.

• Si vous disposez d'une intégration avec un répertoire d'utilisateurs externe, lors du mappage des robots aux comptes d'utilisateurs du répertoire, la valeur Nom d'utilisateur (Username) du robot doit correspondre à l'adresse e-mail ou au nom d'utilisateur du compte d'utilisateur cible.

  Vous pouvez afficher l'adresse e-mail et le nom d'utilisateur d'un compte d'utilisateur sur la page Locataire (Tenant) > Gérer l'accès (Manage Access) > Attribuer les rôles (Assign Roles).

• Lors du mappage des robots aux comptes d'utilisateurs locaux :

  • Si la connexion interactive est appliquée pour le locataire, vous êtes autorisé à mapper n'importe quel robot classique à n'importe quel utilisateur.
  • Si le paramètre d'authentification du robot au niveau du locataire est défini sur Hybride (Hybrid) et que l'automatisation personnelle (personal automation) est activée sur le compte d'utilisateur cible, la valeur Nom d'utilisateur (Username) du robot doit correspondre à la valeur Domaine\Nom d'utilisateur (Domain\Username) de l'utilisateur, comme indiqué sur la page Configuration personnalisée des automatisations (Personal automations setup) de l'utilisateur.
  • Si le paramètre d'authentification du robot au niveau du locataire est défini sur Hybride (Hybrid), que l'automatisation personnelle (personal automation) est activée pour le compte d'utilisateur cible et que l'option Hériter de la licence du groupe de l'utilisateur (Inherit license from user's group) est définie dans la page Configuration personnalisée des automatisations (Personal automations setup) de l'utilisateur, l'utilisateur dispose d'un nom d'utilisateur d'automatisation personnelle généré qui n'est pas affiché, mais doit correspondre au nom d'utilisateur (Username) du robot, sinon le mappage ne sera pas autorisé.

Attention : Lorsque plusieurs robots assistés (attended) sont mappés sur le même compte cible, le nom d'utilisateur du robot dans le dossier moderne sera l'un des noms d'utilisateur des robots migrés, de manière aléatoire. Cela peut entraîner des problèmes d'accès lors de la tentative de connexion aux machines.

Utilisation de l'assistant pour les utilisateurs Unattended

Vous devez mapper les robots non assistés (unattended) à des comptes de robot nouveaux ou existants. Les comptes Robot (Robot accounts) sont conçus pour exécuter des automatisations non assistées (unattended) et nous vous recommandons de les utiliser à la place des comptes utilisateur.

La page Utilisateurs non assistés (Unattended users) répertorie tous les robots non assistés (unattended) trouvés dans les dossiers classiques.

1. En haut à droite, sous Action en bloc (Bulk Actions), sélectionnez la façon dont vous souhaitez que l'assistant gère les robots non assistés (unattended) classiques qui n'ont pas de compte robot cible mappé :

   • Recommandé: sélectionnez Générer automatiquement des comptes robot ( Automatically generate robot accounts ) si vous souhaitez migrer tous les robots Unattended répertoriés et autoriser l'assistant à créer de nouveaux comptes robot pour eux. Détails...

   • Non recommandé : sélectionnez Ignorer (Ignore them) si vous souhaitez migrer uniquement certains des robots classiques trouvés.

2. Examinez la colonne Compte robot cible (Target robot account) pour vous assurer que tous les mappages existants sont corrects.
   • Si vous avez sélectionné Générer automatiquement des comptes robot (Automatically generate robot accounts), ignorez cette étape.

   • Si vous avez sélectionné Ignorer (Ignore them), vous devez mapper manuellement uniquement les robots non assistés (unattended) classiques que vous souhaitez migrer vers un compte robot cible en cliquant sur Attribuer (Assign) dans la colonne Compte robot cible (Target robot account).Vous pouvez également créer de nouveaux comptes Robot à ce stade, si nécessaire.

     Attention : Les robots classiques qui ne sont pas mappés à un compte robot cible ne sont pas migrés vers les dossiers modernes.
3. Lorsque vous êtes prêt, cliquez sur Suivant (Next) pour passer à l'étape finale.

   La page Terminer (Finishing) s'ouvre.

À quoi sert Générer automatiquement des comptes robot

Lorsque cette option est sélectionnée, au moment de la migration, l'assistant tente de mapper automatiquement chaque robot classique comme suit :

1. Il recherche un compte utilisateur ou robot existant avec un nom d'utilisateur non assisté (unattended) correspondant.

   S'il est trouvé, il mappe le Robot non assisté (unattended) à ce compte existant. Si aucune correspondance n'est trouvée, il passe à l'étape suivante.

2. Il recherche d'autres robots non assistés (unattended) classiques avec le même nom d'utilisateur (Username) qui ont déjà été mappés à un compte.

   S'il est trouvé, il mappe ce robot sur le même compte. Si aucune correspondance n'est trouvée, un nouveau compte de robot est créé pour le robot classique.

Les nouveaux comptes de robot créés par l'assistant ont un nom au format Migrated folderName_robotName.

Règles de mappage pour les robots Unattended

Les règles suivantes s'appliquent lorsque vous essayez de mapper des robots non assistés (unattended) classiques à des comptes de robot ou d'utilisateur.

Si vous choisissez de mapper manuellement les robots aux comptes de robot (non recommandé) au lieu de permettre à l'assistant de créer de nouveaux comptes de robot, vous devez suivre ces règles.

1. Recherche un compte Robot existant qui utilise les mêmes informations d'identification que le Robot non assisté (unattended) classique.

   Si une correspondance est trouvée, l'assistant vous demande de mapper le robot non assisté (unattended) classique au compte de robot existant. Sinon, il passe à l'étape suivante.

2. Recherche un autre robot non assisté (unattended) classique possédant les mêmes informations d'identification que le robot classique à mapper. S'il est trouvé et déjà mappé à un compte cible, l'assistant vous oblige à mapper le robot actuel au même compte cible.

Important : si vous mappez plusieurs robots avec des informations d'identification différentes au même compte de robot, après la migration, le compte de robot utilisera les informations d'identification de l'un des robots classiques de manière aléatoire. Il existe un risque que ces informations d'identification ne fonctionnent pas sur toutes les machines cibles et, après la migration, puissent entraîner un échec de la connexion aux machines.

Démarrage de la migration

1. Lorsque vous êtes prêt, cliquez sur Exécuter la migration (Execute migration) pour démarrer le processus.

   Une boîte de dialogue de confirmation s'ouvre.

2. Cliquez sur Exécuter (Execute) pour lancer la migration.

   La page s'actualise pour afficher la progression de la migration pour chaque dossier.

   Remarque : En cas d'échec, consultez les messages d'erreur affichés. Après avoir résolu le problème dans chaque dossier classique, vous pouvez redémarrer ou réessayer la migration.
3. Cliquez sur Fermer (Close) pour quitter l'assistant.

Étapes suivantes : Si la migration a réussi, passez à Configuration post-migration (Post-migration setup).

Résolution des problèmes

Les tâches ne sont pas encore dans leur état définitif

Lorsque la migration démarre, l'assistant arrête automatiquement toutes les tâches en cours pour qu'il puisse s'exécuter. Si une tâche terminée garde le statut En fin d'exécution (Terminating) et n'atteint pas le statut Arrêté (Stopped) au moment où la migration est terminée, la migration échoue.

Si cela se produit, nous définissons automatiquement les Exécutions en cours d'achèvement (Terminating Jobs) sur le statut Arrêté (Stopped) après 24 heures. À ce stade, vous pouvez redémarrer la migration.

Redémarrer ou réessayer la migration

Si la migration a échoué pour certains ou tous les dossiers, vous pouvez réessayer après avoir résolu les erreurs de configuration qui ont causé des erreurs.

Pour redémarrer ou réessayer une migration qui a échoué :

1. Examinez les messages d'erreur pour chaque dossier, puis vérifiez la configuration de dossier classique pour résoudre les erreurs.
2. Après avoir résolu toutes les erreurs, accédez à Locataire (Tenant) > Paramètres (Settings) > Commencer la migration (Start migration).

   L'assistant s'ouvre sur la dernière page.

3. Pour réexécuter la migration :

   • Si vous souhaitez relancer la migration avec vos paramètres précédents, cliquez sur l'icône Réessayer (Retry) à droite de la ligne d'un dossier dont la migration a échoué. Cette option redémarre la migration telle qu'elle était précédemment configurée, sans vous donner la possibilité de modifier les mappages.

     (Facultatif) Cochez la case Nettoyer avant de réessayer (Clean-up before retrying) si vous souhaitez supprimer les données partiellement migrées du dossier pour lequel la migration a échoué. Si vous ne cochez pas cette case, la migration est effectuée uniquement pour les entités qui n'ont pas pu être migrées auparavant.

     Conseil: si la migration échoue avec une erreur pour les files d'attente de données de test ou les éléments de la file d'attente de données de test, cochez la case Nettoyer avant de réessayer avant de redémarrer la migration. Cela empêche les éléments de file d'attente de données de test en double dans les dossiers modernes.

   • Si vous souhaitez rétablir les mappages pour les robots Attended et Unattended, cliquez sur Redémarrer (Restart) en bas à droite. Cette option vous ramène à la première étape de l'assistant. Suivez les instructions de la section Utilisation de l'assistant (Using the wizard) pour terminer la configuration une fois de plus.

Étape 2. Configuration post-migration

Une fois la migration terminée, vous devez effectuer les étapes manuelles suivantes pour résoudre les problèmes de rétrocompatibilité :

1. Recompilez les workflows existants qui utilisent les activités Orchestrator ou effectuent des appels HTTP directs vers l'API Orchestrator pour utiliser la version 2019.10 ou une version ultérieure pour UiPath.System.Activities.
2. Réenregistrez toutes les autres entités existantes, telles que les catalogues d'actions, dans le dossier moderne correspondant.

   Vous n'avez pas besoin de réenregistrer les robots assistés (attended) et non assistés (unattended) (ils sont automatiquement enregistrés pour les utilisateurs ayant accès au nouveau dossier moderne) et les environnements (ils ne sont pas utilisés dans le contexte d'un dossier moderne).

3. Dissociez les ensembles de tests des dossiers classiques en les supprimant des projets Test Manager correspondants.
   
   

   

   
   
4. Liez à nouveau les ensembles de tests en sélectionnant les ensembles de tests dont la description est [Migrated] .
   
   

   

   
   
5. Mettez à jour le processus de dossier classique utilisé dans les applications UiPath (UiPath Apps) pour utiliser le processus de dossier moderne récemment migré.
6. Mettez à jour tous les workflows qui :
   • ont une dépendance par rapport à l'ancien chemin de dossier
   • utilisent l’activité Démarrer la tâche (Start Job). Dans les dossiers classiques, là où vous aviez processName_envName, vous devez maintenant passer à processName pour les dossiers modernes.
7. Si ce n'est déjà fait, activez la connexion interactive pour le locataire. Ceci est obligatoire pour travailler dans des dossiers modernes.
8. Exécutez les processus non assistés (unattended) à partir d'Orchestrator à l'aide de Démarrer la tâche (Start Job) pour les tester dans une configuration moderne.
   Remarque : Prévoyez 10 minutes après la fin de la migration pour que l'assistant désactive les robots des dossiers classiques migrés. Ceci est nécessaire pour que les licences soient publiées et puissent être utilisées dans des dossiers modernes.
9. Mettez à niveau les stations de travail des utilisateurs finaux pour qu'elles utilisent un Robot UiPath de version 2019.10 ou ultérieure.
10. Supprimez les dossiers classiques désormais inutilisés.

Revenir aux dossiers classiques

Si vous avez exécuté l'assistant de migration, mais que vos automatisations ne fonctionnent pas correctement dans les dossiers modernes, vous pouvez réactiver temporairement la configuration de vos dossiers classiques afin de pouvoir continuer à exécuter des automatisations jusqu'à ce que vous puissiez résoudre les problèmes de migration et réussir à passer aux dossiers modernes.

Pour revenir temporairement à l'utilisation des dossiers classiques après l'exécution de la migration :

1. Redéfinissez les paramètres d'authentification du robot pour le locataire sur Hybride (Hybride).
2. Activez tous les robots classiques.
3. Activez les déclencheurs dans les dossiers classiques.
4. Supprimez les dossiers modernes.
5. Supprimez les nouveaux comptes robot.
6. Recherchez ce qui a causé l’échec des automatisations dans la configuration des dossiers classiques et nettoyez éventuellement vos dossiers classiques.
7. Exécutez à nouveau la migration.

Migration manuelle

Pour tirer parti des fonctionnalités fournies par les dossiers modernes, vous devez recompiler les workflows existants qui utilisent des activités Orchestrator ou qui effectuent des appels HTTP directs à l'API Orchestrator à l'aide de UiPath.System.Activities v19.10.1 ou une version supérieure. Vous devez également réenregistrer toutes les autres entités existantes dans une structure de dossiers modernes, à l'exception des éléments suivants : Robots (car ils sont automatiquement enregistrés pour les utilisateurs ayant accès au nouveau dossier moderne) et Environnements (Environments) (car ils ne sont pas utilisés dans le contexte d'un dossier moderne).

Important :

La mise à niveau de vos entités existantes vers le modèle moderne supprime toute rétrocompatibilité. Les workflows recompilés ne sont exécutables que par des Robots version 2019.10 et ultérieure.

Migration vers des dossiers modernes

Pour effectuer une conversion complète ou partielle de votre déploiement actuel afin d'utiliser des dossiers modernes, certaines entités doivent être redéployées tandis que d’autres doivent être entièrement recréées. Un aperçu général du processus de migration peut être conçu comme suit :

• Chaque environnement devient un sous-dossier distinct ou, autrement, son propre dossier de premier niveau si vous souhaitez séparer entièrement les utilisateurs et les processus à l'intérieur.

• Le workflow de chaque paquet doit être recompilé à l'aide des activités en cours, puis republié ou téléchargé dans Orchestrator.

• En utilisant les paquets récemment compilés, chaque processus doit être redéployé dans le dossier (ou sous-dossier) qui correspond à son environnement précédent.

• Chaque utilisateur doit être ajouté à un ou plusieurs dossiers correspondant aux processus auxquels il doit accéder.

Cette migration peut être effectuée sans interrompre l’Utilisateur. L’administrateur Orchestrator crée et ajoute toute la structure du dossier moderne et les entités nécessaires, tandis que les utilisateurs continuent à utiliser les entités existantes dans les dossiers classiques où elles sont assignées. Pendant ce temps, vous pouvez créer deux Robots avec le même domain\username, l’un dans un dossier classique et l’autre dans un dossier moderne ; l’utilisateur ne pourra voir et exécuter que les processus classiques mis à leur disposition. Lorsque le Robot classique est supprimé, le Robot moderne prend le relais et exécute les versions modernes nouvellement créées et ajoutées de ces mêmes processus, sans modifier l’expérience de l’utilisateur.

Important :

Si un Robot classique existe avec le même domain/username qu'un utilisateur dans un dossier moderne, l'utilisateur n'aura accès qu'au Robot classique et aux processus associés. Pour que l'Attended Robot fonctionne dans un contexte moderne, le Robot flottant classique doit être désactivé. Une fois la migration testée et approuvée avec succès, le Robot classique peut être supprimé en toute sécurité.

Migration assistée à l’aide de l'Orchestrator Manager

Pour simplifier le processus de migration vers les dossiers modernes, vous pouvez utiliser le gestionnaire d’orchestration UiPath. Il s’agit d’un projet Studio qui utilise l’API Orchestrator pour manipuler des entités basées sur des classeurs Microsoft Excel. Pour obtenir des instructions sur la façon de l’utiliser pour la migration, consultez la documentation du produit.