Gestion des files d'attente dans Orchestrator

Découvrez comment configurer des files d'attente dans Orchestrator.

Création d'une file d'attente

1. Sur la page Files d’attente, cliquez sur Ajouter (Add). Trois boutons s'affichent, vous permettant d'ajouter une file d’attente, de lier des files d’attente à partir d'autres dossiers ou de masquer les options.

2. Cliquez sur Ajouter (Add). La fenêtre Créer une file d'attente (Create Queue) s'affiche.

3. Dans le champ Nom (Name), saisissez un nom pour la file d’attente.

4. Dans le champ Description, ajoutez une description de la file d'attente.

5. Dans le champ Référence unique (Unique Reference), sélectionnez Oui (Yes) ou Non (No), pour indiquer si vous souhaitez que les références de transaction soient uniques ou non.

6. Dans le champ Nouvelle tentative automatique (Auto Retry), sélectionnez Oui (Yes) ou Non (No) pour indiquer si vous souhaitez utiliser le mécanisme de nouvelle tentative automatique.

7. Dans le champ Nombre max de nouvelles tentatives (Max # of retries), si vous avez sélectionné Oui (Yes) à l'étape 5, saisissez le nombre souhaité de nouvelles tentatives d'un élément de file d'attente.

8. Upload a JSON schema for any or each of Specific Data, Output Data, and Analytics Data by using the corresponding Browse button.

9. Enable SLA predictions if you want to better control the processing time of your items, and to assess what resources you need such that they meet their deadline. If SLA predictions are enabled, configure the following fields:

   • Dans la liste déroulante Processus (Process), sélectionnez le processus qui gère les éléments de la file d'attente, puis renseignez la valeur du SLA ci-dessous. La valeur maximale est de 90 jours.
   • Enable Risk SLA if you want to define a buffer zone before the actual SLA, and fill in the value below. The risk SLA must be smaller than the SLA.

10. Cliquez sur Ajouter (Add). La file d'attente est créée et s'affiche sur la page Files d'attente (Queues), bien qu'elle soit vide.

You can populate queues either using Studio or on the Upload Items window. Processing items from a queue is only possible using Studio.

Modification des files d'attente

Vous pouvez mettre à jour des paramètres de file d'attente existants, tels que :

• Le nom de la file d’attente
• L'option Nouvelle tentative automatique (Auto Retry)
• Le nombre maximum de nouvelles tentatives

Modification d'un nom de file d'attente

Pour modifier un nom de file d'attente existant dans Orchestrator :

1. Dans la page Files d'attente (Queues), cliquez sur le bouton Options supplémentaires (More Options) pour la file d'attente souhaitée.

2. Cliquez sur Modifier (Edit) . L'assistant de mise à jour de la file d'attente s'affiche.

3. Dans le champ Nom (Name), saisissez le nouveau nom de la file d'attente sélectionnée.

   Remarque :

   • Assurez-vous d'entrer un nom unique. Si une file d'attente du même nom existe déjà dans votre locataire, vous êtes invité par le message d'erreur : The name <QueueName> is already used. (#1001).
   • The name is not case sensitive. Therefore, NEW_QueueName and new_queuename are duplicates.

4. Cliquez sur Mettre à jour (Update).

   Important :

   Assurez-vous de mettre à jour le nom de la file d'attente dans le ou les workflows correspondants dans Studio. Vous devez le faire manuellement, car il n'existe aucun moyen automatique de mettre à jour le nom de la file d'attente dans Studio.

Modification de l'option Nouvelle tentative automatique (Auto Retry)

Pour modifier l'option Nouvelle tentative automatique (Auto Retry) pour une file d'attente existante :

1. Dans la page Files d'attente (Queues), cliquez sur le bouton Options supplémentaires (More Options) pour la file d'attente souhaitée.
2. Cliquez sur Modifier (Edit) . L'assistant de mise à jour de la file d'attente s'affiche.
3. Dans le champ Nouvelle tentative automatique (Auto Retry), sélectionnez l'option dont vous avez besoin.
4. Cliquez sur Mettre à jour (Update).

Définition d'un nombre maximum de tentatives

Option de Nouvelle tentative automatique (Auto Retry) : Oui

Si vous sélectionnez Oui pour l'option Nouvelle tentative automatique (Auto Retry), le champ Nombre max de nouvelles tentatives (Max # of Retries) s'affiche.

Entrez une valeur comprise entre 1 et 50 comme nombre de nouvelles tentatives de la transaction ayant échoué.

Remarque :

Existing failed transactions are not being retried. Only the transactions that fail after you set the new value are being retried.

Les éléments de file d'attente réessayés et supprimés ne participent pas aux vérifications de référence unique. Par conséquent, nous vous recommandons de ne pas supprimer un élément de file d'attente d'origine d'une chaîne de nouvelles tentatives, car cela empêche la validation de références uniques.

Example: Let's say you have a list of failed transactions that are retried once. The current value of Max # of retries is 2. Update the value to 3 and the failed transactions are retried two more times instead of one.

Option de Nouvelle tentative automatique (Auto Retry) : Non

Si vous sélectionnez Non pour l'option Nouvelle tentative automatique (Auto Retry), le champ Nombre max de nouvelles tentatives (Max # of Retries) est masqué.

Aucune transaction n'est réessayé.

Gestion des liens de file d'attente

Le partage de files d’attente entre les dossiers permet de lancer des tâches dans plusieurs dossiers sans devoir concevoir une nouvelle fois vos workflows dans Studio lorsque les processus sous-jacents ont pour cible la même file d’attente. La liaison d'une file d'attente à un dossier rend la file d'attente et tous les objets associés à la file d'attente, tels que les éléments de file d'attente, disponibles dans ce dossier.

Remarque :

• Une file d’attente liée à plusieurs dossiers est marquée à l'aide de l'icône . Si l'icône n'est pas affichée, le dossier actuel est le seul dossier contenant la file d’attente. La supprimer ici supprime complètement la file d'attente d'Orchestrator.
• Vous avez besoin de l'autorisation Files d’attente - Création (Queues - Create) dans les dossiers dans lesquels vous souhaitez ajouter la file d'attente (dossiers cibles) et Files d’attente - Consultation (Queues - View) dans le dossier où réside actuellement la file d'attente (dossier d'origine). Si vous disposez de Files d’attente - Modification (Queues - Edit) dans le dossier cible, vous avez également besoin de Files d’attente - Modification dans le dossier d'origine.

