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

Both sides previous revisionPrevious revision
Next revision		Previous revision
fmk:1.6.0:struktureret_dosering [2026-04-13 10:52] – adtafmk:1.6.0:struktureret_dosering [2026-06-01 12:45] (current) – adta
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 stilles krav til at systemer understøtter et minimum af funktionalitet for strukturerede doseringer, fx doser fordelt på 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 simple doseringer, (fx en engangsdosis), medicinering efter behov (fx ”1 stk. ved smerter”), +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.
-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.0 er den strukturerede dosering udvidet og ændret på flere punkter. En ikke-udtømmende oversigt: 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 i doseringsperioder, hvor hver gruppe har en længde. Grupper må ikke overlappe hinanden.   * 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. Der angives derfor ikke længere startdato for den enkelte periode. I stedet følger perioderne direkte efter hinanden ud fra deres længder.   * 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.
Line 25: Line 24:
   * ''Precondition'' indeholder de elementer, der beskriver forudsætningerne for, hvornår 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 doseringerne kan henvise til, typisk når 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 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.+  * ''DosagePeriod'' er et nyt koncept i 1.6.0-snitfladen. Doseringsperioder grupperer doseringsstrukturer 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.
  
 Eksempel på overordnet struktur af en struktureret dosering: Eksempel på overordnet struktur af en struktureret dosering:
Line 49: Line 48:
 </DosageForResponse> </DosageForResponse>
 </code> </code>
- 
  
 De enkelte elementer er beskrevet i yderligere detaljer i senere afsnit. De enkelte elementer er beskrevet i yderligere detaljer i senere afsnit.
  
 +Se også [[fmk:1.6.0:struktureret_dosering:eksempler_pa_strukturerede_doseringer|Eksempler på strukturerede doseringer]].
  
-Se også [[fmk:1.6.0:struktureret_dosering:Eksempler på strukturerede doseringer]]. 
 ==== Dosering (Dosage) ==== ==== Dosering (Dosage) ====
- 
-Skemadefinition for 
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageforrequesttype | dosering i request-elementer]] 
-og 
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageforresponsetype | dosering i response-elementer.]] 
- 
-Angivelse af dosering i 1.6.0 er ændret en del siden tidligere snitflader. 
- 
-Rodelementerne er ''<DosageForRequest>'' eller ''<DosageForResponse>'' afhængig af om xml'en er til forespørgsel eller svar. 
  
 === Precondition === === Precondition ===
  
-Skemadefinition for +Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforrequesttype|precondition request]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforresponsetype|precondition response]].
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforrequesttype | precondition request]] +
-og +
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#preconditionforresponsetype | precondition response]]+
  
-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>''. +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.
-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, eller et flag der angiver at FMK skal sætte/opdatere gyldig-fra ud fra fx udleveringstidspunkt eller relevante track and trace events. Ud fra gyldig-fra dato og doseringsperiode-varighederne vil det være muligt at beregne en slutdato for behandlingen.
-eller et flag, der angiver, at FMK skal sætte/opdatere gyldig-fra ud fra, fx udleveringstidspunkt eller relevant track and trace events. Ud fra gyldig-fra dato og doseringsperiode-varighederne +
-vil det være muligt at beregne en slutdato for behandlingen.+
  
-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 +Tidligere snitflader havde mulighed for at definere en startdato for enkelte doseringsstrukturer, 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.+
  
 Felter til alm. fast og PN doseringer: 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.   * ''<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: 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 
  
-Generelt+  * ''<EpisodicTreatment>'': Hvis denne er sat, anses behandlingen for at være af typen PN-kur. 
 +  * ''<EpisodicTreatment>''→''<Trigger>'': Angiver betingelsen 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 give information videre mellem systemer. 
 + 
 +Generelt: 
   * ''<PRNTrigger>'': Bruges til at angive startkriteriet for PN doseringsstrukturer (ikke PN-kur). Uanset startkriteriet anses doseringen tidligst gyldig fra dato i ''<ValidFrom>''.   * ''<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.+Herunder kan ses et eksempel på ''<Precondition>'' som den kan sendes til FMK. Eksemplet er ikke skemavalidt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.
  
 <code xml> <code xml>
Line 109: Line 94:
 </code> </code>
  
-===Doseringsenheden (DosageUnit) ===+=== Doseringsenheden (DosageUnit) ===
  
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageQuantityUnitTextType | enhedstekst]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageQuantityUnitTextsType | enhedstekst i ental og flertal]] anvendes i både anmodning og svar.+Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosagequantityunittexttype|enhedstekst]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosagequantityunittextstype|enhedstekst i ental og flertal]] anvendes i både anmodning og svar.
  
   * ''<DosageUnit>'' elementet anvendes til at angive enheden for doseringen. Herunder anvendes:   * ''<DosageUnit>'' elementet anvendes til at angive enheden for doseringen. Herunder anvendes:
Line 119: Line 104:
 === Selvadministreret (IsSelfAdministration) === === Selvadministreret (IsSelfAdministration) ===
  
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#isselfadministrationtype | selvadministration]] 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".+Doseringen kan markeres med et ''IsSelfAdministration''-flag, hvis patienten selv administrerer medicinen. Anvendes typisk ved selvadministreret VKA behandlinger. I tidligere snitflader var selvadministrerede VKA doseringer angivet med en fritekst-dosering hvor starten af teksten var "Selvstyrende".
  
 +=== Doseringsperiode (DosagePeriod) ===
  
 +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 bygger på [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageperiodtype|Doseringsperiode generelt]].
  
 +Doseringsperioder består af en længde og op til 2 doseringsstrukturer, én fast og/eller én PN dosering. Doseringsstrukturer 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.
  
