Exportieren von Rastern im Hintergrund

Überblick

Orchestrator-Objekte werden auf ihrer dedizierten Seite in einem Raster mit verschiedenen Spalten angezeigt, die hilfreich sind, um den Status dieses Objekts zu beschreiben.

Sie können diese Raster exportieren, um einen Datenstapel zu erhalten, den Sie später zur Erstellung von Dashboards oder Berichten verwenden können. Der Exportvorgang findet im Hintergrund statt, d. h. Sie können weiterhin mit dem Orchestrator interagieren, ohne auf den Abschluss des Exports warten zu müssen, da Sie eine Benachrichtigung informiert, wenn der Download bereit ist.

Das Downloadformat ist .csv, wodurch es mit der Datenanalyse kompatibel ist. Sie können über die Seite Meine Berichte darauf zugreifen.

Für den Export verfügbare Orchestrator-Objekte

Sie können die Raster der folgenden Orchestrator-Objekte exportieren:

• Auf Mandantenebene
  • Protokolle
  • Prüfprotokolle der Testautomatisierung
• Auf Ordnerebene
  • Warteschlangentransaktionen
  • Protokolle
  • Jobs

Der exportierte Bericht

Wenn Sie auf die Schaltfläche Exportieren klicken, wird eine Kopie des Rasters auf der Seite Meine Berichte erstellt. Ein Popup informiert Sie darüber, wann der Export startet und wann oder ob er abgeschlossen ist.

Sobald der Export abgeschlossen ist, erhalten Sie eine Warnung, die Sie darüber informiert, dass die Daten exportiert wurden. Der Bericht wird automatisch im Hintergrund in den standardmäßigen Download-Speicherort Ihres Browsers heruntergeladen, wenn Sie über die Berechtigung zum Anzeigen von Warnungen verfügen. Sie können jedoch auch die Seite Meine Berichte besuchen und den Bericht bei Bedarf herunterladen.

Auf der Seite Meine Berichte werden nur die Exporte angezeigt, die Sie in den letzten 168 Stunden (7 Tage x 24 Stunden) erstellt haben. Exporte, die älter als 168 Stunden sind, werden endgültig gelöscht. Ein am 1. um 00:00 Uhr erstellter Export ist beispielsweise bis zum 7. um 23:59 Uhr verfügbar.

Um Ihre Exporte anzuzeigen, klicken Sie auf das Symbol Meine Berichte in der oberen Navigationsleiste.

Sie können die folgenden Eigenschaften eines Exports sehen:

• Exporttyp – Verweist auf das Orchestrator-Objekt
• Erstellt am – Der relative Zeitstempel, wann Sie den Export erstellt haben
• Erstellt am (absolut) – Der genaue Zeitstempel, wann Sie den Export erstellt haben. Absolute Zeitstempel werden in der Zeitzone des Mandanten angezeigt. Bei Triggern wird die nächste Laufzeit in der Zeitzone des Triggers angezeigt, die sich von der Zeitzone des Mandanten unterscheiden kann.
• Verfügbar bis – Das Datum, an dem der Export aus der Liste entfernt werden soll.Berichte werden am angegebenen Datum um 00:00 Uhr entfernt.

  Dies wird erst angezeigt, nachdem der Bericht exportiert wurde.

• Größe – Die Größe des Exports. Dies wird erst angezeigt, nachdem der Bericht exportiert wurde.

• Status – Der Status des Exportvorgangs:

  • Neu – Der Export wird ausgeführt.
  • Abgeschlossen – Der Export ist abgeschlossen.

  • Fehlgeschlagen – Der Export ist fehlgeschlagen.Dies kann durch eine SQL-Zeitüberschreitung oder zu wenig Speicher generiert werden.Sie müssen den Export manuell wiederholen.

    Die Rechenzeit zum Auflösen des Exports beträgt maximal 15 Minuten. Nach dieser Zeit schlägt der Export fehl. Bevor Sie den Export wiederholen, wenden Sie zusätzliche Filter auf Ihre Daten an.

    Wichtig:

    So verhindern Sie das Fehlschlagen von Exporten mit großen Datenmengen:

    • Sie müssen die API-Endpunkte für das entsprechende Orchestrator-Objekt verwenden. Verwenden Sie beispielsweise /odata/AuditLogs/UiPath.Server.Configuration.OData.Export, um Prüfungsprotokolle zu exportieren.

    • Das Volumen der generierten Exporte sowohl in Bezug auf die Häufigkeit als auch die Menge der abgerufenen Daten kann sich auf die Leistung Ihres Mandanten auswirken. Wenn die Leistung beeinträchtigt ist, drosseln oder blockieren wir solche Anforderungen möglicherweise, um sicherzustellen, dass Ihre Automatisierungen nicht von diesem Verhalten betroffen sind.

    • Wenden Sie Filter an, um die Menge der exportierten Daten zu reduzieren.

