Differences

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

--- fmk:1.4.4:hent_medicinkortversion [2015-09-04 08:13] – [Bagudkompatibilitet] shp
+++ fmk:1.4.4:hent_medicinkortversion [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Hent medicinkortversion ======
-HentMedicinkortVersion-servicen anvendes af systemerne til at finde ud af om de allerede har et opdateret medicinkort lokalt i deres system. Servicen returnerer informationer om ændringer i den del af medicinkortet, der er versioneret, samt information om ændringer i recepterne. Der er en del ændringer i medicinkortet der ikke kan ses i et kald til HentMedicinkortVersion-servicen.
+Ved opdatering af data på et medicinkort skal der sikres, at dette sker på seneste version af medicinkortet. Hent medicinkortversion-servicen gør det muligt at kontrollere, om der findes en nyere version, end den der findes lokalt i LPS eller EPJ-systemet. I forhold til tidligere versioner af denne service er svaret udvidet. Følgende informationer returneres:
-Specielt har det været relevant for mange FMK anvender-systemer at få information om hvornår der sidst er lavet en effektuering på en lægemiddelordination, og da effektueringer i dag ikke er en del af FMK versioneringen, vil nye effektueringer ikke ændre versionen af medicinkortet og dermed ikke kunne ses i HentMedicinkortVersion. Det samme gælder for ændringer i de læste recepter.
-Da medicinkortet med FMK 1.4 også begynder at indkapsle andre uafhængige snitflader, kan også være relevant at returnere informationer om ændringer af disse snitflader.
-I nuværende snitflader inkluderer svaret på HentMedicinkortVersion:
+  * Medicinkort version
-Medicinkort version
+  * Dato tidsstempel for seneste seneste ændring i recept-data, incl. eventuelle effektueringer på recepter.
-En dato for seneste recept-oprettelse og/eller fejlbesked for kald til recept-server.
+  * Dato tidsstempel for seneste lægemiddelordinations-effektuering
+  * Dato tidsstempel for seneste tilknytning af løs recept
+  * Dato tidsstempel for seneste ændring i data vedrørende patient-indlæggelse
+  * Dato tidsstempel for seneste ændring vedrørende tilknytning hjemmesygeplejen
+  * Dato tidsstempel for seneste ændring vedrørende patientens Dosisdispensering.
+  * Dato tidsstempel for seneste oprettelse af en recept.
+  * Dato tidsstempel for seneste ændring vedrørende patientens recept-anmodninger.
+  * Dato tidsstempel for seneste ændring af patient registreringer.
-Svaret udvides med følgende informationer, som giver mulighed for at returnere nuværende informationer samt fremtidige udvidelser uden at skulle lave skema nye skemaændringer:
-Dato tidsstempel for seneste lægemiddelordinations-effektuering
-Dato tidsstempel for seneste tilknytning af løs recept
-Angivelse af om patienten er indlagt
-Angivelse af om patienten er tilknyttet hjemmesygeplejen inklusiv
-Angivelse af om patienten INR værdier er ændret.
+==== Forespørgsel ====
-==== Eksempel ====
+I forespørgselen sendes kun patientens CPR-nummer.
-Servicen ændres til at returnere informationerne som Key-value par. Dette sikrer at listen af mulige nøgler i skemaet kan udvides uden at skemaet skal ændres vha et “Undefined”-element.
+<code xml>
-<code>
+<GetMedicineCardVersionRequest>
+	<PersonIdentifier>1111111118</PersonIdentifier>
+</GetMedicineCardVersionRequest>
+</code>
+==== Svar ====
+FMK svarer med patientens CPR-nummer og [[fmk:1.4.4:versionsnummer|medicinkortets versionsnummer]]. Desuden returneres dato-tidsstempler for ovennævnte list i MedicinCardInformationChange-element med type og dato-tidsstempel par.
+<code xml>
 <GetMedicineCardVersionResponse>
     <PersonIdentifier>1111111118</PersonIdentifier>
@@ Line 34: / Line 43: @@
     </MedicinCardInformationChange>
     <MedicinCardInformationChange>
-        <InformationChangeType>PrescriptionMedicationDateTime</InformationChangeType>
+        <InformationChangeType>PrescriptionAttachmentChange</InformationChangeType>
         <ChangeDateTime>2015-01-09T12:31:16.0Z</ChangeDateTime>
     </MedicinCardInformationChange>
     <MedicinCardInformationChange>
-        <InformationChangeType>Hospitalized</InformationChangeType>
+        <InformationChangeType>HospitalizationStatusChange</InformationChangeType>
         <ChangeDateTime>2015-02-15T05:20:18.0Z</ChangeDateTime>
     </MedicinCardInformationChange>
     <MedicinCardInformationChange>
-        <InformationChangeType>HomeCareSubscription</InformationChangeType>
+        <InformationChangeType>HomeCareSubscriptionChange</InformationChangeType>
         <ChangeDateTime>2013-02-03T08:20:10.0Z</ChangeDateTime>
     </MedicinCardInformationChange>
     <MedicinCardInformationChange>
-        <InformationChangeType>INRChanged</InformationChangeType>
+        <InformationChangeType>DoseDispensingChange</InformationChangeType>
+        <ChangeDateTime>2015-02-01T09:20:10.0Z</ChangeDateTime>
+    </MedicinCardInformationChange>
+        <MedicinCardInformationChange>
+        <InformationChangeType>PrescriptionMedicationCreationDateTime</InformationChangeType>
+        <ChangeDateTime>2015-01-01T07:20:10.0Z</ChangeDateTime>
+    </MedicinCardInformationChange>
+        <MedicinCardInformationChange>
+        <InformationChangeType>PrescriptionMedicationOrderChangeDateTime</InformationChangeType>
+        <ChangeDateTime>2015-02-12T14:20:10.0Z</ChangeDateTime>
+    </MedicinCardInformationChange>
+        <MedicinCardInformationChange>
+        <InformationChangeType>PatientRegistrationChange</InformationChangeType>
         <ChangeDateTime>2013-02-03T08:20:10.0Z</ChangeDateTime>
     </MedicinCardInformationChange>
 </GetMedicineCardVersionResponse>
 </code>
+==== Anvendelse af VOCES certifikat ====
-Det tilsvarende skema er beskrevet nedenfor:
+Der er mulighed for at kalde "Hent medicinkortversion" vha. System rollen og et VOCES certifikat. Indholdet af request'et skal ikke ændres i dette tilfælde men være som ovenfor.
-<code>
-	<complexType name="GetMedicineCardVersionResponseType">
-		<sequence>
-			<element name="PersonIdentifier" type="medicinecard20150101:PersonIdentifierType"/>
-			<element name="MedicineCardVersion" type="medicinecard20150101:MedicineCardVersionType"/>
-			<element name="MedicineCardInformationChange" type="medicinecard20150101:MedicineCardInformationChangeType"
-					minOccurs="0" maxOccurs="unbounded"/>
-		</sequence>
-	</complexType>
-<complexType name="MedicineCardInformationChangeType">
-		<sequence>
-			<element name="InformationChangeType" type="medicinecard20150101:InformationChangeTypeType"/>
-			<element name="ChangeDateTime" type="dateTime" minOccurs="0"/>
-		</sequence>
-	</complexType>
-	<simpleType name="InformationChangeTypeType">
-		<union memberTypes="medicinecard20150101:PredefinedInformationChangeType medicinecard20150101:UndefinedInformationChangeType"/>
-	</simpleType>
-	<simpleType name="UndefinedInformationChangeType">
-		<restriction base="string">
-			<minLength value="1"/>
-			<maxLength value="200"/>
-		</restriction>
-	</simpleType>
-	<simpleType name="PredefinedInformationChangeType">
-		<restriction base="medicinecard20150101:UndefinedInformationChangeType">
-			<enumeration value="PrescriptionMedicationDateTime"/>
-			<enumeration value="EffectuationDateTime"/>
-			<enumeration value="PrescriptionAttachmentChange"/>
-			<enumeration value="HospitalizationStatusChange"/>
-			<enumeration value="HomeCareSubscriptionChange"/>
-			<enumeration value="INRChange"/>
-		</restriction>
-	</simpleType>
-</code>
-==== Bagudkompatibilitet ====
-Ovennævnte problem eksistere i dag også i de gamle versioner. Da det ikke er muligt at lave om på de gamle snitflader, er det bedste der kan gøres, at tage så mange ændringer med i den ene dato der er, nemlig
-<code>
-<PrescriptionMedicationDateTime>
--08-09T12:31:16.0Z
-</PrescriptionMedicationDateTime>
-</code>
-Derfor tages udgangspunkt i hvad hver enkelt snitflade kan levere af oplysninger og det bliver den sidste ændrings tidsstempel der bliver afgørende for hvad tidspunkt der bliver returneret.
-I FMK 1.2.6 vil følgende tidspunkter være inkluderet i beregningen af seneste ændring:
-* Dato-tidsstempel for seneste ændring i recept-data
-* Dato-tidsstempel for seneste lægemiddelordinations-effektuering
-* Dato-tidsstempel for seneste tilknytning af løs recept
-I FMK 1.4.0 desuden:
-* Angivelse af om patienten er tilknyttet hjemmesygeplejen
-I FMK 1.4.2 desuden:
-* Angivelse af om patienten er indlagt