-=== Doseringsperiode (DosagePeriod) === +Doseringsperioder kan ikke overlappe, så derfor kan faste og PN doseringer fra forskellige doseringsperioder ligeledes ikke overlappe. Hvis der på forskellige tidspunkter i behandlingen er brug for at ændre dosering, skal dette ske ved at der oprettes flere doseringsperioder. Rækkefølgen af doseringsperioder i anmodninger og svar definerer rækkefølgen for behandlingen.
-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 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. +
- +
-Doseringsperioder kan ikke overlappe, så derfor kan faste og PN doseringer fra forskellig doseringsperioder ligeledes ikke overlappe. Hvis der på forskellige tidspunkter i behandlingen er brug for at ændre dosering, skal dette ske ved at der oprettes flere doseringsperioder. Rækkefølgen af doseringsperioder i anmodninger og svar definere rækkefølgen for behandlingen.+
  
   * ''<PeriodLength>'' angiver længden af doseringsperioden i hele dage.   * ''<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.+  * ''<PeriodLengthFreeText>'' alternativ til ''<PeriodLength>''; angiver længden af doseringsperioden som fritekst.
   * ''<Empty>'' angiver at der for denne doseringsperiode ikke er dosis der skal indtages. Det kan fx bruges til at angive en pause i doseringen.   * ''<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.   * ''<Unspecified>'' angiver at der for denne doseringsperiode endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.
Line 142: Line 124:
   * ''<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.   * ''<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 skemavalidt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen. 
 <code xml> <code xml>
-<DosagePeriodForResponse> +<DosagePeriod>
-  <PRN>...</PRN> +
-  <Fixed>...</Fixed>+
   <PeriodLength>...</PeriodLength>   <PeriodLength>...</PeriodLength>
   <PeriodLengthFreeText>...</PeriodLengthFreeText>   <PeriodLengthFreeText>...</PeriodLengthFreeText>
 +  <Fixed>...</Fixed>
 +  <PRN>...</PRN>
   <EndDate>...</EndDate>   <EndDate>...</EndDate>
-</DosagePeriodForResponse>+</DosagePeriod>
 </code> </code>
- 
  
 === Doseringsperiode længde (PeriodLength) === === Doseringsperiode længde (PeriodLength) ===
  
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodLengthType | doseringsperiode længde]] alternativt [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosagePeriodLengthTextType | doseringsperiode længde fritekst]]+Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageperiodlengthtype|doseringsperiode længde]] alternativt [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageperiodlengthtexttype|doseringsperiode længde fritekst]].
  
-Længden af en periode bør angives i dage ''<PeriodLength>'' hvis muligt. +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.
-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+
  
 +  * ''<PeriodLength>'' angiver længden i antal dage.
 +  * ''<PeriodLengthFreeText>'' angiver længden som fritekst.
  
 === Struktureret dosering (DosageStructure) === === Struktureret dosering (DosageStructure) ===
  
-Skemadefinition for +Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosagestructuretype|doseringsstruktur ved anmodning]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosagestructureforresponsetype|doseringsstruktur ved svar]].
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageStructureType | doseringsstruktur ved anmodning]] +
-og +
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageStructureForResponseType | doseringsstruktur ved svar]].+
  
-Der er to typer af struktureret dosering: Fast og PN. Forskellene på de to består primært af hvordan de bruges og ikke i skemadefination. +Der er to typer af struktureret dosering: Fast og PN. Forskellene på de to består primært af hvordan de bruges og ikke i skemadefinitionen. 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.
-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 følgende elementer indgå: For hver doseringsstruktur kan følgende elementer indgå:
Line 181: Line 156:
   * ''<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.   * ''<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. Fx: ved behandling hver 2. dag skal der 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>'' angiver doseringer for specifikke dage i perioden.+  * ''<Day>'' angiver doseringer for specifikke dage i perioden, identificeret ved et dagnummer (indeks). 
 +  * ''<UnspecifiedDay>'' angiver en PN-dosering der ikke er knyttet til en specifik dag i iterationen. Benyttes udelukkende i ''<PRN>''-strukturer med ''<IterationInterval>'' > 1, fx "1 tablet efter behov, højst 1 gang ugentlig" (''<IterationInterval>7</IterationInterval>''). For daglige PN-begrænsninger (''<IterationInterval>1</IterationInterval>'') benyttes ''<Day>'' i stedet. 
 +  * ''<Week>'' angiver ugedagsbaserede doseringer, grupperet pr. uge. Hver uge indeholder op til 7 ugedage med tilhørende doser. 
 + 
 +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: 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.   * ''<Profile>'' indeholder profilkoden for den strukturerede dosering. Beskrives yderligere i det efterfølgende.
-  * ''<DosageTranslation>'' Vil indeholde en tekstuel beskrivelse af den strukturerede dosering+  * ''<DosageTranslation>'' vil indeholde en tekstuel beskrivelse af den strukturerede dosering.
  
 +Herunder kan ses eksempler på doseringsstrukturer som de bliver returneret fra FMK. Eksemplerne er ikke skemavalide eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten er at vise strukturen.
 +
 +Eksempel med dagsnummerbaseret dosering (''<Day>''):
  
-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. 
 <code xml> <code xml>
 <DosageStructureForResponse> <DosageStructureForResponse>
-  <IterationInterval>...</IterationInterval> 
   <Restriction>...</Restriction>   <Restriction>...</Restriction>
   <Instruction>...</Instruction>   <Instruction>...</Instruction>
 +  <IterationInterval>...</IterationInterval>
   <Day>...</Day>   <Day>...</Day>
   <Day>...</Day>   <Day>...</Day>
Line 203: Line 184:
 </code> </code>
  
-===Doseringsrestriktioner (Restriction)===+Eksempel med ugedagsbaseret dosering (''<Week>''):
  
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageRestrictionType | doseringsrestriktioner]]+<code xml> 
 +<DosageStructureForResponse> 
 +  <Restriction>...</Restriction> 
 +  <Instruction>...</Instruction> 
 +  <IterationInterval>7</IterationInterval> 
 +  <Week> 
 +    <Weekday> 
 +      <Label>Monday</Label> 
 +      <Dosage>...</Dosage> 
 +    </Weekday> 
 +    <Weekday> 
 +      <Label>Thursday</Label> 
 +      <Dosage>...</Dosage> 
 +    </Weekday> 
 +  </Week> 
 +  <Profile>...</Profile> 
 +  <DosageTranslation>...</DosageTranslation> 
 +</DosageStructureForResponse> 
 +</code>
  
