UiPath Documentation
orchestrator
latest
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 17 avr. 2026

Paramètres

La page Paramètres (Settings) permet aux Administrators d'ajuster les paramètres du locataire Orchestrator.

Onglet Général (General)

Champ

Description

Paramètres d’application

Fuseau horaire (Time Zone) : le fuseau horaire du tenant. Par défaut, ce champ est configuré sur UTC.

Espaces de travail personnels

For Automation Cloud and Test Cloud or Automation Cloud Dedicated, Automatically configure Serverless machines in Personal Workspace for Studio Web users - Option selected by default, allowing Serverless machines to be automatically provisioned in the personal workspaces of users who design or debug in Studio Web.

For Automation Cloud and Test Cloud or Automation Cloud Dedicated, deselecting the option prevents Serverless machines from being automatically created in personal workspaces, which may impact designing or debugging processes in Studio Web.

Note: For Automation Cloud and Test Cloud or Automation Cloud Dedicated, deselecting the option does not deallocate the Serverless machine from your personal workspace. Explicit deallocation of the Serverless machine might be required.

Automatically stop exploring Personal Workspaces after - Allows Orchestrator administrators to enforce a rule dictating that personal workspace exploration is automatically stopped after a set amount of time.

Les options disponibles sont 15 minutes, 1 heure (1 hour), 1 jour (1 day) et valeur personnalisée (custom value).

Par défaut, lors de la migration ou de la création de locataires, cette valeur n'est pas définie. Vous devez la configurer manuellement une fois le processus de migration/création terminé.

Arrêter toutes les sessions actives pour explorer les espaces de travail personnels (Stop all active sessions for exploring Personal Workspaces) : permet aux Orchestrator Administrators d'arrêter toutes les sessions d'exploration d'espaces de travail personnel actives. S'ensuit le nombre de sessions actives, affiché entre parenthèses, et cette option peut être activée en cliquant sur Arrêter l'exploration de la/des session(s) (Stop session(s) explore).

Les modifications que vous apportez aux paramètres d'exploration ne s'appliquent pas rétroactivement aux sessions qui ont déjà été explorées.

Mass enable Personal workspaces for current users and groups: - Create personal workspaces for all users in a tenant that use a certain attended licensing profile, while also selecting the UI profile to be used for those users.

Cette action ne peut pas être annulée, une fois que la fonctionnalité Espaces de travail personnels (Personal Workspaces) a été activée, elle ne peut plus être désactivée.

Rôles standard

Create standard roles for folders. These roles allow you to leverage the benefits of user groups.

Cliquez sur Créer un rôle (Create Role) en regard de chacun des rôles que vous souhaitez créer.

Paramètres de mise à jour automatique des binaires client (Robot, Studio, Assistant)

Ignorer le statut de mise à jour automatique pour les machines robot qui étaient hors ligne pendant plus de ___ jours - Exclut les machines inactives du processus de mise à jour et ne les prend plus en compte lorsque le statut de mise à jour est signalé.

Dossiers

Activer les mappages compte-machine : permet d'activer la fonctionnalité Mappages compte-machine .

Section Paramètres d'exécution (Execution Settings)

Remarque :

In this section, settings pertaining to triggers apply to all process types. However, settings pertaining to queues and jobs do not apply to agents and agentic processes.

Champ/Valeur par défaut

Description

Déclencheurs - Stratégie de comptage des tâches

( Triggers.JobsCountStrategy )

Default value: Per Process

Choisissez la stratégie en termes de nombre de tâches pour les tâches lancées via des déclencheurs.

Notez que cela ne prend pas en compte les arguments qui ont pu être fournis.

