Gestion des tâches

Démarrage d'une tâche

Avant de suivre les étapes ci-dessous, vous devez créer un processus.

1. Accédez à Automatisations (Automations) > Tâches (Jobs) depuis le dossier dans lequel réside le processus.
2. Cliquez sur Démarrer (Start). La fenêtre Démarrer la tâche s'affiche.
3. Dans la liste déroulante Nom du processus (Process Name), sélectionnez un processus précédemment déployé vers le dossier actuel.
4. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.
5. Cliquez sur Démarrer (Start). La fenêtre Démarrer la tâche (Start Job) se ferme et, si des runtimes sont disponibles dans le dossier actuellement actif, la tâche démarre sur un robot en fonction des paramètres définis. Le Statut (State) de la tâche s'affiche en temps réel sur la page Tâches (Jobs).

Définition de la priorité de la tâche

Dans la liste déroulante Priorité des tâches (Jobs Priority), sélectionnez la priorité de la tâche à exécuter si vous souhaitez qu'elle diffère de la priorité définie au niveau du processus. Ce champ se renseigne automatiquement avec la priorité héritée du package.

Sélection du runtime d’exécution

Dans la liste déroulante Type de runtime (Runtime type), sélectionnez le type de runtime utilisé pour exécuter la tâche.

Le nombre de runtimes disponibles et connectés est affiché sous la liste déroulante.

• _ Disponible (Available) - Le nombre de runtimes disponibles, calculé comme le nombre total de runtimes moins le nombre de runtimes en cours d’exécution.

• _ Connecté (Connected) - Le nombre total de runtimes, calculé comme le nombre total de runtimes sur toutes les machines connectées à Orchestrator associé au dossier actif.

  Type de runtime	Description
  Production (Unattended)	La tâche est exécutée en mode Unattended et consomme un runtime Unattended.
  Test	La tâche est exécutée en mode Unattended et consomme un runtime de Test.
  Hors production (NonProduction)	La tâche est exécutée en mode Unattended et consomme un runtime NonProduction.
  Cloud - Serverless Testing	La tâche est exécutée en mode Unattended, sur une machine robot sans serveur qui a été configurée pour s'exécuter dans un environnement de test. Le nombre de Robot Units requis est spécifique aux environnements de test et dépend de la taille de la machine robot sans serveur et du nombre de minutes nécessaires à l'exécution d'une tâche. Voir Robot Units - Utilisation pour plus de détails.
  Cloud - Serverless	La tâche est exécutée en mode Unattended, sur une machine robot sans serveur qui a été configurée pour s'exécuter dans un environnement de production. Le nombre de robot units requis est spécifique aux environnements de production et dépend de la taille de la machine robot sans serveur et du nombre de minutes nécessaires à l'exécution d'une tâche. Voir Robot Units - Utilisation pour plus de détails.
  Cloud - VM Testing	La tâche est exécutée en mode Unattended, sur un Cloud - VM configuré pour s'exécuter dans un environnement de test ou de non-production. L'exécution de la machine virtuelle consomme les Robot Units pour les environnements de test. Voir Robot Units - Utilisation pour plus de détails.
  Cloud - VM	La tâche est exécutée en mode Unattended, sur un cloud - VM configuré pour s'exécuter dans un environnement de production. L'exécution de la machine virtuelle consomme les robot units pour les environnements de production. Voir Robot Units - Utilisation pour plus de détails.

Exemple : Imaginons que vous disposiez de 2 runtimes NonProduction et 1 runtime Unattended sur un modèle de machine A, et de 3 runtimes NonProduction et 2 runtimes Unattended sur un autre modèle de machine B. Les deux sont associés à un dossier. Pour chaque modèle, vous connectez une machine hôte. L'état de runtime obtenu est le suivant :

• Unattended : 3 Available, 3 Connected
• NonProduction : 5 Available, 5 Connected

Une tâche en cours d'exécution occupant un runtime retire 1 au nombre de runtimes disponibles pour ce type.

Remarque :

Au moment de la publication, Orchestrator choisit parmi les runtimes d'espace de travail personnel disponibles pour exécuter la tâche. La priorité du runtime est la suivante :

• Production (Unattended)
• Hors production (NonProduction)