Relier plusieurs files d’attente au dossier actuel

1. Dans le dossier auquel vous souhaitez lier une file d'attente, sur la page Files d'attente (Queues), cliquez sur Ajouter (Add). Trois boutons s'affichent, vous permettant d'ajouter une file d’attente, de lier des files d’attente à partir d'autres dossiers ou de masquer les options.

2. Cliquez sur Lier les files d'attente depuis d'autres dossiers (Link Queues From Other Folders). La fenêtre Lier les files d’attente (Link Queues) s'affiche et affiche une liste de tous les files d’attente des dossiers dans lesquels vous disposez des autorisations Consultation (View) pour les files d’attente.

3. Dans la section Sélectionner des files d’attente (Select Action Queues), sélectionnez une ou plusieurs files d’attente dans la liste.

   

4. Cliquez sur Continuer (Continue). Vous êtes redirigé vers la section Validation du dossier (Folder Validation). Ici, vous pouvez voir les dossiers auxquels les files d’attente sont déjà liés. S'il y a plusieurs dossiers, le numéro est affiché. Survolez-les avec la souris pour voir les noms des dossiers.

   

5. Cliquez sur Supprimer (Remove) pour la file d’attente correspondante pour annuler la modification ou cliquez sur Quitter (Exit) pour annuler l'opération.

6. Cliquez sur Lier (Link) si vous souhaitez relier les files d’attente que vous avez sélectionnés et le dossier actuel. Les files d'attente sont affichées sur la page Files d'attente (Queues).

   

