Hintergrundprozesse (SYS20)

Transaktion: SYS20 Hintergrundprozesse
UI-Pfad: /backgroundJobList

Business-Zweck

Hintergrundprozesse zeigen die Job-Queue (BackgroundJob): CSV-Exporte, Marktplatz-Syncs, Massenoperationen und andere asynchrone Tasks. Fast jede Partner-Integration, die „Export im Hintergrund" auslöst, erzeugt hier einen Eintrag.

Kernbegriffe

Begriff	Bedeutung
BackgroundJob	Job mit processName, actionName, params (JSON)
processingStatus	Status (offen, läuft, fertig, Fehler)
processingTries	Wiederholungszähler
file	Ergebnisdatei (CSV/XML) zum Download
marketplace	Optional: OMP-Bezug

Fachlicher Ablauf / Workflow

1. API/UI stößt Job an (z. B. isExport=1 auf Listen-Endpoints)
2. BackgroundJobApiService.save legt Eintrag an
3. Scheduler verarbeitet Job
4. SYS20 listet: GET /api/backgroundJob/
5. Download: GET /api/backgroundJob/download/{id}
6. Abbrechen: POST /api/backgroundJob/cancel
7. Manuell starten: GET /api/backgroundJob/execute/{id}

Sichtbarkeit

• Admin/CEO: alle Jobs
• Andere User: nur eigene Jobs

Partner-Szenarien

Szenario	Beispiel
Großer Kunden-CSV-Export	GET /api/customer/?isExport=1 → SYS20
Marktplatz-Massenexport	OMP + BackgroundJob
Export hängt	Status/Fehler in SYS20, ggf. cancel + retry

Voraussetzungen

• Authentifizierter User
• Ausreichend Scheduler-Kapazität (Server-seitig)

Typische Fehlerquellen

• Job nicht sichtbar – falscher User (nicht Admin)
• Download 404 – Job noch nicht fertig
• errorMessage im Job – Parameter/ Daten prüfen

Weiterlesen

• Online Marktplätze
• Sperreinträge (SYS01)