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:27] – [Eksempel på nyt komplet request (GetHandoversRequest)] 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 21: Line 21:
 <soap:Body> <soap:Body>
     <Request-body>     <Request-body>
 +        <!-- Flyttet fra header -->
         <FMKRequestHeader>         <FMKRequestHeader>
             <Paging> ... </Paging>             <Paging> ... </Paging>
Line 86: 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 227: Line 236:
 <code xml> <code xml>
     <soap:Header>     <soap:Header>
 +        <!-- Tidligere en del af "FMKResponseHeader", men er nu enkeltelementer -->
         <KnownPersonIdentifier> ... </KnownPersonIdentifier>         <KnownPersonIdentifier> ... </KnownPersonIdentifier>
         <FMKConfigurationUpdatedWarning>...</FMKConfigurationUpdatedWarning>         <FMKConfigurationUpdatedWarning>...</FMKConfigurationUpdatedWarning>
Line 233: Line 243:
     <soap:Body>     <soap:Body>
         <Response>         <Response>
 +            <!-- Flyttet fra header -->
             <FMKResponseHeader>             <FMKResponseHeader>
                 <MedicinecardInvalid> ...</MedicinecardInvalid>                 <MedicinecardInvalid> ...</MedicinecardInvalid>
Line 288: 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 294: 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 373: Line 400:
     <!-- Body-element -->     <!-- Body-element -->
     <soap:Body>     <soap:Body>
-     
         <!-- Request-body -->         <!-- Request-body -->
         <mc160:GetHandoversRequest>         <mc160:GetHandoversRequest>
Line 424: 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.1786710464.txt.gz · Last modified: by andm

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki