- Démarrage
- Meilleures pratiques
- Locataire
- À propos du contexte du locataire
- Recherche de ressources dans un locataire
- Gestion des Robots
- Connexion des Robots à Orchestrator
- Enregistrement des identifiants du Robot dans CyberArk
- Stockage des mots de passe d'Unattended Robot dans Azure Key Vault (lecture seule)
- Stockage des informations d'identification de l'Unattended Robot dans HashiCorp Vault (lecture seule)
- Suppression des sessions Unattended déconnectées et qui ne répondent pas
- Authentification du Robot
- Authentification du Robot avec les informations d'identification du client
- Authentification par carte à puce
- Gestion des dossiers
- Dossiers classiques vs dossiers modernes
- Migration de dossiers classiques vers des dossiers modernes
- Administration des dossiers modernes
- Espaces de travail personnels
- Gestion des espaces de travail personnels
- Attribution de rôles
- Gestion des rôles
- Rôles par défaut
- FAQ
- Permettre aux utilisateurs d'exécuter des automatisations personnelles
- Permettre aux utilisateurs d'exécuter des automatisations sur une infrastructure Unattended via des robots Unattended
- Configuration des comptes Robot pour exécuter des automatisations Unattended
- Audit
- Service de catalogue de ressources
- Robots Automation Suite
- Contexte des dossiers
- Automatisations
- Processus (Processes)
- Tâches (Jobs)
- Déclencheurs (Triggers)
- Journaux (Logs)
- Surveillance
- Files d'attente (Queues)
- Actifs
- Compartiments de stockage
- Test Suite - Orchestrator
- Intégrations
- Robots classiques
- Résolution des problèmes
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.
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.
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.
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.
- 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.
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.
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.
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.
Pour migrer les dossiers classiques vers les dossiers modernes d'un locataire :
É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.
- 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
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
- Pour chaque compte cible incorrect ou non défini, vous devez définir manuellement le compte :
- 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é.
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.
À 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 :
-
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.
-
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.
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.
-
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.
-
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.
É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.
Une fois la migration terminée, vous devez effectuer les étapes manuelles suivantes pour résoudre les problèmes de rétrocompatibilité :
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 :
- Redéfinissez les paramètres d'authentification du robot pour le locataire sur Hybride (Hybride).
- Activez tous les robots classiques.
- Activez les déclencheurs dans les dossiers classiques.
- Supprimez les dossiers modernes.
- Supprimez les nouveaux comptes robot.
- Recherchez ce qui a causé l’échec des automatisations dans la configuration des dossiers classiques et nettoyez éventuellement vos dossiers classiques.
- Exécutez à nouveau la migration.
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).
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.
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.
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.
- Vue d’ensemble du processus de migration
- Modifications apportées aux paramètres des locataires
- Prérequis
- Autorisations
- Limitation du volume
- Étape 1. Utilisation de l'assistant de migration moderne
- Préparation de la migration
- Utilisation de l'assistant
- Utilisation de l'assistant pour les utilisateurs assistés
- Utilisation de l'assistant pour les utilisateurs Unattended
- Démarrage de la migration
- Redémarrer ou réessayer la migration
- Étape 2. Configuration post-migration
- Revenir aux dossiers classiques
- Migration manuelle