UiPath Documentation
orchestrator
2023.10
false
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur d'Orchestrator

Dernière mise à jour 30 mars 2026

Gestion des tâches

Démarrage d'une tâche

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

  1. Navigate to Automations > Jobs from the folder that the process resides in.
  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 , 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 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 runtimeDescription
    Production (Unattended)La tâche est exécutée en mode sans assistance, ce qui consomme un runtime Unattended (Sans assistance).
    TestLa tâche est exécutée en mode sans assistance, ce qui consomme un runtime Testing (Test).
    Hors production (NonProduction)La tâche est exécutée en mode sans assistance, ce qui consomme un runtime NonProduction (Non-production).
    Cloud - VM TestingLa 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 Unit - Consommation pour plus de détails.
    Cloud - VMLa 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 Unit - Consommation 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 :

  • Sans serveur
  • 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

Configure your execution target by setting the options below as desired on the Execution Target tab.

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

Capture d'écran de la page Démarrer la tâche

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

Machine

Vous pouvez choisir l’une des approches suivantes :

  • Specifying a machine object means the process is executed on one of the host machines attached to the selected machine template. Select a specific host machine from the pool of connected host machines on the Connected Machines field.
  • Le fait de spécifier à la fois le compte et la machine signifie que la tâche se lance sur cette paire compte-machine spécifique. 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.

Figure 2. Choisir une paire compte-machine spécifique pour exécuter la tâche

Capture d'écran de la page Démarrer 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 le faites, une tâche en attente 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) :

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

Figure 3. Arrêter l'exécution d'une tâche

Capture d'écran de l'option Planifier la fin de l'exécution de la tâche

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

Figure 4. Forcer l'arrêt d'une exécution de tâche

Capture d'écran de l'option Planifier la fin de l'exécution de la tâche

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

Figure 5. Arrêter l'exécution d'une tâche

Capture d'écran de l'option Planifier la fin de l'exécution de la tâche

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.

Figure 6. Page Démarrer une tâche dans une configuration non valide

Capture d'écran de la page Démarrer la tâche dans une configuration non valide

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

On the Arguments tab, provide input arguments for the selected process. This tab is automatically populated with all the input arguments accepted by the selected process, and the corresponding values inherited from the package.

Remarque :

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

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.

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 journaux de tâches

Pour afficher les journaux d'une tâche spécifique, cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Afficher les journaux (View Logs). La page Journaux (Logs) s'affiche et contient les données concernant la tâche indiqué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 .

Affichage des détails de la tâche

Pour afficher les détails d'une tâche spécifique, cliquez sur le bouton Afficher les détails (View Details) correspondant. Cela affiche la fenêtre Détails de la tâche (Job Details), où vous pouvez trouver 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

Figure 7. Détails de la tâche

Détails de la tâche terminée

Figure 8. Détails de la tâche en attente

Détails de la tâche en attente

Remarque :

Le champ Info n'affiche 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.

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.

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

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour