Déploiement d'automatisations unattended

Déploiement de Unattended Robots - Community License

Les robots non assistés sont utilisés pour automatiser les tâches qui ne nécessitent pas de supervision humaine ; ils s'exécutent généralement dans des environnements virtuels sur des machines dédiées, et les automatisations sont contrôlées depuis Orchestrator.

Une automatisation non assistée peut être démarrée manuellement à partir d'Orchestrator en cas de besoin, mais peut également être planifiée si la tâche doit commencer à un intervalle spécifique (quotidien, horaire, hebdomadaire) ou à une heure et une date spécifiques (fin de la semaine).

This document guides you through the process of running your first unattended automation using the Community licensed version of UiPath^® , starting with building the automation, setting up the environment, and running the unattended process.

Pour exécuter une automatisation non assistée, il faut suivre les étapes suivantes :

1. Création de l'automatisation et publication dans Orchestrator

Pour donner un exemple concret, supposons que nous devions faire une sauvegarde des fichiers journalisations sur un serveur tous les jours à 9 heures. Pour cela, nous devons copier le fichier journalisation de ce jour dans un autre dossier. Dans cet exemple, nous copions un fichier appelé « Journalisations.txt » ("Logs.txt") du dossier « Journalisations » ("Logs") vers le dossier « Anciennes journalisations » ("Old Logs"), en écrasant la sauvegarde à chaque fois.

1. Créez un nouveau processus, ajoutez l'activité Copier le fichier, configurez les champs/chemins d'accès aux fichiers et sélectionnez l'option Écraser afin que le fichier nouvellement copié puisse remplacer le fichier précédent chaque jour.

2. Publiez le processus à Orchestrator.

3. Cliquez sur le bouton Publier à droite sur le ruban Studio,

4. Dans l'onglet Publier les propriétés, entrez un nom pour le package.

5. Dans l'onglet Publier les options, pour l'option Publier vers, sélectionnez Flux des processus des locataires Orchestrator, l’emplacement où les Unattended Robots peuvent accéder à l’automatisation.

6. Click Publish.

   For more information, see About Publishing Automation Projects in the Studio Guide.

7. Dans Orchestrator, créez le processus que le Unattended Robot utilise pour exécuter l’automatisation.

8. Accédez à votre instance Automation Cloud à l'adresse https://cloud.uipath.com, et sélectionnez votre locataire Orchestrator.

9. Dans Orchestrator, sélectionnez le Dossier Partagé > Processus puis cliquez sur le bouton Ajouter sur le côté droit pour ouvrir la page Ajouter processus.

10. Sélectionnez le package et cliquez sur Créer pour ajouter le processus au dossier partagé.

    Remarque :

    Gardez à l’esprit que vous travaillez avec deux entités dans ce processus. La première entité c'est vous, le développeur qui crée et publie le processus. Le second est l'utilisateur non assisté qui exécute l’automatisation et le Robot sur la Unattended machine.

2. Configurez la machine Windows pour exécuter le Unattended Robot

Set up a Windows machine on which to run the unattended robot, ideally this would be a cloud virtual machine that matches the Hardware and Software Requirements. Make sure that the screen saver is disabled on the Windows machine.

For example, you can host your virtual machine in Azure. For details on how to set up a Windows virtual machine in Azure, see Windows VMs Overview.

D’autres environnements tels qu’AWS, VMware ou Citrix sont également pris en charge s’ils correspondent aux Exigences en matière de matériel et de logiciels.

3. Créez le Unattended Robot dans Orchestrator

Le Unattended Robot a deux composantes, l'utilisateur du robot et la machine sur laquelle il fonctionne. L'utilisateur du Robot est l'identité du Robot qui fournit les autorisations et est utilisé pour déclencher des tâches vers le Robot, tandis que la Machine est celle qui exécute l'automatisation.

Les modèles de machine offrent un moyen plus facile de déployer des machines, car une seule clé de machine peut être utilisée par plusieurs robots pour se connecter à Orchestrator.

1. Créez l’utilisateur du Robot.

   • Depuis Automation Cloud, accédez à Admin > Utilisateurs et groupes > Inviter les utilisateurs pour inviter l'utilisateur à votre Organization afin de créer un Unattended Robot pour elle.Une adresse e-mail factice peut être utilisée pour cette étape.

