Gestion des files d'attente dans Studio

Ajout d'éléments à une file d'attente

Sur la page Files d'attente (Queues), créez une file d'attente.
Dans Studio, créez un projet d'automatisation qui, par exemple, collecte certains chiffres à partir d'une feuille de calcul Excel et les enregistre dans une variable.
Dans le volet Activités (Activities), faites glisser une activité Ajouter un élément de file d'attente (Add Queue Item) vers le volet Concepteur (Designer).
Dans le volet Propriétés (Properties), champ Nom de la file d'attente (QueueName), tapez le nom de la file d'attente créée à l'étape 1, entre guillemets.

Remarque : Les noms de files d'attente ne sont pas sensibles à la casse. Par exemple, « Test_QuEuE » et « test_queue » sont identiques.
Dans la liste Priorité (Priority), sélectionnez Basse (Low), Normale (Normal) ou Haute (High), en fonction de l'importance des éléments ajoutés par cette activité et de la vitesse de traitement choisie.
(Option facultative (Optionally)) Dans le champ Référence (Reference), entrez une chaîne ou une variable de type chaîne à utiliser comme identifiant d'un élément de file d'attente ou de groupe d'éléments. (La référence peut être utilisée pour lier vos transactions à d'autres applications utilisées au sein d'un projet d'automatisation. En outre, cette fonctionnalité permet de rechercher certaines transactions dans Orchestrator, en fonction de la référence personnalisée fournie.)

Remarque : les références ne sont pas compatibles avec les versions 2016.2 ou ultérieure d'Orchestrator ou du robot.
(Option facultative) Dans le champ Échéance (Deadline), ajoutez une date indiquant que l'élément de la file d'attente peut être traité à cette date.
(Option facultative) Dans le champ Différer (Postpone), ajoutez une date indiquant que l'élément de la file d'attente ne peut être traité qu'après cette date.
En regard du champ InformationsÉlément, cliquez sur le bouton Parcourir (Browse) . La fenêtre InformationsÉlément s’affiche et permet d’ajouter des données à chaque élément créé de la file d’attente.

Remarque : La valeur des arguments de chaîne ajoutée dans la fenêtre Informations sur l'élément (ItemInformation) ne peut pas contenir les caractères suivants : [ et " ".
Cliquez sur Créer un argument (Create Argument). Un argument vide est créé.
Donnez un nom plus évocateur à l'argument.
Remplacez le Type (Type) de l'argument par l'élément requis. Par exemple, sélectionnez Int32 si vous voulez enregistrer des valeurs numériques à partir des transactions.
Dans le champ Valeur (Value), entrez la valeur à ajouter aux éléments de la file d'attente ou une variable que vous utilisez pour enregistrer une valeur spécifique.
Cliquez sur OK (OK). Vos paramètres sont enregistrés.

Remarque : Placez ces types de projets d'automatisation dans une boucle. Sinon, seul un élément est créé et renseigné dans Orchestrator.

Les données ajoutées dans la fenêtre Informations sur l'élément (ItemInformation) dans Studio s'affichent dans la fenêtre Détails de l'élément (Item Details), sous Données spécifiques (Specific Data), dans Orchestrator. L'état de tous les éléments ajoutés aux files d'attente est configuré sur Nouveau (New).

Obtention d'éléments à partir d'une file d'attente et modification de leur état

Dans Orchestrator, envisagez d'avoir une file d'attente remplie d'éléments.
Dans le volet Activités (Activities) de Studio, faites glisser une activité Obtenir l'élément de transaction (Get Transaction Item) vers le volet Concepteur (Designer).
Dans le volet Propriétés (Properties), champ Nom de la file d'attente (QueueName), tapez entre guillemets le nom de la file d'attente remplie depuis Orchestrator.

