Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » fmk » 1.6.0 » struktureret_dosering
fmk:1.6.0:struktureret_dosering

Differences

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

Link to this comparison view

fmk:1.6.0:struktureret_dosering [2026-01-27 14:12] – [Dosering (Dosage)] chskfmk:1.6.0:struktureret_dosering [2026-03-06 08:53] (current) – external edit 127.0.0.1
Line 4: Line 4:
 ===== Indledning  ===== ===== Indledning  =====
  
-Doseringer i FMK skal så vidt muligt angives som strukturerede doseringer, +Doseringer i FMK skal så vidt muligt angives som //strukturerede doseringer//, 
-og der er krav om at systemer understøtter et vist minimum af funktionalitet til strukturerede doseringer, fx doser morgen, middag aften og nat.+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 både simple doseringer, fx en engangsdosis, medicinering efter behov (”1 stk ved smerter”), +Strukturerede doseringer kan anvendes til simple doseringer, (fx en engangsdosis), medicinering efter behov (fx ”1 stk. ved smerter”),  
-en gentaget dosering ("1 stk 3 gange daglig" , "2 stk. hver tirsdag") eller til at opbygge et doseringsskema , evt. til op- eller nedtrapning.+gentagne doseringer (fx "1 stk. 3 gange daglig" eller "2 stk. hver tirsdag") eller til at opbygge et doseringsskema, evt. til op- eller nedtrapning.
  
-I FMK 1.6 er der sket flere ændringer og udvidelser af den strukturerede dosering. En ikke-fuldstændig liste af ændringer er: +I FMK 1.6.0 er den strukturerede dosering udvidet og ændret på flere punkter. En ikke-udtømmende oversigt: 
-  * Fast og /eller PN doseringer grupperes hvor hver gruppe har en længde. Forskellige grupper kan ikke overlappe. +  * Fast og/eller PN doseringer grupperes i doseringsperioder, hvor hver gruppe har en længde. Grupper må ikke overlappe hinanden. 
-  * Perioder angives nu med længde, sådan at der ikke længere angives startdato på de enkelte perioder,  i stedet angives dette ved at perioderne har en længde, og at perioder følger umiddelbart efter hinanden. +  * Perioder angives nu med længde. Der angives derfor ikke længere startdato for den enkelte periode. I stedet følger perioderne direkte efter hinanden ud fra deres længder.
-  * Mulighed for at angive at en dosering tilhører en PN-kur med betingelser for at kuren må påbegyndes. +
-  * Bedre understøttelse af kontinuerlig dosering. +
-  * I doser kan der nu også angives indløbstid og -hastighed. +
-  * Mulighed for at angive minimumstid mellem doser.+
   * Doseringer beskrives ved profiler.   * Doseringer beskrives ved profiler.
 +  * Mulighed for at angive at en dosering tilhører en PN-kur, inkl. betingelser for hvornår kuren må påbegyndes.
 +  * Bedre understøttelse af kontinuerlige doseringer.
 +  * Doser kan nu indeholde oplysninger om indløbstid og indløbshastighed.
 +  * Mulighed for at angive minimumstid mellem doser.
  
 ===== Overordnet format for strukturerede doseringer ===== ===== Overordnet format for strukturerede doseringer =====
  
-På yderste niveau(af struktureret dosering) beskrives de fælles elementer der indgår i doseringen, fx enhedsbeskrivelse som ved tidligere snitflader, men også en række nye 160 snitflade elementer som "Precondition", "Parameter" og "DosagePeriod".+På det yderste niveau af struktureret dosering beskrives de fælles elementer der indgår i doseringen. Det omfatter fx enhedsbeskrivelser som fra tidligere snitflader, men i FMK 1.6.0 også følgende nye elementer:
  
-"Precondition" indeholder en række elementer der beskriver hvornår hele doseringen er gyldig. +  * ''Precondition'' indeholder de elementer, der beskriver forudsætningerne for, hvornår doseringen er gyldig. 
-"Parameter" kan bruges til at beskrive doseringsparametre som kan henvises til fra doseringer, typisk i forbindelse med at dosis afhænger af en målt værdi. +  * ''Parameter'' kan bruges til at beskrive doseringsparametre, som doseringerne kan henvise til, typisk når dosis afhænger af en målt værdi. 
-"DosagePeriod" er et nyt koncept fra og med 160 snitfladen. Doseringsperioder grupperer strukturerede faste og pn doseringer og definere længden af de indeholdte doseringer. Doseringsperioder for en dosering kan ikke overlappe.+  * ''DosagePeriod'' er et nyt koncept i 1.6.0-snitfladen. Doseringsperioder grupperer doseringsstrukture for faste og PN-doseringer, maksimum en af hver, og angiver varigheden af de doseringer, de indeholder. Perioder for samme dosering må ikke overlappe hinanden.
  
-Som en del af responset fra FMK 1.6.0 snitfladen vil der også blive returneret en profil(kode) for hver struktureret dosering. Profilen skal gøre det nemmere for klienter at håndtere svaret fra FMK, fx i forbindelse med visning. Ud fra profilkode er det nemt at kategorisere typen af dosering. +Eksempel på overordnet struktur af en struktureret dosering:
- +
-Eksempel på overordnet struktur+
  
 <code xml> <code xml>
