Skip to main content

​
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-Jobs verfolgen

Sieh alle Berichtsexport-Jobs mit Status, Format, Datumsbereich, Berichtstyp und Erstellungsdatum.

Abgeschlossene Dateien herunterladen

Lade abgeschlossene Exporte herunter, sobald die Datei bereit ist.

Filtern und aktualisieren

Filtere nach Status, Dateiformat und Erstellungsdatum oder aktualisiere die Tabelle manuell.

​
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.
1

Reports öffnen

Gehe in Mathership in den Berichtsbereich.
2

Export History öffnen

Wähle Export History.
3

Exporte prüfen

Prüfe den Status früherer Exporte und lade abgeschlossene Dateien herunter.

​
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.
1

Abgeschlossenen Export finden

Suche nach einer Zeile mit dem Status Completed.
2

Auf Download klicken

Klicke im Aktionsbereich der Zeile auf Download.
3

Datei öffnen

Mathership öffnet eine sichere Download-URL in einem neuen Browser-Tab.
Download wird nur angezeigt, wenn der Exportstatus completed ist und der Job heruntergeladen werden kann.

​
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:
Das Frontend verwendet created_from und created_to; der Backend-Export-Job-Endpunkt verwendet created_at_from und created_at_to. Der API-Hook sollte diese Werte übersetzen, bevor er das Backend aufruft.

​
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

Hintergrundexporte für größere Berichte verwenden

Erstelle Export-Jobs für Berichte, deren Erzeugung länger dauern kann.

Status vor dem Download prüfen

Download ist erst verfügbar, nachdem der Export den Status Completed erreicht hat.

Bei Bedarf aktualisieren

Verwende den Refresh-Button, wenn du den neuesten Jobstatus sofort prüfen möchtest.

Filter verwenden

Filtere nach Status, Format und Erstellungsdatum, um ältere Exporte schnell zu finden.

Zeitnah herunterladen

Sichere Download-URLs laufen nach 1 Stunde ab.

Berechtigungen prüfen

Benutzer benötigen Finanzberichtszugriff für das Unternehmen, um Exporte aufzulisten, zu erstellen oder herunterzuladen.

​
Häufige Probleme

Der Job muss den Status completed haben und als herunterladbar markiert sein.Wenn der Job noch pending oder processing ist, warte, bis er abgeschlossen ist.
Klicke auf Refresh, um den neuesten Status neu zu laden.Wenn sich der Status lange nicht ändert, muss der Export-Task möglicherweise im Backend geprüft werden.
Prüfe die Fehlermeldung, die unter dem Failed-Badge angezeigt wird.Erstelle den Export erneut, nachdem Berichtsfilter oder zugrunde liegendes Datenproblem korrigiert wurden.
Prüfe, ob du das richtige Unternehmen ausgewählt hast und ob dein Benutzer die Berechtigung hat, Finanzberichte für dieses Unternehmen anzuzeigen.

​
Verwandte Seiten

Bestandsbericht

Prüfe Lagerbestände, Bewegungshistorie, Kosten und Zutatenaktivität.

Einkaufsbestellungsbericht

Analysiere erhaltene Lieferantenbestelldaten nach Lieferort und Datumsbereich.

Lieferorte

Verwalte Lieferorte, die von Einkaufsberichten verwendet werden.

Organisationseinstellungen

Verwalte Organisationen, Unternehmen, Mitglieder und Zugriffsberechtigungen.
Zuletzt geändert am 9. Juni 2026