Les options suivantes sont disponibles :

  • Per Process - A trigger launches the required number of jobs taking into account any pending jobs for the specified process. For example, two triggers defined for the same process launch 3 and 5 jobs, respectively. If the first trigger launches 3 jobs at a given point in time, when the second trigger is set off, 2 jobs are launched so as to reach the 5 required jobs.
  • Per Trigger - A trigger launches the required number of jobs taking into account any existing jobs previously launched by that same trigger. For example, a trigger is defined to launch 5 jobs at a given point in time. If 3 jobs have been successfully completed by the time this trigger is set off again, Orchestrator launches another 2 jobs so as to reach the 5 required jobs.

Déclencheurs - Déclencheurs de file d'attente - Activer la stratégie des tâches en attente

( Features.QueueTriggers.PendingJobsStrategy )

Default value: True

Choisissez la méthode de calcul du nombre de tâches supplémentaires à déclencher lorsque de nouveaux éléments sont ajoutés à une file d'attente. Pour ce faire, il faut soustraire le nombre d'emplois dans un certain état du nombre maximal ciblé d'emplois à créer.

Les options suivantes sont disponibles :

  • True - This option is best suited for cases where you want Orchestrator to assume that all running jobs have already moved queue items out of the status New .

Le nombre est calculé comme suit :

Maximum additional jobs to be created based on newly available queue items = the maximum number of pending and running jobs allowed simultaneously minus the number of jobs in a Pending state.

  • False - This option is best suited for cases where you want Orchestrator to assume all running jobs have yet to move queue items out of the status New .

Le nombre est calculé comme suit :

Maximum additional jobs to be created based on newly available queue items = the maximum number of pending and running jobs allowed simultaneously minus the number of jobs in one of these states: Pending , Resumed , Running , Stopping , Terminating .

Déclencheurs - Désactiver lors du comptage des échecs de création de tâche

( Triggers.DisableWhenFailedCount )

Default value: 10

Configurez un déclencheur pour qu'il soit désactivé automatiquement après un certain nombre de lancements échoués et qu'aucune exécution réussie ne se soit produite pendant un nombre de jours spécifique.

This option works in conjunction with Triggers -Grace period when job creation keeps failing count (days) , as follows: Triggers - Disable when job creation fail count allows you to adjust the number of failed runs, whereas Triggers - Disable when it keeps failing count (days) enables you to change the number of days.

By default, the Triggers - Disable when job creation fail count value is 10, and the Triggers - Grace period when job creation keeps failing count (days) value is 1, which means that the trigger is disabled after 10 unsuccessful attempts to launch if there were no successful runs in the past day.

Cette option peut être définie dans une plage de 10 à 100.

Déclencheurs - Période de grâce lors du comptage des échecs répétés de création de tâche (jours)

( Triggers.DisableWhenFailingSinceDays )

Default value: 1

Configurez un déclencheur pour qu'il soit désactivé automatiquement après un certain nombre de lancements échoués et qu'aucune exécution réussie ne se soit produite pendant un nombre de jours spécifique.

This option works in conjunction with Triggers - Disable when failed count , as detailed above.

Il peut être défini dans une plage de 1 à 30.

Déclencheurs - Déclencheurs connectés - Désactiver lors du comptage des échecs d'exécution de tâche

Default value: 5

Remarque :

Cela cible uniquement les déclencheurs connectés (c’est-à-dire les déclencheurs créés dans Studio Web) publiés sur l’espace de travail personnel.

Le déclencheur est désactivé après le nombre d'exécutions échouées que vous choisissez pour ce paramètre.

Il peut être défini dans une plage de 0 à 100, où 0 signifie que le déclencheur n’est jamais désactivé.

If you select 0, Triggers - Connected triggers - Grace period when job execution keeps failing count (days) becomes irrelevant, and its field is disabled.

Ce paramètre est uniquement valide pour les déclencheurs connectés récemment créés. Les modifications ne sont pas appliquées rétroactivement aux déclencheurs connectés existants.

Déclencheurs - Déclencheurs connectés - Période de grâce lors du comptage des échecs répétés d'exécution de tâche (jours)

Default value: 0

Remarque :

Cela cible uniquement les déclencheurs connectés (c’est-à-dire les déclencheurs créés dans Studio Web) publiés sur l’espace de travail personnel.

