Differences

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

--- fmk:1.4.2:struktureret_dosering [2014-01-02 08:19] – tom
+++ fmk:1.4.2:struktureret_dosering [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 3: / Line 3: @@
 Den strukturerede dosering er generelt beskrevet i afsnittet [[fmk:generel:struktureret_dosering|Struktureret dosering]], og eksempler findes i afsnittet [[fmk:generel:dosering:eksempler_pa_strukturerede_doseringer|Eksempler på strukturerede doseringer]].
-I dette afsnit gennemgås XML formatet for strukturerede doseringer i FMK 1.4.2.
+I dette afsnit gennemgås XML formatet for strukturerede doseringer i FMK 1.4.2 (og FMK 1.4.4, da strukturen er ens bortset fra en ændring af namespace).
-<code xml file="DosageForRequest-Structured-Simple.xml">
+I FMK 1.4.2 findes der to varianter af XML-skemaet for strukturerede doseringer, en variant til anvendelse som request til FMK og en variant til response. Forskellen består i at responset indeholder en eller flere doseringsoversættelser og en type af dosering. I det følgende gennemgås request-dokumentet i DosageForRequest-skemaet.
-<?xml version="1.0" encoding="UTF-8"?>
+Idet doseringen er struktureret anvendes Structures-elementet.
-<DosageForRequest
-	xmlns="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01"
-	xsi:schemaLocation="http://www.dkma.dk/medicinecard/xml.schema/2013/06/01
+==== Doseringsenhed ====
-		../../../../etc/schemas/2013/06/01/DosageForRequest.xsd"
-	xmlns:m12="http://www.dkma.dk/medicinecard/xml.schema/2012/06/01"
+I Structures-elementet findes enheden for dosering i enten UnitText eller UnitText**s**-elementet. Findes der kun en doseringsenhed (dvs. samme anvendes i ental og flertal) kan UnitText-elementet anvendes, ellers anvendes UnitTexts-elementet med angivelse af enhed for ental og flertal.
-	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-	<Structures>
+Se evt. [[fmk:generel:doseringsenhed|Doseringsenhed]].
-		<UnitTexts source="Doseringsforslag">
-			<m12:Singular>kapsel</m12:Singular>
-			<m12:Plural>kapsler</m12:Plural>
+==== Struktur for doseringsperiode ====
-		</UnitTexts>
-		<Structure>
+Fra og med FMK 1.4.2 kan doseringen indeholde flere perioder. Hver periode angives i et Structure-element. Der gælder den regel, at såfremt der er flere doseringsperioder må der ikke være "huller" mellem doseringsperioderne, med mindre dette er angivet med et EmptyStructure-element. Som beskrevet i [[fmk:generel:dosering:doseringer_med_flere_perioder|Doseringer med flere perioder]] kan der være op til 2 parallelle perioder, såfremt den ene periode består af en fast medicinering og den anden af en PN medicinering. EmptyStructure-elementet kan anvendes i den faste, såvel som i PN delen.
-			<IterationInterval>1</IterationInterval>
-			<StartDate>2014-01-01</StartDate>
+Endvidere gælder det, at der maksimalt må angives 10 doseringsperioder.
-			<DosageEndingUndetermined/>
-			<SupplementaryText>ved måltid</SupplementaryText>
+**Bemærk** Såfremt det er muligt vil kun aktive perioder returneres. Det betyder at hvis man henter det aktuelle medicinkort eller en aktuel lægemiddelordination, vil perioder der er afsluttet ikke blive returneret. Hvis der hentes en speciel version af medicinkortet eller af en lægemiddelordination, vil kun de perioder, der var aktuelle på det tidspunk versionen blev skabt, blive returneret.
-			<Day>
-				<m12:Number>1</m12:Number>
+Såfremt der ikke er nogen aktive perioder på ordinationen, vil de(n) senest aktive period(er) bliver returneret. Der tales her om den doseringsperiode som har den seneste slutdato, såfremt der er overlappende doseringsperioder (Fast og PN), og disse har samme slutdato, vil begge doseringsperioder blive returneret.
-				<m12:Dose>
+==== Iterationsinterval ====
-					<m12:Time>morning</m12:Time>
-					<m12:Quantity>40</m12:Quantity>
+En doseringsperiodes iterationsinterval angiver efter hvor mange dage den angivne dosering gentages. Eksempelvis er iterationsintervallet for en daglig dosering 1 og for en ugentlig gentaget dosering 7, hvor der så efterfølgende defineres doser for dagene i perioden. Der er ingen begrænsninger for værdier for iterationsintervaller, værdien bør dog vælges så lille som mulig.
-				</m12:Dose>
-				<m12:Dose>
+Iterationsintervallet angives i IterationInterval-elementet.
-					<m12:Time>evening</m12:Time>
-					<m12:Quantity>40</m12:Quantity>
+Er doseringen i en form hvor den ikke skal gentages (f.eks. idet det er en engangsdosis, en op- eller nedtrapning eller en PN-dosering uden en maksimal døgndosis) anvendes i stedet det tomme NotIterated-element.
-				</m12:Dose>
-			</Day>
+Se evt. [[fmk:generel:dosering:iterationsinterval|Iterationsinterval]].
-		</Structure>
-	</Structures>
-</DosageForRequest>
+==== Start og slut ====
+For en doseringsperiode i Structure-elementet (eller evt. som en tom doseringsperiode i EmptyStructure-elementet) skal der angives hvornår perioden starter og optionelt hvornår den slutter.
+Der skal angives en startdato for perioden. Der kan dog angives en startdato med tidspunkt også (dog kun muligt til og med version 1.4.2), såfremt dette er væsentligt for doseringen, tidspunktet bør dog ikke anvendes hvis dette ikke er tilfældet.
+Der kan angives en slutdato for perioden. Igen kan der angives et tidspunkt også, med samme forbehold som før. For den sidste doseringsperiode (eller såfremt der kun er en enkelt) kan slutdato udelades og i stedet anvendes det tomme DosageEndingUndetermined-element.
+Se evt. [[fmk:generel:dosering:doseringer_med_flere_perioder|Doseringer med flere perioder]].
+==== Supplerende tekst ====
+Der kan angives en supplerende tekst, som f.eks. en betingelse eller en vejledning.
+Se [[fmk:generel:dosering:anvendelse_af_den_supplerende_tekst|Anvendelse af den supplerende tekst]].
+Den supplerende tekst indgår i doseringsoversættelsen, se [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse]]. Den er derfor ikke en "tilføjelse" til doseringen.
+==== Dag ====
+For hver dag inden for iterationsintervallet kan der defineres et antal doser i Day-elementet. Dagens nummer regnet fra doseringens start angives i Number-elementet, hvor startdato er dag 1 osv. For en itereret doseringsperiode må dagens nummer ikke overskride iterationsintervallet.
+Bemærk at også for en ugentligt gentaget dosering gælder det at dag 1 er dagen for startdato. Dvs. er startdato en torsdag vil dag 1 også være en torsdag, og ikke en mandag!
+Er doseringen i form af en ren PN-dosering uden en maksimal døgndosis kan AnyDay-elementet anvendes i stedet. Altså i tilfælde af f.eks. en dosering "1 tablet ved smerter" i stedet for "1 tablet ved smerter højst 1 gang daglig".
+==== Dosis ====
+For hver dag kan der angives et antal doser i Dose-elementet.
+En dosis kan have et tidpunkt angivet i Time-elementet. Enten en af de faste tekster "morning", "noon", "evening", "night" eller et klokkeslæt uden tidszone.
+Herefter angives en mængde (med enheden angivet i UnitText(s)). Eventuelt kan der angives en min og max dosis i stedet.
+Endeligt kan der med IsAccordingToNeed-elementet angives at dosis er PN.
+=== Eksempel "1 kapsel morgen og aften ved måltid" ===
+<code xml DosageForRequest-Structured-Simple.xml>
+<Dosage>
+    <Structures>
+        <UnitTexts source="Local">
+            <Singular>kapsel</Singular>
+            <Plural>kapsler</Plural>
+        </UnitTexts>
+        <Structure>
+            <IterationInterval>1</IterationInterval>
+            <StartDate>2014-01-01</StartDate>
+            <DosageEndingUndetermined/>
+            <SupplementaryText>ved måltid</SupplementaryText>
+            <Day>
+                <Number>1</Number>
+                <Dose>
+                    <Time>morning</Time>
+                    <Quantity>1</Quantity>
+                </Dose>
+                <Dose>
+                    <Time>evening</Time>
+                    <Quantity>1</Quantity>
+                </Dose>
+            </Day>
+        </Structure>
+    </Structures>
+</Dosage>
 </code>