Differences

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

--- fmk:1.6.0:struktureret_dosering [2026-02-03 19:28] – [Dosering (Dosage)] chsk
+++ fmk:1.6.0:struktureret_dosering [2026-04-15 21:25] (current) – [Elementer i en struktureret dosering] chsk
@@ Line 7: / Line 7: @@
 og der stilles krav til at systemer understøtter et minimum af funktionalitet for strukturerede doseringer, fx doser fordelt på morgen, middag aften og nat.
 Strukturerede doseringer kan anvendes til simple doseringer, (fx en engangsdosis), medicinering efter behov (fx ”1 stk. ved smerter”),
 gentagne doseringer (fx "1 stk. 3 gange daglig" eller "2 stk. hver tirsdag") eller til at opbygge et doseringsskema, evt. til op- eller nedtrapning.
@@ Line 38: / Line 38: @@
     <Fixed>...</Fixed>
     <PRN>...</PRN>
+    <EndDate>...</EndDate>
+  </DosagePeriod>
+  <DosagePeriod>
+    <PeriodLength>...</PeriodLength>
+    <Empty/>
+    <EndDate>...</EndDate>
   </DosagePeriod>
   <DosagePeriod>...</DosagePeriod>
   <DosageTranslationCombined>...</DosageTranslationCombined>
 </DosageForResponse>
@@ Line 88: / Line 93: @@
 Generelt
-  * ''<FreeText>'': Bruges til at angive startkriteriet for PN doseringsstrukturer (ikke PN-kur). Uanset startkriteriet anses doseringen tidligst gyldig fra dato i ''<ValidFrom>''. Dette felt kan ikke stå alene, startkriterie/trigger skal angives for doseringen.
+  * ''<PRNTrigger>'': Bruges til at angive startkriteriet for PN doseringsstrukturer (ikke PN-kur). Uanset startkriteriet anses doseringen tidligst gyldig fra dato i ''<ValidFrom>''.
 Herunder kan ses et eksempel på ''<Precondition>'' som den kan sendes til FMK. Eksemplet er ikke skema validt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.
@@ Line 96: / Line 101: @@
   <ValidFrom></ValidFrom>
   <UpdateValidFromUponHandover/>
-  <FreeText></FreeText>
+  <PRNTrigger></PRNTrigger>
   <EpisodicTreatment>
     <Trigger>...</Trigger>
@@ Line 114: / Line 119: @@
 === Selvadministreret (IsSelfAdministration) ===
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#isselfadministrationtype | Selv administreret]] anvendes i både anmodning og svar.
+Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#isselfadministrationtype | selvadministration]] anvendes i både anmodning og svar.
 Doseringen kan markeres med et ''IsSelfAdministration''-flag, hvis patienten selv administrerer medicinen. Anvendes typisk ved selvadministreret VKA behandlinger. I tidligere snitflader var selvadministrerede VKA dosering angive med en fritekst-dosering hvor starten af teksten var "Selvstyrende".
@@ Line 131: / Line 136: @@
   * ''<PeriodLength>'' angiver længden af doseringsperioden i hele dage.
   * ''<PeriodLengthFreeText>'' som alternativ til ''<PeriodLength>'' kan der angives  angiver længden af doseringsperioden i hele dage.
+  * ''<Empty>'' angiver at der for denne doseringsperiode ikke er dosis der skal indtages. Det kan fx bruges til at angive en pause i doseringen.
+  * ''<Unspecified>'' angiver at der for denne doseringsperiode endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.
   * ''<Fixed>'' angiver en fast doseringsstruktur som er gældende for denne doseringsperiode.
   * ''<PRN>'' angiver en PN doseringsstruktur som er gældende for denne doseringsperiode.
+  * ''<EndDate>'' FMK vil beregne slutdatoen for doseringsperioden hvis det er muligt. I tilfælde hvor der ikke er angivet startdato på første doseringsperiode eller slutdato på sidste doseringsperiode vil det ikke være muligt.
 Herunder kan ses et eksempel på en doseringsperiode som den bliver returneret fra FMK. Eksemplet er ikke skema validt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.
