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.

Hent-lægemiddelordination-forespørgselen udvides således at der kan angives enten et datointerval eller et interval af versionsnumre.

Responset i servicen er uændret, bortset fra at der tilføjes et MoreAvailable-flag.

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.

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>

En forespørgsel med et version-interval kan foretages med en fra- og en til-lægemiddelordinations-version. I forespørgselen angives om versionerne 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.

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>

I begge typer af forespørgsler er både fra- og til-værdier optionelle. Dvs. der kan forespørges på lukkede og halvåbne intervaller. Desuden kan begge værdier udelades, hvilket kan anvendes til at få returneret de N nyeste versioner af lægemiddelordinationen, hvor N angives i MaximumNumberOfResults. Dette er i tråd med den generelle regel at de kun de nyeste i intervallet vil blive returneret, såfremt der findes flere lægemiddelordination-versioner end angivet i MaximumNumberOfResults.

I eksemplet herunder forespørges på de 5 nyeste versioner af lægemiddelordinationen.

GetDrugMedicationRequest-EmptyVersionInterval.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>
		<MaximumNumberOfResults>5</MaximumNumberOfResults>
	</IdentifierAndVersionInterval>
	<IncludePrescriptionMedications>false</IncludePrescriptionMedications>
	<IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>