Merge branch 'pr-scheme-referenzierung' into 'master'

Aktualisierung der Schema-Referenzierung.

See merge request fit-connect/FIT-Connect-PoC!24

CHANGELOG.md

@@ -38,6 +38,8 @@ Der Aufbau & Umfang von Destination-Objekten hat sich geändert:
     - `keys`: Hier befinden sich die öffentlichen Schlüssel des Zustellpunktes.
     - Der `signingKid` fehlt, da dieser an signierten Nachrichten mit angehängt wird und ebenso im Attribut `keys`
       auffindbar ist.
+- Ein Schema besteht nun aus einer `schemaURI` und optional einem Feld `mimeType`.
+  - Wurde im Zuge der Vereinfachung so umgesetzt. URLs und URNs können in das Feld `schemaURI` eingetragen werden.
 
 ```json
 {
@@ -49,8 +51,7 @@ Der Aufbau & Umfang von Destination-Objekten hat sich geändert:
   },
   "schemas": [
     {
-      "mimeType": "application/json",
-      "schemaSource": "none"
+      "schemaURI": "urn:fitko:schema-x"
     }
   ],
   "callback": "http://127.0.0.1:4010/voluptas",

spec/examples/create-destination.yml

@@ -5,8 +5,7 @@ value:
     email: max@mustermann.not
     organizationName: Musterorganisation
   schemas:
-    - mimeType: application/json
-      schemaSource: none
+    - schemaURI: urn:fitko:schema-x
   callback: 'http://127.0.0.1:4010/voluptas'
   encryptionKid: my-key-id-0xfff
   keys:

spec/examples/destination-list.yml

@@ -2,8 +2,7 @@ value:
   destinations:
     - destinationId: de735e92-8ced-4298-a021-5f4aa124cc47
       schemas:
-        - mimeType: application/json
-          schemaSource: none
+        - schemaURI: urn:fitko:schema-x
       encryptionKid: my-key-id-0xfff
       keys:
         keys:
@@ -11,13 +10,9 @@ value:
             kid: my-key-id-0xfff
     - destinationId: 2f59b8c6-3206-4734-aa21-a7b2a4d92f7a
       schemas:
-        - mimeType: application/xml
-          schemaSource: none
-        - mimeType: application/json
-          schemaSource: none
-        - mimeType: application/xml
-          schemaSource: fim
-          schemaId: S99000001V1.0
+        - schemaURI: urn:fitko:schema-x
+        - schemaURI: urn:fitko:schema-y
+          mimeType: application/xml
       encryptionKid: my-key-id-0xeee
       keys:
         keys:

spec/examples/destination.yml

 value:
   destinationId: 7881dba9-4055-4854-8b6d-11ea5b7f3047
   schemas:
-    - mimeType: application/json
-      schemaSource: none
+    - schemaURI: urn:fitko:schema-x
   encryptionKid: my-key-id-0xfff
   keys:
     keys:

spec/examples/update-destination.yml

@@ -5,8 +5,7 @@ value:
     email: max@mustermann.not
     organizationName: Musterorganisation
   schemas:
-    - mimeType: application/json
-      schemaSource: none
+    - schemaURI: urn:fitko:schema-x
   callback: 'http://127.0.0.1:4010/voluptas'
   encryptionKid: my-key-id-0xfff
   keys:

spec/schemas/application-schema.yml

 title: Fachdatenschema
-description: 'Repräsentation eines Schemas, in dem die Fachdaten eines Antrags übermittelt werden.'
+description: 'Referenz auf ein Schema, das die Struktur der Fachdaten eines Antrags beschreibt.'
 type: object
 required:
-  - schemaSource
-  - mimeType
+  - schemaURI
 additionalProperties: false
 properties:
-  schemaId:
+  schemaURI:
     type: string
-    description: 'Identifikator des Schemas, abhängig von der ausgewählten Quelle.'
-  schemaSource:
-    type: string
-    enum:
-      - fim
-      - none
-    description: 'Quelle, von der das Schema bezogen werden kann.'
+    format: uri
+    description: 'URI (URL oder URN) des Fachdaten-Schemas. Wird hier eine URL verwendet, sollte das Schema unter der angegebenen URL abrufbar sein. Eine Verfügbarkeit des Schemas unter der angegebenen URL darf jedoch nicht vorausgesetzt werden.'
   mimeType:
     type: string
-    enum:
-      - application/json
-      - application/xml
-    description: Gibt das zulässige Format (JSON oder XML) der Fachdaten an.
+    description: Mimetype (z.B. application/json oder application/xml) des referenzierten Schemas (z.B. XSD- oder JSON-Schema).