Par exemple, si aucun runtime Production n'existe, Orchestrator utilise le runtime NonProduction disponible. S'il n'en existe pas non plus, la tâche échoue.

Si le runtime sélectionné devient indisponible entre les exécutions de tâche, l'exécution de tâche à venir échoue, car Orchestrator ne recherche pas le prochain runtime disponible.

Configurez la cible d'exécution

Configurez votre cible d'exécution en définissant les options ci-dessous comme vous le souhaitez dans l'onglet Cible d' exécution (Execution Target) .

Allouer 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 cette option, vous pouvez exécuter un processus jusqu'à 10 000 fois dans une seule tâche.

Compte (Account)

Vous pouvez choisir l’une des approches suivantes :

• La spécification d'un compte signifie que le processus est exécuté sous ce compte utilisateur ou Robot spécifique.
• Le fait de spécifier à la fois le compte et la machine signifie que la tâche se lance sur cette paire compte-machine en particulier. Seules les paires compte-machine valides sont disponibles pour la sélection.
• Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement le compte.

Machine

Vous pouvez choisir l’une des approches suivantes :

• La spécification d'un objet machine signifie que le processus est exécuté sur l'une des machines hôtes associées au modèle de machine sélectionné. Sélectionnez une machine hôte spécifique dans le pool de machines hôtes connectées dans le champ Machines connectées (Connected Machines).
• Le fait de spécifier à la fois le compte et la machine signifie que la tâche se lance sur cette paire compte-machine en particulier. Seules les paires compte-machine valides sont disponibles pour la sélection.
• Si vous ne spécifiez aucune machine, Orchestrator allouera dynamiquement la machine hôte.

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.

Sélectionner des mappages compte-machine valides

Choisissez la paire compte-machine spécifique qui exécutera la tâche.

Vous pouvez cliquer sur Ajouter un mappage compte-machine (Add Account-Machine mapping) si vous souhaitez que votre tâche s'exécute sur plusieurs de ces paires. Si vous procédez ainsi, 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.

Conserver l’affectation Compte/Machine à la reprise de la tâche

Ce champ permet de configurer si les différents fragments d'une tâche de longue durée sont exécutés sur la même paire compte-machine.

Par défaut, une tâche suspendue reprend sur n'importe quel robot disponible sur n'importe quelle machine disponible.

En fonction de vos besoins en licence ou en ressources, vous avez la possibilité de reprendre une tâche sur la même machine et dans le même contexte de compte que celui qui a démarré la tâche.

Supposons que vous ayez besoin d'une licence SAP pour exécuter une tâche. Au lieu d'installer une licence SAP sur chaque machine disponible (coûts accrus), vous pouvez l'installer sur une seule machine et utiliser cette machine pour démarrer et reprendre la tâche. La même stratégie peut s'appliquer aux licences d'utilisation. Vous ne pouvez allouer qu'une seule licence utilisateur et l'utiliser pour exécuter la tâche.

Planifiez 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. L’activation de la bascule vous permet (cliquez pour développer) :

• Sélectionnez Forcer l'arrêt (Kill) dans la liste déroulante - tente de forcer l'arrêt de l'exécution une fois l'intervalle de temps défini écoulé depuis que la tâche est bloquée dans l'état En attente (Pending) (définissez l'heure sur un minimum de 1 minute, et un maximum de 10 jours, 23 heures et 59 minutes) ;
  
  

  

  
  
• Sélectionnez Forcer l'arrêt (Kill) dans la liste déroulante - tente de forcer l'arrêt de l'exécution une fois l'intervalle de temps défini écoulé depuis que la tâche est bloquée dans l'état En attente (Pending) (définissez l'heure sur un minimum de 1 minute, et un maximum de 10 jours, 23 heures et 59 minutes) ;
  
  

  

  
  
• Sélectionnez Arrêter (Stop) dans la liste déroulante et activez l'option Si le travail ne s'arrête pas, forcer l'arrêt (If the job does not stop, kill it) - tente de mettre fin normalement à l'exécution une fois l'intervalle de temps défini écoulé depuis que le travail est bloqué dans un état En attente (Pending), puis tente d'en forcer l'arrêt une fois que l'intervalle de temps défini s'est écoulé depuis que le travail est bloqué dans un état En cours d'arrêt (Stopping) (définissez le temps sur un minimum de 1 minute, un maximum de 10 jours, 23 heures et 59 minutes).
  
  

  

  
  

