Exportieren von Rastern im Hintergrund

So funktioniert der Export von Hintergrundrastern in Orchestrator zum Generieren von Datendateien aus Ressourcenseiten

Ü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, wann der Export beginnt 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, wählen Sie die Schaltfläche vertikale Ellipsen (⋮) neben Mandant aus und wählen Sie in der Liste Meine Berichte aus.

Abbildung 1. Meine Berichte

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 SQL-Timeout oder wenig Speicher verursacht werden. Sie müssen den Export manuell wiederholen. Die Rechenzeit für die Durchführung des Exports beträgt maximal 15 Minuten. Nach dieser Zeit schlägt der Export fehl. Bevor Sie den Export erneut versuchen, 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 (`\ / : * ? " < >
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	Robot	❌
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)	❌

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	Robot	❌
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 Warnungs-E-Mails über abgeschlossene oder fehlgeschlagene Exporte. Sie können diese Warnungen abbestellen, indem Sie zur Seite Warnungseinstellungen navigieren und die Option Exportieren deaktivieren.