Gestion des tâches

Démarrage d'une tâche

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

1. Dans le dossier dans lequel se trouve le processus, sélectionnez Automations (Automatisations), puis accédez à Jobs (Tâches) et sélectionnez Start (Démarrer). Vous pouvez également démarrer une tâche à l'aide d'une des options suivantes :
   • Sous Automations (Automatisations), sélectionnez Processes (Processus), puis localisez le processus pertinent dans la liste et sélectionnez Start a Job (Démarrer une tâche) à la fin de la ligne.
   • Sous Automations (Automatisations), sélectionnez Triggers (Déclencheurs), puis localisez le déclencheur pertinent dans la liste et sélectionnez Start a Job Now (Démarrer une tâche maintenant) à la fin de la ligne.
2. Dans la fenêtre Start Job (Démarrer une tâche), utilisez la liste déroulante Process Name (Nom du processus) pour sélectionner un processus qui a déjà été déployé dans le dossier actuel.
   Remarque :

   • Si vous avez sélectionné Start a Job (Démarrer une tâche) dans la liste des processus, le processus sous-jacent est présélectionné dans la liste déroulante Process Name (Nom du processus).
   • Si vous avez sélectionné Start a Job Now (Démarrer une exécution maintenant) dans la liste des déclencheurs, le processus associé au déclencheur sous-jacent est présélectionné dans la liste déroulante Process Name (Nom du processus).
3. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.
4. 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 Job Priority (Priorité des tâches), sélectionnez la priorité de la tâche à exécuter si vous voulez qu'elle soit différente de la priorité définie au niveau du processus. Ce champ est automatiquement rempli 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.
  App Testing	La tâche est exécutée en mode sans assistance, ce qui consomme un runtime App Testing. Important : le runtime App Testing (Tests d'applications) peut exécuter uniquement les éléments suivants : Cas de test d'applications issus de projets d'automatisation de test. Processus de non-production pour tests d'applications, créés avec une licence App Test Developer. Si vous sélectionnez tout autre type de processus, vous ne pouvez pas sélectionner l'option App Testing (Tests d'applications) dans le menu déroulant Runtime type (Type de runtime).
  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 de la section Execution Target (Cible d'exécution) de la fenêtre Start Job (Démarrer une tâche) selon vos besoins.

Allouer dynamiquement

La sélection de Dynamic Allocation (Allocation dynamique) sans sélection explicite de compte et de machine vous permet d'exécuter un processus en premier plan plusieurs fois avec 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.
• La spécification simultanée du compte et de la machine signifie que le travail se lance sur cette paire compte-machine spécifique. Seules les paires compte-machine valides peuvent être sélectionnées.
• Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement le compte.

Remarque : si vous tentez d'exécuter une tâche sans qu'aucun compte approprié ne soit affecté au dossier, vous recevez un message d'erreur expliquant le problème. En outre, le bouton Assign an account to the folder (Affecter un compte au dossier) est mis en surbrillance. En sélectionnant le bouton, vous pouvez affecter un compte existant au dossier ou en créer un nouveau instantanément, puis reprendre le workflow Start Job (Démarrer une tâche).

Machine

Vous pouvez choisir l’une des approches suivantes :

• La spécification d'un objet machine signifie que le processus est exécuté sur 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 de la liste déroulante.
• La spécification simultanée du compte et de la machine signifie que le travail se lance sur cette paire compte-machine spécifique. Seules les paires compte-machine valides peuvent être sélectionnées.
• 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.

Activer Healing Agent

Pour recevoir des suggestions et des informations de débogage sur la façon de résoudre les problèmes pouvant survenir pendant l'exécution de la tâche, activez la bascule Enable Healing Agent (Activer Healing Agent). En outre, vous pouvez autoriser Healing Agent à résoudre de manière indépendante les problèmes d'exécution des tâches en sélectionnant l'option Enable Healing Agent self-healing (Activer l'auto-réparation de Healing Agent). Pour obtenir des informations détaillées sur Healing Agent et ses fonctionnalités, consultez la documentation Healing Agent.

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

Ce paramètre vous permet de configurer si les différents fragments d'une tâche de longue durée doivent être 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 une allocation dynamique, c'est-à-dire sans spécifier de machine ni de compte, avec une configuration de dossier incompatible, entraîne une erreur. Veillez à corriger la configuration. Autrement, les tâches restent en attente indéfiniment. Par exemple, vous ne pouvez pas exécuter une tâche .NET Framework 4.6.1 en arrière-plan lorsque le dossier ne contient que des configurations multiplateformes, car les tâches restent en attente jusqu'à ce que la configuration soit corrigée.

Ajouter des arguments

Dans la section Runtime Arguments (Arguments de runtime) de la fenêtre Start Job (Démarrer une tâche), configurez les paramètres suivants :

• Sélectionnez le point d'entrée. Si le processus ne prend pas en charge plusieurs points d'entrée, Orchestrator affiche Default (Défaut) dans la liste déroulante Entry point (Point d'entrée) et vous ne pouvez pas effectuer de sélection.

  Pour de plus amples d'informations, consultez la section Points d'entrée.

• Fournissez les arguments d'entrée du processus sélectionné.Le tableau est automatiquement rempli avec tous les arguments d'entrée acceptés par le processus sélectionné et les valeurs correspondantes héritées du package.

  Remarque : les arguments de la tâche ne peuvent pas dépasser 10 000 caractères.

Remarque :

Si l’

L'erreur Robots without credentials cannot run processes that require an interactive session. s’affiche et qu’aucune interaction d’interface utilisateur n’est nécessaire, utilisez l’option Démarrage en arrière-plan dans les paramètres du projet Studio.

Démarrer une tâche d'agent

Avant les étapes suivantes, vous devez créer un processus.

1. Accédez à Automations (Automatisations), puis à Jobs (Tâches) dans le dossier dans lequel se trouve le processus.
2. Cliquez sur Démarrer (Start). La fenêtre Démarrer la tâche s'affiche.
3. Dans la liste déroulante Process Name (Nom du processus), sélectionnez un processus qui a déjà été déployé dans le dossier actuel. Pour afficher uniquement les agents dans la liste déroulante, utilisez le filtre Filter types (Types de filtres) et sélectionnez Agent.
4. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.
5. Cliquez sur Start (Démarrer). La fenêtre Start Job (Démarrer une tâche) se ferme et la tâche démarre en fonction des paramètres que vous avez définis. Le statut de la tâche s'affiche en temps réel sur la page Jobs (Tâches).

Configurez la cible d'exécution

Configurez votre cible d'exécution en définissant les options que vous souhaitez dans l'onglet Execution Target (Cible d'exécution) de la fenêtre Start Job (Démarrer une tâche).

Planifiez la fin de l’exécution de la tâche

L'exécution du processus peut parfois présenter des problèmes, ce qui peut laisser la tâche en attente. L'activation de ce bouton bascule permet d'effectuer les opérations suivantes :

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

Compte (Account)

Vous pouvez choisir 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.
• Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement le compte.

Définir la configuration de l'environnement des tâches d'agent codées

Pour spécifier les variables d'environnement d'une tâche d'agent codée, utilisez le champ de texte Environment Configuration (Configuration de l'environnement). Les agents codés sont indiqués sous la forme (Agent – <programming language>) dans l'interface utilisateur.

Vous pouvez utiliser le champ Environment Configuration (Configuration de l'environnement) pour référencer des secrets, tels que les clés API, à l'aide de l'une des méthodes suivantes :

• Saisissez la valeur du secret directement dans le champ Environment Configuration (Configuration de l'environnement), comme le montre l'exemple suivant :

  SECRET=Abc@123

  Vous pouvez renforcer la sécurité des secrets en affichant des astérisques à la place de la valeur du secret dans les scénarios suivants :
  • Démarrage d'une tâche dont la configuration de l'environnement est héritée du processus sous-jacent.
  • Redémarrage d'une tâche.
  Pour activer ce comportement, vérifiez que le nom de la clé secrète se termine par l'une des chaînes suivantes :
  • ACCESS_KEY
  • API_KEY
  • AUTH
  • CREDENTIALS
  • PASSWORD
  • PRIVATE_KEY
  • SECRET
  • SESSION
  • TOKEN
  Pour mettre à jour la valeur du secret, vous pouvez supprimer les astérisques et entrer la nouvelle chaîne de caractères.
• Référencez une ressource de type secrète située dans le même dossier que l'agent, comme le montre l'exemple suivant :

  MySecret=%ASSETS/SECRET%

  Remarque :

  • Si vous saisissez =% après la clé secrète, une suggestion de remplissage automatique ASSETS/ s'affiche. Si vous acceptez la suggestion, une liste déroulante s'affiche, contenant les ressources parmi lesquelles vous pouvez sélectionner l'élément souhaité.
  • Vous ne pouvez pas récupérer de secrets à partir de magasins d'informations d'identification externes lorsque vous utilisez un proxy d'informations d'identification déconnecté.

Ajouter des arguments

Si le package contient des arguments d'entrée et/ou de sortie, ils s'affichent dans la section Runtime Arguments (Arguments de runtime), sous les onglets Input (Entrée) et Output (Sortie). Les valeurs des arguments sont héritées du package, mais vous pouvez les modifier selon les besoins.

Remarque : les arguments de la tâche ne peuvent pas dépasser 10 000 caractères.

Pour basculer entre les arguments et une vue du schéma JSON sous-jacent, sélectionnez JSON schema (Schéma JSON).

Démarrer une tâche de processus agentique.

Avant les étapes suivantes, vous devez créer un processus.

1. Accédez à Automations (Automatisations), puis à Jobs (Tâches) dans le dossier dans lequel se trouve le processus.
2. Cliquez sur Démarrer (Start). La fenêtre Démarrer la tâche s'affiche.
3. Dans la liste déroulante Process Name (Nom du processus), sélectionnez un processus qui a déjà été déployé dans le dossier actuel. Pour afficher uniquement les processus agentiques dans la liste déroulante, utilisez le filtre Filter types (Types de filtres) et sélectionnez Agentic process (Processus agentique).
4. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.
5. Cliquez sur Start (Démarrer). La fenêtre Start Job (Démarrer une tâche) se ferme et la tâche démarre en fonction des paramètres que vous avez définis. Le statut de la tâche s'affiche en temps réel sur la page Jobs (Tâches).

Configurez la cible d'exécution

Configurez votre cible d'exécution en définissant les options que vous souhaitez dans l'onglet Execution Target (Cible d'exécution) de la fenêtre Start Job (Démarrer une 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 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.

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.
• Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement le compte.

Ajouter des arguments

Si le package contient des arguments d'entrée et/ou de sortie, ils s'affichent dans la section Runtime Arguments (Arguments de runtime), sous les onglets Input (Entrée) et Output (Sortie). Les valeurs des arguments sont héritées du package, mais vous pouvez les modifier selon les besoins.

Remarque : les arguments de la tâche ne peuvent pas dépasser 10 000 caractères.

Pour basculer entre les arguments et une vue du schéma JSON sous-jacent, sélectionnez JSON schema (Schéma JSON).

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.

   Remarque : les arguments de la tâche ne peuvent pas dépasser 10 000 caractères.
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

Dans le menu More actions (Autres actions) de la tâche, sélectionnez Stop (Arrêter).Orchestrator affecte à la tâche le statut Stopping (Arrêt) et envoie une notification au robot, mais l'exécution du projet d'automatisation se poursuit.

Si une activité Should Stop (Doit s'arrêter) est rencontrée, elle renvoie true comme résultat. Vous pouvez utiliser le résultat comme marqueur pour déterminer quand appeler une activité Stop Job (Arrêter la tâche) afin de lancer un processus d'arrêt en douceur.

Si aucune activité Stop Job (Arrêter la tâche) n'est trouvée, l'exécution de la tâche ne s'arrête pas avant d'atteindre la fin du projet. Le statut final de la tâche est Successful (Réussi).

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 package sous-jacent
• le point d'entrée utilisé pour l'exécution de la tâche
• le robot et la machine d’exécution
• l'heure de début et l'heure de fin de la tâche
• la durée de la tâche
• 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

Remarque :

Pour les tâches d'agent et de processus d'agent, le volet Détails des tâches comprend un onglet nommé Trace (Traçage). Le traçage fournit une vue complète et hiérarchique de l'exécution de la tâche, de ses entrées et de ses sorties, ainsi que de toutes les autres ressources invoquées ou de toutes les tâches exécutées dans le cadre de l'exécution.

La vue du traçage vous permet également de fournir des commentaires positifs ou négatifs sur n'importe quel élément du traçage.

Dans l'affichage Traçage, lorsque vous activez/désactivez l’option Afficher les données brutes, vous pouvez réduire ou développer une section à l’aide de raccourcis clavier :

• Pour réduire une section, utilisez le raccourci Ctrl + Shift + [ sur un ordinateur Windows ou Linux, ou le raccourci Cmd + Option + [ sur un ordinateur macOS.
• Pour développer une section, utilisez le raccourci Ctrl + Shift + ]sur un ordinateur Windows ou Linux, ou le raccourci Cmd + Option + ] sur un ordinateur macOS.

Remarque : si Healing Agent est activé et détecte des problèmes pendant l'exécution de la tâche, un onglet nommé Healing Agents'affiche dans le panneau des détails de la tâche. L'onglet vous permet de télécharger le fichier de débogage ou de l'ouvrir dans Studio. Il vous fournit des informations sur les problèmes qui sont apparus lors de l'exécution de la tâche. Outre la description du problème, vous pouvez afficher des captures d'écran et des suggestions décrivant comment résoudre chaque problème. Si vous avez sélectionné Enable Healing Agent self-healing (Activer l'autoréparation de Healing Agent), l'onglet Healing Agent fournit également des informations détaillées sur la façon dont Healing Agent a résolu les problèmes qu'il a identifiés. Pour obtenir davantage d'informations sur Healing Agent et ses fonctionnalités, consultez la documentation de Healing Agent.

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.

Pour actualiser manuellement les journaux d’une tâche, sélectionnez le bouton Actualiser dans la section Journaux du panneau latéral de la tâche.

Pour les tâches qui ne sont pas dans un état En attente ou dans un état final, vous avez la possibilité d’actualiser automatiquement les journaux de tâche à un intervalle de dix secondes. Pour activer cette option, sélectionnez la liste déroulante à côté de Actualiser dans la section Journaux du panneau latéral de la tâche, puis sélectionnez Activer l’actualisation automatique. Le bouton Actualiser change d’apparence pour confirmer votre sélection. Cette option restera activée pour les tâches futures, même si vous actualisez la fenêtre de votre navigateur.

Les journaux d’une tâche sont actualisés automatiquement jusqu’à une minute après que la tâche a atteint sont état final. À ce stade, vous ne pouvez plus sélectionner Activer la réactualisation automatique et l’actualisation manuelle des journaux devient la seule option disponible.

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.