À propos des files d'attente et des transactions

Une file d'attente est un conteneur qui permet de contenir un nombre illimité d'éléments. Les éléments de la file d'attente peuvent enregistrer plusieurs types de données, tels que les informations sur la facture ou sur le client. Vous pouvez traiter ces informations dans d'autres systèmes : SAP ou Salesforce, par exemple.

The data stored in, and output from, Queue items is free form by default. For situations where a specific schema is needed, such as integrations with other applications, processing machine-generated forms, or analytics, you can upload custom JSON schemas to ensure that all Queue item data is in the proper format.

Dans Orchestrator, les files d'attente récemment créées sont vides par défaut. Pour les remplir avec des éléments, vous pouvez utiliser la fonctionnalité de téléchargement dans Orchestrator ou les activités de Studio. Ces dernières permettent également de modifier les statuts d’éléments et de les traiter. Dès que les éléments de la file d'attente sont traités, ils deviennent des transactions.

Vue d'ensemble des files d'attente

Les files d'attente permettent de créer de gros projets d'automatisation mis en évidence par la logique complexe. Par exemple, vous pouvez créer un processus qui collecte toutes les informations de factures et créer un élément de file d'attente pour chaque donnée afin de le stocker. Ensuite, vous pouvez créer un autre processus qui recueille les informations depuis Orchestrator et qui les utilise pour effectuer d'autres tâches, telles que régler les factures dans une application différente, différer leur paiement selon leur échéance ou valeur, envoyer des e-mails à l'équipe comptable chaque fois qu'une facture est réglée, etc.

La page Files d'attente (Queues) permet de créer des files d'attente. Elle fournit également un accès en consultation aux files d'attente auparavant créées, aux graphiques avec la progression de l'état des transactions dans le temps et à d'autres détails divers, tels que le délai d'exécution moyen et le nombre total de transactions réussies.

Les données disponibles dans la grille des files d’attente sont mises à jour à intervalles réguliers, ce qui signifie qu’elles ne sont pas toujours affichées en temps réel et que de légers retards sont possibles. De plus, elles ne sont pas affectées par les stratégies de rétention, de sorte que l’archivage des éléments de la base de données ne modifie pas les informations disponibles dans la grille.

Item statuses are controlled by RPA developers when they create the automation projects, while revision statuses are controlled in Orchestrator and enable you to perform version control, but only of queue items that have been abandoned or have failed with an application or business exception.

Failed or abandoned items can also be assigned to a reviewer, which can be changed or cleared at any point, if needed. Each of these changes are tracked in the History tab of the Audit Details window. The reviewer is in charge of assessing the current status of the transactions they are assigned to, and changing the review status. The status of queue items up for revision can be changed in the Review Requests page.

Important :

To ensure that queue item processing is performed successfully, you need to have a unique reference set at the queue level when dequeuing by reference. Failing to keep the reference unique will lead to concurrency access issues, such as failures due to no transaction data being found (No Transaction Data error message).

Si la référence ne peut pas être unique, il est conseillé de supprimer la file d’attente sans référence.

.

Définitions de schéma

When creating or editing a queue, you can upload a custom JSON schema for the Specific Data,Output Data, and/or Analytics Data. With the schema(s) in place, all transactions are validated against the provided format, and if the resulting data does not conform, that item fails with a Business Exception.

Important :

• Le schéma n'est pas appliqué rétroactivement aux transactions existantes, uniquement à celles exécutées après avoir téléchargé le ou les schémas.
• Your schema(s) must not contain an array.
• À des fins de validation, DateTime est accepté comme type string.
• L'utilisation et la validation d'un schéma de Données d'analyse (Analytics Data) nécessitent des Robots et des activités de version 19.10 ou supérieures.
• Si le ou les schémas téléchargés ne contiennent pas de définition de schéma URIvalide, la définition draft-07 , comme dans l'exemple ci-dessous, est utilisée comme solution de secours.

Exemple de schéma :

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "additionalProperties": { "type": "string" },
  "required": [
    "stringTest",
    "intTest",
    "boolTest"
  ],
  "properties": {
    "stringTest": {
      "$id": "#/properties/stringTest",
      "type": "string",
      "title": "The Stringtest Schema",
      "default": "",
      "examples": [
        "stringTest"
      ],
      "pattern": "^(.*)$"
    },
    "intTest": {
      "$id": "#/properties/intTest",
      "type": "integer",
      "title": "The Inttest Schema",
      "default": 0,
      "examples": [
        30
      ]
    },
    "boolTest": {
      "$id": "#/properties/boolTest",
      "type": "boolean",
      "title": "The Booltest Schema",
      "default": false,
      "examples": [
        false
      ]
    }
  }
}

