À propos des files d'attente et des transactions

Vue d’ensemble des files d’attente et des transactions pour le stockage et le traitement d’un nombre illimité d’éléments de travail d’automatisation dans Orchestrator.

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.

Les données stockées dans les éléments de la file d'attente et extraites de ceux-ci sont de forme libre par défaut. Pour les situations où un schéma spécifique est nécessaire, comme les intégrations avec d'autres applications, le traitement des formulaires générés par la machine ou l'analyse, vous pouvez télécharger des schémas JSON personnalisés pour vous assurer que toutes les données d'éléments de file d'attente sont au format approprié.

In Orchestrator, newly created queues are empty by default. To populate them with items you can either use the upload functionality in Orchestrator, or Studio activities. The latter also enable you to change item statuses and process them. You can also configure queue triggers to automatically start Maestro or RPA processes whenever new items are added. As soon as queue items are processed, they become 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, d’afficher les files d’attente précédemment créées et d’accéder aux graphiques affichant la progression du statut des transactions dans le temps, ainsi que 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.

Les états de l'actif sont contrôlés par des développeurs RPA lorsqu'ils créent les projets d'automatisation, tandis que les états de révision sont contrôlés dans Orchestrator et permettent d'effectuer le contrôle de version, mais uniquement d'éléments de file d'attente qui ont été abandonnés ou qui ont échoué avec une exception d'application ou métier.

Les éléments en échec ou abandonnés peuvent être également affectés à un réviseur. Ils peuvent être modifiés ou supprimés à tout moment, si nécessaire. Chacune de ces modifications est suivie dans l’onglet Historique (History) de la fenêtre Détails de l’audit (Audit Details). Le réviseur est chargé de l'évaluation du statut actuel des transactions auxquelles il est affecté, et de la modification du statut de révision. Le statut des éléments de file d’attente jusqu’à la révision peut être modifié sur la page Demandes de révision (Review Requests).

Important :

Pour vous assurer que les éléments de file d’attente soient traités avec succès, vous devez disposer d’un ensemble de références unique au niveau de la file d’attente lorsque vous supprimez la file d’attente par référence. Si la référence ne demeure pas unique, cela entraînera des problèmes liés à des accès simultanés, tels que des échecs dus à des données de transaction manquantes (message d'erreur No Transaction Data ). 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

Lors de la création ou de la modification d'une file d'attente, vous pouvez télécharger un schéma JSON personnalisé pour les options Données spécifiques (Specific Data), Données de sortie (Output Data) et/ou Données d'analyse (Analytics Data). Avec le ou les schémas en place, toutes les transactions sont validées au format fourni. Si les données obtenues ne sont pas conformes, cet élément échoue avec une exception métier.

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.

Remarque :

Pour obtenir un meilleur contrôle des performances d'Orchestrator, la taille des données spécifiques (Specific Data) des éléments de file d'attente est limitée à 256 000 caractères ou 512 000 octets. Tout ce qui dépasse cette limite ne peut pas être ajouté à une file d’attente et renvoie le code d’erreur 403 - Payload Too Large. Si vous devez télécharger des éléments plus volumineux, stockez les données volumineuses dans un stockage externe et référencez uniquement le lien dans l’élément.

Champs de schéma Draft-07

Lorsque l'URI $schema est absente ou ne correspond pas à une version de schéma reconnue, Orchestrator valide les données de l'élément de la file d’attente par rapport à la spécification de schéma JSON draft-07. La table suivante décrit les champs que vous pouvez inclure dans un schéma draft-07.

Les champs de niveau racine appartiennent à l'objet de schéma de niveau supérieur. Les champs au niveau de la propriété appartiennent à chaque entrée de l'objet properties.

Champ	Niveau (Level)	Requis	Description
type: "object"	Racine	Oui (Yes)	Déclare que les données de l'élément de la file d'attente constituent un objet structuré.
properties	Racine	Oui (Yes)	Définit chaque champ attendu et son type de données.
$schema	Racine	Non (No)	URI de la version du schéma JSON. S'il est absent ou non reconnu, Orchestrator utilise la validation draft-07.
required	Racine	Non (No)	Array des noms de propriétés qui doivent être présents dans chaque élément de la file d'attente.
additionalProperties	Racine	Non (No)	Contrôle si les propriétés non répertoriées dans properties sont acceptées.
type	Propriété	Oui (Yes)	Spécifie le type de données du champ. Consultez les types pris en charge dans la section suivante.
default	Propriété	Non (No)	Valeur par défaut pour le champ si elle n'est pas fournie.
examples	Propriété	Non (No)	Échantillons de valeurs à des fins de documentation uniquement.
pattern	Propriété	Non (No)	Expression régulière à laquelle une valeur string doit correspondre.
minimum	Propriété	Non (No)	Valeur minimale autorisée pour les propriétés integer ou number . La validation signale la propriété et le minimum configuré en cas d'échec.
maximum	Propriété	Non (No)	Valeur maximale autorisée pour les propriétés integer ou number . La validation signale la propriété et le maximum configuré en cas d'échec.
minLength	Propriété	Non (No)	Nombre minimum de caractères pour les propriétés string . La validation signale la propriété et la longueur minimale configurée en cas d'échec.
maxLength	Propriété	Non (No)	Nombre maximal de caractères pour les propriétés string . La validation signale la propriété et la longueur maximale configurée en cas d'échec.
$id	Racine ou propriété	Non (No)	Identificateur unique pour le schéma ou une propriété spécifique.
title	Racine ou propriété	Non (No)	Libellé lisible par l'homme pour le schéma ou la propriété.

Types de données pris en charge

Le champ type de chaque définition de propriété spécifie le format attendu de la valeur de ce champ. Les valeurs suivantes sont valides pour les définitions de type au niveau de la propriété :

Saisie de texte	Description
string	Valeurs de texte. Utilisez ce type pour les champs DateTime.
integer	Nombres entiers sans composant décimal.
boolean	true ou valeurs false.
number	Valeurs numériques, y compris les décimales.
object	Un objet structuré imbriqué avec sa propre définition properties.

Le modèle suivant est un exemple de schéma draft-07 simple et valide, avec un champ de texte requis :

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "fieldName": {
      "type": "string"
    }
  },
  "required": ["fieldName"]
}

