Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:xml-elementer:kombineret_loesning [2026-08-19 13:28] – chj
+++ fmk:1.6.0:xml-elementer:kombineret_loesning [2026-09-24 14:26] (current) – andm
@@ Line 1: / Line 1: @@
-======= Kombineret løsning for request-/response headers =======
+======= Beskrivelse af de to parallelle skema-strukturer =======
-Det har i nogle tilfælde vist sig kompliceret at implementere [[fmk:1.6.0:xml-elementer:request_response_headers|det tidligere forslag til FMK headere]] som en del af soap-headeren. Som følge heraf har der været ønske om at implementere en løsning, hvor FMK-headerne kun indeholder en begrænset, udvalgt gruppe elementer ifht. den oprindelige løsning.
+====== Oprindeligt forslag ======
-Derudover flyttes FMK-headerne ned i hhv. requestet/responset i soap-body. [[fmk:1.6.0:xml-elementer:alternativ_request_response_header| Det nye forslag kan ses her]].
+I starten af 1.6.0 udviklingen besluttedes at placere diverse headerelementer i en samlet FMKRequestHeader i SOAP-headeren:
-Da den originale løsning allerede er ved at blive implementeret flere steder, så er der et behov for, at FMK kan acceptere begge løsninger i overgangsperioden, og derved muliggøre en smidig overgang fra den gamle til den nye udgave i testmiljøerne.
+<code xml>
-Det løses ved at udstille 1.6.0 wsdl'en i 2 udgaver:
+  <soap:Header>
-  - svarende til den nuværende, hvor FMKRequestHeader elementet findes i soap headeren, som angivet i [[fmk:1.6.0:xml-elementer:request_response_headers|Generel request header]]
+    <FMKHeader>
-  - ny udgave, hvor fælles request-specifikke elementer flyttes ned i en FMKRequestHeader i selve request body'en, og hvor fx whitelisting header og consent header bliver i soap headeren som i 1.4.x, d.v.s. som angivet i [[fmk:1.6.0:xml-elementer:alternativ_request_response_header|Alternativt bud på request/response headers]]
+    ...
+    </FMKHeader>
+  </soap:Header>
+  <soap:Body>
+    <Request>
+  </soap:Body>
+</code>
-Endpoints og namespace vil forblive uændrede men FMK vil internt tillade at begge de 2 skema versioner anvendes. Hvis et klientsystem kalder med et request der overholder det oprindelige skema, vil svaret blive udformet således at også overholder det gamle skema. Ligeledes, hvis en klient kalder med den nye udformning af FMKRequestHeader vil svaret blive genereret således at den response headeren flyttes ned som en del af selve requestet under Body elementet.
+Det samme gjorde sig gældende for det tilsvarende response.
+Detaljer kan ses på xxx
-Bemærk, at det vil være udgave 2 der bliver den anvendte når FMK 1.6.0 aktiveres i produktion. Har man som klientsystem derfor endnu ikke implementeret håndteringen af headerne, bør man derfor kun implementere denne. Har man allerede implementeret og testet vha. udgave 1, så vil denne version fortsat fungere i en længere overgangsperiode i testmiljøerne, men på et tidspunkt vil det blive et krav, at der skiftes til udgave 2.
+====== Nyt forslag ======
+Det har efterfølgende vist sig kompliceret at implementere løsningen for mange klienter.
+FMK-headeren er derfor blevet begrænset i sit indhold og flyttet til selve request-elementet i soap-bodyen:
+<code xml>
+  <soap:Header>
+    <!-- Løse elementer, der tidligere var i FMKHeaderen-->
+  </soap:Header>
+  <soap:Body>
+    <Request>
+      <FMKHeader>
+        ...
+      </FMKHeader>
+      <!-- Resterende request>
+    </Request>
+  </soap:Body>
+</code>
+====== Transition ======
+Da den originale løsning allerede er ved at blive implementeret flere steder, så er der et behov for, at FMK kan acceptere begge løsninger i overgangsperioden. Dette skulle muliggøre en smidig overgang fra den gamle til den nye udgave i testmiljøerne.
+Det løses ved at udstille 1.6.0 wsdl'en i begge udgaver. De kan fortsat hentes fra (indsæt link).
+Da den nye løsning er den blivende, er denne navngivet uden præ- eller suffix, mens den originale version kaldes "old". Denne navngivning gælder kun distinktion af folderne.
+Endpoints og namespace vil forblive uændrede i alt indhold, og skemaerne divergerer ikke i andet indhold.
+FMK vil internt tillade at begge skemaversioner anvendes. Hvis et klientsystem kalder med et request, der overholder det originale skema, så vil responset ligeledes blive givet på samme form. Ditto kald med det nye skema.
+====== Fremtiden for headers og ny implementering ======
+Bemærk, at det vil være udgave 2, der bliver den anvendte når FMK 1.6.0 aktiveres i produktion.
+Det er derfor den, der skal implementeres, hvis man endnu ikke er påbegyndt.
+Den originale/"old"-version er KUN tiltænkt de udviklere, der allerede HAR implementeret den originale løsning, frem til implementering af den nye løsning.
+Denne version vil fortsat fungere i en længere overgangsperiode i testmiljøerne. Den nye løsning vil dog blive et krav på længere sigt.