Activités de tâche de file d’attente

Activités des tâches de file d’attente dans les processus BPMN Maestro: champs requis pour créer, mettre à jour et résoudre les éléments de la file d’attente Orchestrator, organisés par activité.

Les activités de tâche de file d'attente créent, mettent à jour et résolvent les éléments de la file d'attente Orchestrator à partir d'une tâche dans un processus Maestro BPMN. Les activités de file d'attente sont accessibles à partir de la liste déroulante Action du panneau Propriétés d'une tâche. Les activités de file d’attente sont disponibles dans les types de tâches suivants. Reportez-vous à Tâches pour obtenir la liste complète:

• 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 :

Un élément de file d'attente démarre exactement une instance de processus Maestro BPMN. Une instance unique utilisant plusieurs éléments dans une boucle n'est pas prise en charge dans cette version.

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.

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 réessaie automatiquement la tâche, sauf si l'appel sous-jacent échoue avec une erreur 4xx. En cas d'échec, la tâche renvoie le code d'erreur 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.