Exemple de schéma complet

L'exemple suivant montre plusieurs types de propriétés et champs facultatifs :

{
  "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.

You can search for a specific transaction or a group of them, according to a custom reference, which is added through the Reference property of the Add Queue Item and Add Transaction Item activities. The reference can be used to link your transactions to other applications used within an automation project.

Additionally, this feature enables you to search for certain transactions in Orchestrator, according to the provided custom reference.

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).

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 :
   • par ordre de priorité ; et
   • 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
   • selon la règle du premier entré, premier sorti pour les éléments ayant la même priorité.

When setting a Deadline or a Postpone date, we recommend populating the respective fields with relative dates. For example, DateTime.Now.AddHours(2), DateTime.Now.AddDays(10) and DateTime.Now.Add(New System.TimeSpan(5, 0, 0, 0)). Additionally, you can use the US notation to add an exact time, such as 10/15/2019 07:40:00.

Automatic correction of this date is available, for example, if you write 15 10 2019 9:0, it is automatically transformed to 15/10/2019 09:00:00.

Le champ Échéance est utile afin de classer des tâches disposant des priorités similaires, tandis que Différer permet de s'assurer qu’une tâche n’est pas lancée avant l’heure spécifiée. Toutefois, ces deux paramètres n'ont pas été conçus afin d'être utilisés conjointement.

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).

Modification groupée des éléments de la file d'attente

Vous pouvez mettre à jour plusieurs éléments de la file d'attente en même temps à partir de la page Transactions . Les éléments de la file d'attente peuvent être modifiés en bloc à partir de la page Transactions en sélectionnant un ou plusieurs éléments, puis en sélectionnant Modifier. Les champs suivants peuvent être mis à jour:

• Priorité (Priority)
• Différer la date
• Date dʹéchéance
• Réinitialiser la progression de la transaction

Les modifications groupées s'appliquent à tous les éléments sélectionnés. Seuls les éléments avec le statut Nouveau, En échec ou Abandonné peuvent être mis à jour.

Exportation des transactions

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

Image 1. fichier CSV

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 à déterminer s'ils peuvent être traités en temps opportun et quelles ressources vous devez allouer afin 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.

The SLA only applies to those items that don't have a deadline set, meaning that a newly added item with no deadline defined beforehand has it automatically filled in according to the value set as the SLA. Specifically, each item's deadline is represented by the value set for the queue SLA from the moment the item was added into the queue.

For instance, if I set the SLA to 2 hours, and I add 3 items into the queue at 4, 5, and 6 PM, then my items have the deadlines 6, 7, 8 PM, respectively.

L’alerte de violation du SLA est déclenchée toutes les 30 minutes, à partir de 7 minutes après l’heure.

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 in 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 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 du SLA de files d'attente

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)