-<DosageForRequest> +<DosageForResponse> 
-  <Precondition>Detaljer udeladt for simplicitet</Precondition> +  <Precondition>...</Precondition> 
-  <UnitTexts>Detaljer udeladt for simplicitet</UnitTexts> +  <UnitTexts>...</UnitTexts> 
-  <Parameter>Detaljer udeladt for simplicitet</Parameter>+  <Parameter>...</Parameter>
   <DosagePeriod>   <DosagePeriod>
-    <PeriodLength>n</PeriodLength> +    <PeriodLength>...</PeriodLength> 
-    <Fixed>Detaljer udeladt for simplicitet</Fixed> +    <Fixed>...</Fixed> 
-    <PRN>Detaljer udeladt for simplicitet</PRN>+    <PRN>...</PRN> 
 +    <EndDate>...</EndDate>
   </DosagePeriod>   </DosagePeriod>
-  <DosagePeriod>Detaljer udeladt for simplicitet</DosagePeriod> +  <DosagePeriod>...</DosagePeriod> 
-</DosageForRequest>+ 
 +  <DosageTranslationCombined>...</DosageTranslationCombined> 
 +</DosageForResponse>
 </code> </code>
  
Line 50: Line 51:
  
 Se også [[fmk:1.6.0:struktureret_dosering:Eksempler på strukturerede doseringer]]. Se også [[fmk:1.6.0:struktureret_dosering:Eksempler på strukturerede doseringer]].
- 
 ==== Dosering (Dosage) ==== ==== Dosering (Dosage) ====
  
Line 61: Line 61:
  
 Rodelementerne er ''<DosageForRequest>'' eller ''<DosageForResponse>'' afhængig af om xml'en er til forespørgsel eller svar. Rodelementerne er ''<DosageForRequest>'' eller ''<DosageForResponse>'' afhængig af om xml'en er til forespørgsel eller svar.
- 
-=== OUTDATED PN-kur OUTDATED === 
- 
-En dosering kan markeres som en PN-kur ved at inkludere elementet ''<PRNFixed>'' som det første i doseringen. 
- 
-Elementet indeholder to underelementer: 
-  * ''<Trigger>'' angiver den betingelse, der skal være opfyldt for at doseringen må påbegyndes, fx ''Ved smerter''. 
-  * (Optionel) ''<MinimumDurationBetweenDosagePeriod>'' angiver minimumstid før en ny periode må starte. Værdien angives i positivt helt antal dage. 
  
 === Precondition === === Precondition ===
Line 77: Line 69:
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforresponsetype | precondition response]] [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforresponsetype | precondition response]]
  
-En ''<Precondition>'' beskriver kriterier for at doseringen som helhed må påbegyndes.+En ''<Precondition>'' beskriver kriterier for at doseringen som helhed må påbegyndes. Det gælder for alm. fast dosering, PN dosering og for PN-kur dosering. PN-kur betegnes som 'Episodic Treatment' i snitfladen fx. ''<EpisodicTreatment>''. 
 +PN-kurer adskiller sig fra øvrige doseringer ved: 1. at startdatoen for faktisk behandling er ukendt og først begynder når startkriteriet er tilstede, 2. at PN-kurer evt. gentages hvis startkriteriet opstår/indfries igen.
  
 Alt efter typen af behandling kan forskellige felter benyttes. Ved alm. doseringer (ikke PN-kur) skal der enten angives en gyldig-fra dato, som fortæller, hvornår denne dosering er gældende fra Alt efter typen af behandling kan forskellige felter benyttes. Ved alm. doseringer (ikke PN-kur) skal der enten angives en gyldig-fra dato, som fortæller, hvornår denne dosering er gældende fra
Line 83: Line 76:
 vil det være muligt at beregne en slutdato for behandlingen. vil det være muligt at beregne en slutdato for behandlingen.
  
-Tidligere snitflader havde mulighed for at definere en startdato for enkelte strukturerede doseringer, det er ikke muligt længere. Strukturerede doseringer indgår nu som en del af doseringsperioder hvor startdatoen+Tidligere snitflader havde mulighed for at definere en startdato for enkelte doseringstrukturer, det er ikke muligt længere. Doseringsstrukturer indgår nu som en del af doseringsperioder hvor startdatoen
 for en doseringsperiode beregnes ud fra gyldighedsdatoen og summen af tidligere perioders varighed. for en doseringsperiode beregnes ud fra gyldighedsdatoen og summen af tidligere perioders varighed.
  
-''<ValidFrom>'': Bruges til at angive gyldig-fra på formatet yyyy-MM-dd for hele doseringen. Hvis doseringen er itereret eller af typen PN-kur, vil datoen være gældende for den første behandling+Felter til alm. fast og PN doseringer: 
 +  * ''<ValidFrom>'': Bruges til at angive gyldig-fra på formatet yyyy-MM-dd for hele doseringen. Hvis doseringen er itereret, vil datoen være gældende for den første behandling. 
 +  * ''<UpdateValidFromUponHandover>'': Flag der angiver at FMK skal holde gyldig-fra opdateret, indtil at det ud fra system events formodes at behandlingen er startet. I tilfælde af en itereret behandling hvor ''<UpdateValidFromUponHandover>'' er sat, vil gyldig-fra udelukkende blive opdateret indtil første iteration af behandlingen antages for påbegyndt.
  