Ce paramètre détermine le nombre de jours avant la désactivation du déclencheur après le premier échec d’une tâche.

Il peut être défini dans une plage de 0 à 30.

If Triggers - Connected triggers - Disable when job execution fail count is 0, this field is disabled.

Déclencheurs - Déclencheurs d'API - Limite maximale de tâches en attente

Default value: 10

Set the maximum number of pending jobs that can be created by an API trigger .

La plage prise en charge s’étend entre 1 et 100.

Files d'attente - Abandon en cours des éléments de la file d'attente après le seuil (heures)

( inProgressMaxNumberOfMinutes )

Default value: 24

Set the maximum amount of time, in hours, that queue items can have the In Progress status. After this time, the status of the queue items changes to Abandoned .

The default value is 24 hours, which means that queue items cannot be marked as Abandoned unless they have had the In Progress status for at least one day.

Ceci est géré par une tâche en arrière-plan qui s'exécute une fois par heure. Par conséquent, vous pouvez vous attendre à ce que la transition se produise jusqu'à une heure après la valeur sélectionnée.

Files d’attente (Queues) : fréquence de vérification des éléments de file d’attente non traités (minutes)

( Queue.ProcessActivationSchedule )

Default value: 30

Le temps entre les vérifications pour les éléments de file d’attente non traités.

Pour ajuster l'intervalle de vérification, vous pouvez choisir entre 10, 15, 20, 30 ou 60 minutes.

Pour chaque déclencheur de file d'attente que vous créez, nous générons un déclencheur de temps en arrière-plan destiné à gérer les éléments de la file d'attente qui n'ont pas pu être traités au moment même où ils ont été mis en file d'attente. Ce déclencheur de temps en arrière-plan est utilisé pour calculer la fréquence dictée par le paramètre.

Existing queue triggers : the setting is applied when the default value is changed for the first time, and cannot be restored.

New queue triggers : the setting is always applied.

Important :

  • L'horodatage de référence utilisé est basé sur l'heure à laquelle le déclencheur de file d'attente a été créé. Par exemple, si un déclencheur de file d'attente est créé à 14:22:43 et que cette option est définie sur 10 minutes, la récurrence suivante est générée : 14:32:43, 14:42:43, 14:52:43, et ainsi de suite.
  • La tâche en arrière-plan qui effectue les modifications déclenchées par ce paramètre peut prendre jusqu'à 10 minutes pour entrer en vigueur.

Tâches - Délai d'attente de fin (heures)

( Jobs.TerminatingJobsTimeout )

Default value: 24

Set the time elapsed, in hours, until Terminating jobs become fit to be marked as Failed .

The default value is 24, which means that jobs cannot be marked as Failed unless they have been in a Terminating state for at least one day.

Ceci est géré par une tâche en arrière-plan qui s'exécute une fois par heure. Par conséquent, vous pouvez vous attendre à ce que la transition se produise jusqu'à une heure après la valeur sélectionnée.

Section Paramètres de l’API

ParamètreDescription
Liste d’autorisation CORS pour les déclencheurs d’APIAllows you to enter domains permitted for incoming traffic. Separate distinct domains through a comma or by pressing Enter.
Exiger l'en-tête d'authentification pour les redirections de déclencheurs d'API de synchronisationThis is enabled by default, and it enforces the use of an authentication header when selecting the Sync (long-polling) call mode for an API trigger.
API stricteIf enabled, certain API fields become non-filterable and/or non-sortable, thus helping prevent performance issues. You can see a list of these fields in the dedicated page. This setting is enabled by default for new tenants, but existing tenants need to be opted in manually. Keeping this option enabled at all times is a recommended best practice in API integrations.

Onglet Déploiement (Deployment)

Vous permet de configurer et de sécuriser les flux des packages et des bibliothèques. Vous pouvez gérer les flux de tous les locataires à partir d'un emplacement centralisé à l'aide d'Automation Ops. Pour plus d'informations, consultez la section sur la gestion des flux dans le guide d'Automation Ops.