Générer une alerte si l'exécution est bloquée en attente ou reprise

En activant le bouton bascule, vous activez des alertes sur les tâches qui conservent le statut En attente ou Reprise plus longtemps que la durée spécifiée.

La durée configurable est d'une minute au minimum et de onze jours au maximum.

Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte de gravité « Erreur » vous en informe avec le texte suivant :

"N tâches pour #process {process_number} ont été en attente ou ont repris pendant plus de X heures et Y minutes.", où :

• N : Correspond au nombre de tâches qui ont déclenché l'alerte
• {process_number} - l'identifiant du processus

• X  : le nombre d'heures configuré que la tâche a dépassée tout en ayant le statut en attente ou repris. Les jours sont convertis en heures.

• Y : Le nombre configuré de minutes que la tâche a dépassé tout en ayant le statut En attente ou Reprise.

Générer une alerte si une tâche s’est interrompue

En activant la bascule, vous activez les alertes sur les tâches qui ne se terminent pas dans la durée spécifiée.

La durée configurable est d'une minute au minimum et de onze jours au maximum.

Si la tâche dépasse la durée configurée, une fenêtre contextuelle d'alerte de gravité « Erreur » vous en informe avec le texte suivant :

"La tâche du #processus {numéro_processus} s’exécute depuis plus de X heures et Y minutes.", où :

• {process_number} - l'identifiant du processus

• X : le nombre d'heures configuré que la tâche a dépassé lors de sa tentative d'achèvement. Les jours sont convertis en heures.

• Y - le nombre configuré de minutes que la tâche a dépassé lors de sa tentative d'achèvement.

Orchestrator empêche le démarrage de tâches sur des configurations non valides. Essayer de démarrer une tâche dans une configuration non valide entraîne un message d'erreur avec une description vous fournissant des informations pour corriger votre configuration.

Le démarrage d'une tâche en utilisant l'allocation dynamique, c'est-à-dire sans machine ni compte spécifié, avec une configuration de dossier incompatible entraînera une erreur. Assurez-vous de corriger la configuration, sinon les tâches resteront en attente indéfiniment. Par exemple, essayer d'exécuter une tâche .NET Framework 4.6.1 en arrière-plan alors qu'il n'y a que des modèles multiplateformes dans le dossier ne fonctionnera pas, car les tâches resteront en attente jusqu'à ce que la configuration soit corrigée.

Ajouter des arguments

Dans l'onglet Arguments, fournissez les arguments d'entrée du processus sélectionné. Cet onglet se renseigne automatiquement avec tous les arguments d'entrée acceptés par le processus sélectionné et les valeurs correspondantes héritées du package.

Démarrer une tâche via un déclencheur d'API

Vous pouvez démarrer une tâche via un déclencheur d'API à partir de l'application tierce de votre choix. Suivez ces étapes :

1. Créez un déclencheur d'API en fonction du processus que vous souhaitez exécuter. Cela va générer l'URL requise pour démarrer la tâche. Suivez les instructions de la rubrique Créer un déclencheur d'API pour procéder à cela.
2. Créez un jeton d'accès personnel dédié et accordez-lui l'accès aux ressources nécessaires. Cela se fait au niveau de l'organisation, depuis la page Préférences > Jeton d'accès personnel. Une fois le jeton d'accès personnel enregistré, veillez à le copier immédiatement car il ne s'affichera plus ensuite.
3. Collez le jeton d'accès personnel dans le champ de jeton du porteur afin d'autoriser votre demande.
4. Obtenez l'URL de la tâche en cliquant sur l'option Copier l'URL complète du champ de données dynamique à côté du locataire souhaité dans la liste des déclencheurs, puis collez-la dans votre outil.
5. Configurez vos arguments en fonction de vos besoins.

   Vous pouvez saisir des arguments tels que :

   Paramètres de la chaîne de requête

   Pour une tâche disposant du champ de données dynamique hw-process ainsi que des arguments files et folders, la commande cURL que vous pouvez utiliser dans la ligne de commande ressemblera à ceci :

   curl --location --request POST 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process?argument1=files&argument2=folders' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ='

   Données du formulaire

   Pour une tâche disposant du champ de données dynamique hw-process ainsi que des arguments files et folders, la commande cURL que vous pouvez utiliser dans la ligne de commande ressemblera à ceci :

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ=' \
   --form 'argument1="files"' \
   --form 'argument2="folders"'

   Corps de texte JSON

   Pour une tâche disposant du champ de données dynamique hw-process ainsi que des arguments files et folders, la commande cURL que vous pouvez utiliser dans la ligne de commande ressemblera à ceci :

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Content-Type: application/json' \
   --data '{
       "argument1" : "files",
       "argument2" : "folders"
   }
   '

   Les arguments peuvent également être saisis en combinant certaines des méthodes ci-dessous.

