User Tools

Site Tools


fmk:1.6.0:xml-elementer:alternativ_request_response_header

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
fmk:1.6.0:xml-elementer:alternativ_request_response_header [2026-08-14 12:19] – [Elementer i FMK-request header] andmfmk:1.6.0:xml-elementer:alternativ_request_response_header [2026-10-09 11:51] (current) – [FMKConfigurationLastUpdated] andm
Line 1: Line 1:
-======= Alternativt bud på request/response headers =======+======= FMKRequest/response headers i body=======
 Som følge af klienternes ønske om en ændret udformning af request/Response headeren i 1.6.0 følger her en beskrivelse af et alternativt bud.  Som følge af klienternes ønske om en ændret udformning af request/Response headeren i 1.6.0 følger her en beskrivelse af et alternativt bud. 
- 
-**OBS. Nedenstående afventer høring, og er dermed ikke endeligt vedtaget.**  
  
 SecurityHeader og MedcomHeader er stadigvæk defineret uændret i DGWS standarden. SecurityHeader og MedcomHeader er stadigvæk defineret uændret i DGWS standarden.
Line 11: Line 9:
 <code xml> <code xml>
 <soap:Header  ... > <soap:Header  ... >
 +    <!-- Alle disse elementer var tidligere en del af "FMKRequestHeader", men er nu enkeltelementer -->
     <OnBehalfOfHeader> ... </OnBehalfOfHeader>     <OnBehalfOfHeader> ... </OnBehalfOfHeader>
     <WhitelistingHeader> ... </WhitelistingHeader>     <WhitelistingHeader> ... </WhitelistingHeader>
     <ConsentHeader> ... </ConsentHeader>     <ConsentHeader> ... </ConsentHeader>
     <MinLogSessionId>...</MinLogSessionId>     <MinLogSessionId>...</MinLogSessionId>
 +    <FMKConfigurationLastUpdated>...</FMKConfigurationLastUpdated>
     <PreflightOnly/>     <PreflightOnly/>
     <PartOfBatchOperation/>     <PartOfBatchOperation/>
Line 20: Line 20:
  
 <soap:Body> <soap:Body>
-    <FMKRequestHeader> +    <Request-body> 
-        <Paging> ... </Paging> +        <!-- Flyttet fra header --> 
-        <ExtendedValidationHeader> ... </ExtendedValidationHeader> +        <FMKRequestHeader> 
-    <FMKRequestHeader>+            <Paging> ... </Paging> 
 +            <ExtendedValidationHeader> ... </ExtendedValidationHeader> 
 +        <FMKRequestHeader> 
 +        <!-- Resterende request --> 
 +    </Request-body>
  
-    <Request-body> ... </Request-body> 
 </soap:Body> </soap:Body>
 </code> </code>
Line 84: Line 87:
  
 ==== FMKConfigurationLastUpdated ==== ==== FMKConfigurationLastUpdated ====
-Der er mulighed for at få oplysninger om specifikke dele af FMK's konfiguration, i tilfælde af at det er nødvendigt at udstille information om ændringen, så klienter kan indrette sig efter hvilken konfiguration, FMK er i. Sædvanligvis foretages der ikke større ændringer i FMK uden at det indgår som en del af en ny FMK snitflade/extension, men i enkelte tilfælde foretages også semantiske ændringer der kan styres vha. disse konfigurationsoplysninger. Hvis FMKConfigurationLastUpdated sendes med i et kald til FMK, returneres FMKConfigurationUpdatedWarning elementet i response headeren, i tilfælde af at konfigurationen har ændret sig siden det tidsstempel der er angivet i FMKConfigurationLastUpdated elementet. Herefter kan klienten kalde [[fmk:1.6.0:services:hent_fmk_konfiguration|GetFMKConfiguration]] servicen og indhente detaljerede oplysninger om konfiguration. Hvis elementet udelades, returnes ingen konfigurationsinformation.+Der er mulighed for at få oplysninger om specifikke dele af FMK's konfiguration, hvis det er nødvendigt at udstille information om ændringen. 
 +På den måde kan klienter indrette sig efter hvilken konfiguration, FMK er i.  
 +Sædvanligvis foretages der ikke større ændringer i FMK uden at det indgår som en del af en ny FMK snitflade/extension. I enkelte tilfælde foretages semantiske ændringer, der kan styres vha. disse konfigurationsoplysninger. 
 + 
 +FMKConfigurationLastUpdated er et tidsstempel, der kan sendes med i et kald til FMK. 
 +Hvis konfigurationen har ændret sig siden tidsstempelet, så returneres FMKConfigurationUpdatedWarning elementet i responset. Det er et tidsstempel, der indikerer, hvornår den sidste konfigurationsændring er trådt i kraft. 
 +Der bliver altså ikke returneret //hvilke// ændringer, der er trådt i kraft, men kun en implicit notifikation om, at der er sket ændringer efter klientens sidste opdatering. 
 + 
 +Klienten kan efterfølgende kalde [[fmk:1.6.0:services:hent_fmk_konfiguration|GetFMKConfiguration]] servicen og indhente detaljerede oplysninger om den specifikke konfiguration. Hvis elementet udelades, returnes ingen konfigurationsinformation.
  
 Eksempel: Eksempel:
