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.

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.

Lesen Sie mehr über Warnungen.