À propos des tâches

Affichez, gérez et exécutez des tâches pour les processus d'automatisation dans Orchestrator.

Remarque :

La disponibilité des fonctionnalités dépend de l'offre Cloud que vous utilisez. Consultez la page Disponibilité des fonctionnalités pour plus de détails. Avant de maîtriser les tâches, découvrez les arguments de runtime, les types de processus et la compatibilité des processus.

Vue d'ensemble (Overview)

Une tâche représente l'exécution d'un processus au niveau d'un Robot UiPath. Vous pouvez lancer des tâches en mode Attended ou Unattended. Les Attended Robots ne peuvent pas exécuter de tâches depuis Orchestrator, sauf pour le débogage ou le développement.

Les tâches Attended sont 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 depuis Orchestrator directement depuis la page Tâches ou Processus , ou via des déclencheurs sur la page Déclencheurs .

La page Tâches est votre centre de contrôle pour surveiller les tâches lancées, afficher les détails et les journaux, et gérer l'exécution des tâches (arrêter, forcer l'arrêt, reprendre, redémarrer).

Référence des champs de tâche

Le tableau suivant décrit chaque champ disponible sur la page Tâches . Certains champs ne sont pas pertinents pour tous les types de tâches; lorsqu’un champ ne s’applique pas à un type de tâche, la valeur s’affiche sous la forme N/A.

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 .
Type d’exécution	Le type d'exécution dépend de l'endroit où elle a lieu et du fait que le robot se fait passer pour un utilisateur ou non : Unattended - The execution happens on a server and the robot does not impersonate a user. Jobs are launched from 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 - The execution happens on a user's personal machine. Jobs are launched from the Assistant. Développement : l'exécution se produit sur un serveur. Les tâches sont lancées depuis Studio via le débogage à distance. Agent : exécution d'un agent. Remarque : lorsque vous exécutez des agents codés, le type d'exécution est indiqué sous la forme Agent ()<programming language> . Maestro BPMN – exécution d'un processus Maestro BPMN.
État (State)	L'état de la tâche. See details about job states .
Healing Agent	Indique si Healing agent a détecté ou non des problèmes pendant l'exécution de la tâche : Issues Detected (Problèmes détectés) : Healing agent a détecté des problèmes lors de l'exécution de la tâche. N/A (S/O) : Healing agent n'était pas actif ou n'a pas détecté de problèmes lors de l'exécution de la tâche.
Démarré (Started)	The relative amount of time since the job has started executing. Hovering over this field displays the exact start time and date.
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)) (*)	The absolute amount of time since the job has started executing. 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) (*)	The absolute amount of time since the job has finished executing. 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.
Duration	La durée de la tâche, calculée comme l'intervalle entre l'heure de début et l'heure à laquelle la tâche a atteint son état final.
Source	L'agent de l'exécution. Manuel (Manual) : la tâche est démarrée à partir d'Orchestrator. Déclencheur de temps (Time trigger) : la tâche a été démarrée par un déclencheur de temps dont le nom est affiché dans la colonne Source. Déclencheur de file dʹattente (Queue trigger) : la tâche a été démarrée par un déclencheur de file d’attente dont le nom est affiché dans la colonne Source. Déclencheurs d’événement (Event trigger) : la tâche a été démarrée par un déclencheur d’événement dont le nom est affiché dans la colonne Source. Déclencheur d’API (API trigger) : la tâche a été démarrée par un déclencheur d’API dont le nom est affiché dans la colonne Source. Assistant : la tâche est lancée par l'Assistant UiPath. Studio : la tâche est démarrée à des fins de débogage à partir de Studio. Applications (Apps) : la tâche a été démarrée via une application. Agent : la tâche a été lancée dans le cadre de l'exécution d'un agent. Maestro BPMN: la tâche a été lancée dans le cadre de l'exécution d'un processus Maestro BPMN. SAP : la tâche a été démarrée dans le cadre d’une intégration SAP. Pipelines Automation Ops : la tâche a été démarrée dans le cadre d’un pipeline Automation Ops Test Manager : la tâche a été démarrée via Test Manager.
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.
Priorité (Priority)	La priorité de la tâche. See details about job priorities .
Interaction de l’utilisateur	Spécifie si le processus sous-jacent nécessite une interaction utilisateur : Required (Obligatoire) : indique un processus d'avant-plan qui nécessite une interaction de l'utilisateur. Not required (Non obligatoire) : indique un processus d'arrière-plan qui ne nécessite pas d'interaction de l'utilisateur.
Machine (*)	Objet machine utilisé pour connecter l'infrastructure d'exécution à Orchestrator.
Hostname(*) (Nom de l'hôte)	Le nom du poste de travail utilisé pour l'exécution.
Host identity(*) (Identité de l'hôte)	The identity under which the execution takes place. The following values are possible: <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. For Robots older than 2021.10, the host identity gets populated dynamically according to the account settings made in Orchestrator. Changing the domain\username for the account used to execute a job changes the host identity as well. ROOT : tâches d’arrière-plan exécutées sur des robots Linux . NT AUTHORITY\LOCAL SERVICE - jobs executed under the Robot service identity. Displayed for background jobs executed on Robots 2021.10+ without credentials. Service mode robots run under NT AUTHORITY\LOCAL SERVICE . User mode robots run under a certain user identity. N/A - jobs started from the Assistant by users connected using interactive sign-in . For robots connected using the machine key, without user sign-in, the <Domain\Username> is displayed.
Type de runtime	Type de runtime utilisé pour l'exécution.

(*) 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).

Découvrez comment configurer les mappages compte-machine.

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

En savoir plus sur les cibles d'exécution pour les déclencheurs.

Remarque :

Lorsqu’une cible d’exécution est configurée via des liaisons (l’automatisation parent invoquant un autre processus), sélectionnez Hériter de l’identité de la tâche parente pour exécuter la tâche invoquée sous l’identité du parent. Cette option fonctionne à la fois pour les automatisations en arrière-plan et Windows (premier plan). Pour les automatisations de premier plan, l'identité de tâche parente doit disposer d'un Unattended Robot dont les informations d'identification sont configurées.

Remarque :

Si l'exécution de la tâche dépend d'une ressource spécifique qui n'est pas encore disponible, la tâche reste en attente jusqu'à ce que les conditions soient remplies. Par exemple, si les informations d'identification incorrectes C2 sont utilisées au lieu de C1 pour se connecter au nom d'hôte H1, la tâche passe à l'état En attente. Une fois corrigée sur C1, la tâche reprend.

Remarque :

Si le robot ne répond pas (machine arrêtée ou panne du service de robot UiPath) pendant l'exécution, il redémarre les tâches en cours d'exécution après la reconnexion.

Image 1. Démarrage d'une tâche

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.

Figure 2. Onglet Cible d'exécution

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 une interaction de l’utilisateur : P1 - qui ajoute des éléments de la file d’attente à une file d’attente, P2 - qui traite les éléments de 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 à l'aide de P1, ne l'affectez à aucun compte en particulier et définissez la priorité sur Élevée .
• 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 :

Figure 3. Priorités d'exécution

Orchestrator affecte les tâches en utilisant la séquence d’étapes suivante :

1. Un Robot devient disponible pour exécuter une nouvelle tâche.
2. Orchestrator identifie le modèle de machine affecté à ce Robot ainsi que tous les dossiers associés à ce modèle.
3. Orchestrator évalue toutes les tâches en attente dans ces dossiers.
4. Orchestrator attribue la tâche avec la priorité la plus élevée au Robot. Si plusieurs tâches ont la même priorité, elles sont envoyées au Robot dans l’ordre chronologique, de la plus ancienne à la plus récente.

Veuillez noter que les modèles de machine et les machines haute densité peuvent exécuter des tâches à partir de plusieurs dossiers de façon simultanée.

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.

• Où : page Automatisations > Déclencheurs

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 :

Priorité (Priority)	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 des 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. Elle est peut-être déjà terminée. » Pour savoir 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.