-For visse doseringer kan der angives generelle restriktioner for indtagelse af præparatet, fx “2 tabletter dagligt, med mindst 12 timer imellem”.+=== Doseringsrestriktioner (Restriction) === 
 + 
 +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".
  
 Elementet ''<Restriction>'' kan indeholde: Elementet ''<Restriction>'' kan indeholde:
-  * ''<MaximumDailyDose>'' maksimal daglig dosis 
-  * ''<MinimumDurationBetweenDoses>'' minimumstid mellem doser angivet i minutter 
  
-=== Doseringsinstruktion (Instruction)===+  * ''<MaximumDailyDose>'' maksimal daglig dosis. 
 +  * ''<MinimumDurationBetweenDoses>'' minimumstid mellem doser angivet i minutter.
  
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DosageInstructionType | doseringsinstruktion]]+=== Doseringsinstruktion (Instruction) === 
 + 
 +Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosageinstructiontype|doseringsinstruktion]].
  
 En doseringsinstruktion angives ved ''<Instruction>'' elementet, der har et underelement ''<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. Doseringsinstruktionen må ikke i sig selv påvirke doseringens omfang.
- 
  
 === Iterationsinterval (IterationInterval) === === Iterationsinterval (IterationInterval) ===
-Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#IterationIntervalType | iterationsinterval]].+ 
 +Skemadefinition for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#iterationintervaltype|iterationsinterval]].
  
 Til at mindske behovet for gentagelser i doseringsangivelser kan man definere et ''<IterationInterval>'' på en struktureret dosering. Iterationsintervallet angiver fra hvilken dag i doseringen en evt. gentagelse skal begynde. Til at mindske behovet for gentagelser i doseringsangivelser kan man definere et ''<IterationInterval>'' på en struktureret dosering. 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.+For fx en daglig dosering skal doseringen defineres og ''<IterationInterval>'' skal være 1. Hvis det derimod kun er hver anden dag, kan doseringen defineres med et enkelt ''<Day>'' element og ''<IterationInterval>'' sættes til 2.
  
 Ved kontinuerlig behandling, fx behandling med infusion, må ''<IterationInterval>'' ikke angives. Ved kontinuerlig behandling, fx behandling med infusion, må ''<IterationInterval>'' ikke angives.
  
 +=== Doseringsangivelse (Day og Dosage) ===
  
-===Doseringsangivelse===+Skemadefinitioner for [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#daytype|Day]] og [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#dosagechoicetype|DosageChoiceType]].
  
-Skemadefinitioner for +En struktureret dosering kan indeholde et eller flere ''<Day>'' elementer, som definerer doseringerne pr. dag. Dagnumrene er relative til periodens startdato. Fortolkningen angives af profilkoden.
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DayType | Day]] +
-og +
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#DoseType | Dose]].+
  
-En struktureret dosering kan indeholde et eller flere ''<Day>'' elementer, som definerer doseringerne pr. dag. +Et ''<Day>'' element indeholder:
-Disse kan enten være relative til periodens startdato eller knyttet til specifikke ugedage. Fortolkningen angives af profilkoden.+
  
-''<Day>'' elementer kan indeholde enten ''<WeekdayLabel>'' eller ''<Index>'' og ét eller flere ''<Dose>'' elementer+  * ''<Index>'': et heltal (1-365) der angiver dagnummeret i perioden. Værdien må aldrig være større end værdien af ''<IterationInterval>'', hvis denne er angivet. 
 +  * ''<Dosage>'': doseringen for dagen, af type ''DosageChoiceType''.
  
-  * ''<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]]. +''<Dosage>'' er et valg (''DosageChoiceType'') -- kun én type pr. dag:
-  * ''<Index>'' er et heltal, der angiver dagnummer i perioden for den strukturerede dosering, 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.+  * ''<PartOfDayDosage>'': dosering på navngivne tidspunkter på dagen. Indeholder valgfrit op til fire subelementer: ''<Morning>'', ''<Noon>'', ''<Evening>'', ''<Night>'', hvert indeholdende en mængde. 
 +  * ''<TimeOfDayDosage>'': dosering til specifikke klokkeslæt. Indeholder ét eller flere ''<TimeOfDayDose>'' elementer, hvert med en mængde og ''<Time>'' (klokkeslæt på formatet ''HH:MM:SS'', fx ''08:00:00''). 
 +  * ''<TimesPerDayDosage>'': dosering et fast antal gange dagligt. Indeholder mængde og ''<TimesPerDay>''. 
 +  * ''<DuringTheDayDosage>'': dosering i løbet af dagen, tidspunkt ikke specificeret. Indeholder kun mængde. 
 +  * ''<UnlimitedDayDosage>'': dosering uden øvre grænse for antal gange i løbet af dagen. Benyttes primært ved ubegrænsede PN-doseringer, hvor patienten kan tage dosen vilkårligt mange gange, samt ved kontinuerlig infusion. Indeholder kun mængde.
  
-''<Dose>'' kan forekomme én eller flere gange i et ''<Day>'' 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>''.+Dosis angives i alle ovenstående typer via ''DoseType''. ''DoseType'' består af en mængdeangivelse, som er et valg mellem:
  