Les paramètres qui se trouvent ici n'affectent que les flux de locataires ; les flux de dossier et les flux d'espace de travail personnel sont toujours internes et disponibles uniquement dans le contexte du dossier ou de l'espace de travail personnel respectif.

Paquets

Vous permet également de définir un flux interne ou externe dans lequel les packages d'automatisation peuvent être maintenus. Par défaut, un flux interne est utilisé. Les flux peuvent être sécurisés en définissant des identifiants d'authentification de base ou en utilisant une clé API.

Champ

Description

Interne (Internal)

Utilisez un flux interne. Le flux peut être sécurisé soit avec l'option Déploiement sécurisé (Secure Deployment), soit en utilisant une clé API :

  • Déploiement sécurisé (Secure Deployment) : vérifie que vos packages d'automatisation sont téléchargés via un flux NuGet sécurisé.
  • Clé API (API Key) : clé utilisée pour protéger votre flux contre les opérations d’écriture telles que la suppression ou le téléchargement. Cette opération est requise uniquement si vous souhaitez charger un package directement dans le flux NuGet via un client externe.
Important : vous ne pouvez utiliser l'option API key que pour authentifier les téléversements de packages. Pour authentifier les téléchargements de packages, utilisez l'option Secure Deployment .

Externe

Utilisez un flux externe. Vous pouvez sécuriser le flux via une clé API ou des informations d’identification de base :

  • Deployment URL * - The address where the NuGet feed is located.

  • Clé API (API Key) : clé utilisée pour protéger votre flux contre les opérations d’écriture telles que la suppression ou le téléchargement.
  • Authentification (Authentication) : vous permet de spécifier les informations d’identification de votre flux de base authentifié.

Gardez à l'esprit que le nom d'utilisateur et le mot de passe utilisés avec l'option Clé API (API Key) doivent être également utilisés dans ce cas.

Important :

Nous ne prenons pas en charge les packages multiplateforme téléchargés vers un flux externe. Leurs métadonnées ne peuvent être lues que si elles sont téléchargées directement dans Orchestrator.

Authentifier les flux à l'aide de jetons de porteurs JWT grâce à une autorisation de base

Vous pouvez spécifier des jetons d'accès personnels et d'autres jetons de porteurs JWT pour authentifier vos flux, comme le montre l'exemple suivant :

curl https://:<rt_my-reference-token>@cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json
curl https://:<rt_my-reference-token>@cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json

L'approche commune à tous les principaux flux NuGet consiste à utiliser le mot de passe d'autorisation de base pour envoyer le jeton d'accès personnel. Cela vous permet d'utiliser les mécanismes d'authentification intégrés de NuGet, comme le montre l'exemple suivant :

<configuration>
  <packageSources>
    <add key="myfeed" value="cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <myfeed>
      <add key="Username" value="" />
      <add key="ClearTextPassword" value="%UIPATH_PAT%" />
    </myfeed>
  </packageSourceCredentials>
</configuration>
<configuration>
  <packageSources>
    <add key="myfeed" value="cloud.uipath.com/myorg/DefaultTenant/orchestrator_/nuget/v3/5830878b-1a38-47d9-9689-4fb543e2e227/index.json" />
  </packageSources>
  <packageSourceCredentials>
    <myfeed>
      <add key="Username" value="" />
      <add key="ClearTextPassword" value="%UIPATH_PAT%" />
    </myfeed>
  </packageSourceCredentials>
</configuration>

Additionally, you can integrate the feeds using secure credential providers. For further information, refer to the Microsoft documentation.

Bibliothèques

Vous permet de configurer le flux à utiliser pour les packages de bibliothèques et d'activités.

Champ

Description

Flux d’hôte uniquement

