Wait Queue Item

Activité Attendre un élément de la file d’attente qui récupère un élément de la file d’attente Orchestrator d’une file d’attente spécifiée et le stocke dans une variable QueueItem.

UiPath.Core.Activities.WaitQueueItem

Description

Récupère un élément de file d' attente Orchestrator d'une file d'attente spécifiée et le stocke dans une variable QueueItem . Cette activité est différente de l'activité Obtenir l'élément de transaction car, au moment de l'exécution, si la file d'attente spécifiée est vide, elle envoie un message à Orchestrator indiquant qu'il est prêt à recevoir un élément de file d'attente, puis attend qu'un nouvel élément de file d'attente y soit ajouté la file d'attente spécifiée. Une fois récupéré, le statut de l'élément de file d'attente est défini sur En cours.

Remarque :

Autorisations d'Orchestrator

Cette activité s'exécute sous le compte Orchestrator du robot qui l'exécute. Il doit disposer des autorisations de rôle Orchestrator suivantes sur le dossier cible:

• Files d’attente.Afficher: permet de résoudre la file d’attente cible
• Transactions.Afficher: permet de lire les données des éléments de la file d'attente et des transactions
• Transactions.Créer: permet de créer l’élément de la file d’attente ou de démarrer sa transaction
• Transactions.Modifier: permet de mettre à jour ou de verrouiller la transaction
• Folders.View (Dossiers).Afficher: permet de parcourir et de sélectionner le dossier Orchestrator

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, configuration multiplate-forme

• Chemin du dossier Orchestrator : le chemin du dossier où se trouve la file d'attente spécifiée, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple : "Finance/Accounts Payable".

  Remarque :

  Le paramètre Orchestrator FolderPath ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier. Les chemins d’accès relatifs aux dossiers sont pris en charge dans un en-tête X-UIPATH-FolderPath-Encoded comme suit :

  • Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.
  • Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.
  • Chemin d'accès commençant par . : commence à partir du dossier.
  • Chemin commençant par .. : commence un niveau au-dessus dans la hiérarchie du dossier pour chaque .. dans le chemin d'accès (par exemple ../ pour un niveau au-dessus, ../../ pour deux niveaux au-dessus dans la hiérarchie).

  Les barres obliques finales ne sont pas acceptées.

• QueueName : le nom de la file d'attente dans laquelle vous voulez rechercher l'élément de file d'attente. Ce champ ne prend en charge que les chaînes et les variables String.

  Remarque :

  Pour que l'activité Attendre un élément de la file d'attente (Wait Queue Item) utilise la méthode de communication en temps réel du Robot, la version du pack d'activités système et la version d'Orchestrator doivent être toutes deux antérieures à la v20.10 ou toutes deux plus récentes que la v20.10. Sinon, l'activité Attendre un élément de la file d'attente (Wait Queue Item) n'utilise pas la méthode de communication en temps réel du Robot et a un délai maximum égal à la durée d'un intervalle Pulsation. La durée par défaut d'un intervalle Pulsation est de 30 secondes et peut être configurée dans Orchestrator.

¹For cross-platform projects created in Studio Web as part of a solution, the Orchestrator folder path field is unavailable. If the activity had a folder path before it became part of the solution, the field is displayed as read-only, and that folder overrides the solution resource. Selecting the resource again removes the folder.

²Pour les projets multiplate-forme créés dans Studio Web dans le cadre d'une solution, le champ Nom propose des options pour Définir de nouvelles ressources Orchestrator, telles que des files d'attente, des ressources ou des compartiments de stockage, au moment de la conception, ou pour Ouvrir Orchestrator pour la gestion des ressources.

Options avancées

Options

• PollTime (millisecondes) : indique la durée (en millisecondes) entre deux tentatives de récupération d’un nouvel élément. La valeur par défaut est de 30 000 millisecondes (30 secondes).
• Stratégie de filtrage (FilterStrategy) - Stratégie à utiliser lors du filtrage selon la référence. Ce champ accepte une valeur littérale ou une expression. Les options suivantes sont disponibles:
  • Commencer par (StartWith) - Recherche les éléments dont les références commencent la valeur indiquée dans le champ Référence (Reference).
  • Égal à (Equals) - Recherche les éléments dont les références sont identiques à la valeur indiquée dans le champ Référence (Reference).