-''<UpdateValidFromUponHandover>'': Flag der angiver at FMK skal holde gyldig-fra opdateret, indtil at det ud fra system events formodes at behandlingen er startet. I tilfælde af en itereret behandling hvor ''<UpdateValidFromUponHandover>'' er sat, vil gyldig-fra udelukkende blive opdateret indtil første iteration af behandlingen antages for påbegyndt.+Felter til PN-kur doseringer: 
 +  * ''<EpisodicTreatment>'': Hvis denne er sat, anses behandlingen for, at være af typen PN-kur. 
 +  * ''<EpisodicTreatment>''''<Trigger>'': Angiver betigelsen for at behandlingen kan startes, fx 'Ved smerter' 
 +  * ''<EpisodicTreatment>''''<MinimumDaysBetweenEpisodes>'': Angiver minimum antal dage der skal være mellem 2 behandlinger. FMK vil ikke validere på baggrund af denne værdi, men kan bruges til at videre give information mellem systemer
  
-''<EpisodicTreatment>'': TBD+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.
  
 +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.
  
-Udover gyldighedsdatoen kan tilføjes yderligere en af fælgende betingelser: +<code xml> 
- +<PreconditionRequest> 
- +  <ValidFrom></ValidFrom> 
-''<FreeText>'' Et fritekstfelt til angivelse af betingelse, der skal være opfyldt for at dosering begynder, fx ''Ved smerter''. Dette felt kan ikke stå alene, ''<ValidFrom>'' eller ''<UpdateValidFromUponHandover>'' skal angives. +  <UpdateValidFromUponHandover/> 
 +  <FreeText></FreeText> 
 +  <EpisodicTreatment> 
 +    <Trigger>...</Trigger> 
 +    <MinimumDaysBetweenEpisodes>...</MinimumDaysBetweenEpisodes> 
 +  </EpisodicTreatment> 
 +</PreconditionRequest> 
 +</code>
  
 ===Doseringsenheden (DosageUnit) === ===Doseringsenheden (DosageUnit) ===
Line 112: Line 118:
  
 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". 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".
- 
- 
-===Parameterskema (Parameter) === 
- 
-Der kan for en dosering  defineres en eller flere parameterskemaer. Se [[fmk:1.6.0:struktureret_dosering:parameterskema|dokumentation af parameterskema]] 
  
  
Line 124: Line 125:
 Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodForRequestType | Doseringsperiode for anmodning]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodForResponseType | Doseringsperiode for svar]] som begge bygge på [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodType | Doseringsperiode generelt ]]. Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodForRequestType | Doseringsperiode for anmodning]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodForResponseType | Doseringsperiode for svar]] som begge bygge på [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodType | Doseringsperiode generelt ]].
  
-Doseringsperioder består af en længde og op til 2 strukturerede doseringer én fast og/eller én PN dosering. Strukturerede doseringer på samme doseringsperiode vil altid have samme start og sluttidspunkt.+Doseringsperioder består af en længde og op til 2 doseringsstrukturer én fast og/eller én PN dosering. Doserignsstrukturer på samme doseringsperiode vil altid have samme start og sluttidspunkt.
 Hvis der er behov for at fx en PN behandling slutter senere end en fast behandling, skal der oprettes 2 doseringsperioder hvor den sidste kun indeholder PN doseringen og den ønskede længde. Hvis der er behov for at fx en PN behandling slutter senere end en fast behandling, skal der oprettes 2 doseringsperioder hvor den sidste kun indeholder PN doseringen og den ønskede længde.
  
Line 133: Line 134:
   * ''<Fixed>'' angiver en fast doseringsstruktur som er gældende for denne doseringsperiode.   * ''<Fixed>'' angiver en fast doseringsstruktur som er gældende for denne doseringsperiode.
   * ''<PRN>'' angiver en PN 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. 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 143:
   <PeriodLength>...</PeriodLength>   <PeriodLength>...</PeriodLength>
   <PeriodLengthFreeText>...</PeriodLengthFreeText>   <PeriodLengthFreeText>...</PeriodLengthFreeText>
 +  <EndDate>...</EndDate>
 </DosagePeriodForResponse> </DosagePeriodForResponse>
 </code> </code>
Line 155: Line 158:
   * ''<PeriodLength>'' angiver længden i antal dage   * ''<PeriodLength>'' angiver længden i antal dage
   * ''<PeriodLengthFreeText>'' angiver længden som fritekst   * ''<PeriodLengthFreeText>'' angiver længden som fritekst
- 
  
  
Line 178: Line 180:
  
   * ''<Profile>'' indeholder profilkoden for den strukturerede dosering. Beskrives yderligere i det efterfø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   * ''<DosageTranslation>'' Vil indeholde en tekstuel beskrivelse af den strukturerede dosering
  
Line 195: Line 196:
  
   <Profile>...</Profile>   <Profile>...</Profile>
-  <EndDate>...</EndDate> 
   <DosageTranslation>...</DosageTranslation>   <DosageTranslation>...</DosageTranslation>
 </DosageStructureForResponse> </DosageStructureForResponse>