Vue d'ensemble des transactions

La page Transactions (Transactions) affiche les transactions à partir d'une file d'attente donnée. Elle affiche également leurs états, les dates de leur traitement, le Robot qui les a traitées et le type d'exception générée ou la référence affectée, le cas échéant.

Vous pouvez rechercher une transaction spécifique ou un groupe de transactions, en fonction d'une référence personnalisée, qui est ajoutée via la propriété Reference des activités Add Queue Item et Add Transaction Item. La référence peut être utilisée pour lier vos transactions à d'autres applications utilisées dans 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.

Les références de transactions peuvent également être appliquées de manière unique au niveau de la file d'attente. Cette fonctionnalité est activée lors de la création de la file d'attente et s'applique à toutes les transactions sauf celles qui sont supprimées ou retentées. Cela simplifie l'identification d'un élément spécifique et facilite le processus de révision.

En cas de référence en double lors de l'ajout d'éléments à une file d'attente, la tâche échoue avec un état Défaillant (Faulted) et affiche le message d'erreur Execution error: UiPath.Core.Activities.OrchestratorHttpException: Error creating Transaction. Duplicate Reference. dans la fenêtre Détails de la tâche (Job Details).

Les informations enregistrées dans les éléments de la file d'attente s'affichent dans Orchestrator, dans la fenêtre Détails de la transaction (Transaction Details), sous Données spécifiques (Specific Data). En outre, si l'élément a échoué et a été retenté, l'historique de l'élément s'affiche dans la même fenêtre.

Remarque :

To achieve better control in terms of Orchestrator performance, the Specific Data size of queue items is limited to 1 MB with the Queue.MaxSpecificDataSizeInKiloBytes parameter. Anything beyond this limit cannot be added to a queue, and it returns the 403 - Payload Too Large error code. If you need to upload larger items, store the large data in external storage and only reference the link within the item.

La fenêtre Détails de la transaction (Transaction Details) contient trois onglets :

• Détails (Details) : permet d’afficher les informations exactes ajoutées à une transaction, ainsi que les statuts qu’elle a affichés et le nombre de nouvelles tentatives.
• Comments - enables you to view and add transaction-related comments in case you need to share information about a specific transaction with your teammates. All the users with View,Edit, and Delete permissions on Queues and Transactions can add, edit, or remove comments, respectively; however, keep in mind you can make changes to your own comments only.
• Historique - permet de voir quelle action a été effectuée par qui, de savoir qui est le réviseur et quel est le statut de la révision.

Ordre de traitement

Dans une file d'attente donnée, les transactions sont traitées de manière hiérarchique selon cet ordre :

1. Éléments avec une Échéance (Deadline), comme suit :
   1. par ordre de priorité ; et
   2. selon l'Échéance (Deadline) fixée pour les éléments ayant la même priorité.
2. Les éléments sans échéance (no Deadline), dans l'ordre de Priorité (Priority), et
   1. selon la règle du premier entré, premier sorti pour les éléments ayant la même priorité.

Lors de la définition d'une Échéance ou d'une date de Report , nous recommandons de remplir les champs correspondants avec des dates relatives. Par exemple, DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) et DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). En outre, vous pouvez utiliser la notation américaine pour ajouter une heure exacte, telle que 10/10/2019 07:40:00. La correction automatique de cette date est disponible, par exemple, si vous écrivez 12 10 2019 9:0, elle est automatiquement transformée en 12/10/2019 09:00:00.

Les dates ajoutées dans Studio pour les champs Échéance (Deadline) et Report (Postpone) s'affichent dans Orchestrator, sur la page Transactions, sous les colonnes Échéance (Deadline) et Report (Postpone).

Exportation des transactions

Vous pouvez exporter toutes les transactions et informations liées à une file d'attente donnée dans un fichier .csv en cliquant sur le bouton Exporter (Export) sur la page Transactions (Transactions). Toutes les options de filtrage de la page s'appliquent également au fichier généré.

Pour garantir les meilleures performances, notez que les entrées exportées ne sont pas dans l'ordre chronologique inverse.

Prévisions du SLA de files d'attente