@@ Line 141: / Line 149: @@
   <PeriodLength>...</PeriodLength>
   <PeriodLengthFreeText>...</PeriodLengthFreeText>
+  <EndDate>...</EndDate>
 </DosagePeriodForResponse>
 </code>
@@ Line 167: / Line 176: @@
 Som beskrevet ovenfor i ''Doseringsperiode'' kan hver periode bestå af én fast og én PN. Det angives altså på perioden hvilken type dosering der er tale om.
-For hver doseringsstruktur kan der angives følgende:
+For hver doseringsstruktur kan følgende elementer indgå:
-  * ''<Restriction>'' Restriktioner specifikt til den aktuelle doseringsstruktur.
+  * ''<Restriction>'' angiver restriktioner specifikt til den aktuelle doseringsstruktur.
-  * ''<Instruction>'' Fritekstbeskrivelse af hvordan lægemiddelet skal anvendes (fx i højre øje). Der må ikke angives instruktioner der er påvirker behandlingen (fx ved smerter dobbelt dosis)
+  * ''<Instruction>'' angiver en fritekst instruktion for hvordan lægemidlet skal anvendes, fx "1 tablet ved smerter". Instruktionen må ikke i sig selv påvirke doseringens omfang, fx ved smerter dobbelt dosis.
-  * ''<IterationInterval>'' Bruges ved behandling hvor dosis i en enkelt struktureret behandling gentages indtil doseringsperioden eller lægemiddelordinationen udløber. Ved behandling hver 2. dag skal fx angives iterationsinterval 2 og 1 dagsdosis på daynumber 1.
+  * ''<IterationInterval>'' bruges ved behandling, hvor dosis i en enkelt struktureret behandling gentages indtil doseringsperioden eller lægemiddelordinationen udløber. Fx: ved behandling hver 2. dag skal der angives iterationsinterval 2 og 1 dagsdosis på daynumber 1.
-  * ''<Day>'', ''<Empty>'' eller ''<Unspecified>'' En af disse, evt flere ''<Day>'' elementer kan angives. ''<Day>'' elementer angiver doseringer for specifikke dage i perioden. Typen beskrives yderligere i det efterfølgende. ''<Empty>'' og ''<Unspecified>'' er begge tomme doseringer. ''<Empty>'' betyder at der ingen behandling er i perioden og at det ikke forventes at der efterfølgende defineres en behandling. ''<Unspecified>'' betyder, at der er planlagt behandling, men at den specifikke behandling skal revurderes af en læge, inden perioden starter.
+  * ''<Day>'' angiver doseringer for specifikke dage i perioden, identificeret ved et dagnummer (indeks).
+  * ''<UnspecifiedDay>'' angiver en dosering der ikke er knyttet til en specifik dag.
+  * ''<Week>'' angiver ugedagsbaserede doseringer, grupperet pr. uge. Hver uge indeholder op til 7 ugedage med tilhørende doser. Se afsnittet //Ugedagsbaseret dosering// nedenfor.
+Bemærk at ''<Day>'', ''<UnspecifiedDay>'' og ''<Week>'' er et valg (choice) — kun én af de tre kan anvendes pr. doseringsstruktur.
 Udover ovenstående, vil der i svar fra FMK også indgå følgende:
   * ''<Profile>'' indeholder profilkoden for den strukturerede dosering. Beskrives yderligere i det efterfølgende.
-  * ''<EndDate>'' FMK vil beregne slutdatoen for den strukturerede dosering hvis det er muligt. I tilfælde hvor der ikke er angivet startdato på første doseringsperiode eller slutdato på sidste doseringsperiode vil det ikke være muligt.
   * ''<DosageTranslation>'' Vil indeholde en tekstuel beskrivelse af den strukturerede dosering
-Herunder kan ses et eksempel på en doseringsstruktur som det bliver returneret fra FMK. Eksemplet er ikke skema validt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.
+Herunder kan ses eksempler på doseringsstrukturer som de bliver returneret fra FMK. Eksemplerne er ikke skema-valide eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten er at vise strukturen.
+Eksempel med dagsnummerbaseret dosering (''<Day>''):
 <code xml>
 <DosageStructureForResponse>