Line 340: Line 340:
 I nedenstående skema kan de mulige værdier for hvert felt under ''<ProfileCode>'' findes (se skema-valide værdier i feltbeskrivelser). I nedenstående skema kan de mulige værdier for hvert felt under ''<ProfileCode>'' findes (se skema-valide værdier i feltbeskrivelser).
  
-^ Kode (del) ^ DosageType  ^ PeriodType                 ^ Schedule                            ^ Frequency                    ^ +^ DosageType  ^ PeriodType                 ^ Schedule                            ^ Frequency                    ^ 
-|            | Fast        | gentaget periode           | med en eller flere daglige doser    | morgen, middag, aften og nat | +| Fast        | gentaget periode           | med en eller flere daglige doser    | morgen, middag, aften og nat | 
-|            | PN          | ikke-gentaget periode      | med en eller flere doser på ugedage | på klokkeslæt                | +| PN          | ikke-gentaget periode      | med en eller flere doser på ugedage | på klokkeslæt                | 
-|            |             | periode uden medicinindtag | valgfri dag i perioden              | i løbet af dagen             | +|             | periode uden medicinindtag |                                     | i løbet af dagen             | 
-|            |             | uspecificeret periode      |                                     | uden døgnbegrænsning         |+|             | uspecificeret periode      |                                     | uden døgnbegrænsning         |
  
 Skemaet skal læses, sådan at en dosering er defineret ved at sammensætte en doseringstype, periodetype, skematype og en frekvenstype. Dog er ikke alle sammensætninger gyldige. Fx har en dosering "1 tablet morgen og aften" profilen "fast gentaget periode med en eller flere daglige doser morgen, middag, aften og nat". Skemaet skal læses, sådan at en dosering er defineret ved at sammensætte en doseringstype, periodetype, skematype og en frekvenstype. Dog er ikke alle sammensætninger gyldige. Fx har en dosering "1 tablet morgen og aften" profilen "fast gentaget periode med en eller flere daglige doser morgen, middag, aften og nat".
Line 353: Line 353:
  
  
 +===Parameterskema (Parameter) ===
  
-==== Doseringsperioder  ====+Der kan for en dosering  defineres en eller flere parameterskemaer. Se [[fmk:1.6.0:struktureret_dosering:parameterskema|dokumentation af parameterskema]]
  
-<del>Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodType | doseringsperiode i request]] og 
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodForResponseType | doseringsperiode i response]] 
  
-En behandling beskrives ved et eller flere ''<DosagePeriod>'' elementer, som altid angives i umiddelbar forlængelse af hinanden. 
  
-I modsætning til tidligere snitfladeversioner angives der ikke længere en startdato for hver periode. En periode starter altid umiddelbart i forlængelse af doseringens forudgående periode. 
  
  
-=== Doseringsprofil ===+==== Elementer i en struktureret dosering ====
  
