Obtenir l'élément de transaction (Get Transaction Item)

UiPath.Core.Activities.GetQueueItem

Description

Obtient un élément de la file d' attente Orchestrator pour que vous puissiez le traiter (démarrer la transaction) et définir son statut sur En cours. Le démarrage de son traitement en fait une transaction.

Veuillez noter que pour exécuter cette activité, le rôle Robot doit disposer des autorisations de modification sur les files d'attente. L'activité s'exécute avec le robot qui l'exécute.

Si la file d'attente est vide, l'erreur suivante sera générée lors de l'accès à l'élément TransactionItem récupéré : System.Exception: Object reference not set to an instance of an object.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Multiplate-forme, configuration Windows

• Chemin du dossier Orchestrator (Orchestrator Folder Path): 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).

    Notez que les barres obliques finales ne sont pas acceptées.

• Nom de la file d'attente (Queue Name): la file d'attente où l'objet ph b doit être ajouté. Le nom n'est pas sensible à la casse, ce qui signifie que s'il a été défini en tant que « MaPremièreFileAttente » (MyFirstQueue) dans Orchestrator, il correspondra à « mapremièrefileattente » (myfirstqueue).

  Pour gérer les files d'attente dans vos dossiers Orchestrator, cliquez sur Gérer les files d'attente(Manage queues).

Options avancées

Options

• 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 (Reference) - Filtre les éléments en fonction de leur référence.
• Timeout (millisecondes) : spécifie 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).
• 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 (Vrai (True), Faux (False)). La valeur par défaut est Faux (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 Vrai (True), l'exécution du projet se poursuit même en cas d'erreur.

Sortie

• ÉlémentTransaction: l'élément de transaction récupéré, stocké dans une variable ph b.

• Données spécifiques (Specific Data ) : cette propriété devient disponible pour les files d'attente qui ont une définition de schéma. Permet d'accéder aux propriétés du schéma Contenu spécifique (Specific Content) de la file d'attente.

  Si une nouvelle version de schéma a été appliquée à la file d'attente, cliquez sur Actualiser ( Refresh ) pour récupérer les dernières modifications.

Configuration Windows - Héritage

Panneau propriétés

Options

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'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 renvoyée, l'exécution du projet s'interrompt. Si la valeur est définie sur true, l'exécution du projet continue indépendamment de tout message d'erreur affiché.
• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Timeout (millisecondes) : spécifie 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).

Entrée

• Nom de la file d'attente (Queue Name): la file d'attente où l'objet ph b doit être ajouté. Le nom n'est pas sensible à la casse, ce qui signifie que s'il a été défini en tant que « MaPremièreFileAttente » (MyFirstQueue) dans Orchestrator, il correspondra à « mapremièrefileattente » (myfirstqueue).

Divers

• Chemin du dossier (Folder Path) : le chemin du dossier où se trouve l'objet ÉlémentsFileAttente (QueueItems), 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 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.

  Chemin commençant par .. - commence un niveau supérieur dans la hiérarchie du dossier pour chaque .. dans le chemin d'accès (par exemple ../ pour un niveau supérieur, ../../ pour deux niveaux supérieurs dans la hiérarchie).

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

• ÉlémentTransaction: l'élément de transaction récupéré, stocké dans une variable ph b.

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 (Reference) - Filtre les éléments en fonction de leur référence.