Line 225: Line 236:
 <code xml> <code xml>
     <soap:Header>     <soap:Header>
-        <mc160:KnownPersonIdentifier> ... </mc160:KnownPersonIdentifier> +        <!-- Tidligere en del af "FMKResponseHeader", men er nu enkeltelementer --> 
-        <mc160:FMKConfigurationUpdatedWarning>...</mc160:FMKConfigurationUpdatedWarning>+        <KnownPersonIdentifier> ... </KnownPersonIdentifier> 
 +        <FMKConfigurationUpdatedWarning>...</FMKConfigurationUpdatedWarning>
     </soap:Header>     </soap:Header>
          
     <soap:Body>     <soap:Body>
-        <FMKResponseHeader> +        <Response> 
-        <mc160:FMKResponseHeader> +            <!-- Flyttet fra header --> 
-            <mc160:MedicinecardInvalid> ...</mc160:MedicinecardInvalid> +            <FMKResponseHeader> 
-            <mc160:VersionMismatchWarning/> +                <MedicinecardInvalid> ...</MedicinecardInvalid> 
-            <mc160:HiddenData> ...</mc160:HiddenData> +                <VersionMismatchWarning/> 
-            <mc160:Paging> ...</mc160:Paging> +                <HiddenData> ...</HiddenData> 
-            <mc160:Warnings> ... </mc160:Warnings> +                <Paging> ...</Paging> 
-            <mc160:Informations> ... </mc160:Informations> +                <Warnings> ... </Warnings> 
-        <mc160:FMKResponseHeader> +                <Informations> ... </Informations> 
- +            <FMKResponseHeader> 
-        <GetHandoversResponse> ... </GetHandoversResponse>+            <!-- Resterende respons --> 
 +        </Response>
     </soap:Body>     </soap:Body>
  
Line 286: Line 299:
  
 ==== HiddenData ==== ==== HiddenData ====
-Information omkring privatmarkering eller af andre årsager skjulte data. Dette felt er generaliseret i forhold til tidligere af hensyn til en evt. kommende MinSpærring integration. I tilfælde af udeladte data angives nu et element ''<HiddenData>'' med yderligere underelement der beskriver årsagen. P.t. vil kun ''<NegativeConsent>'' være implementeret, men altså med mulighed for udvidelser. Eksempel:+Information omkring privatmarkering eller af andre årsager skjulte data.  
 +I tilfælde af udeladte data angives elementet ''<HiddenData>'' med yderligere underelement der beskriver årsagen. 
 +Det inkluderer identifikation på klienten, årsag til udeladelse samt en liste af de udeladte elementer 
 + 
 +OBS! Dette felt er generaliseret i forhold til tidligere af hensyn til en evt. kommende MinSpærring integration. P.t. vil kun ''<HasNegativeConsent>'' være implementeret som grundlag, men altså med mulighed for udvidelser.  
 + 
 + 
 +Eksempel:
  
 <code xml> <code xml>
Line 292: Line 312:
   <PersonIdentifier source="CPR">2512489996</PersonIdentifier>   <PersonIdentifier source="CPR">2512489996</PersonIdentifier>
   <HasNegativeConsent/>   <HasNegativeConsent/>
 +  <DrugMedicationsWithNegativeConsentList>
 +    <DrugMedicationsWithNegativeConsent>
 +      <Identifier> 123 </Identifier> 
 +      <Version> 1 </Version>
 +    </DrugMedicationWithNegativeConsent>
 +    <DrugMedicationsWithNegativeConsent>
 +    ...
 +    </DrugMedicationsWithNegativeConsent>
 +  <DrugMedicationsWithNegativeConsentList>
 </HiddenData> </HiddenData>
 </code> </code>