2. Ajoutez l’utilisateur au Dossier Partagé.

   At this point, the user created in your Organization exists only as an identity with no roles or permissions assigned. Therefore, we need to add it to the Shared Folder to gain access to processes published there and give it the Automation User role:

3. Dans Orchestrator, sélectionnez le Dossier Partagé > Utilisateurs, puis cliquez sur le bouton Assigner un utilisateur ou un groupe sur le côté droit.

4. Sélectionnez l’utilisateur, puis le rôle Automation User, et cliquez sur Assigner (Assign).

5. Créez le Unattended Robot qui exécute les automatisations :

6. Retournez dans le Dossier Partagé et sélectionnez Plus d'actions > Modifier.

7. Sélectionnez Unattended Robot, activez Activer/Désactiver pour Créer automatiquement un Unattended Robot pour cet utilisateur, remplissez les informations d’identification Windows, et cliquez sur Mise à jour.

Les informations d’identification Windows sont utilisées par le Robot pour les autorisations et l’autorisation sur la Unattended Machine lors de l’exécution des automatisations.

Remarque :

Les informations d’identification que vous définissez lors de la création du Robot dans Orchestrator doivent correspondre aux informations d’identification du compte Windows utilisées sur la machine du Unattended Robot. Ouvrez l'invite de commande et utilisez la commande whoami sur la Unattended Machine pour obtenir cette information.

4. Créez le modèle de machines non assistées.

Une fois l'utilisateur Unattended Robot créé, ajoutez un nouveau modèle de machine avec une seule licence de runtimes non assistés :

1. Dans Orchestrator, sélectionnez le dossier Partagé > Machines puis cliquez sur le bouton Gérer les modèles de machine sur le côté droit.
2. Cliquez sur le bouton Plus sur le côté droit pour ouvrir la page Ajouter machine.
3. Enter a template name, for example Unattended Machines, assign one unattended runtimes license, and click Provision.
4. Copiez la clé de machine nouvellement générée pour une utilisation ultérieure.

4. Install UiPath^® Studio on the unattended machine

In order to run unattended automations on a machine with a Community License, you need to install UiPathStudio.msi on the unattended machine. If you opt for the Quick Setup during installation, the Robot is deployed in User Mode, meaning that it runs under the user that started it, and has the exact rights as that particular user.

Le programme d'installation UiPathStudio.msi peut être téléchargé à partir du Centre de ressources (Resource Center) ou directement de la Page d'accueil (Home Page) Automation Cloud.

Afin de démarrer une tâche depuis Orchestrator, l’utilisateur Windows doit être connecté. Le Robot en mode utilisateur ne peut pas exécuter de tâches simultanées sur différents utilisateurs, que le Robot soit installé sur un serveur Windows ou non.

After downloading the Community version of UiPath^® Studio and Robot, you need to connect it to your Orchestrator instance. For unattended automations, it's recommended to use the Machine Key connection.

5. Établir une connexion entre Robot et Orchestrator

Depuis Studio

Une fois l'installation terminée, l'écran Démarrer s'affiche, qui par défaut vous demande de vous authentifier. Choisissez d'utiliser la clé de la machine, car il s'agit de la configuration recommandée pour les robots non assistés. Le nom de la machine est renseigné automatiquement, il vous suffit de saisir l'URL d'Orchestrator dans le formulaire https://cloud.uipath.com/organisation/tenant, la clé de la machine que vous avez enregistrée lors de la création du modèle de machine, et de cliquer sur Continuer.

From the UiPath^® Assistant

The connection between the Robot and Orchestrator can also be established from the UiPath^® Assistant by following the steps below:

1. Open the UiPath^® Assistant.

2. Dans le menu Préférences, sélectionnez Préférences.

3. Accédez aux paramètres d'Orchestrator.

4. Dans le champ URL Orchestrator, entrez votre URL Orchestrator.

5. In the Machine Key field, enter the key you copied earlier when you created the machine template in Orchestrator.

   For details about the differences between machine entities in Orchestrator and when to use each one, see Machines in the Orchestrator Guide.

