orchestrator
latest
false
Guide de l'utilisateur d'Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 1 oct. 2024

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

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

available

Status

État (Status)

available

ReviewStatus

Révision (Revision)

available

Reference

Référence (Reference)

available

ProcessingExceptionType

Exception

available

DueDate

S/O

Non disponible

DueDateAbs

Échéance (absolue)

Non disponible

Priority

Priorité (Priority)

available

RobotName

Robot

Non disponible

DeferDate

S/O

Non disponible

DeferDateAbs

Différer (absolu)

Non disponible

StartProcessing

S/O

available

StartProcessingAbs

Commencé (absolu)

Non disponible

EndProcessing

S/O

available

EndProcessingAbs

Terminé (absolu)

Non disponible

SecondsInPreviousAttempts

Délai d'exécution de la transaction (Transaction Execution Time)

Non disponible

AncestorId

AncestorId

Non disponible

AncestorUniqueKey

AncestorUniqueKey

Non disponible

RetryNumber

Nbre de nouvelles tentatives

Non disponible

ManualAncestorId

AncestorId manuel

Non disponible

ManualAncestorUniqueKey

Clé AncestorUniqueKey manuelle

Non disponible

ManualRetryNumber

Nombre de nouvelles tentatives manuelles

Non disponible

UniqueKey

UniqueKey

Non disponible

SpecificData

Données spécifiques

Non disponible

Key

Clé (Key)

Non disponible

ReviewerName

Nom du réviseur

Non disponible

ProcessingExceptionReason

Raison de l'exception

Non disponible

Output

Sortie

Non disponible

RobotId

S/O

available

ReviewerUserId

S/O

available

Analytics

Données d'analyse

Non disponible

CreationTime

S/O

available

CreationTimeAbs

Créé (absolu)

Non disponible

ProgressProgression (Progress)

Non disponible

Id

Id

available

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

available

DisplayName

S/O

available

Action

Action

available

Component

Composant (Component)

available

UserId

S/O

available

ExecutionTime

S/O

available

OperationText

Opération (Operation)

Non disponible

ExecutionTimeAbs

Heure (absolue)

Non disponible

ServiceName

S/O

Non disponible

MethodName

S/O

Non disponible

EntityId

S/O

Non disponible

UserType

S/O

Non disponible

UserIsDeleted

S/O

Non disponible

ExternalClientId

S/O

Non disponible

UserName

Utilisateur (User)

Non disponible

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

available

TimeStamp

Heure (absolue)

available

Level

Niveau (Level)

available

ProcessName

Processus (Process)

available

HostMachineName

Nom de l'hôte

available

WindowsIdentity

Identité de l’hôte

available

Message

Message

available

RawMessage

S/O

Non disponible

RobotName

Nom du Robot (Robot Name)

available

MachineId

S/O

Non disponible

MachineKey

S/O

available

RuntimeType

S/O

Non disponible

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

available

SourceType

S/O

available

State

État (State)

available

SpecificPriorityValue

Priorité (Priority)

available

HostMachineName

Nom de l'hôte

available

LocalSystemAccount

Identité de l’hôte

available

MachineName

Machine

Non disponible

Key

Clé (Key)

Non disponible

JobPriority

S/O

Non disponible

ReleaseName

Processus (Process)

Non disponible

RobotName

Robot

Non disponible

MachineScope

S/O

Non disponible

EnvironmentName

Environnement (Environment)

Non disponible

Type

Type de tâche

Non disponible

RuntimeType

Type/licence runtime

Non disponible

StartTime

S/O

available

StartTimeAbs

Commencé (absolu)

Non disponible

EndTime

S/O

available

EndTimeAbs

Terminé (absolu)

Non disponible

ProcessType

S/O

Non disponible

Source

Source

Non disponible

CreationTimeAbs

Créé (absolu)

Non disponible

ServerlessJobType

S/O

Non disponible

StartingScheduleId

S/O

available

Release

S/O

Non disponible

Machine

S/O

Non disponible

Robot

S/O

Non disponible

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.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.