Activités de la tâche de la file d'attente

Queue task activities in BPMN processes: required fields for creating, updating, and resolving Orchestrator queue items, organized by activity.

Queue task activities create, update, and resolve Orchestrator queue items from a task in a BPMN process. Queue activities are accessed from the Action dropdown in a task's Properties panel. Queue activities are available in the following task types — refer to Tasks for the full list:

• Tâches de service
• Tâches de l’utilisateur
• Tâches - Envoyer
• Recevoir les tâches
• Tâches de règle métier
• Tâches de script

Cycle de vie de l’élément de la file d’attente

État (State)	Comment y est-il atteint?
Nouveau	L’élément est ajouté à la file d’attente.
InProgress	Un déclencheur de file d'attente démarre une instance de processus pour l'élément et le définit sur InProgress.
Réussite/Échec	Le processus définit l'état final avec Définir le statut de la transaction.
Abandonné	Automatique si un élément reste InProgress pendant 24 heures sans atteindre un état final. Si la fonction de nouvelle tentative est configurée sur la file d’attente, Orchestrator clone l’élément et le met à nouveau en file d’attente.

Remarque :

One queue item starts exactly one BPMN process instance. A single instance consuming multiple items in a loop isn't supported in this release.

Créer des éléments de file dʹattente

Ajoute un nouvel élément à une file d'attente Orchestrator avec le statut Nouveau .

Champ	Requis	Description
Nom de la file d'attente	Oui (Yes)	La file d'attente Orchestrator à laquelle ajouter l'élément.
Chemin d'accès au dossier	Oui (Yes)	Le dossier Orchestrator qui contient la file d'attente.
Priorité (Priority)	Non (No)	La priorité de traitement de l'élément.
Échéance (Deadline)	Non (No)	La date et l'heure auxquelles l'élément doit être traité.
Différer la date	Non (No)	Date et heure les plus anciennes auxquelles l'élément est disponible pour le traitement.
Données personnalisées	Non (No)	Données supplémentaires associées à l’élément, disponibles pour le robot ou le processus qui le traite.

Créer et attendre les éléments de la file d’attente

Ajoute un élément à une file d'attente et attend que l'élément atteigne un état final avant de poursuivre le processus. Utilise les mêmes champs que Créer des éléments de file d’attente.

Get queue items

Interroge les éléments d'une file d'attente Orchestrator sans les supprimer ni les verrouiller, à des fins d'inspection en lecture seule ou d'arborescence conditionnelle sur l'état de la file d'attente.

Champ	Requis	Description
Nom de la file d'attente	Oui (Yes)	La file d'attente Orchestrator à interroger.
Chemin d'accès au dossier	Oui (Yes)	Le dossier Orchestrator qui contient la file d'attente.
État (Status)	Non (No)	Filtrez par statut d’élément.
Référence (Reference)	Non (No)	Filtrez par référence d'élément.
Plage de dates de création	Non (No)	Filtrez par plage de dates dans laquelle l'élément a été créé.
Priorité (Priority)	Non (No)	Filtrez par priorité d'élément.

L'activité renvoie les 100 éléments correspondants les plus récents et un nombre total. Un filtre correspondant à plus de 100 éléments renvoie une liste tronquée. - affinez le filtre pour voir les éléments restants.

Attendre un événement de file d’attente

Disponible sur une tâche de réception ou un événement de capture intermédiaire, cet élément d'attente bloque l'exécution jusqu'à ce qu'un élément de transaction devienne disponible sur une file d'attente Orchestrator.

Champ	Requis	Description
Nom de la file d'attente	Oui (Yes)	La file d'attente Orchestrator à attendre.
Chemin d'accès au dossier	Oui (Yes)	Le dossier Orchestrator qui contient la file d'attente.

Lorsqu'un élément est supprimé de la file d'attente, ses champs deviennent disponibles en tant que sorties de processus, sous la même forme que Obtenir les éléments de la file d'attente. L’attente n’a pas de délai d’attente — joignez un minuteur de limite pour arrêter l'attente après une durée définie. Cet élément est pris en charge dans les moteurs d'exécution V1 et V2.

Bulk add queue items

Ajoute plusieurs éléments à une file d'attente en un seul lot, jusqu'à 15 000 éléments par appel.

Champ	Requis	Description
Nom de la file d'attente	Oui (Yes)	La file d'attente Orchestrator à laquelle ajouter des éléments.
Chemin d'accès au dossier	Oui (Yes)	Le dossier Orchestrator qui contient la file d'attente.
Eléments	Oui (Yes)	La liste des éléments à ajouter, dans une limite de 15 000 par appel.
TypeValidation	Oui (Yes)	AllOrNothing rejette l'ensemble du lot si un élément échoue à la validation. ProcessAllIndependently ajoute tous les éléments valides et signale les échecs individuellement.

Lorsque le type de validation est ProcessAllIndependently, l'activité renvoie la liste des éléments qui n'ont pas pu être ajoutés.

Delete queue items

Supprime les éléments avec le statut Nouveau d’une file d’attente spécifiée.

Champ	Requis	Description
Nom de la file d'attente	Oui (Yes)	La file d'attente Orchestrator à partir de laquelle supprimer des éléments.
Chemin d'accès au dossier	Oui (Yes)	Le dossier Orchestrator qui contient la file d'attente.
Eléments	Oui (Yes)	Les éléments à supprimer. Seuls les éléments avec le statut Nouveau peuvent être supprimés.

Postpone transaction item

Définit une date de report, et éventuellement une date d'échéance, pour un élément de transaction en cours, et renvoie l'élément au statut Nouveau .

Champ	Requis	Description
Reporter la date	Oui (Yes)	Date et heure les plus anciennes auxquelles l'élément sera disponible pour le traitement à nouveau.
Date dʹéchéance	Non (No)	La date limite de traitement de l'élément.

Remarque :

Différer l'élément de transaction n'est pas réessayé automatiquement lorsque l'appel sous-jacent échoue avec une erreur 4xx.

Set transaction progress

Met à jour un élément de transaction InProgress avec une chaîne de statut personnalisée. Le statut est visible dans Orchestrator.

Champ	Requis	Description
Progression (Progress)	Oui (Yes)	Une chaîne de texte personnalisée décrivant l'état de traitement actuel de l'élément.

Set transaction status

Définit l'état final d'un élément de transaction sur Réussite ou Échec.

Champ	Requis	Description
État (Status)	Oui (Yes)	Réussite ou Échec.
Type d'erreur	Conditionnel	Requis lorsque le statut est Échec. BusinessException ou ApplicationException.
Raison de l'erreur	Conditionnel	Requis lorsque le statut est Échec. Une brève description de l'erreur.
Détails de l’erreur	Non (No)	Informations supplémentaires sur l'erreur.

Maestro Orchestrate automatically retries the task unless the underlying call fails with a 4xx error. On failure, the task returns the error code OrchestratorSetTransactionResultFailed.

Pour le déclencheur qui démarre un processus à partir d'un élément de file d'attente, reportez-vous à Événements. Pour plus d'informations sur les tâches, consultez la section Tâches de la modélisation BPMN.