6. Cliquez sur Connexion. Le statut doit afficher Connected, Licensed.

   Remarque :

   Lors de la configuration de la machine, si la configuration est basée sur un environnement virtuel, vous pouvez déconnecter la session distante mais assurez-vous de laisser l'utilisateur non assisté connecté à la machine afin que la connexion à Orchestrator reste active.

6. Test de l’automatisation

1. Dans Orchestrator, sélectionnez le Dossier Partagé > Automatisations > Processus. Recherchez le processus déployé à l’étape 1 et cliquez sur le bouton Démarrer une tâche sur le côté droit pour ouvrir la page Démarrer Tâche.

2. Choisissez l’utilisateur et la machine configurée plus tôt, puis cliquez sur Démarrer.

   Cela démarre le processus non assisté sélectionné sur la machine sélectionnée. Vous pouvez surveiller la tâche dans la section Statut de la tâche du Dossier Partagé dans Orchestrator.

7. Planification de l’automatisation

Programmons l'automatisation dans cet exemple pour qu'elle s'exécute quotidiennement à 9 heures :

1. Dans Orchestrator, sélectionnez le Dossier Partagé > Déclencheurs,puis cliquez sur le bouton Ajouter sur le côté droit pour ouvrir la page Créer déclencheur .
2. Assurez-vous que le Temps est sélectionné, puis fournissez les informations requises : entrez un nom pour le déclencheur, sélectionnez le processus, l’utilisateur et la récurrence quotidienne à 9 h.
3. Cliquez sur Ajouter.

Définir l’horaire selon la capture d’écran ci-dessus déclenche le processus Logs.Backup à exécuter sur la machine non assistée pour le compte de l’utilisateur sélectionné tous les jours à 9 heures UTC.

Déploiement de Unattended Robots - License d'entreprise

Les robots non assistés sont utilisés pour automatiser les tâches qui ne nécessitent pas de supervision humaine ; ils s'exécutent généralement dans des environnements virtuels sur des machines dédiées, et les automatisations sont contrôlées depuis Orchestrator.

Une automatisation non assistée peut être démarrée manuellement à partir d'Orchestrator en cas de besoin, mais peut également être planifiée si la tâche doit commencer à un intervalle spécifique (quotidien, horaire, hebdomadaire) ou à une heure et une date spécifiques (fin de la semaine).

This document guides you through the process of running your first unattended automation using the Enterprise Licensed Version of UiPath^® , starting with building the automation, setting up the environment and running the unattended process.

Pour exécuter une automatisation non assistée, il faut suivre les étapes suivantes :

1. Création de l'automatisation et publication dans Orchestrator

Pour donner un exemple concret, supposons que nous devions faire une sauvegarde des fichiers journalisations sur un serveur tous les jours à 9 heures. Pour cela, nous devons copier le fichier journalisation de ce jour dans un autre dossier. Dans cet exemple, nous copions un fichier appelé « Journalisations.txt » ("Logs.txt") du dossier « Journalisations » ("Logs") vers le dossier « Anciennes journalisations » ("Old Logs"), en écrasant la sauvegarde à chaque fois.

1. Créez un nouveau processus, ajoutez l'activité Copier le fichier, configurez les champs/chemins d'accès aux fichiers et sélectionnez l'option Écraser afin que le fichier nouvellement copié puisse remplacer le fichier précédent chaque jour.

2. Publiez le processus à Orchestrator.

3. Cliquez sur le bouton Publier à droite sur le ruban Studio,

4. Dans l'onglet Publier les propriétés, entrez un nom pour le package.

5. Dans l'onglet Publier les options, pour l'option Publier vers, sélectionnez Flux des processus des locataires Orchestrator, l’emplacement où les Unattended Robots peuvent accéder à l’automatisation.

6. Click Publish.

   For more information, see About Publishing Automation Projects in the Studio Guide.

7. Dans Orchestrator, créez le processus que le Unattended Robot utilise pour exécuter l’automatisation.

8. Accédez à votre instance Automation Cloud à l'adresse https://cloud.uipath.com, et sélectionnez votre locataire Orchestrator.

9. Dans Orchestrator, sélectionnez le Dossier Partagé > Processus puis cliquez sur le bouton Ajouter sur le côté droit pour ouvrir la page Ajouter processus.