- +Elementer hvor andet ikke fremgår, er kardinaliteten 1.
-I FMK 1.6.0 indføres også profiler på doseringer. Profilerne skal gøre det nemmere for klienter af FMK at præsentere doseringer returneret fra FMK. Profiler er beskrevet i et senere afsnit. Profiler bl.a. anvendes til at forklare udfaldsrummet for strukturerede doseringer i FMK 1.6: +
- +
-^ Kode (del) ^Doseringstype    ^ Periodetype ^ Skema-type ^ Frekvens-type ^ +
-| Fast    | gentaget periode         | med en eller flere daglige doser    | morgen, middag, aften og nat| +
-| PN      | ikke-gentaget periode    | med en eller flere doser på ugedage | på klokkeslæt               | +
-| Fast+PN | periode uden medicinindtag|                                     | i løbet af dagen           | +
-| PN-kur  | uspecificeret periode     |                                     | uden døgnbegrænsning       | +
- +
-Skemaet skal læses, sådan at en dosering er defineret ved at sammensætte en doseringstype, periodetype, skematype og en frekvenstype. Dog er ikke alle sammensætninger gyldige. Fx har en dosering "1 tablet morgen og aften" profilen "fast gentaget periode med en eller flere daglige doser morgen, middag, aften og nat". +
- +
-I responset fra FMK vil der være angivet en doseringsprofil, se [[fmk:1.6.0:struktureret_dosering:doseringsprofil|dokumentation af doseringsprofil]]. +
- +
-I kald til FMK angives doseringsprofilen ikke. +
- +
- +
-===Doseringsrestriktioner=== +
- +
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageRestrictionType | doseringsrestriktioner]] +
- +
-For visse doseringer kan der angives generelle restriktioner for indtagelse af præparatet, fx “2 tabletter dagligt, med mindst 12 timer imellem”. +
- +
-For MinimumDurationBetweenDoses angives der et positivt helt antal minutter. +
- +
-Elementet ''<Restriction>'' kan indeholde: +
-  * ''<MaximumDailyDose>'' maksimal daglig dosis +
-  * ''<MinimumDurationBetweenDoses>'' minimumstid mellem doser +
- +
- +
-=== Doseringsinstruktion === +
- +
-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. +
- +
-Doseringsinstruktionen må ikke i sig selv påvirke doseringens omfang.</del> +
- +
- +
-===Dosisperiodelængde=== +
- +
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodLengthType | dosisperiodelængde]] alternativt [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodLengthTextType | dosisperiodelængde-fritekst]] +
- +
-Længden af en periode bør angives i dage (''<PeriodLength>'') hvis muligt. +
-Hvis længden ikke kan angives numerisk, bruges ''<PeriodLengthFreeText>''. +
-Ved behandling uden slutdato kan den sidste periodelængde udelades. +
- +
-  * ''<PeriodLength>'' angiver længden i antal dage +
-  * ''<PeriodLengthFreeText>'' angiver længden som fritekst +
- +
- +
-===Iterationsinterval=== +
- +
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#IterationIntervalType | iterationsinterval]]. +
- +
-Til at mindske behovet for gentagelser i doseringsperioder kan man definere et ''<IterationInterval>''. Iterationsintervallet angiver fra hvilken dag i doseringen en evt. gentagelse skal begynde. +
- +
-For, fx en daglig dosering, skal doseringen defineres og ''<IterationInterval>'' skal være 1. Hvis det derimod kun er hver anden dag, så kan doseringen igen defineres med et enkelt ''<Day>'' element, ''<IterationInterval>'' sættes til 2. +
- +
-Ved kontinuerlig behandling, fx behandling med infusion, må ''<IterationInterval>'' ikke angives. Hvis den angivne dosering ikke skal gentages, på trods af en evt. længere doseringsperiode, så skal værdien sættes til 0. +
- +
- +
-===Doseringsangivelse=== +
- +
-Skemadefinitioner for +
-[[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]]. +
- +
-En doseringsperiode ''<DosagePeriod>'' 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 også af profilkoden. +
- +
-''<Day>'' elementer kan indeholde enten ''<WeekdayLabel>'' eller ''<Index>'' og ét eller flere ''<Dose>'' elementer +
- +
- +
-''<WeekdayLabel>'' angiver ugedagen via en enumeration ''Monday'', ''Tuesday'' osv. Anvendes elementet svarer dette til '''...med en eller flere doser på ugedage'' i [[fmk:1.6.0:struktureret_dosering:doseringsprofil|doseringsprofilen]]. +
- +
-''<Index>'' er et heltal, der angiver dag nummer i perioden, hvilket skal angives med fortløbende og unikke værdier. Anvendes elementet svarer dette til '''...med en eller flere daglige doser'' i [[fmk:1.6.0:struktureret_dosering:doseringsprofil|doseringsprofilen]]. +
- +
-Værdien må aldrig være større end værdien af ''<IterationInterval>'', hvis denne er angivet. +
- +
-''<Dose>'' kan forekomme en eller flere gange i et ''<Dose>'' element. Elementet indeholder 3 typer information: hvor ofte (frekvens), mængden der skal indtages og evt. hvor hurtigt det skal intages. +
-Hastighedsangivelsen bruges i forbindelse med infusionsbehandling. +
- +
-Hvis mængden ikke er fast, men afhænger af, fx en målt værdi, så kan dette angives ved ''<AccordingToParameterSchema>''. +
- +
-Frekvens kan angives med: +
-  * ''<TimeOfDay>'' der angiver et specifikt klokkeslæt for en dosis +
-  * ''<TimesPerDay>'' der angiver hvor mange gange om dage der skal doseres +
-  * ''<MinimumTimesPerDay>'' der angiver minimumsværdien for den daglige dosis +
-  * ''<MaximumTimesPerDay>'' der angiver et maximumsværdien for den daglige dosis +
- +
-Mængden angives med: +
-  * ''<Quantity>'' mængden der doseres +
-  * ''<MinimumQuantity>'' minimumsmængde +
-  * ''<MaximumQuantity>'' maximumsmængden +
- +
-Hastigheden angives med: +
-  * ''<Duration>'' angiver hvor længe en infusion af den angivne mængde skal tage. +
-  * ''<MinimumDuration>'' angiver hvor længe en infusion af den angivne mængde som minimum skal tage. +
-  * ''<MaximumDuration>'' angiver hvor længe en infusion af den angivne mængde som maximum må tage. +
-  * ''<InfusionRate>'' angiver indløbshastigheden i ml/t fx 25 ml/t +
-  * ''<MinimumInfusionRate>'' angiver den minimale indløbshastighed i ml/t +
-  * ''<MaximumInfusionRate>'' angiver den maximale indløbshastighed i ml/t +
- +
-Indløbshastighed (InfusionRate) og varighed (Duration) er to reciprokke måder at angive en indløbshastighed på. Begge elementer kan angives samtidigt, og der skal naturligvis være overensstemmelse mellem dem. Der er ingen grund til at begrænse systemerne til at vælge én af de to måder, da begge måder er lige gode, og der bør ikke kunne opstå uoverensstemmelse, da data så under alle omstændigheder alligevel vil være fejlagtige. +
- +
- +
-''<AccordingToParameterSchema>'' bruges, som alternativ til Quantity-elementerne mm, til at referere et [[fmk:1.6.0:struktureret_dosering:parameterskema|parameterskema]]. +
-Hvis der kun er defineret et enkelt parameterskema, er det tilstrækkeligt at angive et tomt </AccordingToParameterSchema> element. Hvis der er defineret flere, skal der refereres ParameterLabel for det skema, der skal anvendes, fx som "Dagsdoser" som værdi i AccordingToParameterSchema-elementet. +
- +
- +
-==== Elementer i strukturerede doseringer ==== +
- +
-Doseringen på struktureret form angives som defineret i XML-skemaet Structures (navngivet StructuredDosageForRequest.xsd), der indeholder nedenstående elementer. +
- +
- +
-Elementer med kursiv stammer fra doseringsoversættelsen, og findes kun ved opslag på medicinkort og lægemiddelordination, se afsnittet under tabellen. Hvor andet ikke fremgår, er kardinaliteten 1.+
  
 | **Element** |||||| **Beskrivelse** | | **Element** |||||| **Beskrivelse** |