Lier une file d'attente à plusieurs dossiers

1. Accédez à un dossier contenant la file d’attente à lier.

2. Cliquez sur Autres actions (More Actions) > Gérer les liens (Manage Links) pour la file d’attente souhaitée pour ouvrir la fenêtre Gérer les liens. La fenêtre Gérer les liens de file d’attente (Manage Queue Links) s'affiche.

   1 - Left-hand pane displaying all the folders you have been granted View permissions on Queues. 2 - The current state of the queue displaying the number of folders it currently resides in as well as their names. 3 - The folders the queue is to be added in according to your selection in the left-hand pane. 4 - The folders the queue will be removed from.

   

3. Cliquez sur Mettre à jour (Update). Une boîte de dialogue de confirmation s'affiche.

4. Cliquez sur Annuler (Cancel) si vous souhaitez annuler les modifications ou sur Continuer (Continuer) pour que les modifications prennent effet. Les opérations sont désormais prises en compte dans Orchestrator en fonction de vos modifications.

Dissociation des files d'attente des dossiers

La dissociation des files d’attente des dossiers peut être effectuée d'une manière similaire à l'opération de liaison. Accédez aux zones de gestion des liens présentées dans les procédures ci-dessus et supprimez les connexions entre la file d’attente et le dossier de votre choix.

Vous pouvez également supprimer une file d'attente à l'aide de la fonctionnalité Supprimer (Remove).

Important :

La suppression d'une file d’attente existant dans plusieurs dossiers ne la supprime que du dossier dans lequel l'opération de suppression a lieu, sans la supprimer des autres dossiers. Afin de supprimer complètement une file d'attente, vous devez supprimer tous ses liens existants.

Vous ne pouvez pas dissocier une file d'attente d'un dossier dans les situations suivantes :

• le SLA de la file d'attente a été activé dans ce dossier ;
• un déclencheur de file d'attente est attaché à la file d'attente.

Affichage des transactions

In the Queues page, click More Actions > View Transactions. The Transactions page is displayed, containing only the items from the indicated queue.

Affichage des requêtes de révision

Dans la page Files d'attente (Queues), cliquez sur Requêtes de révision (Review Requests) pour afficher tous les éléments de file d'attente affectés pour la révision à l'utilisateur actuellement connecté. La page prend en compte les modifications de l'état et la gestion des informations sur les éléments.

Affichage du graphique de la file d'attente

Pour afficher le graphique d'une file d'attente spécifique, cliquez sur le bouton Autres actions (More Actions), puis sur Afficher le graphique (View Chart).

Un graphique en courbes affiche l'évolution de l'état des transactions sur une période spécifique. La période (dernière heure, dernier jour, dernière semaine, 30 derniers jours) peut être modifiée, et vous pouvez afficher le délai d'exécution moyen et le nombre maximal de nouvelles tentatives.

Surveillance d'une file d'attente

To monitor a queue, click the corresponding More Actions button and then Monitor Queue. Alternatively, select it from the Queues Overview widget (Monitoring > Queues).

Note that monitoring a queue requires your user to have View permissions on Queues and on Monitoring. Additionally, Edit on Monitoring is required in order to disable errors from the Error Feed widget on the Monitoring > Queues page.

Suppression d'une file d'attente

Pour supprimer une planification, cliquez sur le bouton Autres actions (More Actions) correspondant, puis sur Supprimer (Remove).

Sinon, sélectionnez-la sur la page Files d'attente (Queues) et cliquez sur Supprimer (Remove). La file d'attente ne s'affiche plus sur la page Files d'attente (Queues).

Important :

La suppression d'une file d’attente existant dans plusieurs dossiers ne la supprime que du dossier dans lequel l'opération de suppression a lieu, sans la supprimer des autres dossiers. Afin de supprimer complètement une file d'attente, vous devez supprimer tous ses liens existants.

Remarque :

Après la suppression d'une file d'attente, les éléments de transaction affectés appartenant à la file d'attente ne sont plus visibles dans la page Requêtes de révision (Review Requests).