Remarque : Les noms de files d'attente ne sont pas sensibles à la casse. Par exemple, « New_QueUe » et « new_queue » sont identiques.
Créez une variable Élément de file d'attente (QueueItem). Cette variable enregistre le premier élément d'une file d'attente, en fonction de sa priorité et de son échéance. En cas de placement dans une boucle, le Robot parcourt plusieurs fois tous les éléments de la file d'attente. Après qu'un élément de la file d'attente passe par cette activité, il n'est PAS traité, et l'état de l'élément passe à En cours (In Progress).
Dans le champ Élément de transaction (TransationItem), saisissez la variable Élément de file d'attente (QueueItem) créée auparavant.
Dans le volet Activités (Activities), faites glisser une activité Décision (Decision) sous l'activité Obtenir l'élément de transaction (Get Transaction Item).
Créez vos prérequis d'automatisation. Par exemple, ajoutez les éléments de transaction dans une feuille de calcul Excel et envoyez les e-mails avec ces informations.
Dans le volet Propriétés (Properties), champ Condition (Condition), tapez une condition (par exemple, l'élément de la file d'attente est vide) selon laquelle l'état de l'élément peut changer.
Dans le volet Activités (Activities), faites glisser une activité Définir l'état de la transaction (Set Transaction Status) et connectez-la à la branche Faux (False) de l'activité Décision (Decision). Tous les éléments de transaction qui passent par cette activité ne respectent pas la condition ajoutée à l'étape 7.
Dans le volet Propriétés (Properties) de la liste déroulante État (Status), sélectionnez Réussi (Successful). Cet état est appliqué à tous les éléments de la file d'attente qui passent par cette activité.
Dans le champ Élément de transaction (TransactionItem), entrez la variable Élément de file d'attente (QueueItem) utilisée à l'étape 5.
(En option) Cliquez sur le bouton Parcourir (Browse) en regard du champ Données analytiques (Analytics), puis entrez les données à afficher dans la fenêtre Détails de l'élément (Item Details), champ Données analytiques (Analytics).
(Option facultative (Optionally)) Cliquez sur le bouton Parcourir (Browse) en regard du champ Sortie (Output), et entrez les données à afficher dans la fenêtre Détails de l'élément (Item Details), dans le champ Sortie (Output).

Remarque : Ces informations ne s'affichent qu'en cas de traitement de l'élément de la file d'attente.
Faites glisser une autre activité Définir l'état de transaction (Set Transaction Status) vers le volet Concepteur (Designer) et connectez-la à la section Vrai (True) de l'activité Décision (Decision). Tous les éléments de la file d'attente qui passent par cette activité respectent la condition ajoutée à l'étape 7.
Dans le volet Propriétés (Properties), champ État (Status), sélectionnez Échec (Failed). Cet état est appliqué à tous les éléments de la file d'attente qui passent par cette activité.
Dans le champ Élément de transaction (TransactionItem), entrez la variable Élément de file d'attente (QueueItem) utilisée à l'étape 5.
Dans la liste TypeErreur (ErrorType), sélectionnez Métier (Business) ou Application, en fonction de la condition indiquée dans l'activité Décision (Decision). Par exemple, un élément de file d'attente vide peut être une exception d'application, tandis qu'une valeur de transaction inférieure à une valeur standard peut être une exception métier. Pour plus d'informations sur ce choix, consultez l'article Exception métier vs Exception d'application.
Dans le champ Raison (Reason), saisissez une chaîne expliquant la raison du déclenchement de l'exception. Une fois le projet exécuté, ces informations s'affichent dans la fenêtre Détails de l'élément (Item Details).
Connectez les deux activités Définir l'état de transaction (Set Transaction Status) à l'activité Obtenir l'élément de transaction (Get Transaction Item). Cela crée une boucle et permet de parcourir plusieurs fois tous les éléments de la file d'attente. Un projet d'automatisation de base doit ressembler à l'illustration suivante.

Mappage des propriétés dans l'activité Définir l'état de transaction (Set Transaction Status) (à gauche) et leurs champs correspondants dans la fenêtre Détails de l'élément (Item Details) dans Orchestrator.

Pour récupérer des données spécifiques à partir d'un élément de la file d'attente, vous pouvez utiliser la fonction SpecificContent(). Écrivez entre guillemets et entre parenthèses le nom de l'argument qui a été utilisé pour ajouter des informations à la file d'attente.

Par exemple, la capture d'écran ci-dessus affiche le champ Valeur (Value) d'une activité Affecter (Assign). Cela permet de récupérer la valeur attribuée à un élément de la file d'attente (affiché dans la fenêtre Détails de l'élément (Item Details), sous Données spécifiques (Specific Data), dans Orchestrator) et de l'affecter à une variable de type chaîne, afin de pouvoir l'affecter ultérieurement.

Dans la capture d'écran ci-dessus :