-| ''Precondition'' (0-1)|||||| Betingelse der skal være opfyldt, før doseringen må startes. |+| ''IsSelfAdministration'' (0-1) |||||| Markerer at lægemidlet er til patientens selvadministration. | 
 +| ''Precondition'' |||||| Betingelse der skal være opfyldt, før doseringen må startes. |
 | | ''ValidFrom'' (0-1)||||| Doseringsstartdato. | | | ''ValidFrom'' (0-1)||||| Doseringsstartdato. |
-| | ''PredefinedCondition'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. Gyldig værdi er ''Medicine in possession''. | +| | ''UpdateValidFromUponHandover'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. FMK vil opdatere ''ValidFrom'' ved events | 
-| | ''FreeText'' (0-1)||||| Fritekst beskrivelse af betingelse. |+| | ''FreeText'' (0-1)||||| Fritekst beskrivelse af betingelse for PN doseringsstrukturer. |
 | | ''EpisodicTreatment''||||| Angivelse om at doseringen tilhører en PN-kur | | | ''EpisodicTreatment''||||| Angivelse om at doseringen tilhører en PN-kur |
 | | | ''Trigger'' |||| Betingelse der skal være opfyldt, før PN-kuren må startes. | | | | ''Trigger'' |||| Betingelse der skal være opfyldt, før PN-kuren må startes. |
Line 498: Line 378:
 | | ''Singular'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. | | | ''Singular'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. |
 | | ''Plural'' ||||| Enhed for dosering i flertal, fx kapsler, dråber m.v. | | | ''Plural'' ||||| Enhed for dosering i flertal, fx kapsler, dråber m.v. |