• Référence - Filtre les éléments en fonction de leur référence. L'expression ne peut pas dépasser 128 caractères, ni contenir le guillemet simple '.
• Timeout (millisecondes) : indique le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes). L'ouverture d'une connexion à Orchestrator est toujours limitée à 30 secondes, quelle que soit cette valeur.
• Continuer en cas d'erreur (Continue on error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ n'est pas configuré et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.
• Convert dates to local time - When on, the dates on the returned queue item (deadline, postpone date, transaction start, and last processing time) are converted from UTC to the local time of the robot machine. When left empty, the project setting Convert dates to local time under Project Settings > System > Queues applies. That setting is on by default for new projects and off for projects created with an earlier System package version, so existing workflows keep receiving UTC values. The project settings for queues are available in Windows projects.

Sortie

• Result : l'élément de file d'attente récupéré, stocké dans une variable QueueItem.

Configuration Windows - Héritage

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue On Error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.
• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Timeout (millisecondes) : indique le délai d'attente (en millisecondes) pour l'exécution de l'activité avant qu'une erreur soit générée. La valeur par défaut est de 30 000 millisecondes (30 secondes). L'ouverture d'une connexion à Orchestrator est toujours limitée à 30 secondes, quelle que soit cette valeur.
  Remarque :

  Pour que l'activité Attendre un élément de la file d'attente (Wait Queue Item) utilise la méthode de communication en temps réel du Robot, la version du pack d'activités système et la version d'Orchestrator doivent être toutes deux antérieures à la v20.10 ou toutes deux plus récentes que la v20.10. Sinon, l'activité Attendre un élément de la file d'attente (Wait Queue Item) n'utilise pas la méthode de communication en temps réel du Robot et a un délai maximum égal à la durée d'un intervalle Pulsation. La durée par défaut d'un intervalle Pulsation est de 30 secondes et peut être configurée dans Orchestrator.

Entrée

• PollTime (millisecondes) : indique la durée (en millisecondes) entre deux tentatives de récupération d’un nouvel élément. La valeur par défaut est de 30 000 millisecondes (30 secondes).
• QueueName : le nom de la file d'attente dans laquelle vous voulez rechercher l'élément de file d'attente. Ce champ ne prend en charge que les chaînes et les variables String.

Divers

• Chemin du dossier : le chemin du dossier où se trouve l'objet ÉlémentsFileAttente, s'il est différent du dossier dans lequel le processus est en cours d'exécution. Ce champ prend uniquement en charge les valeurs de chaîne, avec / comme séparateur permettant d'indiquer les sous-dossiers. Par exemple : "Finance/Accounts Payable".

  Remarque :

  Le paramètre Folder Path ne fonctionne pas pour les processus exécutés par des robots dans des dossiers classiques. Seuls les robots des dossiers modernes ont la capacité de transmettre des données à l'extérieur de leur dossier. Les chemins d’accès relatifs aux dossiers sont pris en charge dans un en-tête X-UIPATH-FolderPath-Encoded comme suit :

  • Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.
  • Chemin d'accès commençant par / : commence à partir du dossier root de l'arborescence dont il fait partie.
  • Chemin d'accès commençant par . : commence à partir du dossier.
  • Chemin commençant par .. : commence un niveau au-dessus dans la hiérarchie du dossier pour chaque .. dans le chemin d'accès (par exemple ../ pour un niveau au-dessus, ../../ pour deux niveaux au-dessus dans la hiérarchie).

  Les barres obliques finales ne sont pas acceptées.

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Result : l'élément de file d'attente récupéré, stocké dans une variable QueueItem.

Référence (Reference)

• Stratégie de filtrage (FilterStrategy) - Stratégie à utiliser lors du filtrage selon la référence. Les options suivantes sont disponibles :
  • Commencer par (StartWith) - Recherche les éléments dont les références commencent la valeur indiquée dans le champ Référence (Reference).
  • Égal à (Equals) - Recherche les éléments dont les références sont identiques à la valeur indiquée dans le champ Référence (Reference).
• Référence - Filtre les éléments en fonction de leur référence. L'expression ne peut pas dépasser 128 caractères, ni contenir le guillemet simple '.