@@ Line 187: / Line 201: @@
   <Restriction>...</Restriction>
   <Instruction>...</Instruction>
-  <Empty/>
-  <Unspecified/>
   <Day>...</Day>
   <Day>...</Day>
   <Day>...</Day>
   <Profile>...</Profile>
-  <EndDate>...</EndDate>
   <DosageTranslation>...</DosageTranslation>
 </DosageStructureForResponse>
 </code>
+Eksempel med ugedagsbaseret dosering (''<Week>''):
+<code xml>
+<DosageStructureForResponse>
+  <IterationInterval>7</IterationInterval>
+  <Restriction>...</Restriction>
+  <Instruction>...</Instruction>
+  <Week>
+    <Weekday>
+      <Label>Monday</Label>
+      <Dose>...</Dose>
+    </Weekday>
+    <Weekday>
+      <Label>Thursday</Label>
+      <Dose>...</Dose>
+    </Weekday>
+  </Week>
+  <Profile>...</Profile>
+  <DosageTranslation>...</DosageTranslation>
+</DosageStructureForResponse>
+</code>
 ===Doseringsrestriktioner (Restriction)===
@@ Line 216: / Line 244: @@
 Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageInstructionType | doseringsinstruktion]]
-En doseringsinstruktion angives ved ''<Instruction>'' elementet, der har et under element ''<FreeText>'' hvor en fritekst instruktion til doseringen kan angives.
+En doseringsinstruktion angives ved ''<Instruction>'' elementet, der har et underelement ''<FreeText>'', hvor en fritekst instruktion til doseringen kan angives.
 Doseringsinstruktionen må ikke i sig selv påvirke doseringens omfang.
@@ Line 234: / Line 262: @@
 Skemadefinitioner for
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DayType | Day]],
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DayType | Day]]
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#EmptyPeriodType | Empty]],
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#UnspecifiedPeriodType | Unspecified]]
 og
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DoseType | Dose]].
@@ Line 242: / Line 268: @@
 En struktureret dosering kan indeholde et eller flere ''<Day>'' elementer, som definerer doseringerne pr. dag.
 Disse kan enten være relative til periodens startdato eller knyttet til specifikke ugedage. Fortolkningen angives af profilkoden.
-Hvis der ikke er specificeret en dosering i en given periode, skal ''<Day>'' elementet udelades og enten ''<Empty>'' eller ''<Unspecified>'' anvendes i stedet. ''<Empty>'' skal bruges hvis der i perioden ikke er og at der ikke forventes at komme medicinering.
-''<Unspecified>'' skal bruges til at angive at der på 'nuværende tidspunkt' ikke er en kendt dosering, men det forventes at lægen angiver en dosering.
 ''<Day>'' elementer kan indeholde enten ''<WeekdayLabel>'' eller ''<Index>'' og ét eller flere ''<Dose>'' elementer
@@ Line 369: / Line 392: @@
 | | ''ValidFrom'' (0-1)||||| Doseringsstartdato. |
 | | ''UpdateValidFromUponHandover'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. FMK vil opdatere ''ValidFrom'' ved events |
-| | ''FreeText'' (0-1)||||| Fritekst beskrivelse af betingelse for PN doseringsstrukturer. |
+| | ''PRNTrigger'' (0-1)||||| Fritekst trigger for PN doseringsstrukturer. |
 | | ''EpisodicTreatment''||||| Angivelse om at doseringen tilhører en PN-kur |
 | | | ''Trigger'' |||| Betingelse der skal være opfyldt, før PN-kuren må startes. |
@@ Line 393: / Line 416: @@
 | | ''PeriodLength'' (0-1) ||||| Længden på doseringsperioden i hele dage. |
 | | ''PeriodLengthFreeText'' (0-1) ||||| Alternativ til PeriodLength. Angiver tekstuelt hvad er afgør, at en periode afsluttes, typisk et subjektivt kriterie som, fx ''når du ikke længere har ondt''. |