10. Sélectionnez le package et cliquez sur Créer pour ajouter le processus au dossier partagé.

    Remarque :

    Gardez à l’esprit que vous travaillez avec deux entités dans ce processus. La première entité c'est vous, le développeur qui crée et publie le processus. Le second est l'utilisateur non assisté qui exécute l’automatisation et le Robot sur la Unattended machine.

2. Configurez la machine Windows pour exécuter le Unattended Robot

Set up a Windows Machine that runs the Unattended Robot, ideally this would be a cloud virtual machine. Make sure that its screen saver functionality is disabled and matches the Hardware and Software Technical Requirements.

For example, you can host your virtual machine on Azure, see the Windows VMs Overview document for details on how to set up a Windows Virtual Machine in Azure.

D’autres environnements tels qu’AWS, VMware ou Citrix sont également pris en charge s’ils correspondent aux Exigences en matière de matériel et de logiciels.

3. Créez le Unattended Robot dans Orchestrator

Le robot non assisté (unattended) a deux composantes, l'utilisateur du Robot et la Machine sur laquelle il fonctionne. L'utilisateur du Robot est l'identité du Robot qui fournit les autorisations et est utilisé pour déclencher des tâches vers le Robot, tandis que la Machine est celle qui exécute l'automatisation.

Les modèles de machine offrent un moyen plus facile de déployer des machines, car une seule clé de machine peut être utilisée par plusieurs robots pour se connecter à Orchestrator.

1. Créez l’utilisateur du Robot.

   • Depuis Automation Cloud, accédez à Admin > Utilisateurs et groupes > Inviter les utilisateurs pour inviter l'utilisateur à votre Organization afin de créer un Unattended Robot pour elle.Une adresse e-mail factice peut être utilisée pour cette étape.

2. Ajoutez l’utilisateur au Dossier Partagé.

   At this point, the user created in your Organization exists only as an identity with no roles or permissions assigned. Therefore, we need to add it to the Shared Folder to gain access to processes published there and give it the Robot role:

3. Dans Orchestrator, sélectionnez le Dossier Partagé > Utilisateurs, puis cliquez sur le bouton Assigner un utilisateur ou un groupe sur le côté droit.

4. Sélectionnez l’utilisateur, puis le rôle du Robot, et cliquez sur Assigner.

5. Créez le Unattended Robot qui exécute les automatisations :

6. Retournez dans le Dossier Partagé et sélectionnez Plus d'actions > Modifier.

7. Sélectionnez Unattended Robot, activez Activer/Désactiver pour Créer automatiquement un Unattended Robot pour cet utilisateur, remplissez les informations d’identification Windows, et cliquez sur Mise à jour.

Les informations d’identification Windows sont utilisées par le Robot pour les autorisations et l’autorisation sur la machine non assistée lors de l’exécution des automatisations. Lorsque la version Entreprise (.MSI) est déployée, ces informations d’identification sont utilisées pour créer des sessions Windows sur la machine non assistée pour l’exécution d’automatisations.

Remarque :

Les informations d’identification que vous définissez lors de la création du Robot dans Orchestrator doivent correspondre aux informations d’identification du compte Windows utilisées sur la machine du Unattended Robot. Ouvrez l’invite de commande et utilisez la commande whoami sur la machine non assistée pour obtenir cette information. Ces informations d’identification sont utilisées pour créer des sessions Windows sur la machine non assistée pour l’exécution d’automatisations.

4. Créez le modèle de machines non assistées.

Une fois l'utilisateur Unattended Robot créé, ajoutez un nouveau modèle de machine avec une seule licence de runtimes non assistés :

1. Dans Orchestrator, sélectionnez le dossier Partagé > Machines puis cliquez sur le bouton Gérer les modèles de machine sur le côté droit.
2. Cliquez sur le bouton Plus sur le côté droit pour ouvrir la page Ajouter machine.
3. Enter a template name, for example Unattended Machines, assign one unattended runtimes license, and click Provision.
4. Copiez la clé de machine nouvellement générée pour une utilisation ultérieure.

4. Install the UiPath^® Studio Enterprise (.MSI) on the Unattended machine

The UiPathStudio.msi installer is used for installing Studio, the UiPath^® Assistant or the legacy Robot on your machine. Using the .MSI installer, the Robot is deployed in Service-Mode by default, meaning that it is available to all users on the machine. For running the installer administrator rights are needed.