Cet outil vous aide à définir un SLA (échéance des éléments) pour les éléments récemment ajoutés dans une file d'attente. Cela vous aide à évaluer si les éléments de file d'attente récemment ajoutés peuvent être traités rapidement et quelles ressources vous devez affecter de telle sorte que leur SLA ne soit pas violé. Chaque fois que le SLA risque de ne pas être respecté, vous êtes correctement informé afin que vous puissiez effectuer les ajustements en conséquence.

Remarque :

Learn how to configure queue SLA.

Learn how predictions are made and what they mean exactly.

Le SLA s'applique uniquement aux éléments dont l'échéance n'est pas définie, ce qui signifie qu'un élément récemment ajouté sans date limite préalablement définie, est automatiquement renseigné en fonction de la valeur définie en tant que SLA. Plus précisément, l'échéance de chaque élément est représentée par la valeur définie pour le SLA de files d'attente à partir du moment où l'élément a été ajouté à la file d'attente. Supposons que vous avez défini le SLA sur 2 heures et que vous ajoutez 3 éléments dans la file d'attente à 16 h, 17 h et 18 h, vos éléments ont respectivement les échéances 18 h, 19 h et 20 h.

Les éléments qui ont une échéance (définie dans Studio ou dans un fichier .csv utilisé pour le téléchargement) ne sont pas affectés par la configuration du SLA.

Important :

• The Priority of the items added in a queue after enabling SLA predictions is automatically set to High, regardless of how it was set in Studio or the .csv file used for upload.
• Vous ne pouvez pas supprimer un processus associé à une file d'attente avec des prévisions de SLA activées.
• If at least one queue item exceeds its deadline, Over Capacity is displayed in the Necessary Robots (SLA) column, and predictions are no longer calculated.
• Les prévisions sont faites pour les éléments de file d'attente avec des échéances dans les prochaines 24 heures (modifiable à l'aide du paramètre Queue.SlaReadaheadTimeLimitHours dans web.config) et ne prennent pas en compte les dates de report des éléments.

Les déclencheurs de file d’attente et les prévisions SLA sont interdépendants en termes d'association file d’attente/processus. Lorsque vous en configurez un, l'autre est prérempli de façon à assurer la parité entre les configurations. Imaginons que je définisse un déclencheur de file d’attente afin que la file d’attente Y utilise le processus X. Les prévisions SLA pour la file d’attente Y ne peuvent être effectuées qu'à l'aide du processus X. Par conséquent, X est prérempli et en lecture seul lors de l'activation du SLA de la file d'attente pour Y.

SLA à risque

Vous pouvez également définir un SLA à risque pour vos éléments, qui fonctionne comme une zone tampon avant le SLA. De manière explicite, les échéances à risque de vos éléments sont calculées en fonction du SLA à risque à partir du moment où l'élément de file d'attente a été ajouté dans la file d'attente. Supposons que je définis le SLA à risque sur 2 heures et que j'ajoute 3 éléments dans la file d'attente à 4h30, 17h15 et 18h45, puis que mes éléments ont les échéances à risque 6h30, 7h15 et 8h45, respectivement.

Une fois le SLA à risque expiré et l'élément de file d'attente non traité, l'élément risque de ne pas respecter son échéance. L'utilisateur est correctement informé, de sorte qu'il puisse effectuer des ajustements en conséquence.

Autorisations

Pour configurer les prévisions du SLA pour une file d’attente, vous avez besoin des autorisations suivantes :