+| | ''EndDate'' |||| | Beregnet slutdato for doseringsperioden. Kun en del af svaret fra FMK |
+| | | ''CalculatedEndDate'' (0-1) |||| Slutdatoen, hvis denne kan beregnes |
+| | | ''Unknown'' (0-1) |||| Flag der angiver, at det ikke er muligt at beregne slutdato. |
+| | ''Empty'' (0-1) ||||| Angiver at der i denne doseringsperiode ikke er dosis der skal indtages.|
+| | ''Unspecified'' (0-1) ||||| Angiver at der i denne doseringsperiode endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.|
 | | ''Fixed'' (0-1) ||||| Doseringsstruktur til angivelse af den faste doseringsstruktur i doseringsperioden. |
 | | ''PRN'' (0-1) ||||| Doseringsstruktur til angivelse af PN doseringsstrukturen i doseringsperioden. |
@@ Line 401: / Line 429: @@
 | | | | ''FreeText'' ||| Selve fritekst instruktionen, fx ''i højre øje''. |
 | | | ''IterationInterval'' (0-1) |||| Gentages efter antal dage, for ugentligt gentagede skal IterationInterval være deleligt med 7. |
-| | | ''Day'' (0-*) |||| De enkelte daglige doser, kan udelades ved tomme doseringsperioder.|
+| | | ''Week'' (0-*) |||| Ugedagsbaserede doser grupperet pr. uge. Rækkefølgen definerer ugenummer (første ''Week'' = uge 1). Valg med ''Day'' og ''UnspecifiedDay''. Maks 53 uger. |
-| | | | ''WeekdayLabel'' (0-1) ||| Specifik ugedag, fx tirsdag, hvor dose skal indtages. |
+| | | | ''Weekday'' (1-7) ||| En specifik ugedag med tilhørende doser. |
-| | | | ''Index'' (0-1) ||| Dagens indeks, hvor 1 er første dag i doseringsperioden. Det kan ikke antages, at 1 er mandag. |
+| | | | | ''Label'' || Ugedagen: ''Monday'', ''Tuesday'', ''Wednesday'', ''Thursday'', ''Friday'', ''Saturday'' eller ''Sunday''. |
+| | | | | ''Dose'' (1-*) || Dosis for den pågældende ugedag. Samme struktur som ''Dose'' under ''Day''. |
+| | | ''Day'' (0-*) |||| Dagsnummerbaserede doser. Kan udelades ved tomme doseringsperioder. Valg med ''Week'' og ''UnspecifiedDay'' - kun én type pr. doseringsstruktur. |
+| | | | ''Index'' ||| Dagens indeks, hvor 1 er første dag i doseringsperioden. Det kan ikke antages, at 1 er mandag. |
 | | | | ''Dose'' (1-*) ||| Dosis. |
 | | | | | ''TimeOfDay'' (0-1) || Tidspunkt for dosis, fx ''morning'' eller ''10:00''. |
@@ Line 421: / Line 452: @@
 | | | | | ''MaximumInfusionRate'' (0-1) || Indløbshastigheden der maksimalt må anvendes. |
 | | | | | ''AccordingToParameterSchema'' (0-1) || Angiver hvilket parameterskema der skal bruges til at finde mængden der skal anvendes. Elementet kan være tomt hvis der kun er et skema på doseringen. |
-| | | ''Empty'' (0-1) |||| Angiver at der for denne doseringsstruktur ikke er dosis der skal indtages.|
-| | | ''Unspecified'' (0-1) |||| Angiver at der for denne doseringsstruktur endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.|
 | | | ''Profile'' |||| Beskriver doseringsstrukturen. |
 | | | | ''ProfileCode'' ||| Kode med 4 dimensioner der beskriver doseringsstrukturen. |
@@ Line 430: / Line 459: @@
 | | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. |
 | | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen. |
-| | | ''EndDate'' |||| Beskrivelse af slutdato for doseringsstrukturen |
-| | | | ''CalculatedEndDate'' (0-1) ||| Information om beregnet slutdato for doseringsstrukturen. |
-| | | | ''Unknown'' (0-1) ||| Flag der angiver, at det ikke er muligt at beregne slutdato. |
 | | | ''DosageTranslation'' |||| Indeholder doseringsstrukturen omsat til textuel representation. |