-| ''IsSelfAdministration'' (0-1) |||||| Markerer at lægemidlet er til patientens selvadministration. | +| ''Parameter'' (0-n) |||||| Anvendes ved parametriserede doseringer efter skema. | 
-| ''StructureFixed'' %%|%% ''StructurePRN'' (0-1) |||||| Rod-element for en struktureret dosering. Typen af element afgør om det er en henholdsvis Fast eller PN dosering. | +| | ''ParameterName'' ||||| Navn på måleparameteren (fx ''Blodglukoseværdi''). | 
-| | ''Parameter'' (0-n) ||||| Anvendes ved parametriserede doseringer efter skema. | +| | ''ParameterLabel'' (0-1) ||||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). | 
-| | | ''ParameterName'' |||| Navn på måleparameteren (fx ''Blodglukoseværdi''). | +| | ''ParameterUnit'' ||||| Måleparameterens enhed. | 
-| | | ''ParameterLabel'' (0-1) |||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). | +| | | ''ParameterUnitText'' |||| Måleparameterens enhed (fx ''mmol/l''). | 
-| | | ''ParameterUnit'' |||| Måleparameterens enhed. | +| | ''ParameterSchema'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. | 
-| | | | ''ParameterUnitText'' ||| Måleparameterens enhed (fx ''mmol/l''). | +| | | ''ParametricQuantity'' (1-n) |||| Beskriver en indgang i doseringsskemaet, kan være givet enten ved en enkelt værdi (da anvendes Quantity, alternativt ved et interval hvor MinValue/MaxValue anvendes. Sidste mulighed er AssessedValue som angiver en subjektiv vurdering. | 
-| | | ''ParameterSchema'' |||| Enhed for dosering i ental, fx kapsel, dråbe m.v. | +| | | | ''FromValue'' (0-1) ||| Fra-værdien for hvornår denne ''ParametricQuantity'' er gældende. | 
-| | | | ''ParametricQuantity'' ||| Beskriver en indgang i doseringsskemaet, kan være givet enten ved en enkelt værdi (da anvendes Quantity, alternativt ved et interval hvor MinValue/MaxValue anvendes. Sidste mulighed er AssessedValue som angiver en subjektiv vurdering. | +| | | | ''Criterion'' (0-1) ||| Fritekstkriterie beskrivelse for hvornår denne ''ParametricQuantity'' er gældende. | 
-| | | | ''Value'' ||| Værdi for hvilken ''Quantity'' er gældende. | +| | | | ''Quantity'' (0-1) ||| Doseringsværdi der skal anvendes. | 
-| | | | ''MinimumValue'' (0-1) ||| Minimumsværdi (inkl.) hvor ''Quantity'' er gældende. | +| | | | ''MinimumQuantity'' (0-1) ||| Minimum doseringsværdi der skal anvendes. | 
-| | | | ''MinimumValueInclusive'' (0-1) ||| Minimumsværdi (inkl.) hvor ''Quantity'' er gældende. | +| | | | ''MaximumQuantity'' (0-1) ||| Maximum doseringsværdi der skal anvendes. | 
-| | | | ''MinimumValueExclusive'' (0-1) ||| Minimumsværdi (eks.) hvor ''Quantity'' er gældende. | +| | | | ''Instruction'' (0-1) ||| Fritekstinstruktion hvis der ikke kan angives en mængde. | 
-| | | | ''MaximumValue'' (0-1) ||| Maksimumsværdi (inkl.) hvor ''Quantity'' er gældende. | +| ''DosagePeriod'' (1-n) |||||| Anvendes til at definere en doseringsperiode hvori der kan defineres fast og eller PN dosering. | 
-| | | | ''MaximumValueInclusive'' (0-1) ||| Maksimumsværdi (inkl.) hvor ''Quantity'' er gældende. | +| | ''PeriodLength'' (0-1) ||||| Længden på doseringsperioden i hele dage. | 
-| | | | ''MaximumValueExclusive'' (0-1) ||| Maksimumsværdi (eks.) hvor ''Quantity'' er gældende. | +| | ''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''. | 
-| | | | ''AssessedValue'' (0-1) ||| Tekstbeskrivelse af subjektiv vurdering. | +| | ''EndDate'' |||| | Beregnet slutdato for doseringsperioden. Kun en del af svaret fra FMK | 
-| | | | ''Quantity'' (0-1) ||| Doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). | +| | | ''CalculatedEndDate'' (0-1) |||| Slutdatoen, hvis denne kan beregnes | 
-| | | | ''MinimumQuantity'' (0-1) ||| Minimum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). | +| | | ''Unknown'' (0-1) |||| Flag der angiver, at det ikke er muligt at beregne slutdato. | 
-| | | | ''MaximumQuantity'' (0-1) ||| Maximum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). | +| | ''Fixed'' (0-1) ||||| Doseringsstruktur til angivelse af den faste doseringsstruktur i doseringsperioden. | 
-| | ''DosagePeriod'' (1-*) ||||| En eller flere doseringsperioder. | +| | ''PRN'' (0-1) ||||| Doseringsstruktur til angivelse af PN doseringsstrukturen i doseringsperioden. |
-| | | ''Profile'' |||| Beskriver doseringens karakteristika. | +
-| | | | ''ProfileCode'' ||| Kode med 4 dimensioner der angiver hhv. 1) fast/PN/PN-kur behandling 2) engangs/gentaget/tom/uspecificeret 3) dagsdosering/ugedagsdosering 4) morgen/middag/aften/nat/tidspunkt/i løbet af dagen/uden døgnbegrænsning). 3. og 4. dimension kan også være N/A hvis de ikke er relevante i forhold til den anden dimension.| +
-| | | | | ''DosageType'' || Angiver typen af hele behandlingen. Gyldige værdier er: ''Fast'', ''PN'' og ''PN-kur''. | +
-| | | | | ''PeriodType'' || Angiver typen af doseringsperiode.  Gyldige værdier er: ''Repeating'', ''Non-repeating'', ''Empty'', ''Unspecified''. | +
-| | | | | ''Schedule'' || Angiver om de beskrevne doseringer i denne periode skal indtages på specifikke ugedage eller om doseringen er relativ til hvornår borgeren begynder indtagelsen af doseringen. Gyldige værdier er: ''Specific weekdays'' og ''Non-specific weekdays''.  | +
-| | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. Gyldige værdier: ''Morning, noon, evening, night'', ''Specific time'', ''During the day'' og ''No frequency limit''. | +
-| | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen - kun ved læsninger. |+
 | | | ''Restriction'' (0-1) |||| Begrænsning i anvendelsen af lægemidlet. | | | | ''Restriction'' (0-1) |||| Begrænsning i anvendelsen af lægemidlet. |
 | | | | ''MaximumDailyDose'' (0-1) ||| Maksimal døgndosis, fx ''10'' tabletter. | | | | | ''MaximumDailyDose'' (0-1) ||| Maksimal døgndosis, fx ''10'' tabletter. |
Line 531: Line 404:
 | | | ''Instruction'' (0-1) |||| Instruktion der præciserer anvendelsen af lægemidlet. Anvendes hvis administrationsvej eller lægemiddelform ikke i sig selv giver tilstrækkelig information. Bemærk at instruktionsteksten ikke må ændre doseringens værdi, fx er det ikke hensigtsmæssigt at angive en struktureret dosering på ''2 dråber'' og i instruktionsteksten angive ''i hvert øje''. | | | | ''Instruction'' (0-1) |||| Instruktion der præciserer anvendelsen af lægemidlet. Anvendes hvis administrationsvej eller lægemiddelform ikke i sig selv giver tilstrækkelig information. Bemærk at instruktionsteksten ikke må ændre doseringens værdi, fx er det ikke hensigtsmæssigt at angive en struktureret dosering på ''2 dråber'' og i instruktionsteksten angive ''i hvert øje''. |
 | | | | ''FreeText'' ||| Selve fritekst instruktionen, fx ''i højre øje''. | | | | | ''FreeText'' ||| Selve fritekst instruktionen, fx ''i højre øje''. |
