orchestrator
2023.10
false
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur d'Orchestrator

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Dernière mise à jour 4 déc. 2024

À propos des tâches

Remarque : pour maîtriser les tâches, vous devez d'abord maîtriser les processus. En savoir plus sur les arguments de runtime, les types de processus et la compatibilité des processus.

Les tâches représentent les exécutions de processus au niveau d’un Robot UiPath®. Vous pouvez lancer une exécution en mode Attended ou Unattended. Vous ne pouvez pas lancer une tâche depuis Orchestrator sur les Attended Robots, hormis à des fins de débogage ou de développement.

Les tâches assistées peuvent être déclenchées à partir de l'Assistant UiPath ou de l'interface de ligne de commande du Robot. Les tâches Unattended sont lancées à partir d'Orchestrator, soit directement sur place à partir de la page Tâches ( Jobs ) ou Processus , soit de manière préplanifiée via des déclencheurs, sur la page Déclencheurs (Triggers).

La page Tâches ( Jobs ) représente le centre de contrôle des tâches, où vous pouvez surveiller les tâches lancées, afficher leurs détails et leurs journaux, et arrêter/arrêter/reprendre/redémarrer une tâche.

La table ci-dessous contient des descriptions de champ pour la page Exécutions (Job)

Champ

Description

Processus (Process)

Le nom du processus.

[Remote debugging job] s'affiche pour les tâches démarrées à partir de Studio via des sessions de débogage à distance .

Machine (*)

Objet machine utilisé pour connecter l'infrastructure d'exécution à Orchestrator.

Nom de l'hôte

Le nom du poste de travail utilisé pour l'exécution.

Identité de l'hôte

Identité sous laquelle l'exécution a lieu. Les valeurs suivantes sont possibles :

  • <Domain\Username> : tâches exécutées sous ce compte spécifique. Affiché dans les cas suivants :

    • tâches de premier plan quelle que soit la version du Robot ;

    • toutes les tâches exécutées sur des Robots antérieurs à 2021.10 ;

    • tâches Attended exécutées sur des Robots connectés à l'aide d'une clé machine, sans connexion de l'utilisateur.

Pour les Robots antérieurs à la version 2021.10, l'identité de l'hôte est renseignée dynamiquement en fonction des paramètres de compte définis dans Orchestrator. La modification du domain\username du compte utilisé pour exécuter une tâche modifie également l'identité de l'hôte.
  • ROOT - tâches en arrière-plan exécutées sur des robots Linux .
  • NT AUTHORITY\LOCAL SERVICE : tâches exécutées sous l'identité du service de Robot. Affiché pour les tâches d'arrière-plan exécutées sur des Robots 2021.10 et ultérieurs sans informations d’identification.
    Les robots en mode service s'exécutent sous NT AUTHORITY\LOCAL SERVICE. Les robots en mode utilisateur s'exécutent sous une certaine identité d'utilisateur.
  • N/A - tâches démarrées à partir de l'Assistant par les utilisateurs connectés à l'aide de la connexion interactive . Pour les robots connectés à l'aide de la clé machine, sans connexion de l'utilisateur, le <Domain\Username> s'affiche.

Type de tâche

Le type de tâche selon l'endroit où l'exécution a lieu et selon que le robot emprunte ou non l'identité d'un utilisateur :

  • Service Unattended : l'exécution se produit sur un serveur et le Robot n'emprunte pas l'identité d'un utilisateur. Les tâches sont lancées à partir d'Orchestrator
  • Personnel à distance : l'exécution se produit sur un serveur et le Robot s'exécute sous l'identité d'un propriétaire d'espace de travail personnel. Les tâches sont lancées à partir d'Orchestrator.
  • Attended : l'exécution se produit sur la machine personnelle d'un utilisateur. Les tâches sont lancées à partir de l'Assistant.
  • Développement : l'exécution se produit sur un serveur. Les tâches sont lancées depuis Studio via le débogage à distance.

Type de runtime

Type de runtime utilisé pour l'exécution.

État (State)

L'état de la tâche. Voir les détails sur les états des tâches.

Priorité (Priority)

La priorité de la tâche. Voir les détails sur les priorités des tâches.

Démarré (Started)

Le délai écoulé depuis le début de l'exécution de la tâche. Le survol de ce champ à l'aide du curseur affiche l'heure et la date exactes.

Terminé (Ended)