6. Exécutez la tâche.

   En fonction du mode d'appel sélectionné dans la définition du déclencheur, la tâche s'exécutera comme suit :

   • Interrogation asynchrone

   • Déclenchement et oubli asynchrones

   • Synchronisation (interrogation longue)

   À noter que le mode d'appel peut être remplacé dans la chaîne ou le corps de la requête via le paramètre $callMode.

   Pour plus de détails sur ces options, consultez la section Explication des modes d'appel.

Limitation de débit

Le nombre de requêtes pouvant être effectuées vers le point de terminaison du statut est limité à 10 toutes les 10 secondes pour chaque tâche démarrée.

Limite de tâches en attente

Le nombre maximal de tâches en attente démarrées par le biais de déclencheurs d'API est de 100. Vous pouvez modifier ce nombre via le paramètre Déclencheurs - Déclencheurs d'API - Limite maximale de tâches en attente au niveau du locataire, qui présente une valeur par défaut de 10.

Arrêt d'une tâche

Cliquez sur le bouton Autres actions (More Actions) correspondant et sur Arrêter (Stop). Le projet d'automatisation est exécuté jusqu'à ce qu'il trouve une activité Should Stop. Pendant ce temps, la tâche est dans l'état En cours d'arrêt (Stopping). Si l'activité se produit, l'exécution est arrêtée et l'état final de la tâche est Réussi (Successful). Si une activité Should Stop est introuvable, l'exécution de la tâche ne s'arrête pas avant qu'elle n'atteigne la fin du projet. L'état final, dans ce cas précis, est également Réussi (Successful).

Remarque :

• Une tâche démarrée à partir d'Orchestrator ne peut être arrêtée qu'à partir d'Orchestrator.
• Il est possible de forcer l’arrêt d’une tâche commencée depuis Orchestrator depuis la page Tâches dans Orchestrator, ou bien en utilisant l’Assistant UiPath®.
• Une fois qu'une tâche est arrêtée, les planifications de fin de tâche sont perdues et vous devez reconfigurer les options Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) au redémarrage de la tâche.

Reprise d’une tâche

Cliquez sur le bouton Autres actions (More Actions) correspondant et sur Reprendre (Resume).

Abandon d'une tâche

Cliquez sur le bouton Autres actions (More Actions) correspondant et sur Forcer l'arrêt (Kill). Le projet d'automatisation est arrêté de force, l'état de la tâche est Arrêté (Stopped), et le message « Tâche annulée » s'affiche dans la fenêtre Détails de la tâche (Job Details).

Remarque :

• Il est possible de forcer l'arrêt d'une tâche commencée à partir Orchestrator aussi bien dans Orchestrator, depuis la page d'emploi, qu'en utilisant l'assistant UiPath.
• Il est possible de forcer l'arrêt d'une tâche commencée depuis Orchestrator à la fois dans Orchestrator, depuis la page Tâches (Jobs) et en utilisant l'Assistant UiPath.
• Une fois qu'une tâche est arrêtée, les planifications de fin de l'exécution de la tâche sont perdues et vous devez reconfigurer les options Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) au redémarrage de la tâche.

Redémarrage d'une tâche

Cette fonctionnalité vous permet d’exécuter rapidement une tâche à partir de la liste de tâches, sans passer par le flux de tâches de configuration. Vous pouvez redémarrer n’importe quelle tâche présentant un état final (Arrêté (Stopped), Défaillant (Faulted) ou Réussi (Successful)).

Remarque :

• Vous ne pouvez pas redémarrer les tâches déclenchées par des agents tels que l'Assistant ou via des sessions de débogage à distance de Studio.
• Lorsque vous redémarrez une tâche dont les options Planifier la fin de l'exécution de la tâche (Schedule ending of job execution) étaient actives, vous devez reconfigurer ces options.