Les bibliothèques sont stockées dans le flux hôte et sont disponibles pour tous les locataires qui l'utilisent. La page Bibliothèques (Libraries) est la même pour une seule instance d'Orchestrator, cela implique que les bibliothèques ne sont pas isolées au niveau du locataire : chaque locataire a accès à l'activité des autres locataires.

Vous ne pouvez pas télécharger de bibliothèques depuis Orchestrator si cette option est sélectionnée.

Cette option permet au robot d'accéder uniquement au flux de l'hôte.

Seul le flux de locataire

Les bibliothèques sont isolées au niveau du locataire. Cela implique que les données sont séparées entre les locataires. Vous pouvez définir un flux interne ou externe dans lequel les bibliothèques sont conservées. Par défaut, un flux interne est utilisé.

Cette option permet au robot d'accéder uniquement au flux du locataire.

Flux d’hôte et de locataire

Les bibliothèques sont isolées au niveau du locataire. Cela implique que les données sont séparées entre les locataires. Vous pouvez définir un flux interne ou externe dans lequel les bibliothèques sont conservées. Par défaut, un flux interne est utilisé.

Cette option permet au robot d'accéder à la fois aux flux de l'hôte et du locataire.

Interne (Internal)

Affiché lorsque Flux du locataire uniquement ou Flux de l’hôte et du locataire à la fois est sélectionné.

Utilisez un flux interne pour vos bibliothèques. Le flux peut être sécurisé à l'aide de l'option Déploiement sécurisé ou à l'aide d'une clé API :

  • Déploiement sécurisé (Secure Deployment) : vérifie que vos packages d'automatisation sont téléchargés via un flux NuGet sécurisé.
  • Clé API (API Key) : clé utilisée pour protéger votre flux contre les opérations d’écriture telles que la suppression ou le téléchargement.

Externe

Affiché lorsque Flux du locataire uniquement ou Flux de l’hôte et du locataire à la fois est sélectionné.

Utilisez un flux externe pour vos bibliothèques. Le flux peut être sécurisé à l'aide d'une clé API ou d'identifiants d'authentification de base :

  • Deployment URL * - The address where the NuGet feed is located.
  • Clé API (API Key) : clé utilisée pour protéger votre flux contre les opérations d’écriture telles que la suppression ou le téléchargement.
  • Authentification (Authentication) : permet de spécifier les informations d’identification (nom d’utilisateur et mot de passe) de votre flux de base authentifié.

Gardez à l'esprit que le nom d'utilisateur et le mot de passe utilisés avec l'option Clé API (API Key) doivent être également utilisés dans ce cas.

For more details, read through the Library feeds page.

Onglet Sécurité des Robots

Sécurité

ChampDescription
Nombre total d'heures pendant lesquelles un robot peut fonctionner hors ligne sans vérification de licenceSpécifiez le nombre d'heures pendant lesquelles un Robot peut s'exécuter hors ligne, sans qu'Orchestrator ne vérifie sa licence. Par défaut, cette valeur est définie sur 0. La valeur maximale acceptée est de 168 heures.

Authentification du Robot

ChampDescription
Authentification de Unattended RobotClient credentials (Recommended) - This option only allows for connections with tokens that expire. It uses the OAuth 2.0 framework as the basis for the authentication protocol, meaning unattended robots can connect to Orchestrator with a client ID - client secret pair generated via machine template objects. The client ID - client secret pair generates a token that authorizes the connection between the robot and Orchestrator and provides the robot with access to Orchestrator resources. Hybrid - This option allows for both connections with tokens that don't expire (machine key) and connections with tokens that expire (client credentials).
Authentification de l'Attended RobotInteractive Sign-in SSO (Recommended) - This option only allows for robot connections with tokens that expire. Users can authenticate their robots only by signing-in with their credentials in the Assistant. User sign in is required to run attended robots, make Orchestrator HTTP requests, or view processes in the Assistant. When using interactive sing-in, there is no need to create machine objects in Orchestrator. User license management option enforeces Interactive Sign-In (SSO) for Attended robot authentication. Hybrid - This option allows for both connections with tokens that don't expire (machine key) and connections with tokens that expire (interactive sign-in or client credentials). Users have the option to sign-in with their credentials to authenticate their robots, which in turn allows them to connect Studio and the Assistant to Orchestrator, however it is not mandatory.

