This is an old revision of the document!
Table of Contents
Opslag på intervaller af historiske lægemiddelordinationer
Bemærk at dette er et forslag til en udvidelse, der endnu ikke besluttet.
Servicen hent lægemiddelordination udvides med funktionalitet, således at det bliver muligt at hente et interval af lægemiddelordination-versioner i en enkelt forespørgsel.
Dette kan foretages ved at angive enten et datointerval eller et interval af versionsnumre.
Forespørgsel med datointerval
En forespørgsel med et datointerval kan foretages med en fra- og en til-dato. I forespørgselen angives om datoerne er inklusiv eller eksklusiv. Desuden skal der angives et maksimalt antal lægemiddelordination-versioner der ønskes returneret.
Findes der flere lægemiddelordination-versioner i intervallet end enten angivet eller FMKs generelle maksimum på (#TODO: værdi skal afklares), vil der blive returneret et MoreAvailable-element i responset, og kun de nyeste i intervallet vil blive returneret. Der kan herefter evt. foretaget et nyt kald, i et tilpasset interval.
Bemærk, at såfremt et system har en lokal version af en lægemiddelordination, og der ønskes alle versioner der siden er kommet til, vil den sikreste løsning være at slå op med lægemiddelordinationens version, og ikke med versionens dato som startdato i et datointerval. Årsagen hertil er, at der ved distribueret drift og udfald af kommunikation mellem driftscentre kan ske at ældre versioner først vil være distribuerede til alle driftscentre når kommunikationen er genoprettet.
Eksempel
Der ønskes returneret et antal lægemiddelordination-versioner for de seneste 3 måneder. Der angives derfor et FromDateTime tidspunkt 3 måneder tilbage, og ikke et ToDateTime. Desuden angives at der ønskes højst 20 lægemiddelordination-versioner returneret.
- GetDrugMedicationRequest-DateTimeInterval.xml
<?xml version="1.0" encoding="UTF-8"?> <GetDrugMedicationRequest xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/05/01 GetDrugMedicationRequest.xsd" xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/05/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <PersonIdentifier>1111111118</PersonIdentifier> <IdentifierAndDateTimeInterval> <Identifier>1221231331123</Identifier> <FromDateTimeInclusive>2014-03-27T14:52:14</FromDateTimeInclusive> <MaximumNumberOfResults>20</MaximumNumberOfResults> </IdentifierAndDateTimeInterval> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
Forespørgsel med versions-interval
En forespørgsel med et version-interval kan foretages med en fra- og en til-lægemiddelordinations-version. Desuden skal der angives et maksimalt antal lægemiddelordination-versioner der ønskes returneret.
Findes der flere lægemiddelordination-versioner i intervallet end enten angivet eller FMKs generelle maksimum på (#TODO: værdi skal afklares), vil der blive returneret et MoreAvailable-element i responset, og kun de nyeste i intervallet vil blive returneret. Der kan herefter evt. foretaget et nyt kald, i et tilpasset interval.
Eksempel
Et system har ved en tidligere behandling hentet en lægemiddelordination-version fra FMK, og et nyt opslag har returneret en nyere lægemiddelordination-version. Et check på PreviousVersion i lægemiddelordinationen har vist at der findes mellemlæggende lægemiddelordination-versioner. Disse hentes med et opslag som vist herunder, hvor der i From/ToVersionExclusive angives at kun de mellemliggende versioner skal returneres.
- GetDrugMedicationRequest-VersionInterval.xml
<?xml version="1.0" encoding="UTF-8"?> <GetDrugMedicationRequest xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2014/05/01 GetDrugMedicationRequest.xsd" xmlns="http://www.dkma.dk/medicinecard/xml.schema/2014/05/01" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <PersonIdentifier>1111111118</PersonIdentifier> <IdentifierAndVersionInterval> <Identifier>1221231331123</Identifier> <FromVersionExclusive>1341404077658001001</FromVersionExclusive> <ToVersionExclusive>1341404198929002001</ToVersionExclusive> </IdentifierAndVersionInterval> <IncludePrescriptionMedications>false</IncludePrescriptionMedications> <IncludeEffectuations>false</IncludeEffectuations> </GetDrugMedicationRequest>