-| | | ''PeriodLength'' (0-1) |||| Doseringsperiodelængde. Sidste periode behøver ikke en periodelængde, mens alle øvrige perioder skal have en periodelængde som enten antal dage eller fritekst. Er givet implicit ved ikke-gentagede doseringer som antallet af doseringsdage i en periode, men hvis en periode skal afsluttes med et antal dage uden doseringer, inden en ny periode påbegyndes, skal periodelængden angives (eks.: periodelængde = 7, 5 doseringsdage angivet, dermed skal lægemidlet ikke anvendes de sidste 2 dage af perioden). | +| | | ''IterationInterval'' (0-1) |||| Gentages efter antal dage, for ugentligt gentagede skal IterationInterval være deleligt med 7. |
-| | | ''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''.  | +
-| | | ''IterationInterval'' |||| 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.| | | | ''Day'' (0-*) |||| De enkelte daglige doser, kan udelades ved tomme doseringsperioder.|
-| | | | ''Index'' (1) ||| Dagens indeks (indenfor doseringsperioden alternativt ugedagsnummer, afhængig af 2. dimension i den valgte profil kode. |+| | | | ''WeekdayLabel'' (0-1) ||| Specifik ugedag, fx tirsdag, hvor dose skal indtages. | 
 +| | | | ''Index'' (0-1) ||| Dagens indeks, hvor 1 er første dag i doseringsperioden. Det kan ikke antages, at 1 er mandag. |
 | | | | ''Dose'' (1-*) ||| Dosis. | | | | | ''Dose'' (1-*) ||| Dosis. |
 | | | | | ''TimeOfDay'' (0-1) || Tidspunkt for dosis, fx ''morning'' eller ''10:00''. | | | | | | ''TimeOfDay'' (0-1) || Tidspunkt for dosis, fx ''morning'' eller ''10:00''. |
-| | | | | ''TimesPerDay'' (0-1) || Antal gange doseringen gentages på en dag (kun for doseringer af typen ''i løbet af dagen'' d.v.s. profiltypen *.*.*.3. | +| | | | | ''TimesPerDay'' (0-1) || Antal gange doseringen gentages på en dag | 
-| | | | | ''MinimumTimesPerDay'' (0-1) || Hvor mange gange i døgnet dosis som minimum skal anvendes. | +| | | | | ''MaximumTimesPerDay'' (0-1) || Antal gange dosis maksimalt må indtages. | 
-| | | | | ''MaximumTimesPerDay'' (0-1) || Hvor mange gange i døgnet dosis maksimalt må anvendes. |+| | | | | ''MinimumTimesPerDay'' (0-1) || Antal gange dosis som minimum skal indtages. | 
 +| | | | | ''DuringTheDay'' (0-1) || Dosis skal indtages i løbet af dagen, tidspunkt ikke specificeret. | 
 +| | | | | ''Unlimited'' (0-1) || Dosis må indtages ubegrænses i løbet af dagen. |
 | | | | | ''Quantity'' (0-1) || Mængde, fx ''2'' | | | | | | ''Quantity'' (0-1) || Mængde, fx ''2'' |
 | | | | | ''MinimumQuantity'' (0-1) || Mængde som der som minimum skal anvendes. | | | | | | ''MinimumQuantity'' (0-1) || Mængde som der som minimum skal anvendes. |
Line 551: Line 425:
 | | | | | ''MaximumInfusionRate'' (0-1) || Indløbshastigheden der maksimalt må anvendes. | | | | | | ''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. | | | | | | ''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. |
-| | | ''CalculatedDosageEndDate'' |||| Information om beregnet slutdato for periode. Er udelukkende en del af response payload. | +| | | ''Empty'' (0-1) |||| Angiver at der for denne doseringsstruktur ikke er dosis der skal indtages.| 
-| | | | ''UnableToCalculateEndDate'' (0-1) ||| Tomt element der indikerer at det ikke er muligt at beregne en slutdato.  | +| | | ''Unspecified'' (0-1) |||| Angiver at der for denne doseringsstruktur endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.| 
-| | | | ''CalculatedEndDate'' (0-1) ||| Indholder den beregnede slutdato for perioden i formatet ''yyyy-MM-dd''.  | +| | | ''Profile'' |||| Beskriver doseringsstrukturen. | 
-| | | ''DosageTranslation'' |||| Indeholder periodedoseringen omsat til textuel representation. Er udelukkende en del af response payload. |+| | | | ''ProfileCode'' ||| Kode med 4 dimensioner der beskriver doseringsstrukturen. | 
 +| | | | | ''DosageType'' || Angiver typen af behandlingen. | 
 +| | | | | ''PeriodType'' || Angiver typen af doseringsperioden. | 
 +| | | | | ''Schedule'' || Angiver om doseringser er på specifikke ugedage eller relativ til periodensstart. | 
 +| | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. | 
 +| | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen. | 
 +| | | ''DosageTranslation'' |||| Indeholder doseringsstrukturen omsat til textuel representation. |
  
  
  
fmk/1.6.0/struktureret_dosering.1769523173.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki