Exportation des grilles dans l'arrière-plan

Vue d'ensemble (Overview)

Les objets Orchestrator sont affichés sur leur page dédiée, dans une grille comportant plusieurs colonnes qui permettent de décrire le statut de cet objet.

Vous pouvez exporter ces grilles pour obtenir un lot de données utilisable par la suite pour créer des tableaux de bord ou des rapports. L'opération d'exportation a lieu en arrière-plan, ce qui signifie que vous pouvez continuer à interagir avec Orchestrator sans avoir à attendre la fin de l'exportation, car une notification vous informe lorsque le téléchargement est prêt.

The download format is .csv, which makes it data-analysis compliant, and you can access it from the My Reports page.

Objets Orchestrator disponibles pour l'exportation

Vous pouvez exporter les grilles des objets Orchestrator suivants :

• Au niveau du locataire
  • Journaux d’audit
  • Journaux d'audit d’automatisation de test
• Au niveau du dossier
  • Transactions de file d'attente
  • Journaux (Logs)
  • Tâches (Jobs)

Remarque :

Les journaux d’audit, les transactions de file d’attente, les journaux et les tâches sont limités à 100 exportations par jour et par locataire. Une fois cette limite dépassée, une erreur #4502 s’affiche indiquant que la limite quotidienne par locataire a été atteinte. La limite se réinitialise à 00 h 00 UTC.

Le rapport exporté

Cliquer sur le bouton Exporter (Export) crée une copie de la grille sur la page Mes rapports (My reports). Une fenêtre contextuelle vous informe lorsque l'exportation commence et quand ou si elle se termine.

Une fois l’exportation terminée, vous recevez une alerte vous informant que les données ont été exportées. Le rapport est téléchargé automatiquement en arrière-plan, vers l’emplacement de téléchargement par défaut de votre navigateur, si vous disposez de l’autorisation Consultation pour les alertes. Cependant, vous pouvez également visiter la page Mes rapports et télécharger le rapport à votre convenance.

La page Mes rapports (My reports) affiche uniquement les exportations que vous avez créées au cours des 168 dernières heures (7 jours x 24 heures). Les exportations de plus de 168 heures sont supprimées définitivement. Par exemple, un export créé le 1er à 00 h 00 est disponible jusqu'au 7 à 23 h 59.

Pour voir vos exportations, sélectionnez le bouton Ellipse verticale (⋮) en regard de Locataire et choisissez Mes rapports dans la liste.

Image 1. Mes rapports

Vous pouvez voir les propriétés suivantes d'une exportation :

• Export type - refers to the Orchestrator object
• Created on - the relative timestamp of when you created the export
• Date de création (absolue) : l’horodatage exact de création de l’exportation. Les horodatages absolus sont affichés dans le fuseau horaire du locataire. Pour les déclencheurs, l’exécution suivante est affichée dans le fuseau horaire du déclencheur, qui peut différer du fuseau horaire du locataire.
• Disponible jusqu'au (Available until) : date à laquelle l'exportation doit être supprimée de la liste. Les rapports sont supprimés à 00 h 00 à la date spécifiée. Il ne s'affiche qu'une fois le rapport exporté.
• Taille (Size) : la taille de l'exportation. Il ne s'affiche qu'une fois le rapport exporté.
• Status - the status of the export operation:
  • New - the export is in progress.
  • Completed - the export finished.
  • Échec - l’exportation a échoué. Cela peut être généré par un délai d’expiration SQL ou un stockage faible. Vous devez réessayer manuellement l’exportation. Le temps de calcul pour résoudre l’exportation est de 15 minutes maximum. Après cette période, l’exportation échoue. Avant de réessayer l’exportation, appliquez des filtres supplémentaires à vos données.
    Important :

    Pour éviter l'échec des exportations d'une grande quantité de données :

    • You must use the API endpoints for the corresponding Orchestrator object. For example, use /odata/AuditLogs/UiPath.Server.Configuration.OData.Export to export Audit logs.
    • Le volume des exportations générées, tant en termes de fréquence que de quantité de données récupérées, peut affecter les performances de votre locataire. Si les performances sont affectées, nous pouvons limiter ou bloquer ces requêtes pour nous assurer que vos automatisations ne sont pas affectées par ce comportement.
    • Appliquez des filtres pour réduire la quantité de données exportées.

To download the data to your device, click the Download button for the desired report. This operation uses the default download location on your device. The report is downloaded as an archive, which contains the .csv file of the grid filtered data.

Remarque :

To download exports to your device, you need to add the storage domains to your allowlist. More info here.

Les fichiers .zip et .csv sont nommés en utilisant les conventions d'affectation de nom suivantes :

Type d'objet exporté	Télécharger la convention d'affectation de noms aux fichiers
Transactions de file d'attente	{queue-name}-items-{export-date}-{export-timestamp}-{export-id} Si le nom de la file d’attente contient des caractères non valides (`\ / : * ? " < >
Journaux d’audit	audit-logs-{export-date}-{export-timestamp}-{export-id}
Journaux (Logs)	robot-logs-{export-date}-{export-timestamp}-{export-id}
Tâches (Jobs)	jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id}

Où :

• {queue_name} : le nom de la file d'attente contenant les éléments de file d'attente exportés
• {job_folder_key} : l'ID du dossier à partir duquel la grille des tâches a été exportée
• {export_date} : la date de création de l'exportation, au format yyyy-MM-dd.
• {export_timestamp} - l'heure à laquelle l'export a été créé, dans un format HH-mm-ss-fff.
• {export-id} : l'ID de l'exportation

Par exemple, un fichier de téléchargement exporté pour une grille de journaux d'audit peut être nommé audit-logs-2023-01-27-12-29-40-843-24.zip.

Important :

Les colonnes de temps dans les rapports exportés sont exprimées dans le fuseau horaire du locataire.

Considérations importantes concernant les exportations d’API

• Les mots clés $select, $top, $skip et $orderBy, and $count n’étant pas pris en charge dans notre API d’exportation, nous vous déconseillons fortement de les utiliser. Merci d’utiliser des filtres appropriés à la place.
• Les entrées du rapport sont uniquement triées par Id, autrement dit par $orderBy=Id. Tous les autres paramètres utilisés pour le mot clé $orderBy sont ignorés.
• Si vous filtrez via une structure $filter=, seuls les champs marqués comme disponibles s’afficheront dans la table.
• Si vous utilisez un champ non pris en charge (voir tableaux ci-dessous), une erreur 400 sera renvoyée.

Champs pris en charge pour les exportations d’API de transactions de file d’attente

Le tableau suivant détaille les champs disponibles dans le rapport généré lors de l’exportation des transactions de file d’attente via API, et indique si ces champs sont autorisés pour le filtrage.

Champ d’API	Colonne correspondante dans le rapport exporté	Permet le filtrage
QueueDefinitionId	S/O	✅
Status	État (Status)	✅
ReviewStatus	Révision (Revision)	✅
Reference	Référence (Reference)	✅
ProcessingExceptionType	Exception	✅
DueDate	S/O	❌
DueDateAbs	Échéance (absolue)	❌
Priority	Priorité (Priority)	✅
RobotName	Robot	❌
DeferDate	S/O	❌
DeferDateAbs	Différer (absolu)	❌
StartProcessing	S/O	✅
StartProcessingAbs	Commencé (absolu)	❌
EndProcessing	S/O	✅
EndProcessingAbs	Terminé (absolu)	❌
SecondsInPreviousAttempts	Délai d'exécution de la transaction (Transaction Execution Time)	❌
AncestorId	AncestorId	❌
AncestorUniqueKey	AncestorUniqueKey	❌
RetryNumber	Nbre de nouvelles tentatives	❌
ManualAncestorId	AncestorId manuel	❌
ManualAncestorUniqueKey	Clé AncestorUniqueKey manuelle	❌
ManualRetryNumber	Nombre de nouvelles tentatives manuelles	❌
UniqueKey	UniqueKey	❌
SpecificData	Données spécifiques	❌
Key	Clé (Key)	❌
ReviewerName	Nom du réviseur	❌
ProcessingExceptionReason	Raison de l'exception	❌
Output	Sortie	❌
RobotId	S/O	✅
ReviewerUserId	S/O	✅
Analytics	Données d'analyse	❌
CreationTime	S/O	✅
CreationTimeAbs	Créé (absolu)	❌
Progress	Progression (Progress)	❌
Id	Id	✅

Champs pris en charge pour les exportations d’API de journaux d’audit

Le tableau suivant détaille les champs disponibles dans le rapport généré lors de l’exportation des journaux d'audit via API, et indique si ces champs sont autorisés pour le filtrage.

Champ d’API	Colonne correspondante dans le rapport exporté	Permet le filtrage
Parameter	S/O	✅
DisplayName	S/O	✅
Action	Action	✅
Component	Composant (Component)	✅
UserId	S/O	✅
ExecutionTime	S/O	✅
OperationText	Opération (Operation)	❌
ExecutionTimeAbs	Heure (absolue)	❌
ServiceName	S/O	❌
MethodName	S/O	❌
EntityId	S/O	❌
UserType	S/O	❌
UserIsDeleted	S/O	❌
ExternalClientId	S/O	❌
UserName	Utilisateur (User)	❌

Champs pris en charge pour les exportations d’API de journaux de Robot

Le tableau suivant détaille les champs disponibles dans le rapport généré lors de l’exportation des journaux de Robot via API, et indique si ces champs sont autorisés pour le filtrage.

Champ d’API	Colonne correspondante dans le rapport exporté	Permet le filtrage
JobKey	S/O	✅
TimeStamp	Heure (absolue)	✅
Level	Niveau (Level)	✅
ProcessName	Processus (Process)	✅
HostMachineName	Nom de l'hôte	✅
WindowsIdentity	Identité de l’hôte	✅
Message	Message	✅
RawMessage	S/O	❌
RobotName	Nom du Robot (Robot Name)	✅
MachineId	S/O	❌
MachineKey	S/O	✅
RuntimeType	S/O	❌

Champs pris en charge pour les exportations d’API de tâches

Champ d’API	Colonne correspondante dans le rapport exporté	Permet le filtrage
CreationTime	S/O	✅
SourceType	S/O	✅
State	État (State)	✅
SpecificPriorityValue	Priorité (Priority)	✅
HostMachineName	Nom de l'hôte	✅
LocalSystemAccount	Identité de l’hôte	✅
MachineName	Machine	❌
Key	Clé (Key)	❌
JobPriority	S/O	❌
ReleaseName	Processus (Process)	❌
RobotName	Robot	❌
MachineScope	S/O	❌
EnvironmentName	Environnement (Environment)	❌
Type	Type de tâche	❌
RuntimeType	Type/licence runtime	❌
StartTime	S/O	✅
StartTimeAbs	Commencé (absolu)	❌
EndTime	S/O	✅
EndTimeAbs	Terminé (absolu)	❌
ProcessType	S/O	❌
Source	Source	❌
CreationTimeAbs	Créé (absolu)	❌
ServerlessJobType	S/O	❌
StartingScheduleId	S/O	✅
Release	S/O	❌
Machine	S/O	❌
Robot	S/O	❌