Zum Inhalt springen
ERP Preflight

Workflow Stuck Explainer

Deterministic diagnostic analysis of stuck, failed, or overdue SAP Business Workflows

Inhalt geprüft am 26. September 2026

Engine
WORKFLOW_STUCK_EXPLAINER
Domäne
Operations
Version
2.1.0
Ziel-Releases
S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate
JSON, CSV

Eingabevertrag

Workflow runtime extracts: JSON {'swwwihead': [{wi_id, wi_type, wi_stat, wi_rh_task}], 'swwloghist': [...], 'agent_traces': [...], 'swetypv': [...], 'containers': [...], 'deadlines': [...]} or CSV exports of SWWWIHEAD / SWWLOGHIST / SWETYPV with their column headers.

Erforderliche Eingabe

  • SWWWIHEAD work items (or other workflow runtime tables)

Befundcodes

Befundcodes (6)

  • WF_DEADLOCK_DETECTEDStandard-Schweregrad: BlockerKategorie: Workflow Design

    Zirkuläres Warten zwischen Workitems

    Behebung: Brechen Sie den Wartezyklus auf: Schließen Sie ein Workitem ab oder löschen Sie es logisch (SWIA) und gestalten Sie Bedingungen / Verzweigung so um, dass die Schritte nicht aufeinander warten.

  • WF_BACKGROUND_TASK_FAILEDStandard-Schweregrad: KritischKategorie: Background Processing

    Hintergrundschritt mit Fehler beendet

    Behebung: Analysieren Sie die Ausnahme in SWI1 / SWWLOGHIST, korrigieren Sie Daten oder Methode und starten Sie das Workitem über SWPR / SWIA „Nach Fehler neu starten“ erneut.

  • WF_STUCK_NO_AGENTStandard-Schweregrad: KritischKategorie: Agent Determination

    Workitem im Status READY ohne möglichen Bearbeiter

    Behebung: Leiten Sie das Workitem in SWIA weiter; korrigieren Sie anschließend die Bearbeiterregel (PFAC / Zuständigkeitsregeln in „Workflows verwalten“) und die Organisationszuordnung (PPOME), sodass sie mindestens einen aktiven Benutzer ergibt.

  • WF_CONTAINER_BINDING_ERRORStandard-Schweregrad: HochKategorie: Data Binding

    Containerelement leer oder Datenfluss fehlgeschlagen

    Behebung: Korrigieren Sie den Datenfluss im Workflow Builder (SWDD) oder im Aufgabencontainer, berichtigen Sie die Instanzdaten und starten Sie das Workitem erneut.

  • WF_DEADLINE_BREACHEDStandard-Schweregrad: HochKategorie: SLA Monitoring

    Termin / SLA überschritten

    Behebung: Eskalieren Sie gemäß Terminkonfiguration, leiten Sie an eine Vertretung weiter und prüfen Sie den Terminüberwachungsjob (SWWDHEX / SWWDEADL).

  • WF_EVENT_LINKAGE_DEACTIVATEDStandard-Schweregrad: HochKategorie: Event Linkage

    Ereignistyp-Kopplung deaktiviert

    Behebung: Aktivieren Sie die Kopplung in SWE2 wieder (und prüfen Sie, warum sie deaktiviert wurde – Fehlerreaktion „Kopplung deaktivieren“).

Codes der Eingabeprüfung (5)

  • WF_ARCHIVE_REJECTEDStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Archiv durch Sicherheitsgrenzen der Datenaufnahme abgewiesen

    Behebung: Das Archiv hat das Expansionsverhältnis von 100:1, die Gesamtgröße von 500 MB, die Eintragsanzahl oder die Verschachtelungstiefe von 2 Ebenen überschritten oder enthielt Pfadtraversierung bzw. verschlüsselte Einträge. Laden Sie ein flaches, unverschlüsseltes Archiv der Exportdateien hoch. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Workflow Stuck Explainer akzeptierten Formate (JSON, CSV) und starten Sie die Analyse erneut.

  • WF_INVALID_INPUTStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt entspricht nicht dem Eingabevertrag der Engine

    Behebung: Liefern Sie den für diese Engine dokumentierten Artefakttyp; fremde oder strukturell ungültige Dokumente werden abgewiesen. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Workflow Stuck Explainer akzeptierten Formate (JSON, CSV) und starten Sie die Analyse erneut.

  • WF_PARSE_ERRORStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt konnte nicht geparst werden

    Behebung: Beheben Sie den Syntaxfehler an der gemeldeten Zeile/Spalte (oder exportieren Sie die Datei unverändert erneut aus SAP). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Workflow Stuck Explainer akzeptierten Formate (JSON, CSV) und starten Sie die Analyse erneut.

  • WF_PAYLOAD_TOO_LARGEStandard-Schweregrad: HochKategorie: INPUT_VALIDATION

    Artefakt überschreitet die Größenbegrenzung

    Behebung: Teilen Sie den Export auf (z. B. nach Paket, Buchungskreis oder Zeitraum), sodass jeder Upload unter der Nutzlastgrenze des Dienstes bleibt. Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Workflow Stuck Explainer akzeptierten Formate (JSON, CSV) und starten Sie die Analyse erneut.

  • WF_INSUFFICIENT_INPUTStandard-Schweregrad: InfoKategorie: INPUT_VALIDATION

    Erforderliche Eingabe fehlt

    Behebung: Liefern Sie alle Eingaben, die der Engine-Vertrag als erforderlich kennzeichnet (siehe Eintrag im Engine-Katalog). Es wurde kein Ergebnis erzeugt. Exportieren Sie das Artefakt erneut in einem der von Workflow Stuck Explainer akzeptierten Formate (JSON, CSV) und starten Sie die Analyse erneut.

Zurück zur Dokumentation
Workflow Stuck Explainer — ERP Preflight Docs