Onglet Evolutivité (Scalability)

Permet de spécifier si le service Robot doit s'abonner aux canaux SignalR d'Orchestrator, et vous aide à configurer les protocoles de transport qui fonctionnent le mieux pour vous.

Figure 1. Scalability tab

Capture d'écran de l'onglet Évolutivité

SignalR (Robots)

Champ

Description

Activé (Enabled)

Cette bascule spécifie si le service Robot doit s'abonner ou non aux canaux SignalR d'Orchestrator. Par défaut, ce paramètre est activé, et tous les canaux disponibles sont sélectionnés :

  • WebSocket
  • Événements envoyés par le serveur (SSE)
  • Interrogation longue

Lorsque tous les canaux de transport sont activés, le meilleur transport disponible est automatiquement sélectionné, dans l'ordre de priorité suivant : WebSocket (WebSocket) > Événements envoyés par le serveur (Server-Sent Events) > Interrogation Longue (Long Polling). Si le premier protocole n'est pas disponible pour une raison quelconque, le prochain en ligne (si activé) est utilisé pour faciliter la communication entre Orchestrator et Robot.

La désactivation de SignalR sur le locataire peut entraîner un mauvais fonctionnement ou un arrêt total de certaines capacités UiPath, y compris Studio Web.

WebSocket

Lorsque cette option est sélectionnée, le protocole de transport WebSocket peut être utilisé pour connecter le Robot aux canaux SignalR d'Orchestrator. Il s'agit du premier protocole utilisé dans l'ordre de priorité en raison de ses performances et de la prise en charge de la communication simultanée dans les deux sens : du service Robot à Orchestrator et inversement.

If the SignalR (Robots) feature is not enabled, WebSocket becomes the only available transport protocol.

Événements envoyés par le serveur (SSE)

Lorsque cette option est sélectionnée, la technologie d'envoi d'événements envoyés par le serveur (SSE) doit être utilisée pour connecter le Robot aux canaux SignalR d'Orchestrator. Il s'agit de la première sauvegarde au cas où WebSockets ne serait pas disponible pour une raison quelconque.

Cette option ne peut pas être utilisée si la fonctionnalité SignalR (Robots) (SignalR (Robots)) n'est pas activée.

Interrogation longue

Lorsque cette option est sélectionnée, le protocole de transport à interrogation longue doit être utilisé pour connecter le Robot aux canaux SignalR d'Orchestrator. Ce protocole est utilisé lorsque WebSockets et SSE ne sont pas disponibles.

Cette option ne peut pas être utilisée si la fonctionnalité SignalR (Robots) (SignalR (Robots)) n'est pas activée.

Onglet Jours non ouvrables

Définit une liste de jours non ouvrables, par locataire, sur laquelle vous pouvez restreindre l’exécution des déclencheurs. Cela signifie que, pendant les jours fériés, les week-ends ou tout autre jour où les activités commerciales normales ne sont pas exercées, vos horaires à long terme peuvent être configurés de manière à ne pas se déclencher. Une fois que les jours fériés définis sont passés, le programme se déclenche comme d'habitude.

Afin d’appliquer ces restrictions à vos déclencheurs, vous devez sélectionner le calendrier des jours non ouvrables lors de la configuration des déclencheurs. Toutes les modifications que vous effectuez dans l'onglet Jours non ouvrables (Non-Working Days) affectent tous les déclencheurs qui utilisent ce calendrier.

Pour plus d'informations sur la gestion des jours non ouvrables, cliquez ici.

Connexions au cloud

This tabs allows you to configure integrations with third-party cloud service providers (CSPs) which are used for elastic robot orchestration.

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