​

Export-Historie

Die Export-Historie zeigt Berichtsexporte, die als Hintergrund-Jobs erstellt wurden. Verwende sie, um zu prüfen, ob ein Export ausstehend ist, verarbeitet wird, abgeschlossen ist oder fehlgeschlagen ist, und um abgeschlossene Exportdateien herunterzuladen.

​

Export-Historie öffnen

Die Export-Historie wird aus dem Berichtsbereich geöffnet. Verwende sie, nachdem du einen Hintergrundexport von einer Berichtsseite erstellt hast, zum Beispiel aus dem Purchase Orders Report.

​

Was die Export-Historie zeigt

Die Tabelle der Export-Historie zeigt Berichtsexport-Jobs für den ausgewählten Unternehmenskontext. Jede Zeile kann Folgendes anzeigen:

​

Dateiformat-Badges

Exportdateien werden mit visuellen Badges angezeigt.

​

Status

Export-Jobs können unterschiedliche Status haben. Wenn ein Job verarbeitet wird und Fortschrittsinformationen verfügbar sind, kann das Frontend den Fortschritt in Prozent neben dem Status-Badge anzeigen.

​

Automatische Aktualisierung

Die Export-Historie aktualisiert sich automatisch, solange es noch nicht abgeschlossene Jobs gibt. Nicht abgeschlossene Jobs sind Jobs, die noch nicht:

• completed
• failed

sind. Das Frontend prüft auf nicht abgeschlossene Jobs und aktualisiert die Tabelle alle 5 Sekunden, solange ein nicht abgeschlossener Job sichtbar ist. Du kannst auch auf Refresh klicken, um die Tabelle manuell neu zu laden.

​

Export herunterladen

Abgeschlossene Exporte zeigen einen Download-Button, wenn der Job herunterladbar ist.

​

Filter

Die Export-Historie unterstützt Filter in der Toolbar. Klicke auf Add filter, um optionale Filter anzuzeigen. Verwende Clear all, um aktive Filter zurückzusetzen.

​

URL-Suchparameter

Das Frontend speichert Filter-, Sortier- und Paginierungsstatus in der URL. Die Standardsortierung zeigt die neuesten Einträge zuerst:

​

Sortierung

Die Tabelle unterstützt Sortierung für ausgewählte Spalten. Sortierbare Spalten sind:

• Format
• Datumsbereich
• Berichtstyp
• Status
• Erstellt

Die Sortierung aktualisiert den URL-Parameter ordering und setzt die Tabelle auf die erste Seite zurück.

​

Paginierung

Die Export-Historie ist paginiert. Das Backend gibt Folgendes zurück:

​

Export-Job erstellen

Export-Jobs werden von Berichtsseiten erstellt, zum Beispiel vom Einkaufsbericht. Eine Berichtsseite kann zum Beispiel einen Hintergrundexport-Job mit folgenden Feldern erstellen: Nachdem der Job erstellt wurde, startet er mit dem Status pending. Das Backend stellt den Berichtsexport-Task anschließend zur Verarbeitung in die Warteschlange.

​

Direkter Download vs. Hintergrundexport

Einige Berichtsseiten können sowohl direkte Downloads als auch Hintergrundexporte unterstützen. Hintergrundexporte sind nützlich für größere Berichte oder länger laufende Berichtserstellung.

​

Verhalten der Backend-Liste

Das Backend listet Export-Jobs über den Export-Job-Endpunkt auf. Es unterstützt:

• Paginierung
• Unternehmensfilterung
• Statusfilterung
• Berichtstypfilterung
• Dateiformatfilterung
• Filterung nach Erstellungsdatumsbereich
• Sortierung

Das Backend beschränkt die Liste auf Unternehmen, für die der Benutzer die Berechtigung hat, Finanzdaten einzusehen.

​

Backend-Filter

Das Backend akzeptiert diese Filter für Export-Jobs:

​

Backend-Sortierung

Das Backend unterstützt Sortierung nach: Wenn ein nicht unterstütztes Sortierfeld gesendet wird, fällt das Backend auf „neueste zuerst“ zurück.

​

Zugriffskontrolle

Export-Jobs sind durch Finanzberichtszugriff eingeschränkt. Ein Benutzer kann Export-Jobs nur für Unternehmen auflisten, erstellen oder herunterladen, bei denen er die erforderliche Berechtigung zum Anzeigen von Finanzdaten hat. Wenn der Benutzer keinen Zugriff hat, gibt Mathership einen Zugriffsfehler zurück.

​

Backend-Verhalten beim Download

Wenn ein Benutzer einen abgeschlossenen Export herunterlädt, führt das Backend Folgendes aus:

1. Prüfen, ob der Job zu einem Unternehmen gehört, auf das der Benutzer Zugriff hat
2. Bestätigen, dass der Benutzer die Berechtigung hat, Finanzdaten einzusehen
3. Prüfen, ob der Jobstatus completed ist
4. Prüfen, ob ein Dateischlüssel existiert
5. Eine sichere, vorsignierte S3-Download-URL erzeugen
6. Download-URL, Ablaufzeit und Dateiname zurückgeben

Die zurückgegebene Download-URL läuft nach 1 Stunde ab.

​

Download-Fehler

​

Leere und ladende Zustände

Das Frontend kann Folgendes anzeigen:

​

Häufige Arbeitsabläufe

​

Berichtsexport erstellen und herunterladen

1. Berichtsseite öffnen
2. Benötigte Filter auswählen, zum Beispiel Datumsbereich und Lieferort
3. Export-Job erstellen
4. Export History öffnen
5. Warten, bis der Jobstatus Completed ist
6. Auf Download klicken

​

Prüfen, warum ein Export fehlgeschlagen ist

1. Export History öffnen
2. Nach Status Failed filtern
3. Fehlgeschlagenen Job finden
4. Fehlermeldung prüfen, die unter dem Failed-Badge angezeigt wird
5. Export erneut erstellen, nachdem Berichtsfilter oder Datenproblem korrigiert wurden

​

Bestimmten Export finden

1. Export History öffnen
2. Nach Dateiformat filtern, wenn du weißt, ob es CSV oder PDF war
3. Nach Erstellungsdatumsbereich filtern
4. Nach Created oder Date range sortieren
5. Abgeschlossene Datei herunterladen

​

Best Practices

​

Häufige Probleme

​

Verwandte Seiten