Um die Daten auf Ihr Gerät herunterzuladen, klicken Sie für den gewünschten Bericht auf die Schaltfläche Herunterladen. Dieser Vorgang verwendet den Standardspeicherort für Downloads auf Ihrem Gerät. Der Bericht wird als Archiv heruntergeladen, das die .csv-Datei der rastergefilterten Daten enthält.

Die Dateien .zip und .csv werden gemäß den folgenden Namenskonventionen benannt:

Exportierter Objekttyp	Dateibenennungskonvention für Downloads
Warteschlangentransaktionen	{queue-name}-items-{export-date}-{export-timestamp}-{export-id} Wenn der Warteschlangenname ungültige Zeichen (\ / : * ? " < > |) enthält, werden diese durch _ ersetzt.
Protokolle	audit-logs-{export-date}-{export-timestamp}-{export-id}
Protokolle	robot-logs-{export-date}-{export-timestamp}-{export-id}
Jobs	jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id}

Wo:

• {queue_name} – Der Name der Warteschlange mit den exportierten Warteschlangenelementen

• {job_folder_key} – Die ID des Ordners, aus dem das Auftragsraster exportiert wurde

• {export_date} – Das Datum, an dem der Export erstellt wurde, im Format yyyy-MM-dd
• {export_timestamp} – die Zeit, zu der der Export erstellt wurde, im Format HH-mm-ss-fff
• {export-id} – Die ID des Exports

Beispielsweise könnte eine Export-Download-Datei für ein Prüfprotokollraster den Namen audit-logs-2023-01-27-12-29-40-843-24.zip haben.

Wichtig:

Zeitspalten in exportierten Berichten werden in der Zeitzone des Mandanten angegeben.

Wichtige Hinweise zu API-Exporten

• Die Schlüsselwörter $select, $top, $skip, $orderBy, and $count in unserer Export-API werden nicht unterstützt und wir raten dringend davon ab, sie zu verwenden. Verwenden Sie stattdessen geeignete Filter.
• Berichtseinträge werden nur nach Id sortiert, d. h. $orderBy=Id. Alle anderen Parameter, die für das Schlüsselwort $orderBy verwendet werden, werden ignoriert.
• Das Filtern durch eine Struktur von $filter= lässt nur die Felder zu, die in der Tabelle als verfügbar markiert sind.

• Wenn Sie eines der nicht unterstützten Felder verwenden, wie in den folgenden Tabellen beschrieben, wird ein 400-Fehler zurückgegeben.

Unterstützte Felder für API-Exporte von Warteschlangentransaktionen

In der folgenden Tabelle sind die Felder aufgeführt, die in dem Bericht verfügbar sind, der durch das Exportieren von Warteschlangentransaktionen über die API generiert wird, und es wird angegeben, ob diese Felder zum Filtern zulässig sind.

API-Feld	Entsprechende Spalte im exportierten Bericht	Ermöglicht Filtern
QueueDefinitionId	Keine Angabe
Status	Status
ReviewStatus	Überarbeitung
Reference	Referenz (Reference)
ProcessingExceptionType	Ausnahme
DueDate	Keine Angabe
DueDateAbs	Frist (absolut)
Priority	Priorität
RobotName	Roboter
DeferDate	Keine Angabe
DeferDateAbs	Verschieben (absolut)
StartProcessing	Keine Angabe
StartProcessingAbs	Gestartet (absolut)
EndProcessing	Keine Angabe
EndProcessingAbs	Beendet (absolut)
SecondsInPreviousAttempts	Transaktionsausführungszeit
AncestorId	AncestorId
AncestorUniqueKey	AncestorUniqueKey
RetryNumber	Nr. der Wiederholung
ManualAncestorId	Manuelle VorgängerID
ManualAncestorUniqueKey	Manueller AncestorUniqueKey
ManualRetryNumber	Anzahl manueller Wiederholungen
UniqueKey	UniqueKey
SpecificData	Spezielle Daten
Key	Schlüssel
ReviewerName	Name des Prüfers
ProcessingExceptionReason	Grund der Ausnahme
Output	Ausgabe
RobotId	Keine Angabe
ReviewerUserId	Keine Angabe
Analytics	Analysedaten
CreationTime	Keine Angabe
CreationTimeAbs	Erstellt (absolut)
Progress	Fortschritt
Id	ID

Unterstützte Felder für API-Exporte von Prüfungsprotokollen

In der folgenden Tabelle sind die Felder aufgeführt, die in dem Bericht verfügbar sind, der durch das Exportieren von Prüfungsprotokollen über die API generiert wird, und es wird angegeben, ob diese Felder zum Filtern zulässig sind.

API-Feld	Entsprechende Spalte im exportierten Bericht	Ermöglicht Filtern
Parameter	Keine Angabe
DisplayName	Keine Angabe
Action	Aktion
Component	Komponente
UserId	Keine Angabe
ExecutionTime	Keine Angabe
OperationText	Betrieb
ExecutionTimeAbs	Zeit (absolut)
ServiceName	Keine Angabe
MethodName	Keine Angabe
EntityId	Keine Angabe
UserType	Keine Angabe
UserIsDeleted	Keine Angabe
ExternalClientId	Keine Angabe
UserName	Benutzer

Unterstützte Felder für API-Exporte von Roboterprotokollen

In der folgenden Tabelle sind die Felder aufgeführt, die in dem Bericht verfügbar sind, der durch das Exportieren von Roboterprotokollen über die API generiert wird, und es wird angegeben, ob diese Felder zum Filtern zulässig sind.

API-Feld	Entsprechende Spalte im exportierten Bericht	Ermöglicht Filtern
JobKey	Keine Angabe
TimeStamp	Zeit (absolut)
Level	Ebene
ProcessName	Prozess
HostMachineName	Hostname
WindowsIdentity	Hostidentität
Message	Meldung
RawMessage	Keine Angabe
RobotName	Robotername
MachineId	Keine Angabe
MachineKey	Keine Angabe
RuntimeType	Keine Angabe

Unterstützte Felder für API-Exporte von Aufträgen

API-Feld	Entsprechende Spalte im exportierten Bericht	Ermöglicht Filtern
CreationTime	Keine Angabe
SourceType	Keine Angabe
State	Status (State)
SpecificPriorityValue	Priorität
HostMachineName	Hostname
LocalSystemAccount	Hostidentität
MachineName	Maschine
Key	Schlüssel
JobPriority	Keine Angabe
ReleaseName	Prozess
RobotName	Roboter
MachineScope	Keine Angabe
EnvironmentName	Umgebung
Type	Auftragstyp
RuntimeType	Runtime-Typ/Lizenz
StartTime	Keine Angabe
StartTimeAbs	Gestartet (absolut)
EndTime	Keine Angabe
EndTimeAbs	Beendet (absolut)
ProcessType	Keine Angabe
Source	Quelle
CreationTimeAbs	Erstellt (absolut)
ServerlessJobType	Keine Angabe
StartingScheduleId	Keine Angabe
Release	Keine Angabe
Machine	Keine Angabe
Robot	Keine Angabe

Exportwarnungen

Alle von Ihnen erstellten Exporte werden auf der Seite Warnungen protokolliert, sofern Sie über die entsprechenden Berechtigungen verfügen. Abgeschlossene Exporte werden mit dem Schweregrad Info protokolliert, während fehlgeschlagene Exporte mit dem Schweregrad Fehler protokolliert werden.

Standardmäßig erhalten Sie Warn-E-Mails über abgeschlossene oder fehlgeschlagene Exporte. Sie können diese Warnungen abbestellen, indem Sie zur Seite Warnungseinstellungen navigieren und die Option Exportieren deaktivieren.