-Frekvens kan angives med: +  * ''<Quantity>'': fast mængde, fx ''2''. 
-  * ''<TimeOfDay>'' der angiver morgen, middag, aften, nat eller et specifikt klokkeslæt for en dosis +  * ''<MinimumQuantity>'' + ''<MaximumQuantity>'': mængdeinterval. 
-  * ''<TimesPerDay>'' der angiver hvor mange gange om dagen doseringen skal indtages +  * ''<AccordingToParameterSchema>'': bruges som alternativ til mængde-elementerne 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 ''ParameterLabel'' for det ønskede skema angives som tekstindhold, fx ''<AccordingToParameterSchema>Dagsdoser</AccordingToParameterSchema>''.
-  * ''<DuringTheDay>'' at doseringen blot skal indtages i løbet af dagen, uden krav til tidspunkt +
-  * ''<Unlimited>'' at doseringen må indtages ubegrænset. Hvis der er døgn eller interval begrænsning på indtagelse kan det angives i ''<Restriction>'' +
-  * ''<MinimumTimesPerDay>'' at dosis der angiver minimumsværdien for den daglige dosis +
-  * ''<MaximumTimesPerDay>'' der angiver et maksimumsværdien for den daglige dosis+
  
-Mængden angives med en specifik værdi eller et interval: +Derudover kan dosis valgfrit indeholde et ''<Infusion>'' element, som bruges ved IV-behandling. ''<Infusion>'' er et valg mellem:
-  * ''<Quantity>'' mængden der doseres +
-  * ''<MinimumQuantity>'' minimum dosis +
-  * ''<MaximumQuantity>'' maksimum dosis+
  
-Hastigheden angives med: +  * ''<Duration>'': varighed som dosis skal anvendes over. 
-  * ''<Duration>'' angiver hvor længe en infusion af den angivne mængde skal tage. +  * ''<MinimumDuration>'' + ''<MaximumDuration>'': interval for varighed. 
-  * ''<MinimumDuration>'' angiver hvor længe en infusion af den angivne mængde som minimum skal tage. +  * ''<InfusionRate>'': indløbshastighed (fx ml/t). 
-  * ''<MaximumDuration>'' angiver hvor længe en infusion af den angivne mængde som maksimum må tage. +  * ''<MinimumInfusionRate>'' + ''<MaximumInfusionRate>'': interval for indløbshastighed.
-  * ''<InfusionRate>'' angiver indløbshastigheden i ml/t fx 25 ml/t +
-  * ''<MinimumInfusionRate>'' angiver den minimale indløbshastighed i ml/t +
-  * ''<MaximumInfusionRate>'' angiver den maksimale 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.+Herunder kan ses et ikke-gyldigt eksempel på ''<Day>'' med ''<PartOfDayDosage>''. Hensigten er at vise strukturen.
  
-''<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. 
- 
-Her under kan ses et ikke-gyldigt eksempel på hvordan strukturen på day-xml ser ud. Det indeholder alle elementer hvilket naturligvis ikke er skema-validt. 
 <code xml> <code xml>
 <Day> <Day>
-  <WeekdayLabel>...</WeekdayLabel> +  <Index>1</Index> 
-  <Index>...</Index> +  <Dosage> 
-  <Dose> +    <PartOfDayDosage> 
-    <TimeOfDay>...</TimeOfDay> +      <Morning><Quantity>2</Quantity></Morning> 
-    <TimesPerDay>...</TimesPerDay> +      <Noon><Quantity>1</Quantity></Noon> 
-    <DuringTheDay/> +      <Evening><Quantity>2</Quantity></Evening> 
-    <Unlimited/> +      <Night><Quantity>1</Quantity></Night> 
-    <MinimumTimesPerDay>...</MinimumTimesPerDay> +    </PartOfDayDosage> 
-    <MaximumTimesPerDay>...</MaximumTimesPerDay>+  </Dosage> 
 +</Day> 
 +</code>
  
-    <Quantity>...</Quantity> +==== Ugedagsbaseret dosering ====
-    <MinimumQuantity>...</MinimumQuantity> +
-    <MaximumQuantity>...</MaximumQuantity>+
  
-    <Duration>...</Duration> +Ugedagsbaserede doseringer angives med ''<Week>'' elementet i stedet for ''<Day>''. Én doseringsstruktur kan indeholde op til 53 ''<Week>'' elementer, der fortolkes som uge 1, uge 2 osv.
-    <MinimumDuration>...</MinimumDuration> +
-    <MaximumDuration>...</MaximumDuration>+
  
-    <InfusionRate>...</InfusionRate> +Hvert ''<Week>'' element indeholder 1-7 ''<Weekday>'' elementer. Hvert ''<Weekday>'' element indeholder:
-    <MinimumInfusionRate>...</MinimumInfusionRate> +
-    <MaximumInfusionRate>...</MaximumInfusionRate>+
  
