Angabe der Version des Metadatenschemas in der Instanz der Metadaten (optionales `$schema`-Attribut)
Warum?
Als empfangendes System biete ich mehrere Versionen des Metadatenschemas in meinem Zustellpunkt an. Wenn ich eine Einreichung empfange, möchte ich eine Schemaprüfung des Metadatensatzes durchführen. Dafür möchte ich wissen, welche Version des Metadatenschemas verwendet wurde.
Relevante Links und Bemerkungen
- Mit der nächsten Major-Version wird dieses Feld verpflichtend gesetzt. Hierzu gibt es ein passendes Issue: #572 (closed)
- Anpassung in den SDKs erfolgt in #775 (closed) und #776 (closed)
Akzeptanzkriterien
-
Das Metadatenschema wird um ein Feld $schemaerweitert, dass die URI des Metadatenschemas enthält -
Neu: Für das Attribut $schemasind nur Werte mit Regex"^https:/\\/schema\\.fitko\\.de\\/fit-connect\\/metadata\\/1\\.\\d+\\.\\d+\\/metadata\\.schema\\.json$"erlaubt (vgl. event-payload!5 (diffs)) -
Das Feld und seine Verwendung ist dokumentiert-> wird behandelt in #133 (closed) -
Neu: Für das Metadatenschema 1.0.0 wird in der Dokumentation empfohlen, dass eine $schemaProperty mit dem Werthttps://schema.fitko.de/fit-connect/metadata/1.0.0/metadata.schema.jsonverwendet wird. -
Neu: Die Prüfung von Schemata gegen Beispiel-Payloads erfolgt automatisiert via GitLab-CI -
Die neue Version des Metadatenschemas wurde nach dem PO-Review veröffentlicht. -
Changelog in docs.fitko.de/fit-connect ergänzen -
Neue Version des Metadatenschemas-> #1012 (closed)1.1.0ist im Self-Service-Portal hinterlegt -
Neu: Das im Java-SDK hinterlegte Metadatenschema wurde auf die neue Version 1.1.0aktualisiert. -
Neu: Das im .NET-SDK hinterlegte Metadatenschema wurde auf die neue Version 1.1.0aktualisiert.
Durchführungsplan
-
Property $schemaalsRegEx, der alle Versionen der Formenummit einem fixen Wert1.x.yakzeptiert, ergänzen -
Doku prüfen und ggf. ergänzen -
(Property $schemamit nächster Major-Version inrequiredändern - Achtung: Breaking Change -> #572 (closed))
Branches
Metadaten - 267 schema mandatory
Merge Requests:
Edited by Marco Holz