Line 361: Line 390:
     <soap:Header>     <soap:Header>
             <!-- NYT: Alle elementer i denne soapheader var i tidligere forslag indkapslet i 'FMKRequestHeader'-element -->             <!-- NYT: Alle elementer i denne soapheader var i tidligere forslag indkapslet i 'FMKRequestHeader'-element -->
-            <mc160:OnBehalfOfHeader> +            <mc160:OnBehalfOfHeader> ... </mc160:OnBehalfOfHeader> 
-                ... +            <mc160:WhitelistingHeader> ... </mc160:WhitelistingHeader> 
-            </mc160:OnBehalfOfHeader> +            <mc160:ConsentHeader> ... </mc160:ConsentHeader>
-            <mc160:WhitelistingHeader> +
-                ... +
-            </mc160:WhitelistingHeader> +
-            <mc160:ConsentHeader> +
-                ... +
-            </mc160:ConsentHeader>+
             <mc160:MinLogSessionId>...</mc160:MinLogSessionId>             <mc160:MinLogSessionId>...</mc160:MinLogSessionId>
             <mc160:PreflightOnly/>             <mc160:PreflightOnly/>
Line 377: Line 400:
     <!-- Body-element -->     <!-- Body-element -->
     <soap:Body>     <soap:Body>
 +        <!-- Request-body -->
 +        <mc160:GetHandoversRequest>
 +    
         <!-- NYT: Tidligere under soapheader -->         <!-- NYT: Tidligere under soapheader -->
-        <mc160:FMKRequestHeader> +            <mc160:FMKRequestHeader> 
-            <mc160:Paging> +                <mc160:Paging> 
-                <mc160:PagingObject>Handovers</mc160:PagingObject> +                    <mc160:PagingObject>Handovers</mc160:PagingObject> 
-                <mc160:PageSize>50</mc160:PageSize> +                    <mc160:PageSize>50</mc160:PageSize> 
-                <mc160:LastReceived> +                    <mc160:LastReceived> 
-                    <mc160:Field name="HandoverId">123456</mc160:Field> +                        <mc160:Field name="HandoverId">123456</mc160:Field> 
-                </mc160:LastReceived> +                    </mc160:LastReceived> 
-            </mc160:Paging> +                </mc160:Paging> 
-            <mc160:ExtendedValidationHeader> +                <mc160:ExtendedValidationHeader> 
-                <mc160:ApplyAllOptionalValidations/> +                    <mc160:ApplyAllOptionalValidations/> 
-                <mc160:SkipValidations> +                    <mc160:SkipValidations> 
-                    <mc160:ExtendedValidation> +                        <mc160:ExtendedValidation> 
-                        <mc160:ErrorCode>4022</mc160:ErrorCode> +                            <mc160:ErrorCode>4022</mc160:ErrorCode> 
-                        <mc160:ElementPath>/GetHandoversRequest/PersonIdentifier</mc160:ElementPath> +                            <mc160:ElementPath>/GetHandoversRequest/PersonIdentifier</mc160:ElementPath> 
-                    </mc160:ExtendedValidation> +                        </mc160:ExtendedValidation> 
-                </mc160:SkipValidations> +                    </mc160:SkipValidations> 
-            </mc160:ExtendedValidationHeader> +                </mc160:ExtendedValidationHeader> 
-        </mc160:FMKRequestHeader>+            </mc160:FMKRequestHeader>
             <!-- Slut på nyt -->             <!-- Slut på nyt -->
  
-        <!-- Request-body --> 
-        <mc160:GetHandoversRequest> 
             <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>             <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>
             <mc160:FromDateTime>2026-01-01T00:00:00Z</mc160:FromDateTime>             <mc160:FromDateTime>2026-01-01T00:00:00Z</mc160:FromDateTime>
Line 426: Line 450:
             <mc160:FMKConfigurationUpdatedWarning>...</mc160:FMKConfigurationUpdatedWarning>             <mc160:FMKConfigurationUpdatedWarning>...</mc160:FMKConfigurationUpdatedWarning>
     </soap:Header>     </soap:Header>
 +    
     <!-- Body-element -->     <!-- Body-element -->
     <soap:Body>     <soap:Body>
