Gestion des tâches

Démarrage d'une tâche

Remarque :

La disponibilité des fonctionnalités dépend de l'offre Cloud que vous utilisez. Pour de plus amples informations, consultez la page Disponibilité des fonctionnalités.

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. In the Start Job page, use the Process drop-down to select a process that has been previously deployed to the current folder.
   Remarque :

   • If you selected Start a Job in the process list, the underlying process is pre-selected in the Process drop-down.
   • If you selected Start a Job Now in the trigger list, the process associated with the underlying trigger is pre-selected in the Process drop-down.
3. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.
4. Select Start. The Start Job window closes and, if there are available runtimes on the currently active folder, the job starts on a Robot according to the settings you made. The State of the job is displayed in real-time on the Jobs page.

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

Dans la liste déroulante Job Priority , 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: The App Testing runtime can execute only the following: 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. If you select any other type of process, you cannot select the App Testing option in the Runtime type drop-down menu.
  Robot de test d’application	La tâche est exécutée en mode non assisté, consommant un Runtime App Test Robot. Important: The App Test Robot runtime can execute only the following: Application test cases from a package of project type Test Automation . Workflows RPA pour App Testing (projet créé avec la licence App Test Developer). If you select any other type of process, you cannot select the App Test Robot option in the Runtime type drop-down menu.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.

  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)
    • NonProduction Par exemple, si aucun runtime de production n’existe, Orchestrator utilise un runtime NonProduction disponible. Si aucune n’existe, la tâche échoue. Si le runtime sélectionné devient indisponible entre les exécutions de tâche, l’exécution de la tâche à venir échoue, car Orchestrator ne recherche pas le runtime disponible suivant.

    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 sont disponibles pour la sélection.

  • Si vous ne spécifiez aucun compte, Orchestrator allouera dynamiquement le compte.

    Remarque :

    • Si vous tentez d'exécuter une tâche sans compte approprié affecté au dossier, vous recevrez un message d'Error 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).
    • Si seuls des groupes de comptes de robot sont affectés à un dossier, les comptes de robot individuels dans ces groupes ne peuvent pas être utilisés pour exécuter des tâches.Pour permettre à un compte de robot d’exécuter des tâches dans un dossier, le compte de robot individuel doit être explicitement affecté à ce dossier.

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

    Choose which specific account-machine pair will run the job. You can select Add Account-Machine mapping if you want your job to run on multiple such pairs. If you do so, a Pending job is created for each account-machine pair.

  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

  To receive suggestions and debugging information on how to fix issues that may arise during job execution, turn on the Enable Healing Agent toggle. Additionally, you can allow Healing Agent to independently fix job execution issues by selecting the Enable Healing Agent self-healing option. For detailed information on Healing Agent and its capabilities, refer to the Healing Agent documentation.

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

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 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îne une erreur. Assurez-vous de corriger la configuration, sinon les tâches resteront 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.

    Configuration des variables d'environnement

  Remarque :

  Environment configuration is only applied for Robot version 2025.10 and above.

  To specify environment variables for a job, use the Environment Configuration text field.

  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
    • TOKENPour 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 secret située dans le même dossier que la tâche, comme dans 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

    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 dans la liste déroulante Entry point 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'erreur Robots without credentials cannot run processes that require an interactive session. s'affiche et qu'aucune interaction avec l'interface utilisateur n'est nécessaire, vous pouvez utiliser l'option Démarre en arrière-plan dans les paramètres du projet Studio.

  Démarrer une tâche d'agent

  Remarque :

  La disponibilité des fonctionnalités dépend de l'offre Cloud que vous utilisez. Pour de plus amples informations, consultez la page Disponibilité des fonctionnalités.

  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 Démarrer (Start). 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 :

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 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
    • TOKENPour 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 Schéma JSON.

  Image 1. Schéma JSON

  

  Démarrer une tâche de processus agentique.

  Remarque :

  La disponibilité des fonctionnalités dépend de l'offre Cloud que vous utilisez. Pour de plus amples informations, consultez la page Disponibilité des fonctionnalités.

  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. From the Process Name drop-down, select a process that has been previously deployed to the current folder. To display only agentic processes in the drop-down, use the Filter types filter and select Agentic process.

  4. Configurez les champs obligatoires, comme indiqué dans les sections ci-dessous.

  5. Cliquez sur Démarrer (Start). 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) :

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 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 Schéma JSON.

  Figure 2. 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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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 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 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

  Click the corresponding More Actions button, and then Kill. The automation project is forcefully stopped, the job is marked as Stopped, and "Job canceled" is displayed in the Job Details window.

  Remarque :

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

  Duplicating a Job

  Select the corresponding More Actions button, and then Duplicate job. This action is available for jobs in non-terminal states:

  • En attente
  • En cours d'exécution
  • En cours d'arrêt
  • En fin d'exécution
  • Suspendue
  • Reprise

  This option opens the Start Job form pre-filled with the original job’s configuration.

  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 :

  • While the side panel is open, you can select any job in the list to display its particular details, for all tabs included in the panel. You can scroll the jobs list grid horizontally, with the Process column remaining fixed if needed for your particular screen size and resolution. Note that you can increase the size of some columns, which will cause a scroll bar to be displayed for easier access.
  • You can select the expand icon in the upper-most corner of any tab to open it as a full-sized window, with the name of the underlying process in the breadcrumbs. The Collapse button in the same corner brings the window back to its side panel state.
  • 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.

  To view details about a specific job, select the corresponding Details button. This displays a side panel which includes the Job Details section, providing you with various information:

  • Graph: you can toggle the graph view on or off using the Graph button. The graph provides a visualization of related job executions (parent, child, sblings as applicable), complementing the Trace tree view.

  • Error: error information generated during job execution.

  • Resume conditions: conditions and triggers configured for job resumption.

  • Autopilot Healing: information related to Autopilot Healing actions applied to the job.

  • Job information: core job metadata and execution status details. When applicable, this card displays pending reasons, explaining why a job is waiting or blocked.

  • Environment Variables: environment variables available at job execution time.

  • Input: the input arguments of the job.

  • Output: the output arguments of the job.

  • Raw message: unprocessed message that the job emitted before formatting.

  • Runtime details: runtime-related information for the job execution. Some fields and actions are displayed conditionally, depending on job type and status.

    • Start time: the date and time when the job execution started.
    • End time: the date and time when the job execution ended.
    • Duration: the total execution time of the job.
    • Creation time: the date and time when the job was created.
    • Consumption: the number of consumed units for the job execution, when applicable.
    • Actions: applicable to video recordings, this section includes:
      • Open, to open the video recording.
      • Delete, to delete the video recording.

  • Execution environment: execution information:

    • Package: the name and version of the package used to execute the job.
    • Host identity: the identity under which the job was executed.
    • Machine: the machine template assigned to the job execution.
    • Robot: the robot used to execute the job.
    • Account/Identity: the account under which the robot executed the job.
    • Hostname: the name of the machine where the job was executed.
    • Healing agent: indicates whether Autopilot Healing is enabled for the job.
    • Healing agent self-healing: indicates whether self-healing actions are enabled for the healing agent.

  • Job state history: a chronological timeline of the job states and the duration spent in each state.

  • Additional information: additional job details:

    • Job key: a unique identifier assigned to the job.
    • Entry point: the workflow or process entry point used to start the job.
    • Type: the type of job executed, such as an agentic process.
    • Runtime type: displayed for certain job types, provides additional classification of the runtime used to execute the job.
    • Source: the trigger or source that initiated the job execution.
    • Priority: the priority level assigned to the job.
    • User interaction: describes if user interaction is Required or Not required.
    • Healing agent status: the current status of the healing agent for the job.
    • Machine size: the machine size used for the job execution, when available.
    • Screenshots: screenshots associated with the job execution, when available.

  • Attachments: files associated with the job execution.

  • Human review: information related to human review activities linked to the job.

    When the content of the Input and Output arguments of a job is large, only a portion of it is shown by default.

    Si l'argument dépasse cette taille, l'intégralité du contenu est sauvegardée sous forme de fichier dans un stockage distant et peut être chargée ou téléchargée au besoin :

  • Expand - loads the full file in the editor, up to a certain size limit.

  • Download - downloads the full file when the argument size exceeds the limit.

  • Copy - for improved performance, available only for arguments within a certain limit.

    Remarque :

    If Healing Agent is enabled and detects issues during job execution, a Healing Agent tab appears in the job details panel. The tab allows you to download the debug file or open it in Studio, and provides you with information on the issues that occurred during job execution. In addition to the issue description, you can view screenshots and suggestions on how to address each issue. If you selected Enable Healing Agent self-healing, the Healing Agent tab also provides details on how Healing Agent addressed the issues it identified. For more information on Healing Agent and its capabilities, refer to the Healing Agent documentation.

    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 traces de tâche

  Remarque :

  La disponibilité des fonctionnalités dépend de l'offre Cloud que vous utilisez. Pour de plus amples informations, consultez la page Disponibilité des fonctionnalités.

  For agent and agentic process jobs, the job details panel includes a Trace tab. The trace provides a comprehensive, hierarchical view of the job run, its input and output, as well as any other resources invoked or jobs executed in connection with the run. The trace view also allows you to provide positive or negative feedback, as well as comments, on any of the trace items.

  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.

    For agent jobs, feedback added in the Trace view is automatically available in the Agents Evaluations panel during design time, allowing you to create evaluations from job runs, edit them, and refine your agent based on manually entered feedback. Read more about Evaluations.

    Figure 3. Agent runtime traces

    

  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 des tâches.

  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 la chronologie de la vidéo

  Remarque :

  If a job was suspended and later resumed, the video timeline displays only the execution that occurred after the job resumed.

  To view a video recording of a job execution, along with the underlying logs, select the corresponding Details button. This displays a side panel which includes the Video timeline tab, with a video pane on top, and a logs list at the bottom.

  You can also access this tab by selecting Open recording on the Details tab of the same panel.

  For details, check the topics dedicated to video recording.

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

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