• Consultation (View) des processus
• Consultation (View) pour les files d'attente
• Modification (Edit) des files d’attente (pour configurer un SLA lors de la modification d'une file d’attente)
• Création (Create) par rapport aux files d’attente (pour configurer un SLA lors de la création d'une file d’attente)

Téléchargement d'éléments en bloc à l'aide d'un fichier CSV

Cette fonctionnalité vous permet de télécharger en bloc des éléments de file d'attente dans une file d'attente spécifique dans Orchestrator à l'aide d'un fichier .csv. Pour ce faire, commencez par télécharger votre fichier dans votre instance d'Orchestrator pour une file d'attente spécifique. Une fois le fichier traité, les éléments contenus sont téléchargés dans la file d'attente conformément à la stratégie sélectionnée. Notez que le fichier doit être préalablement rempli en utilisant des formats prédéfinis pour que l'opération de téléchargement réussisse. Veuillez noter que le fichier doit être préalablement rempli en utilisant un format prédéfini pour que l'opération de téléchargement réussisse.

There is a series of predefined column headers that you can use when building your .csv file, but you can also use other custom headers. After successfully uploading the .csv file, the information in columns with predefined headers is mapped to columns as found in Orchestrator. Information in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator.

Remarque :

The upload is limited to 15,000 items per file. You can lower the limit using the Upload.Queues.MaxNumberOfItems parameter in the UiPath.Orchestrator.dll.config

Page

Mappage de colonne

En-tête de colonne de fichier	Champ Orchestrator
Référence (Reference) Obligatoire pour les files d'attente de référence unique. Prend en charge tous les caractères spéciaux, à l'exception des doubles guillemets (").	Référence (Reference) References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
Échéance (Deadline) Ce champ doit être renseigné avec une date dans l'un des formats suivants : JJ-MM-AAAA YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss AAAA MM JJ HH:mm:ss	Échéance (Deadline)
Différer (Postpone) Ce champ doit être renseigné avec une date dans l'un des formats suivants : JJ-MM-AAAA YYYY/MM/DD YYYY MM DD YYYY-MM-DD HH:mm YYYY/MM/DD HH:mm YYYY MM DD HH:mm YYYY-MM-DD HH:mm:ss YYYY/MM/DD HH:mm:ss AAAA MM JJ HH:mm:ss	Différer (Postpone)
Priorité (Priority) Doit être renseignée avec l’une des valeurs suivantes : Low or 1 Normale (Normal) ou 2 Élevée ou 3 Si la priorité n'est pas spécifiée dans le fichier, les éléments sont téléchargés, par défaut, avec une priorité élevée.	Priorité (Priority) Ce champ doit être mappé aux valeurs suivantes, respectivement : Basse Normale Haute
[Custom_Name] Le nom ne peut être composé que de caractères alphanumériques : 0-9, a-z ou des traits de soulignement.	Données spécifiques (Specific Data) Mappé au format JSON. Par exemple : Chèque tiré sur notre banque (On-Us Check) : 5 540

Notez que vous ne pouvez pas avoir d'en-têtes de colonnes vides dans votre fichier.

Remarque :

Les en-têtes de colonnes prédéfinis sont sensibles à la casse. Veillez à suivre les règles de mappage ci-dessus. Une colonne de votre fichier .csv nommée reference est mappée à la section Données spécifiques (Specific Data), au lieu de la colonne Référence (Reference).

Stratégies de téléchargement

Il existe deux stratégies de gestion du téléchargement :

• ProcessAllIndependently : traite tous les éléments individuellement et les ajoute à la file d'attente, en cas de réussite. Sinon, il renvoie une liste de ceux dont le traitement a échoué. Vous avez la possibilité de télécharger la liste dans un fichier .csv contenant les mêmes champs que dans le fichier téléchargé initialement.
• AllOrNothing : ajoute les éléments uniquement si tous ont été correctement traités. Sinon, aucun d'entre eux n'est ajouté.

Exemple :

Imaginons que vous téléchargiez le contenu du fichier .csv. Pour créer facilement ce fichier, vous pouvez renseigner les données dans un fichier Excel et l'enregistrer comme fichier .csv :

Ou vous pouvez télécharger un fichier .csv avec tous les en-têtes de colonne pré-remplis et le personnaliser en fonction de vos besoins.

Télécharger le fichier

Notez que ce fichier contient 3 colonnes prédéfinies, portant le même nom que dans Orchestrator (Référence (Reference), Échéance (Deadline) et Priorité (Priority), mises en évidence en vert) et 2 colonnes personnalisées (Client et Couleur (Color), mises en évidence en rouge).

1. Cliquez sur Télécharger les éléments (Upload Items) correspondant à la file d’attente souhaitée et sélectionnez le fichier .csv. Orchestrator analyse le fichier pour confirmer qu'il respecte les règles de formatage.

2. Sélectionnez les stratégies de téléchargement souhaitées et cliquez sur Télécharger (Upload) pour terminer le processus.

   

Sélectionnez Autres actions (More Actions) > Afficher les transactions (View Transactions) pour afficher les éléments de la file d’attente téléchargés.

The Transactions page displays each item uploaded from your file. The information contained within the file's predefined columns is mapped to the columns with the same name in Orchestrator (Reference,Deadline, and Priority, highlighted in green):

Les informations contenues dans les colonnes personnalisées sont mappées au format JSON dans la section Données spécifiques (Specific Data) de chaque élément. Cliquez sur Afficher les détails (View Details) de l’élément souhaité pour le voir :