transItem : est une variable Élément de file d'attente (QueueItem) utilisée pour enregistrer les éléments de transaction.
.SpecificContent : est la fonction qui récupère les informations provenant des éléments de transaction.
("transactionID") : est le nom de l'argument qui a été ajouté dans la fenêtre Informations sur l'élément (ItemInformation) pour remplir les éléments de la file d'attente avec des données. Le nom de l'argument s'affiche également dans la fenêtre Détails de l'élément (Item Details), sous Données spécifiques (Specific Data), dans Orchestrator.
.ToString : est une fonction utilisée pour convertir l'ID de la file d'attente, qui était initialement un entier, en une chaîne.

Report d'un élément de transaction

Dans Orchestrator, envisagez d'avoir une file d'attente remplie d'éléments.
Dans Studio, pensez à avoir déjà une activité Obtenir l'élément de transaction (Get Transaction Item) qui parcourt plusieurs fois tous les éléments de la file d'attente.
Dans le volet Activités (Activities), faites glisser une activité Décision (Decision) vers le flux de travail. Cette activité permet de prendre une décision commerciale servant de base pour reporter certains éléments de la file d'attente. Par exemple, si la valeur d'une facture est supérieure à 3 000 dollars, vous souhaiterez peut-être différer son paiement.
Dans le volet Activités (Activities), faites glisser une activité Différer l'élément de transaction (Postpone Transaction Item) vers la section Vrai (True) de Décision (Decision). Ceci implique que tous les éléments de la file d'attente qui respectent la condition placée dans l'activité Décision (Decision) sont différés en fonction de vos configurations.
Dans le champ Élément de transaction (TransationItem), saisissez la variable Élément de file d'attente (QueueItem) utilisée dans l'activité Obtenir la transaction (Get Transaction).
Dans le champ Différer (Postpone), ajoutez la date après laquelle cet élément peut être traité.
Dans le champ Échéance (Deadline), ajoutez la date avant laquelle cet élément peut être traité.

Les propriétés Échéance (Deadline) et Différer (Postpone) ajoutent une nouvelle priorité aux éléments de la file d'attente. Par exemple, un élément de la file d'attente qui est prévu aujourd'hui à 19 h et qui a une priorité Moyenne (Medium) sera traité avant un autre élément sans échéance et ayant une priorité Élevée (High).

Remarque : La modification de l'échéance d'un élément de file d'attente ou son report modifie son état par Nouveau (New).

Ajout d'une progression personnalisée

Dans Orchestrator, pensez à avoir une file d'attente remplie de nombreux éléments (millions) avec l'état En cours (In Progress).
Dans Studio, pensez à avoir déjà une activité Obtenir l'élément de transaction (Get Transaction Item) qui parcourt plusieurs fois tous les éléments de la file d'attente et qui utilise une variable Élément de file d'attente (QueueItem).
Dans le volet Activités (Activities), faites glisser une activité Définir la progression de la transaction (Set Transaction Progress) vers le volet Concepteur (Designer).
Dans la propriété Élément de transaction (TransactionItem) de l'activité, saisissez la variable Élément de file d'attente (QueueItem).
Dans la propriété Progression (Progress), ajoutez une chaîne personnalisée pour décrire la progression obtenue ici, telle que "AvantPremièreDécision". Ceci permet de vous informer que l'élément a été récupéré à partir de la base de données Orchestrator. Si votre projet d'automatisation tombe en panne à ce moment lors de l'exécution, un élément présente cet état, et il s'affiche dans la colonne Progression (Progress).

Remarque : Les états de progression personnalisés sont uniquement affichés lorsque l'état d'un élément est InProgress.

Le reste du projet d'automatisation peut être défini comme expliqué ci-dessus.

Par exemple, l'exemple de workflow suivant définit automatiquement le statut de chaque élément sur Réussi ou Échec , selon la façon dont vous concevez la séquence Corps de transaction :

Ne rien faire,Arrêterou Continuer- les résultats sont réussis
Throw Exception - résultats comme Failed (Erreur d'application)
Throw BusinessRuleException - résultats comme Failed (erreur métier)
Définir le statut de la transaction (Set Transaction Status ) - correspond au statut que vous avez défini
Reporter l'élément de transaction (Postpone Transaction Item ) - Résultats comme Nouveau
Devrait s'arrêter : si vous arrêtez le workflow à partir d'Orchestrator, le workflow existe dans la boucle une fois la transaction en cours terminée.

Le workflow se répète automatiquement pour chaque élément de la file d'attente et définit le statut de transaction correspondant.

En cas d' interruption ou si la file d'attente est vide, le workflow fait la boucle.