Le délai écoulé depuis la fin de l'exécution de la tâche. Le survol de ce champ à l'aide du curseur affiche l'heure de fin et la date exactes.

Commencé (absolu) (Started (absolute)) (*)

Le délai absolu écoulé depuis le début de l’exécution de la tâche. Les horodatages absolus sont affichés dans le fuseau horaire du locataire. Pour les déclencheurs, l’exécution suivante est affichée dans le fuseau horaire du déclencheur, qui peut différer du fuseau horaire du locataire.

Terminé (absolu) (Ended (absolute) (*)

Le délai absolu écoulé depuis la fin de l’exécution de la tâche. Les horodatages absolus sont affichés dans le fuseau horaire du locataire. Pour les déclencheurs, l’exécution suivante est affichée dans le fuseau horaire du déclencheur, qui peut différer du fuseau horaire du locataire.

Source

L'agent de l'exécution.

  • [trigger_name]: la tâche est démarrée par ce déclencheur.
  • Assistant : la tâche est lancée par l'Assistant UiPath.
  • Manuel (Manual) : la tâche est démarrée à partir d'Orchestrator.
  • Studio : la tâche est démarrée à des fins de débogage à partir de Studio.

Heure de création (Creation Time) (*)

Le temps relatif de la création de la tâche.

Heure de création (absolue) (Creation Time (absolute)) (*)

L'heure absolue de la création de tâche.

(*) Colonnes qui ne sont pas visibles par défaut dans la grille des tâches. Sélectionnez-les dans la liste déroulante Colonnes (Columns).





Mappages compte-machine

Lors du démarrage d'une tâche ou de la définition d'un déclencheur, vous pouvez définir des paires compte-machine spécifiques sur lesquelles l'exécution aura lieu. Les mappages compte-machine vous permettent de lier l'utilisation Unattended sous des comptes particuliers à des modèles de machine spécifiques. Ils offrent un contrôle précis sur les cibles d'exécution de votre automatisation. Les mappages compte-machine peuvent être basés sur le locataire (ne sont pas liés à un dossier spécifique) ou sur le dossier (liés à un dossier spécifique).

Cible d'exécution (Execution Target)

Selon le mécanisme utilisé pour démarrer les tâches dans Orchestrator, vous pouvez choisir et configurer implicitement une stratégie d'affectation des tâches et une cible d'exécution. Cet article décrit les stratégies d'affectation et les cibles d'exécution disponibles lors du lancement de tâches depuis la page Tâches (Jobs).

Remarque :

Si l'exécution de votre tâche dépend d'une ressource spécifique qui n'est pas encore disponible, la tâche reste à l'état En attente (Pending) jusqu'à ce que les conditions d'exécution des tâches soient remplies.

Par exemple, l'utilisateur U1 se connecte au nom d'hôte H1 à l'aide des informations d'identification C1. Cependant, les informations d'identification incorrectes C2 sont saisies pour se connecter au nom d'hôte. Par conséquent, la tâche passe à l'état En attente (Pending). Si vous mettez à jour ultérieurement les informations d'identification avec les valeurs correctes (c'est-à-dire C1), la tâche reprend son exécution.

Remarque : Si le robot ne répond pas (la machine robot est arrêtée, ou le service de robot échoue) au cours de l'exécution de la tâche, une fois la reconnexion effectuée, il redémarre l'exécution des tâches qui s'exécutaient lors du blocage.


1. Attribuer dynamiquement

L'allocation dynamique sans sélection explicite de compte et de machine vous permet d'exécuter plusieurs fois un processus de premier plan sous le compte et la machine qui deviennent disponibles en premier. Les processus d'arrière-plan sont exécutés sur n'importe quel compte, qu'il soit occupé ou non, tant que vous disposez de suffisamment de runtimes.

À l'aide de l'option Allouer dynamiquement (Allocate Dynamically), vous pouvez exécuter un processus jusqu'à 10 000 fois dans une seule tâche.

2. Sélectionner des mappages compte-machine valides

Vous pouvez décider quelles paires compte-machine spécifiques exécuter la tâche sélectionnée.
docs image
Pour exécuter plusieurs tâches à la fois, une pour chaque paire, cliquez sur Ajouter un mappage compte-machine (Add Account-Machine mapping) et sélectionnez les éléments souhaités dans les listes déroulantes qui s'affichent.

Une fois cela fait, une tâche en attente (Pending) est créée pour chaque paire compte-machine.

Remarque :

Cela ne fonctionne que si l'option Activer le mappage utilisateur-machine (Enable user-machine mapping) dans l'onglet Général (General) de vos paramètres de locataire est sélectionnée.

3. Compte

Le processus est exécuté sous un compte utilisateur ou Robot spécifique. Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement la machine. Le fait de spécifier à la fois le compte et la machine signifie que la tâche se lance sur cette paire compte-machine spécifique.

4. Machine

Le processus est exécuté sur l'une des machines hôtes attachées au modèle de machine sélectionné. La spécification du modèle affiche une option Nom d'hôte (Hostname) supplémentaire, vous permettant de sélectionner une machine hôte spécifique dans le pool de machines hôtes connectées. Si vous spécifiez uniquement la machine, Orchestrator allouera dynamiquement le compte. Le fait de spécifier à la fois le compte et la machine signifie que la tâche se lance sur cette paire compte-machine spécifique.

Assurez-vous que les runtimes correspondant au type de tâche sont affectés au modèle de machine associé. Seules les machines hôtes connectées associées au dossier actif sont affichées.

5. Planifier la fin de l'exécution de la tâche

L'exécution du processus peut parfois être défectueuse, ce qui entraîne le maintien de la tâche à l'état en attente. La bascule vous permet d'automatiser une stratégie d'arrêt de la tâche, en spécifiant le délai qui peut s'écouler jusqu'à ce que la tâche soit arrêtée ou arrêtée. Pour couvrir le cas d'une tâche qui ne peut pas être arrêtée, vous avez la possibilité d'arrêter la tâche.

6. Conserver l'affectation compte-machine à la reprise de la tâche

Le processus reprend son exécution sur n'importe quel robot disponible sur n'importe quelle machine disponible par défaut. Conserver la même configuration compte-machine garantit une utilisation optimisée des ressources et des exigences de licence.

Important :

Vous devez enregistrer un utilisateur Windows pour chaque compte sur une machine hôte qui appartient aux dossiers auxquels le modèle de machine correspondant est affecté.

Imaginons que vous ayez connecté un serveur à Orchestrator à l'aide de la clé générée par le modèle de machine FinanceT. Ce modèle de machine est affecté aux dossiers FinanceExecution et FinanceHR, auxquels 6 comptes ont également été affectés. Ces 6 comptes doivent être enregistrés en tant qu'utilisateurs Windows sur le serveur.

Si vous configurez une tâche pour exécuter le même processus plusieurs fois, une entrée de tâche est créée pour chaque exécution. Les tâches sont commandées en fonction de leur priorité et de leur heure de création avec une priorité plus élevée, les tâches plus anciennes étant placées en premier. Dès qu’un robot devient disponible, il exécute la tâche suivante dans la file. Dans l'intervalle, les tâches restent dans un état en attente.

Exemple

Configuration

  • 1 dossier
  • 1 modèle de machine avec deux runtimes
  • 2 comptes : john.smith et petri.ota
  • 2 processus qui nécessitent l’interaction de l'utilisateur : P1, qui ajoute des éléments de file d’attente à une file d’attente ; P2, qui traite les éléments dans la file d’attente

    Le modèle de machine et les comptes doivent être associés au dossier contenant les processus.

Résultat souhaité

  • P1 est exécuté avec une priorité élevée par toute personne.
  • P2 est exécuté avec une faible priorité par petri.ota.

Configuration de tâche requise

  • Démarrez une tâche en utilisant P1, ne l’affectez à aucun utilisateur particulier, définissez la priorité sur Élevé (High).
  • Démarrez une tâche pour P2, affectez-la à petri.ota, définissez la priorité sur Basse (Low).

Priorité d'exécution

Vous pouvez contrôler quelle tâche est prioritaire sur les autres via le champ Priorité des tâches (Job Priority), soit lors du déploiement du processus, soit lors de la configuration d'une tâche/d'un déclencheur pour ce processus. Une tâche peut avoir l'une des dix priorités suivantes :



Démarrage manuel d'une tâche

La valeur par défaut du champ Priorité de l'exécution (Job Priority) est Héritée (Inherited), ce qui signifie que la priorité est héritée à partir de l'endroit où elle a été initialement configurée.Vous pouvez la laisser telle quelle ou la modifier.

  • Où : page Automatisations (Automations) > Tâches (Jobs)

La tâche hérite de la priorité définie au niveau du processus.

  • Emplacement : page Automatisations (Automations) > Déclencheurs ( Triggers)

Si le déclencheur a la priorité Héritée (Inherited), la tâche hérite de la priorité définie au niveau du processus.

Si le déclencheur a une priorité autre que Héritée (Inherited), la tâche hérite de la priorité définie au niveau du déclencheur.Si elle est remplacée par Héritée (Inherited), la priorité définie au niveau du processus est utilisée.

  • Page Automatisations (Automations) > Processus (Processes)

La tâche hérite de la priorité définie pour ce processus.

Si vous configurez une tâche pour exécuter le même processus plusieurs fois, une entrée de tâche est créée pour chaque exécution. Les tâches sont commandées en fonction de leur priorité et de leur heure de création avec une priorité plus élevée, les tâches plus anciennes étant placées en premier. Dès qu’un robot devient disponible, il exécute la tâche suivante dans la file. Dans l'intervalle, les tâches restent dans un état en attente.

Démarrage d'une tâche via un déclencheur

La priorité est définie par défaut sur Hérité (Inherited), en d'autres termes, elle hérite de la valeur définie au niveau du processus. La sélection d'un processus met à jour automatiquement l'icône de flèche pour illustrer la valeur définie au niveau du processus. Toutes les tâches lancées par le déclencheur ont la priorité définie au niveau du déclencheur. Si la valeur Hérité (Inherited) est conservée, les tâches sont lancées avec la priorité définie au niveau du processus.

Toute modification ultérieure effectuée au niveau du processus se répercute sur le déclencheur, ainsi que les tâches créées via ce déclencheur implicitement.

Définition de la priorité de l'exécution (Job Priority) à l'aide de l'API

Les dix niveaux de priorité disponibles dans l'interface correspondent à 100 niveaux dans l'API, ce qui signifie que l'API vous permet de définir une priorité encore plus précise. Ces niveaux sont mappés comme suit :

Minimum

Maximum

Default

 

Le plus bas

1

10

5

Très bas

11

20

15

Basse

21

30

25

Bas à moyen

31

40

35

Moyenne

41

50

45

Moyen à élevé

51

60

55

Haute

61

70

65

Très élevé

71

80

75

Le plus élevé

81

90

85

Critique (Critical)

91

100

95

Pour définir ou modifier la priorité d'une tâche, utilisez le paramètre SpecificPriorityValue, qui est disponible dans les points de terminaison suivants :
  • POST​/odata​/Jobs​/UiPath.Server.Configuration.OData.StartJobs
  • POST/odata​/ProcessSchedules
  • PUT/odata​/ProcessSchedules({key})

Imaginons que vous ayez deux tâches pour lesquelles vous avez défini des priorités respectives de 92 et 94. Elles se situent toutes les deux dans la plage Critique (Critical), mais la tâche qui a une priorité de 94 sera exécutée avant celle avec une priorité de 92.

Remarque : Si vous démarrez une tâche nécessitant une intervention d'utilisateur sur plusieurs robots sur la même machine (qui ne s'exécute pas sur Windows Server), le processus sélectionné est exécuté uniquement par le premier robot, et les autres échouent. Une instance de chacune de ces exécutions est créée et affichée sur la page Tâches (Jobs).

Tâches sur les robots haute densité

Si vous démarrez une tâche sur plusieurs robots haute densité à partir de la même machine exécutant Windows Server, cela implique que le processus sélectionné est exécuté simultanément par chaque robot spécifié. Une instance de chacune de ces exécutions est créée et affichée sur la page Tâches (Jobs).

Si vous utilisez les Robots haute densité et que vous n'avez pas activé RDP sur cette machine, chaque fois que vous démarrez une tâche, l'erreur suivante s'affiche : « Une session de connexion spécifiée n'existe pas. Il est possible qu'elle soit déjà terminée. » Pour découvrir comment configurer votre machine pour les Robots haute densité, consultez la page À propos de la configuration de Windows Server pour les Robots haute densité.

Enregistrement

Pour les tâches défaillantes Unattended, si l'option Activer l'enregistrement (Enable Recording) de votre processus était activée, vous pouvez télécharger les supports d'exécution correspondants afin de vérifier les derniers moments de l'exécution avant l'échec.

L'option Télécharger l'enregistrement (Download Recording) est uniquement affichée dans la fenêtre Tâches (Jobs) si vous disposez des autorisations de Consultation (View) pour les supports d'exécution.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.