Le programme d'installation UiPathStudio.msi peut être téléchargé à partir du Centre de ressources (Resource Center) ou directement de la Page d'accueil (Home Page) Automation Cloud.

Robot et Studio sont installés par défaut à l'emplacement suivant : C:\Program Files \UiPath\Studio. Vous pouvez modifier l'emplacement d'installation en utilisant des arguments de ligne de commande ou à partir de l'interface du programme d'installation.

Interface d'installation

1. Double-cliquez sur l’installateur pour lancer l’assistant d’installation.

2. Read and accept the Terms of use, and then click Install.

   Please note that by accepting the aforementioned terms of use, you implicitly accept the terms of use of UiPath^® activity packages and their dependencies.

3. Sélectionnez les produits à installer :

   • Install UiPath^® Studio + Robot - Installs UiPath^® Studio, Assistant, and the Robot for creating and testing automations.
   • Install UiPath^® Robot Only - Installs UiPath^® Assistant and the user-mode Robot for running attended automations.

4. Sélectionnez le type d’installation (Installation Type) :

   • Mode service - Installe le robot en mode service
   • Mode utilisateur (User Mode) - installe le Robot en mode utilisateur

Pour en savoir plus sur la façon d’utiliser l'installateur .MSI, consultez le guide d'installation UiPathStudio.msi.

5. Connexion du Robot à Orchestrator

Remarque :

If during the installation process you choose to only install the Robot, the connection to Orchestrator can only be configured From the Command Line Interface (admin rights are needed) or from the UiPath^® Assistant . Otherwise, you can connect your Robot either from Studio or from the UiPath^® Assistant.

Depuis Studio

Une fois l'installation terminée, l'écran Connexion à Orchestrator s'affiche et vous demande par défaut d'utiliser la touche Utiliser la clé machine car il s'agit de la configuration recommandée pour les Unattended Robots. Le nom de la machine est repris automatiquement, il vous suffit de saisir l'URL d'Orchestrator plus la clé de machine que vous avez enregistrée précédemment.

Remarque :

En utilisant le programme d'installation .MSI, lors de la connexion du Robot à Orchestrator, l’ensemble de la machine se connecte, et pas seulement l’utilisateur qui est actuellement connecté à la machine.

From the UiPath^® Assistant

1. Open UiPath^® Assistant
2. Dans le menu Préférences, sélectionnez Préférences. La fenêtre Préférences s’affiche.
3. Accédez aux paramètres d'Orchestrator.
4. Dans le champ URL Orchestrator, entrez l’adresse web d’Orchestrator.
5. Dans le champ Clé machine, entrez la clé que vous avez copiée précédemment.

Click here for details about the different machine entities in Orchestrator and when to use each.

1. Cliquez sur Se connecter. Le statut doit afficher Connected, Licensed

   Remarque :

   Lors de la configuration de la machine en utilisant le programme d'installation Entreprise (.MSI), vous pouvez vous déconnecter de la machine car le Robot est capable de créer sa propre session Windows en utilisant les informations d'identification fournies à l’étape 3.

6. Test de l’automatisation

Afin de tester l’automatisation sur le Unattended Robot, allez à la section Automatisations -> Processus section Dossier Partagé dans Orchestrator et recherchez le processus déployé à l’étape 1.

Vous pouvez voir les détails du processus et, sur le côté droit, vous avez le bouton Démarrer la tâche.

Lorsque vous cliquez, l'interface Démarrer la tâche s'affiche, choisissez l'utilisateur et la machine configurée précédemment puis cliquez sur Démarrer.

Cela permet de lancer le processus non assisté sélectionné sur la machine sélectionnée et il peut être surveillé dans la section Tâche du Dossier Partagé dans Orchestrator.

7. Planification de l’automatisation

Pour l'exemple que nous vous avons donné dans ce guide, nous pouvons programmer son exécution quotidienne à 9 heures. La configuration se fait à partir de la Section déclencheur du Dossier Partagé dans Orchestrator.

Définir l’horaire selon la capture d’écran ci-dessus déclenche le processus Logs.Backup à exécuter sur la machine non assistée pour le compte de l’utilisateur sélectionné tous les jours à 9 heures UTC.