-    <AccordingToParameterSchema>...</AccordingToParameterSchema> +  * ''<Label>'': ugedagen som enumeration: ''Monday'', ''Tuesday'', ''Wednesday'', ''Thursday'', ''Friday'', ''Saturday'' eller ''Sunday''. 
-  </Dose> +  * ''<Dosage>'': dosering for ugedagen (''DosageChoiceType'' -- samme struktur som ''<Dosage>'' under ''<Day>''). 
-  <Dose>...</Dose> + 
-  <Dose>...</Dose> + 
-</Day>+==== PN-doseringer ==== 
 + 
 +PN-doseringer angives ved at placere doseringsstrukturen i ''<PRN>'' fremfor i for ''<Fixed>''. ''<PRN>'' og ''<Fixed>'' har begge typen ''DosageStructureType'' og dermed samme interne struktur. Det er således placeringen i ''<PRN>'', der markerer, at doseringen er til anvendelse efter behov. 
 + 
 + 
 +Tre typer af PN-doseringer er særligt relevante: 
 + 
 +^ Type ^ IterationInterval ^ Day-element ^ Dosage-type ^ Tekst-eksempel ^ 
 +| Ubegrænset PN | Ingen | ''<Day>'' | ''<UnlimitedDayDosage>'' | 1 tablet efter behov | 
 +| Daglig PN (højst N gange pr. dag) | 1 | ''<Day>'' | ''<TimesPerDayDosage>'' | 1 tablet efter behov, højst 1 gang daglig | 
 +| Periodebegrænset PN (højst 1 gang pr. N dage) | N > 1 | ''<UnspecifiedDay>'' | ''<TimesPerDayDosage>'' | 1 tablet efter behov, højst 1 gang ugentlig | 
 + 
 +For PN-doseringer med ''<Day>'' er ''Index'' valgfrit. Hvis ''Index'' angives, skal værdien være 1. 
 + 
 +=== Ubegrænset PN (UnlimitedDayDosage) === 
 + 
 +En ubegrænset PN-dosering benyttes, når patienten kan tage dosen et vilkårligt antal gange uden nogen periodebegrænsning. Strukturen er ''<PRN>'' uden ''<IterationInterval>'', med et enkelt ''<Day>''-element og ''<UnlimitedDayDosage>'' som dosage-type. 
 + 
 +<code xml> 
 +<DosagePeriod> 
 +  <PRN> 
 +    <Day> 
 +      <Dosage> 
 +        <UnlimitedDayDosage> 
 +          <Quantity>1</Quantity> 
 +        </UnlimitedDayDosage> 
 +      </Dosage> 
 +    </Day> 
 +  </PRN> 
 +</DosagePeriod> 
 +</code> 
 + 
 +Resulterende doseringstekst: **1 tablet efter behov** 
 + 
 +Hvis der ønskes en øvre grænse for den daglige dosis, kan ''<Restriction><MaximumDailyDose>'' tilføjes til ''<PRN>''-strukturen. 
 + 
 +I tidligere versioner blev denne type bla angivet med AnyDay-elementet. 
 +=== Daglig PN (IterationInterval = 1) === 
 + 
 +En daglig PN-begrænsning angiver, at dosen kan tages efter behov, men højst et bestemt antal gange pr. dag. Strukturen er et ''<PRN>''-element med iterationsinterval 1 og elementet ''<TimesPerDayDosage>''. 
 + 
 +<code xml> 
 +<DosagePeriod> 
 +  <PRN> 
 +    <IterationInterval>1</IterationInterval> 
 +    <Day> 
 +      <Index>1</Index> 
 +      <Dosage> 
 +        <TimesPerDayDosage> 
 +          <Quantity>1</Quantity> 
 +          <TimesPerDay>1</TimesPerDay> 
 +        </TimesPerDayDosage> 
 +      </Dosage> 
 +    </Day> 
 +  </PRN> 
 +</DosagePeriod> 
 +</code> 
 + 
 +Resulterende doseringstekst: **1 tablet efter behov, højst 1 gang daglig** 
 + 
 +Bemærk,''<UnspecifiedDay>'' må ikke bruges ved IterationInterval = 1. For daglig PN benyttes altid ''<Day>''. 
 + 
 +=== Periodebegrænset PN (UnspecifiedDay, IterationInterval > 1) === 
 + 
 +En periodebegrænset PN-dosering begrænser, hvor ofte patienten kan tage dosen inden for en periode på mere end én dag. ''<IterationInterval>N</IterationInterval>'' angiver periodens længde i dage. ''<UnspecifiedDay>'' angiver, at dosen kan tages på en vilkårlig dag inden for perioden, elementet har ingen ''<Index>''. 
 + 
 +<code xml> 
 +<DosagePeriod> 
 +  <PRN> 
 +    <IterationInterval>7</IterationInterval> 
 +    <UnspecifiedDay> 
 +      <Dosage> 
 +        <TimesPerDayDosage> 
 +          <Quantity>1</Quantity> 
 +          <TimesPerDay>1</TimesPerDay> 
 +        </TimesPerDayDosage> 
 +      </Dosage> 
 +    </UnspecifiedDay> 
 +  </PRN> 
 +</DosagePeriod>
 </code> </code>
  
 +Resulterende doseringstekst: **1 tablet efter behov, højst 1 gang ugentlig**
  
 +I tidligere versioner blev denne type bla angivet med AnyDay-elementet.
  
 === Doseringsprofil (Profile) === === Doseringsprofil (Profile) ===
  
-[[fmk:1.6.0:struktureret_dosering:doseringsprofil| Detaljeret beskrivelse af doseringsprofil]]+[[fmk:1.6.0:struktureret_dosering:doseringsprofil|Detaljeret beskrivelse af doseringsprofil]]
  
-I FMK 1.6.0 indføres profiler på doseringer. Profilerne skal gøre det nemmere for klienter af FMK at præsentere doseringer returneret fra FMK. Profiler anvendes bl.a. til at forklare udfaldsrummet for strukturerede doseringer. +I FMK 1.6.0 indføres profiler på doseringer. Profilerne skal gøre det nemmere for klienter af FMK at præsentere doseringer returneret fra FMK. Profiler anvendes bl.a. til at forklare udfaldsrummet for strukturerede doseringer. Doseringsprofiler returneres som en del af svar fra FMK der indeholder doseringer. En ''Profile(Code)'' indeholder 4 elementer på nedenstående format:
-Doseringsprofiler returneres som en del af svar fra FMK der indeholder doseringer. En Profile(Code) indeholder 4 elementer på nedenstående format+
  
 <code xml> <code xml>
Line 333: Line 398:
 </code> </code>
  
-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 skemavalide værdier i feltbeskrivelser).
  
-^ 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 |                                     | i løbet af dagen             | +|                             |                         |                                           | Times per day                | 
-|             | uspecificeret periode      |                                     | uden døgnbegrænsning         |+|                             |                         |                                           | I løbet af dagen             | 
 +|                             |                         |                                           | 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".
  
-Værdien af ''<ProfileDescription>'' vil være en tekstuel representation af profilkoden+Værdien af ''<ProfileDescription>'' vil være en tekstuel representation af profilkoden.
  
 I kald til FMK er det ikke muligt at angive doseringsprofil. I kald til FMK er det ikke muligt at angive doseringsprofil.
  
 +=== Parameterskema (Parameter) ===
  
-===Parameterskema (Parameter) ===+[[fmk:1.6.0:struktureret_dosering:parameterskema|Detaljeret beskrivelse af parameterskema]]
  