Cette procédure suppose que vous avez auparavant démarré une tâche qui a déjà atteint un statut final.

1. Cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Redémarrer (Restart). La fenêtre Démarrer la tâche (Start Job) s’affiche, avec les paramètres initiaux de la tâche.
2. Effectuez les modifications souhaitées.
3. Cliquez sur Démarrer (Start). La fenêtre Démarrer les tâches (Start Jobs) se ferme et l'exécution démarre. L'état de chaque tâche s'affiche en temps réel sur la page Tâches (Jobs).

Affichage des détails de la tâche

Remarque :

• Lorsque le panneau latéral est ouvert, vous pouvez cliquer sur n’importe quelle tâche de la liste afin d’afficher ses détails spécifiques, pour tous les onglets inclus dans le panneau. La grille de la liste des tâches peut être déroulante horizontalement, avec la colonne Processus (Process) restant fixe si nécessaire pour la taille et la résolution de votre écran. Notez que vous pouvez augmenter la taille de certaines colonnes, ce qui entraînera l’affichage d’une barre de défilement pour un accès plus facile.

• Vous pouvez cliquer sur l’icône de Développer (Expand) dans le coin supérieur droit de n’importe quel onglet pour l’ouvrir sous forme de fenêtre pleine taille, avec le nom du processus sous-jacent dans la barre de navigation. Le bouton Réduire (Collapse) dans le même coin ramène la fenêtre à son état de panneau latéral.

• Les détails de la tâche n’incluent pas les considérations de licence pour les tâches qui échouent. Utilisez la fonctionnalité de surveillance pour plus de détails sur les licences.

Pour afficher les détails d’une tâche spécifique, cliquez sur le bouton Détails (Details) correspondant. Cela affiche un panneau latéral qui inclut la section Détails de la tâche (Job Details), vous fournissant diverses informations, telles que :

• le nom du processus sous-jacent
• le robot et la machine d’exécution
• les raisons de l'échec des tâches
• les raisons pour lesquelles la tâche ne démarre pas
• les actions que vous pouvez effectuer pour résoudre les éventuels problèmes et déclencher le démarrage de la tâche

Détails de la tâche terminée

Détails de la tâche en attente

Dans le contexte d’un locataire SAP, vous pouvez utiliser le bouton Revenir à SAP (Back to SAP) pour revenir au processus dans SAP Build Process Automation.

Affichage des journaux de tâches

Pour afficher les journaux d’une tâche spécifique, cliquez sur le bouton Détails (Details) correspondant. Cela affiche un panneau latéral qui inclut la section Journaux (Logs), avec des données concernant la tâche sélectionnée.

Remarque : Les journaux générés pour les tâches démarrées par le biais de sessions de résolution de débogage à distance ne sont pas disponibles sur la page Journaux de tâches (Job logs). Retrouvez-les sur la page globale Logs.

Afficher les conditions de reprise des tâches

Pour afficher les déclencheurs requis pour la reprise d’une tâche suspendue, cliquez sur le bouton Détails (Details) correspondant. Cela affiche un panneau latéral qui inclut l’onglet Conditions de reprise (Resume conditions), avec des détails sur les tâches de workflow configurées pour la tâche sélectionnée.

Vous pouvez cliquer dans la liste pour accéder aux déclencheurs des autres tâches.

Afficher la chronologie de la vidéo

Pour afficher l’enregistrement vidéo d’une exécution de tâche, ainsi que les journaux sous-jacents, cliquez sur le bouton Détails correspondant. Un panneau latéral s’affiche alors, lequel inclut l’onglet Chronologie de la vidéo, avec en haut un volet vidéo et en bas la liste des journaux.

Vous pouvez également accéder à cet onglet en cliquant sur Ouvrir l’enregistrement (Open recording) dans l’onglet Journaux du même panneau.

Pour plus de détails, consultez les rubriques dédiées à l'enregistrement vidéo.

Téléchargement des supports d'exécution

Pour télécharger l'enregistrement d'une tâche défectueuse, cliquez sur Autres options (More Options) > Télécharger l'enregistrement (Download Recording). Le support d'exécution téléchargé selon vos paramètres.