-        <!-- NYT! Tidligere under soapheader --> 
-        <mc160:FMKResponseHeader> 
-            <mc160:MedicinecardInvalid> 
-                <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier> 
-            </mc160:MedicinecardInvalid> 
-            <mc160:VersionMismatchWarning/> 
-            <mc160:HiddenData> 
-                <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier> 
-                <mc160:HasNegativeConsent/> 
-            </mc160:HiddenData> 
-            <mc160:Paging> 
-                <mc160:PagingObject>Handovers</mc160:PagingObject> 
-                <mc160:ParentObjectIdentifier type="Handovers">123456</mc160:ParentObjectIdentifier> 
-                <mc160:PageSize>50</mc160:PageSize> 
-                <mc160:TotalSize>187</mc160:TotalSize> 
-                <mc160:LastReceived> 
-                    <mc160:Field name="HandoverId">123506</mc160:Field> 
-                </mc160:LastReceived> 
-            </mc160:Paging> 
-            <mc160:Warnings> 
-                <mc160:Warning> 
-                    <mc160:FaultCode>1234</mc160:FaultCode> 
-                    <mc160:FaultText>Some handovers were excluded due to a soft validation rule</mc160:FaultText> 
-                    <mc160:FaultDetails> 
-                        <mc160:KeyValueSet> 
-                            <mc160:Key>WarrantIdentifier</mc160:Key> 
-                            <mc160:Value>456789</mc160:Value> 
-                        </mc160:KeyValueSet> 
-                    </mc160:FaultDetails> 
-                </mc160:Warning> 
-            </mc160:Warnings> 
-            <mc160:Informations> 
-                <mc160:Information> 
-                    <mc160:Text>Additional handovers may exist on a related medicine card version</mc160:Text> 
-                </mc160:Information> 
-            </mc160:Informations> 
-        <mc160:FMKResponseHeader> 
-        <!-- Slut på nyt --> 
- 
         <!-- Response-body -->         <!-- Response-body -->
         <mc160:GetHandoversResponse>         <mc160:GetHandoversResponse>
 +            <!-- NYT! Tidligere under soapheader -->
 +            <mc160:FMKResponseHeader>
 +                <mc160:MedicinecardInvalid>
 +                    <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>
 +                </mc160:MedicinecardInvalid>
 +                <mc160:VersionMismatchWarning/>
 +                <mc160:HiddenData>
 +                    <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>
 +                    <mc160:HasNegativeConsent/>
 +                </mc160:HiddenData>
 +                <mc160:Paging>
 +                    <mc160:PagingObject>Handovers</mc160:PagingObject>
 +                    <mc160:ParentObjectIdentifier type="Handovers">123456</mc160:ParentObjectIdentifier>
 +                    <mc160:PageSize>50</mc160:PageSize>
 +                    <mc160:TotalSize>187</mc160:TotalSize>
 +                    <mc160:LastReceived>
 +                        <mc160:Field name="HandoverId">123506</mc160:Field>
 +                    </mc160:LastReceived>
 +                </mc160:Paging>
 +                <mc160:Warnings>
 +                    <mc160:Warning>
 +                        <mc160:FaultCode>1234</mc160:FaultCode>
 +                        <mc160:FaultText>Some handovers were excluded due to a soft validation rule</mc160:FaultText>
 +                        <mc160:FaultDetails>
 +                            <mc160:KeyValueSet>
 +                                <mc160:Key>WarrantIdentifier</mc160:Key>
 +                                <mc160:Value>456789</mc160:Value>
 +                            </mc160:KeyValueSet>
 +                        </mc160:FaultDetails>
 +                    </mc160:Warning>
 +                </mc160:Warnings>
 +                <mc160:Informations>
 +                    <mc160:Information>
 +                        <mc160:Text>Additional handovers may exist on a related medicine card version</mc160:Text>
 +                    </mc160:Information>
 +                </mc160:Informations>
 +            <mc160:FMKResponseHeader>
 +            <!-- Slut på nyt -->
 +
             <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>             <mc160:PersonIdentifier source="CPR">0101901234</mc160:PersonIdentifier>
             <mc160:HandoversOnDrugMedication>             <mc160:HandoversOnDrugMedication>
fmk/1.6.0/xml-elementer/alternativ_request_response_header.1786709978.txt.gz · Last modified: by andm

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki