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.

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.

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.