Zum Inhalt springen
ERP Preflight

Software Collection Dependency Guard

Export software collection item cross-reference and release validator

Inhalt geprüft am 26. September 2026

Engine
SOFTWARE_COLLECTION_DEPENDENCY_GUARD
Domäne
Release & Transport
Version
1.1.0
Ziel-Releases
S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Akzeptierte Formate
JSON, XML, ZIP

Eingabevertrag

Key-User Software Collection export: JSON {'collections': [{collection_id, items: [{item_id, type, status, dependencies}], dependencies}], 'target_system_collections': [...], 'import_order': [collection ids]}, XML <software_collections> (optional <import_order><step collection="…"/></import_order>), or a ZIP (nested up to 2 levels) containing manifest.json / manifest.xml.

Erforderliche Eingabe

  • At least one software collection

Befundcodes

Befundcodes (7)

  • SC_MISSING_PREREQUISITEStandard-Schweregrad: BlockerKategorie: RELEASE_TRANSPORT

    Vorausgesetzte Collection weder exportiert noch im Zielsystem

    Behebung: Nehmen Sie die vorausgesetzte Collection in den Export auf oder importieren Sie sie zuerst in den Ziel-Tenant („Collection importieren“) und starten Sie den Preflight erneut.

  • SC_SCHEMA_VALIDATION_FAILEDStandard-Schweregrad: BlockerKategorie: RELEASE_TRANSPORT

    Collection- oder Eintragsdatensatz verletzt das Exportschema

    Behebung: Exportieren Sie die Software Collection erneut über „Software Collection exportieren“; dem genannten Collection-/Eintragsdatensatz fehlen Pflichtattribute (id, type, status) und er wurde von der Abhängigkeitsanalyse ausgeschlossen.

  • SC_CIRCULAR_DEPENDENCYStandard-Schweregrad: KritischKategorie: RELEASE_TRANSPORT

    Zirkuläre Abhängigkeit zwischen Software Collections

    Behebung: Führen Sie die voneinander abhängigen Einträge in einer Collection zusammen oder verlagern Sie die gemeinsamen Voraussetzungsobjekte in eine zuerst importierte Basis-Collection; zirkuläre Collections lassen sich in keiner Reihenfolge importieren.

  • SC_DANGLING_FIELD_REFERENCEStandard-Schweregrad: KritischKategorie: RELEASE_TRANSPORT

    Eintrag verweist auf ein nicht exportiertes oder nicht vorhandenes Feld

    Behebung: Nehmen Sie das referenzierte Kundenfeld in eine exportierte Collection auf oder bestätigen Sie, dass es im Ziel-Tenant existiert; andernfalls schlägt die Aktivierung beim Import fehl.

  • SC_WRONG_IMPORT_ORDERStandard-Schweregrad: KritischKategorie: RELEASE_TRANSPORT

    Geplante Importreihenfolge stellt eine Collection vor ihre Voraussetzung

    Behebung: Ordnen Sie den geplanten Import so, dass jede vorausgesetzte Collection zuerst importiert wird (siehe empfohlene Reihenfolge bzw. Importwellen im Analyseergebnis); wird eine abhängige Collection zuerst importiert, schlägt die Aktivierung ihrer Einträge im Ziel-Tenant fehl.

  • SC_DRAFT_ITEM_INCLUDEDStandard-Schweregrad: HochKategorie: RELEASE_TRANSPORT

    Unveröffentlichter Eintrag (Entwurf) in der Collection

    Behebung: Veröffentlichen Sie den Eintrag vor dem Export in seiner Key-User-App (Benutzerdefinierte Felder / Logik / CDS-Views); Entwürfe werden nicht transportiert.

  • SC_GROUPING_SUGGESTEDStandard-Schweregrad: GeringKategorie: RELEASE_TRANSPORT

    Vorgeschlagene Gruppierung zur Auflösung zyklischer Collections

    Behebung: Setzen Sie die vorgeschlagene Gruppierung um: Verschieben Sie die genannten gemeinsam genutzten Einträge in eine zuerst importierte Basis-Collection (EXTRACT_FOUNDATION) oder führen Sie die zyklischen Collections zu einer zusammen (MERGE), wenn das Herauslösen den Zyklus nicht bricht; exportieren Sie erneut und wiederholen Sie den Preflight.

Codes der Eingabeprüfung (5)

  • SC_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 Software Collection Dependency Guard akzeptierten Formate (JSON, XML, ZIP) und starten Sie die Analyse erneut.

  • SC_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 Software Collection Dependency Guard akzeptierten Formate (JSON, XML, ZIP) und starten Sie die Analyse erneut.

  • SC_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 Software Collection Dependency Guard akzeptierten Formate (JSON, XML, ZIP) und starten Sie die Analyse erneut.

  • SC_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 Software Collection Dependency Guard akzeptierten Formate (JSON, XML, ZIP) und starten Sie die Analyse erneut.

  • SC_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 Software Collection Dependency Guard akzeptierten Formate (JSON, XML, ZIP) und starten Sie die Analyse erneut.

Zurück zur Dokumentation
Software Collection Dependency Guard — ERP Preflight Docs