Activités Studio utilisées avec les files d'attente

Ces activités font partie du package d'activités UiPath.System.Activities et sont disponibles dans le panneau Activités (Activities), sous Orchestrator > Files d'attente (Orchestrator > Queues).

• Ajouter un élément de file d'attente (Add Queue Item) : remplit la file d'attente d'éléments, définit une période de traitement de ces éléments et ajoute une référence personnalisée à chaque élément. Par défaut, l'état de l'élément est Nouveau (New) lorsqu'il est ajouté à la file d'attente.
• Ajouter un élément de transaction (Add Transaction Item) : ajoute un élément dans la file d'attente, démarre la transaction et configure l'état sur En cours (In Progress). Vous pouvez également le configurer de manière à ajouter une référence personnalisée à chaque transaction.
• Ajouter des éléments de file d’attente en bloc (Bulk Add Queue Items) : ajoute une collection d’éléments d’un DataTable spécifié à une file d’attente spécifiée et définit les statuts des éléments sur Nouveau (New).
• Supprimer les éléments de la file d’attente (Delete Queue Items) : supprime les éléments avec le statut Nouveau (New) à partir d’une file d’attente spécifiée. Pour exécuter cette activité dans Studio, le Robot doit être connecté à Orchestrator et le rôle Robot a besoin des autorisations Modifier (Edit), Créer (Create) et Supprimer (Delete) sur les files d’attente et les autorisations Supprimer (Delete) sur les transactions. L’activité s’exécute avec le robot qui l’exécute.
• Obtenir des éléments de file d’attente (Get Queue Items) : permet de récupérer une liste de 100 transactions au maximum dans une file d’attente donnée, en fonction de plusieurs filtres, tels que la date de création, la priorité, l’état et la référence.
• Attendre un élément de la file d’attente (Wait Queue Item) : récupère un élément de la file d’attente spécifiée et le stocke dans une variable QueueItem. Au moment de l’exécution, si la file d’attente spécifiée est vide, cette activité 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 soit ajouté à la file d’attente. Une fois récupéré, le statut de l’élément passe sur En cours (In Progress).
• Obtenir l'élément de transaction (Get Transaction Item) : obtient un élément de la file d'attente afin que vous puissiez le traiter (démarrer la transaction) et configure son état sur En cours (In Progress).
• Différer l'élément de transaction (Postpone Transaction Item) : ajoute les paramètres d'heure entre lesquels une transaction doit être traitée (pas avant Différer (Postpone) et pas après Échéance (Deadline)).
• Définir la progression de la transaction (Set Transaction Progress) : permet de créer des états de progression personnalisés pour les transactions En cours (In Progress). Vous pouvez la placer aux emplacements clés de votre projet d'automatisation, pour vous informer de sa progression si, par exemple, il tombe en panne. Cette option peut s'avérer utilise dans le cadre du processus de résolution des problèmes.

• Définir l’état de transaction (Set Transaction Status) : passe l’état de l’élément de transaction en Échec (Failed) (avec une Exception Application or Métier (Business)) ou Réussi (Successful). Les exceptions d’application (Application Exceptions) doivent être utilisées lorsqu’une application que vous automatisez échoue ou ne répond pas, tandis que les exceptions métier (Business Exceptions) doivent être utilisées lorsqu’une certaine valeur de transaction ne répond pas à un prérequis métier.

  Remarque : Les éléments qui échouent avec une exception d'application sont retentés si vous avez configuré les options de Nouvelle tentative automatique (Auto-Retry) dans la file d'attente, dans Orchestrator.

Il existe d’autres activités développées pour être utilisées avec des files d’attente dans le cadre d’autres fonctionnalités d'Orchestrator. Par exemple, les workflows de longue durée utilisent les activités de files d’attente suivantes qui font partie du package d’activités UiPath.Persistence.Activities :

• Ajouter un élément de la file d’attente et obtenir la référence (Add Queue Item and Get Reference) : permet d’ajouter un élément de file d’attente avec des paramètres et récupérer l’objet d’élément de file d’attente correspondant stocké dans un QueueItemData afin d’attendre la fin de la transaction à tout moment pendant l’exécution du workflow.
• Attendre l’élément de la file d’attente et reprendre (Wait for Queue Item and Resume) : suspend l’exécution du workflow en cours jusqu’à ce qu’une transaction spécifiée soit terminée. Pour désigner une transaction, un objet QueueItemData obtenu à partir de l’activité Ajouter un élément de la file d’attente et Obtenir la référence (Add Queue Item and Get Reference) doit être fourni. À la fin de la transaction, l’exécution du workflow reprend.