Zum Inhalt springen
ERP Preflight

Custom Field Flow Doctor

Extension field lineage from CDS views through BAPIs to UI annotations

Inhalt geprüft am 26. September 2026

Engine
CUSTOM_FIELD_FLOW_DOCTOR
Domäne
Output & Extensibility
Version
2.0.0
Ziel-Releases
S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate
JSON

Eingabevertrag

Custom field registry JSON: {'field_name': 'YY1_…', 'hops': [{source_context, target_context, min_release?}], 'field_definitions': {context: {type, length, usages: ['UI', 'FORM', 'API', ...]}}, 'required_exposures': {context: ['FORM', 'API', 'ANALYTICS', 'UI', 'EMAIL']} (or a list for the final context), 'active_scenarios': [...], 'badi_implementations': [...]}.

Erforderliche Eingabe

  • field_name
  • hops or field_definitions
  • JSON only: the Custom Fields app has no machine-readable TXT/XML export this engine could rely on.

Befundcodes

Befundcodes (8)

  • FIELD_MISSING_TARGET_CONTEXTStandard-Schweregrad: KritischKategorie: DATA_MODEL_INTEGRITY

    Kundenfeld im Ziel-Geschäftskontext nicht aktiviert

    Behebung: Öffnen Sie das Feld in der App „Benutzerdefinierte Felder“, Registerkarte „UIs und Berichte“ / „Geschäftsszenarien“, aktivieren Sie es für den Ziel-Geschäftskontext und veröffentlichen Sie das Feld erneut.

  • FIELD_PROPAGATION_BLOCKEDStandard-Schweregrad: KritischKategorie: DOCUMENT_FLOW

    Kundenfeld kann über diesen Übergang nicht weitergegeben werden

    Behebung: Aktivieren Sie das von SAP ausgelieferte Geschäftsszenario für den Übergang (Benutzerdefinierte Felder > Geschäftsszenarien) oder leiten Sie den Wert über die unterstützten Zwischen-Belegkontexte.

  • FIELD_BADI_REQUIRED_NOT_FOUNDStandard-Schweregrad: HochKategorie: CUSTOM_LOGIC

    Erforderliche Cloud-BAdI-Implementierung fehlt

    Behebung: Implementieren und veröffentlichen Sie das aufgeführte Cloud-BAdI in der App „Benutzerdefinierte Logik“, damit der Feldwert in den Zielkontext kopiert wird (z. B. BADI_FINS_ACDOC_EXT_PERSISTENCE für Journalbuchungspositionen).

  • FIELD_EXPOSURE_NOT_ENABLEDStandard-Schweregrad: HochKategorie: EXTENSIBILITY_GOVERNANCE

    Kundenfeld für eine erforderliche Verwendung nicht aktiviert

    Behebung: Aktivieren Sie das Feld in der App „Benutzerdefinierte Felder“ für die fehlenden Verwendungen des Geschäftskontexts (Registerkarten „UIs und Berichte“, „Formularvorlagen“, „E-Mail-Vorlagen“, APIs) und veröffentlichen Sie es; prüfen Sie erneut, ob der Geschäftskontext die Verwendung im Zielrelease anbietet.

  • FIELD_NAME_INVALID_PREFIXStandard-Schweregrad: HochKategorie: EXTENSIBILITY_GOVERNANCE

    Name des Kundenfelds verletzt die Key-User-Namenskonvention

    Behebung: Key-User-Felder müssen das Präfix YY1_ verwenden (Entwicklererweiterbarkeit: ZZ1_). Legen Sie das Feld in der App „Benutzerdefinierte Felder“ mit einem konformen technischen Namen neu an und migrieren Sie die Daten vor dem Transport.

  • FIELD_RELEASE_LIMITATIONStandard-Schweregrad: HochKategorie: RELEASE_COMPATIBILITY

    Weitergabeübergang erfordert ein neueres Release als das Zielrelease

    Behebung: Das Geschäftsszenario bzw. die Weitergabe, auf der dieser Übergang beruht, ist erst ab dem angegebenen Release verfügbar. Planen Sie den Ablauf für ein Zielrelease ab diesem Stand oder leiten Sie den Wert über einen Übergang, den das Zielrelease bereits unterstützt.

  • FIELD_TYPE_MISMATCHStandard-Schweregrad: HochKategorie: DATA_MODEL_INTEGRITY

    Inkompatibler Feldtyp oder inkompatible Länge über einen Übergang

    Behebung: Gleichen Sie Typ und Länge des Kundenfelds in beiden Geschäftskontexten an (ein Key-User-Feld kann seinen Typ nach der Veröffentlichung nicht ändern – neues Feld anlegen und migrieren), sonst werden Werte abgeschnitten oder abgewiesen.

  • FIELD_PROPAGATION_REQUIRES_BADIStandard-Schweregrad: InfoKategorie: CUSTOM_LOGIC

    Weitergabe beruht auf kundeneigener BAdI-Logik

    Behebung: Halten Sie die BAdI-Implementierung unter Regressionstest; sie muss nach jedem Upgrade erneut validiert werden.

Codes der Eingabeprüfung (5)

  • FIELD_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 Custom Field Flow Doctor akzeptierten Formate (JSON) und starten Sie die Analyse erneut.

  • FIELD_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 Custom Field Flow Doctor akzeptierten Formate (JSON) und starten Sie die Analyse erneut.

  • FIELD_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 Custom Field Flow Doctor akzeptierten Formate (JSON) und starten Sie die Analyse erneut.

  • FIELD_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 Custom Field Flow Doctor akzeptierten Formate (JSON) und starten Sie die Analyse erneut.

  • FIELD_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 Custom Field Flow Doctor akzeptierten Formate (JSON) und starten Sie die Analyse erneut.

Zurück zur Dokumentation
Custom Field Flow Doctor — ERP Preflight Docs