-Der kan for en dosering  defineres en eller flere parameterskemaer. Se [[fmk:1.6.0:struktureret_dosering:parameterskema|dokumentation af parameterskema]]+=== Kombineret doseringsoversættelse (DosageTranslationCombined) ===
  
 +''<DosageTranslationCombined>'' er et valgfrit element i ''<DosageForResponse>''. Det indeholder en samlet tekstuel beskrivelse af alle doseringsperioder i doseringen, returneret af FMK. Elementet bruges til at give en læsbar opsummering af den samlede dosering på tværs af perioder.
  
- +===== Elementer i en struktureret dosering =====
- +
- +
-==== Elementer i en struktureret dosering ====+
  
 Elementer hvor andet ikke fremgår, er kardinaliteten 1. Elementer hvor andet ikke fremgår, er kardinaliteten 1.
  
-| **Element** |||||| **Beskrivelse** | +| **Element** ||||||| **Beskrivelse** | 
-| ''IsSelfAdministration'' (0-1) |||||| Markerer at lægemidlet er til patientens selvadministration. | +| ''IsSelfAdministration'' (0-1) ||||||| Markerer at lægemidlet er til patientens selvadministration. | 
-| ''Precondition'' |||||| Betingelse der skal være opfyldt, før doseringen må startes. | +| ''Precondition'' ||||||| Betingelse der skal være opfyldt, før doseringen må startes. | 
-| | ''ValidFrom'' (0-1)||||| Doseringsstartdato. | +| | ''ValidFrom'' (0-1) |||||| Doseringsstartdato. | 
-| | ''UpdateValidFromUponHandover'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. FMK vil opdatere ''ValidFrom'' ved events | +| | ''UpdateValidFromUponHandover'' (0-1) |||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. FMK vil opdatere ''ValidFrom'' ved events. | 
-| | ''PRNTrigger'' (0-1)||||| Fritekst trigger for PN doseringsstrukturer. | +| | ''PRNTrigger'' (0-1) |||||| Fritekst trigger for PN doseringsstrukturer. | 
-| | ''EpisodicTreatment''||||| Angivelse om at doseringen tilhører en PN-kur | +| | ''EpisodicTreatment'' (0-1) |||||| 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. | 
-| | | ''MinimumDaysBetweenEpisodes'' (0-1) |||| Minimumstid der skal gå imellem PN-kurene. Værdien skal angives i positivt antal hele dage. | +| | | ''MinimumDaysBetweenEpisodes'' (0-1) ||||| Minimumstid der skal gå imellem PN-kurene. Angives i positivt antal hele dage. | 
-| ''UnitText'' (0-1)|||||| Enheden for dosering. Denne skal bruges hvis der ikke er forskel på en- og flertalsangivelsen. Der skal fortrinsvis anvendes doseringer i antal, dvs. antal tabletter, kapsler, pust, sug, dråber m.v. Doseringer i mængde, dvs. milliliter, milligram m.v. bør kun anvendes hvis lægemidlet ikke meningsfyldt kan doseres i antal. | +| ''UnitText'' (0-1) ||||||| Enheden for dosering. Bruges hvis der ikke er forskel på en- og flertalsangivelsen. | 
-| ''UnitTexts'' (0-1)|||||| Enheden for dosering. Denne skal bruges hvis der er forskel på en- og flertalsangivelsen. Der skal fortrinsvis anvendes doseringer i antal, dvs. antal tabletter, kapsler, pust, sug, dråber m.v. Doseringer i mængde, dvs. milliliter, milligram m.v. bør kun anvendes hvis lægemidlet ikke meningsfyldt kan doseres i antal. | +| ''UnitTexts'' (0-1) ||||||| Enheden for dosering. Bruges hvis der er forskel på en- og flertalsangivelsen. | 
-| | ''Singular'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. | +| | ''Singular'' |||||| Enhed i ental, fx ''kapsel''. | 
-| | ''Plural'' ||||| Enhed for dosering i flertal, fx kapsler, dråber m.v. | +| | ''Plural'' |||||| Enhed i flertal, fx ''kapsler''. | 
-| ''Parameter'' (0-n) |||||| Anvendes ved parametriserede doseringer efter skema. | +| ''Parameter'' (0-n) ||||||| Anvendes ved parametriserede doseringer efter skema. | 
-| | ''ParameterName'' ||||| Navn på måleparameteren (fx ''Blodglukoseværdi''). | +| | ''ParameterName'' |||||| Navn på måleparameteren (fx ''Blodglukoseværdi''). | 
-| | ''ParameterLabel'' (0-1) ||||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). | +| | ''ParameterLabel'' (0-1) |||||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). | 
-| | ''ParameterUnit'' ||||| Måleparameterens enhed. | +| | ''ParameterUnit'' (0-1) |||||| Måleparameterens enhed. | 
-| | | ''ParameterUnitText'' |||| Måleparameterens enhed (fx ''mmol/l''). | +| | | ''ParameterUnitText'' ||||| Måleparameterens enhedstekst (fx ''mmol/l''). | 
-| | ''ParameterSchema'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. | +| | ''ParameterSchema'' |||||| Måleværdier eller kriterier til doseringsmængder. Indeholder et eller flere ''ParametricQuantity'' elementer. | 
-| | | ''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. | +| | | ''ParametricQuantity'' (1-n) ||||| Beskriver en indgang i doseringsskemaet. Kan gives ved enkelt værdi, interval eller fritekstkriterie. | 
-| | | | ''FromValue'' (0-1) ||| Fra-værdien for hvornår denne ''ParametricQuantity'' er gældende. | +| | | | ''FromValue'' (0-1) |||| Fra-værdien for hvornår denne ''ParametricQuantity'' er gældende. | 
-| | | | ''Criterion'' (0-1) ||| Fritekstkriterie beskrivelse for hvornår denne ''ParametricQuantity'' er gældende. | +| | | | ''Criterion'' (0-1) |||| Fritekstkriterie for hvornår denne ''ParametricQuantity'' er gældende. | 
-| | | | ''Quantity'' (0-1) ||| Doseringsværdi der skal anvendes. | +| | | | ''Quantity'' (0-1) |||| Doseringsværdi der skal anvendes. | 
-| | | | ''MinimumQuantity'' (0-1) ||| Minimum doseringsværdi der skal anvendes. | +| | | | ''MinimumQuantity'' (0-1) |||| Minimum doseringsværdi der skal anvendes. | 
-| | | | ''MaximumQuantity'' (0-1) ||| Maximum doseringsværdi der skal anvendes. | +| | | | ''MaximumQuantity'' (0-1) |||| Maksimum doseringsværdi der skal anvendes. | 
-| | | | ''Instruction'' (0-1) ||| Fritekstinstruktion hvis der ikke kan angives en mængde. | +| | | | ''Instruction'' (0-1) |||| Fritekstinstruktion hvis der ikke kan angives en mængde. | 
-| ''DosagePeriod'' (1-n) |||||| Anvendes til at definere en doseringsperiode hvori der kan defineres fast og eller PN dosering. | +| ''DosagePeriod'' (1-n) ||||||| Grupperer fast og/eller PN doseringsstruktur og angiver varigheden. Perioder må ikke overlappe. | 
-| | ''PeriodLength'' (0-1) ||||| Længden på doseringsperioden i hele dage. | +| | ''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''. | +| | ''PeriodLengthFreeText'' (0-1) |||||| Alternativ til ''PeriodLength''. Angiver tekstuelt hvad der afgør at en periode afsluttes. | 
-| | ''EndDate'' |||| | Beregnet slutdato for doseringsperioden. Kun en del af svaret fra FMK | +| | ''EndDate'' |||||| Beregnet slutdato for doseringsperioden. Kun en del af svaret fra FMK. | 
-| | | ''CalculatedEndDate'' (0-1) |||| Slutdatoen, hvis denne kan beregnes | +| | | ''CalculatedEndDate'' (0-1) ||||| Slutdatoen, hvis denne kan beregnes. | 
-| | | ''Unknown'' (0-1) |||| Flag der angiver, at det ikke er muligt at beregne slutdato. | +| | | ''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.| +| | ''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.| +| | ''Unspecified'' (0-1) |||||| Angiver at der i denne doseringsperiode endnu ikke er bestemt dosis. | 
-| | ''Fixed'' (0-1) ||||| Doseringsstruktur til angivelse af den faste doseringsstruktur i doseringsperioden. | +| | ''Fixed'' (0-1) |||||| Doseringsstruktur til angivelse af den faste doseringsstruktur i doseringsperioden. | 
-| | ''PRN'' (0-1) ||||| Doseringsstruktur til angivelse af PN doseringsstrukturen i doseringsperioden. | +| | ''PRN'' (0-1) |||||| Doseringsstruktur til angivelse af PN doseringsstrukturen i doseringsperioden. | 
-| | | ''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. | 
-| | | | ''MinimumTimeBetweenDoses'' (0-1) ||| Minimumstid der skal gå imellem doserne anvendes. Værdien skal angives som positivt antal hele minutter. Kun relevant ved doseringer uden begrænsninger eller af typen "n gange daglig". | +| | | | ''MinimumDurationBetweenDoses'' (0-1) |||| Minimumstid der skal gå imellem doserne. Angives som positivt antal hele minutter. Kun relevant ved doseringer uden begrænsninger eller af typen "n gange daglig". | 
-| | | ''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. Instruktionsteksten må ikke ændre doseringens værdi. | 
-| | | | ''FreeText'' ||| Selve fritekst instruktionen, fx ''i højre øje''. | +| | | | ''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. | +| | | ''IterationInterval'' (0-1) ||||| Gentages efter antal dage. For ugentlige doseringer skal værdien være deleligt med 7. Ved kontinuerlig behandling, fx infusion, må ''IterationInterval'' ikke angives. | 
-| | | ''Day'' (0-*) |||| De enkelte daglige doser, kan udelades ved tomme doseringsperioder.| +| | | ''Week'' (0-*) ||||| Ugedagsbaserede doser grupperet pr. uge. 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 dosering. | 
-| | | | ''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. | +| | | | | ''Dosage'' ||| Dosering for ugedagen (DosageChoiceType – samme struktur som ''Dosage'' under ''Day''). | 
-| | | | | ''TimeOfDay'' (0-1) || Tidspunkt for dosis, fx ''morning'' eller ''10:00''. | +| | | ''Day'' (0-*) ||||| Dagsnummerbaserede doser. Valg med ''Week'' og ''UnspecifiedDay'' – kun én type pr. doseringsstruktur. | 
-| | | | | ''TimesPerDay'' (0-1) || Antal gange doseringen gentages på en dag | +| | | | ''Index'' (0-1) |||| Dagens indeks, hvor 1 er første dag i doseringsperioden. Det kan ikke antages at 1 er mandag. | 
-| | | | | ''MaximumTimesPerDay'' (0-1) || Antal gange dosis maksimalt må indtages. | +| | | | ''Dosage'' |||| Dosering for dagen. Et valg (DosageChoiceType). | 
-| | | | | ''MinimumTimesPerDay'' (0-1) || Antal gange dosis som minimum skal indtages. | +| | | | | ''PartOfDayDosage'' ||| Dosering på navngivne tidspunkter på dagen. Valg med øvrige Dosage-typer. | 
-| | | | | ''DuringTheDay'' (0-1) || Dosis skal indtages i løbet af dagen, tidspunkt ikke specificeret. | +| | | | | | ''Morning'' (0-1) || Morgendosis. | 
-| | | | | ''Unlimited'' (0-1) || Dosis må indtages ubegrænses i løbet af dagen. | +| | | | | | ''Noon'' (0-1) || Middagsdosis. | 
-| | | | | ''Quantity'' (0-1) || Mængde, fx ''2'' | +| | | | | | ''Evening'' (0-1) || Aftendosis. | 
-| | | | | ''MinimumQuantity'' (0-1) || Mængde som der som minimum skal anvendes. | +| | | | | | ''Night'' (0-1) || Natdosis. | 
-| | | | | ''MaximumQuantity'' (0-1) || Mængde som der maksimalt må anvendes. | +| | | | | ''TimeOfDayDosage'' ||| Dosering til specifikke klokkeslæt. Valg med øvrige Dosage-typer. | 
-| | | | | ''Duration'' (0-1) || Varighed som dosis skal anvendes over, fx en dosis på 25 ml gives i løbet af 15 minutter. | +| | | | | | ''TimeOfDayDose'' (1-*) || En enkelt klokkeslætsdosis med mængde og tidspunkt. | 
-| | | | | ''MinimumDuration'' (0-1) || Varighed som dosis som minimum skal anvendes over. | +| | | | | | | ''Time'' | Klokkeslæt på formatet HH:MM:SS, fx ''08:00:00''. | 
-| | | | | ''MaxmimumDuration'' (0-1) || Varighed som dosis maksimalt må anvendes over. | +| | | | | ''TimesPerDayDosage'' ||| Dosering et fast antal gange dagligt. Valg med øvrige Dosage-typer. | 
-| | | | | ''InfusionRate'' (0-1) || Indløbshastigheden på infusionsvæsker, fx en dosis på 25 ml indgivet med en indløbshastighed på 100 ml/t. | +| | | | | | ''TimesPerDay'' || Antal gange doseringen gentages på en dag. | 
-| | | | | ''MinimumInfusionRate'' (0-1) || Indløbshastigheden der som minimum skal anvendes. | +| | | | | ''DuringTheDayDosage'' ||| Dosering i løbet af dagen, tidspunkt ikke specificeret. Valg med øvrige Dosage-typer. | 
-| | | | | ''MaximumInfusionRate'' (0-1) || Indløbshastigheden der maksimalt må anvendes. | +| | | | | ''UnlimitedDayDosage'' ||| Dosering uden øvre grænse for antal gange i løbet af dagen. Benyttes ved ubegrænsede PN-doseringer og ved kontinuerlig infusion. | 
-| | | | | ''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. | +| | | | | ''Quantity'' (0-1) ||| Mængde, fx ''2''. Indgår i DoseType som deles af alle Dosage-typer. | 
-| | | ''Profile'' |||| Beskriver doseringsstrukturen. | +| | | | | ''MinimumQuantity'' (0-1) ||| Mængde som der som minimum skal anvendes. | 
-| | | | ''ProfileCode'' ||| Kode med 4 dimensioner der beskriver doseringsstrukturen. | +| | | | | ''MaximumQuantity'' (0-1) ||| Mængde som der maksimalt må anvendes. | 
-| | | | | ''DosageType'' || Angiver typen af behandlingen. | +| | | | | ''Infusion'' (0-1) ||| Angiver infusionsoplysninger for dosen, herunder varighed eller indløbshastighed. | 
-| | | | | ''PeriodType'' || Angiver typen af doseringsperioden. | +| | | | | | ''Duration'' (0-1) || Varighed som dosis skal anvendes over, fx en dosis på 25 ml gives i løbet af 15 minutter. | 
-| | | | | ''Schedule'' || Angiver om doseringser er på specifikke ugedage eller relativ til periodensstart. | +| | | | | | ''MinimumDuration'' (0-1) || Varighed som dosis som minimum skal anvendes over. | 
-| | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. | +| | | | | | ''MaximumDuration'' (0-1) || Varighed som dosis maksimalt må anvendes over. | 
-| | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen. | +| | | | | | ''InfusionRate'' (0-1) || Indløbshastigheden på infusionsvæsker, fx en dosis på 25 ml indgivet med en indløbshastighed på 100 ml/t. | 
-| | | ''DosageTranslation'' |||| Indeholder doseringsstrukturen omsat til textuel representation. | +| | | | | | ''MinimumInfusionRate'' (0-1) || Indløbshastigheden der som minimum skal anvendes. | 
- +| | | | | | ''MaximumInfusionRate'' (0-1) || Indløbshastigheden der maksimalt må anvendes. | 
 +| | | | | ''AccordingToParameterSchema'' (0-1) ||| Angiver hvilket parameterskema der skal bruges til at finde mængden. Tomt element hvis kun ét skema er defineret. | 
 +| | | ''UnspecifiedDay'' (0-1) ||||| Dosering i en PN-struktur der ikke er knyttet til en specifik dag i iterationen. Kræver ''<IterationInterval>'' > 1 i den omsluttende doseringsstruktur. Indeholder ''Dosage'' (DosageChoiceType). | 
 +| | | ''Profile'' ||||| Beskriver doseringsstrukturen. Kun en del af svaret fra FMK. | 
 +| | | | ''ProfileCode'' |||| Kode med 4 dimensioner der beskriver doseringsstrukturen. | 
 +| | | | | ''DosageType'' ||| Angiver typen af behandlingen. | 
 +| | | | | ''PeriodType'' ||| Angiver typen af doseringsperioden. | 
 +| | | | | ''Schedule'' ||| Angiver om doseringer er på specifikke ugedage eller relativ til periodens start. | 
 +| | | | | ''Frequency'' ||| Angiver hvornår på dagen en dosis skal indtages. | 
 +| | | | ''ProfileDescription'' |||| Tekstuel beskrivelse af doseringsprofilen. | 
 +| | | ''DosageTranslation'' ||||| Doseringsstrukturen omsat til tekstuel representation. Kun en del af svaret fra FMK. | 
 +| ''DosageTranslationCombined'' (0-1) ||||||| Samlet tekstuel beskrivelse af alle doseringsperioder i doseringen. Kun en del af svaret fra FMK. |
  
fmk/1.6.0/struktureret_dosering.1776077531.txt.gz · Last modified: by adta
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki