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.

Le format de téléchargement est .csv, ce qui le rend compatible avec l'analyse des données, et vous pouvez y accéder à partir de la page Mes rapports (My Reports).

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)

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 afficher vos exportations, cliquez sur l'icône Mes rapports (My reports) dans la barre de navigation supérieure.

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

• Type d'exportation (Export type) : fait référence à l'objet Orchestrator
• Date de création (Created on) : l'horodatage relatif de création de l'exportation
• 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é.

• Statut (Status) : le statut de l'opération d'exportation :

  • Nouveau (New) : l'exportation est en cours.
  • Terminée (Completed) : l'exportation est terminée.

  • Échec (Failed) : l'exportation a échoué. Cela peut être généré par un délai d'expiration SQL ou un stockage insuffisant. Vous devez réessayer manuellement l'exportation.

    Le temps de calcul pour résoudre l'exportation est de 15 minutes maximum. Une fois ce délai écoulé, l'exportation échoue. Avant de relancer l'exportation, appliquez des filtres supplémentaires à vos données.

    Important :

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

    • Vous devez utiliser les points de terminaison de l'API pour l'objet Orchestrator correspondant. Par exemple, utilisez /odata/AuditLogs/UiPath.Server.Configuration.OData.Export pour exporter les journaux d'audit.

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

Pour télécharger les données sur votre appareil, cliquez sur le bouton Télécharger (Download) du rapport souhaité. Cette opération utilise l'emplacement de téléchargement par défaut sur votre appareil. Le rapport est téléchargé en tant qu'archive, qui contient le fichier .csv des données de grille filtrées.

Remarque :

Pour télécharger des exportations sur votre appareil, vous devez ajouter les domaines de stockage à votre liste d'autorisation. Plus d'infos ici.

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 (\ / : * ? " < > |), ils sont remplacés par _.
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)

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)

Fields supported for robot logs API exports

The following table lists the fields that are available in the report generated by exporting robot logs via API, and indicates whether these fields are allowed for filtering.

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	Host Identity
Message	Message
RawMessage	S/O
RobotName	Nom du Robot (Robot Name)
MachineId	S/O
MachineKey	S/O
RuntimeType	S/O

Fields supported for jobs API exports

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	Host Identity
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	Runtime type/license
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

Alertes d'exportation

Toutes les exportations que vous créez sont enregistrées sur la page Alertes (Alerts), à condition que vous disposiez des autorisations appropriées. Les exportations terminées sont consignées avec la gravité Info, tandis que les exportations ayant échoué sont consignées avec la gravité Erreur (Error).

Par défaut, vous recevez des e-mails d'alerte concernant les exportations terminées ou ayant échoué. Vous pouvez vous désabonner de ces alertes en accédant à la page Préférences d'alertes (Alert Preferences) et en désélectionnant l'option Exporter (Export).

En savoir plus sur les alertes.