API-Änderungen · API Change Guard
Inkompatible Typänderung
- Standard-Schweregrad
- Kritisch
- Befundcode:
- API_BREAKING_TYPE_CHANGED
- Engine-Version:
- 2.2.0
Was dieser Befund bedeutet
API Change Guard meldet diesen Befund mit dem Standard-Schweregrad „Kritisch“.
Zur Engine: Kompatibilität und Veraltung von OData-, SOAP- und RFC-Schnittstellen
So beheben Sie es
Stellen Sie den bisherigen Typ wieder her oder ergänzen Sie eine neue Eigenschaft mit dem neuen Typ; inkompatible Konvertierungen brechen die Deserialisierung bei Konsumenten.
So erkennt ERP Preflight das Problem
Die Analyse ist deterministisch: Dieselben exportierten Dateien und derselbe Wissens-Snapshot führen immer zu denselben Befunden. Eine Verbindung zum SAP-System ist nicht nötig — Sie laden Exporte hoch.
- Engine
- API Change Guard
- Akzeptierte Formate
- JSON, XML, TEXT
- Was Sie exportieren
- Technische Beschreibung des Eingabevertrags (Englisch)
Two API specifications of the same service — baseline (current) and candidate (target release): OpenAPI 2/3 (JSON or YAML) or OData EDMX V2/V4 XML — supplied as {'baseline': …, 'candidate': …} in raw_content / configuration or as artifacts named *baseline* / *candidate*; optional 'integrations' registry for consumer impact.
- Erforderliche Eingabe
- baseline specification
- candidate specification
- Nachweis
- Jeder Befund verweist auf Artefaktpfad, Zeile und Spalte, den Codeausschnitt und den SHA-256 der hochgeladenen Datei. Befunde ohne einen solchen Verweis werden auf die Konfidenz UNKNOWN herabgestuft.
- Konfidenz
- Bis zu VERIFIED (1,0), wenn der Befund auf Knowledge-graph API lifecycle snapshot (configuration.api_lifecycle) beruht; höchstens RULE_DERIVED (0,85), wenn er auf Incompatible type-conversion tables (OpenAPI primitive types, OData EDM types) beruht.
- Wissensquellen
- Incompatible type-conversion tables (OpenAPI primitive types, OData EDM types) — kuratiert, nicht gegen die Quelle verifiziert
- Knowledge-graph API lifecycle snapshot (configuration.api_lifecycle) — gegen die offizielle Quelle verifiziert
- Ziel-Releases der Engine
- S4H_2022, S4H_2023, S4HANA_CLOUD_2402, S4HANA_CLOUD_2408
Verwandte Befunde
- KritischEndpunkt entfernt
- KritischOData-Entitätstyp entfernt
- KritischOData-Entitätsmenge entfernt
- KritischEigenschaft / Feld entfernt
- KritischOData-Entitätsschlüssel geändert
- KritischOperation entfernt