User Tools

Site Tools


fmk:1.6.0:struktureret_dosering

This is an old revision of the document!


Struktureret dosering, FMK 1.6.0

Indledning

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.

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.

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.
  • 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.
  • 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

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 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.
  • DosagePeriod er et nyt koncept i 1.6.0-snitfladen. Doseringsperioder grupperer strukturerede faste og PN-doseringer 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 returneres der også en profil for hver struktureret dosering. Profilen skal gøre det nemmere for klienter at håndtere svaret fra FMK, fx i forbindelse med visning. Profilkoden kan bruges til nemt at kategorisere typen af dosering.

Eksempel på overordnet struktur

<DosageForRequest>
  <Precondition>Detaljer udeladt for simplicitet</Precondition>
  <UnitTexts>Detaljer udeladt for simplicitet</UnitTexts>
  <Parameter>Detaljer udeladt for simplicitet</Parameter>
  <DosagePeriod>
    <PeriodLength>n</PeriodLength>
    <Fixed>Detaljer udeladt for simplicitet</Fixed>
    <PRN>Detaljer udeladt for simplicitet</PRN>
  </DosagePeriod>
  <DosagePeriod>Detaljer udeladt for simplicitet</DosagePeriod>
</DosageForRequest>

De enkelte elementer er beskrevet i yderligere detaljer i senere afsnit.

Se også Eksempler på strukturerede doseringer.

Dosering (Dosage)

Skemadefinition for dosering i request-elementer og 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.

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.
  • <MinimumDurationBetweenDosagePeriod> (Optionel) angiver minimumstid før en ny periode må starte. Værdien angives i positivt helt antal dage.

Precondition

Skemadefinition for precondition request og precondition response

En <Precondition> beskriver kriterier for at doseringen som helhed må påbegyndes.

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 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 strukturerede doseringer, det er ikke muligt længere. Strukturerede doseringer indgår nu som en del af doseringsperioder hvor startdatoen 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
  • <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.
  • <EpisodicTreatment>: TBD

Udover gyldighedsdatoen kan tilføjes yderligere en af fælgende betingelser:

<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.

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.

<PreconditionRequest>
  <ValidFrom>...</ValidFrom>
  <UpdateValidFromUponHandover/>
  <FreeText>...</FreeText>
</PreconditionRequest>

Doseringsenheden (DosageUnit)

Skemadefinition for enhedstekst og enhedstekst i ental og flertal anvendes i både anmodning og svar.

  • <DosageUnit> elementet anvendes til at angive enheden for doseringen. Herunder anvendes:
  • <UnitText> anvendes til at angive én enhedstekst, fx ml.
  • <UnitTexts> anvendes til at angive enhedstekster i en- og flertal (fx tablet og tabletter), i de to underelementer <Singular> og <Plural>.

Selvadministreret (IsSelfAdministration)

Skemadefinition for Selv administreret 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”.

Parameterskema (Parameter)

Der kan for en dosering defineres en eller flere parameterskemaer. Se dokumentation af parameterskema

Doseringsperiode (DosagePeriod)

Skemadefinition for Doseringsperiode for anmodning og Doseringsperiode for svar som begge bygge på 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. 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.
  • <PeriodLengthFreeText> som alternativ til <PeriodLength> kan der angives angiver længden af doseringsperioden i hele dage.
  • <Fixed> angiver en fast doseringsstruktur som er gældende for denne doseringsperiode.
  • <PRN> angiver en PN doseringsstruktur som er gældende for denne doseringsperiode.

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.

<DosagePeriodForResponse>
  <PRN>...</PRN>
  <Fixed>...</Fixed>
  <PeriodLength>...</PeriodLength>
  <PeriodLengthFreeText>...</PeriodLengthFreeText>
</DosagePeriodForResponse>

Doseringsperiode længde (PeriodLength)

Skemadefinition for doseringsperiode længde alternativt doseringsperiode læ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

Struktureret dosering (DosageStructure)

Skemadefinition for doseringsstruktur ved anmodning og 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. Som beskrevet ovenfor i Doseringsperiode kan hver periode bestå af én fast og én PN. Det angives altså på perioden hvilken type dosering der er tale om.

For hver doseringsstruktur kan der angives følgende:

  • <Restriction> Restriktioner specifikt til den aktuelle doseringsstruktur.
  • <Instruction> Fritekstbeskrivelse af hvordan lægemiddelet skal anvendes (fx i højre øje). Der må ikke angives instruktioner der er påvirker behandlingen (fx ved smerter dobbelt dosis)
  • <IterationInterval> Bruges ved behandling hvor dosis i en enkelt struktureret behandling gentages indtil doseringsperioden eller lægemiddelordinationen udløber. Ved behandling hver 2. dag skal fx angives iterationsinterval 2 og 1 dagsdosis på daynumber 1.
  • <Day>, <Empty> eller <Unspecified> En af disse, evt flere <Day> elementer kan angives. <Day> elementer angiver doseringer for specifikke dage i perioden. Typen beskrives yderligere i det efterfølgende. <Empty> og <Unspecified> er begge tomme doseringer. <Empty> betyder at der ingen behandling er i perioden og at det ikke forventes at der efterfølgende defineres en behandling. <Unspecified> betyder, at der er planlagt behandling, men at den specifikke behandling skal revurderes af en læge, inden perioden starter.

Udover ovenstående, vil der i svar fra FMK også indgå følgende:

  • <Profile> indeholder profilkoden for den strukturerede dosering. Beskrives yderligere i det efterfølgende.
  • <EndDate> FMK vil beregne slutdatoen for den strukturerede dosering hvis det er muligt. I tilfælde hvor der ikke er angivet startdato på første doseringsperiode eller slutdato på sidste doseringsperiode vil det ikke være muligt.
  • <DosageTranslation> Vil indeholde en tekstuel beskrivelse af den strukturerede dosering

Herunder kan ses et eksempel på en doseringsstruktur som det bliver returneret fra FMK. Eksemplet er ikke skema validt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.

<DosageStructureForResponse>
  <IterationInterval>...</IterationInterval>
  <Restriction>...</Restriction>
  <Instruction>...</Instruction>
  <Empty/>
  <Unspecified/>
  <Day>...</Day>
  <Day>...</Day>
  <Day>...</Day>
 
  <Profile>...</Profile>
  <EndDate>...</EndDate>
  <DosageTranslation>...</DosageTranslation>
</DosageStructureForResponse>

Doseringsrestriktioner (Restriction)

Skemadefinition for 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:

  • <MaximumDailyDose> maksimal daglig dosis
  • <MinimumDurationBetweenDoses> minimumstid mellem doser angivet i minutter

Doseringsinstruktion (Instruction)

Skemadefinition for 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.

Iterationsinterval (IterationInterval)

Skemadefinition for 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.

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.

Doseringsangivelse

Skemadefinitioner for Day, Empty, Unspecified og Dose.

En struktureret dosering kan indeholde et eller flere <Day> elementer, som definerer doseringerne pr. dag. Disse kan enten være relative til periodens startdato eller knyttet til specifikke ugedage. Fortolkningen angives af profilkoden. Hvis der ikke er specificeret en dosering i en given periode, skal <Day> elementet udelades og enten <Empty> eller <Unspecified> anvendes i stedet. <Empty> skal bruges hvis der i perioden ikke er og at der ikke forventes at komme medicinering. <Unspecified> skal bruges til at angive at der på 'nuværende tidspunkt' ikke er en kendt dosering, men det forventes at lægen angiver en dosering.

<Day> elementer kan indeholde enten <WeekdayLabel> eller <Index> og ét eller flere <Dose> elementer

  • <WeekdayLabel> angiver ugedagen via en enumeration Monday, Tuesday osv. Anvendes elementet svarer dette til '…med en eller flere doser på ugedage i doseringsprofilen.
  • <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 doseringsprofilen.

Værdien må aldrig være større end værdien af <IterationInterval>, hvis denne er angivet.

<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>.

Frekvens kan angives med:

  • <TimeOfDay> der angiver morgen, middag, aften, nat eller et specifikt klokkeslæt for en dosis
  • <TimesPerDay> der angiver hvor mange gange om dagen doseringen skal indtages
  • <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:

  • <Quantity> mængden der doseres
  • <MinimumQuantity> minimum dosis
  • <MaximumQuantity> maksimum dosis

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 maksimum 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 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.

<AccordingToParameterSchema> bruges, som alternativ til Quantity-elementerne mm, til at referere et 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.

<Day>
  <WeekdayLabel>...</WeekdayLabel>
  <Index>...</Index>
  <Dose>
    <TimeOfDay>...</TimeOfDay>
    <TimesPerDay>...</TimesPerDay>
    <DuringTheDay/>
    <Unlimited/>
    <MinimumTimesPerDay>...</MinimumTimesPerDay>
    <MaximumTimesPerDay>...</MaximumTimesPerDay>
 
    <Quantity>...</Quantity>
    <MinimumQuantity>...</MinimumQuantity>
    <MaximumQuantity>...</MaximumQuantity>
 
    <Duration>...</Duration>
    <MinimumDuration>...</MinimumDuration>
    <MaximumDuration>...</MaximumDuration>
 
    <InfusionRate>...</InfusionRate>
    <MinimumInfusionRate>...</MinimumInfusionRate>
    <MaximumInfusionRate>...</MaximumInfusionRate>
 
    <AccordingToParameterSchema>...</AccordingToParameterSchema>
  </Dose>
  <Dose>...</Dose>
  <Dose>...</Dose>
</Day>

Doseringsprofil (Profile)

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. Doseringsprofiler returneres som en del af svar fra FMK der indeholder doseringer. En Profile(Code) indeholder 4 elementer på nedenstående format

<Profile>
  <ProfileCode>
    <DosageType>...</DosageType>
    <PeriodType>...</PeriodType>
    <Schedule>...</Schedule>
    <Frequency>...</Frequency>
  </ProfileCode>
  <ProfileDescription>...</ProfileDescription>
</Profile>

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
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
periode uden medicinindtag valgfri dag i perioden i løbet af dagen
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”.

Værdien af <ProfileDescription> vil være en tekstuel representation af profilkoden

I kald til FMK er det ikke muligt at angive doseringsprofil.

Doseringsperioder

Skemadefinition for doseringsperiode i request og 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 === 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 dokumentation af doseringsprofil. I kald til FMK angives doseringsprofilen ikke. ===Doseringsrestriktioner=== Skemadefinition for 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 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.

Dosisperiodelængde

Skemadefinition for dosisperiodelængde alternativt 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 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 Day, Empty, Unspecified og 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 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 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 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
Precondition (0-1) Betingelse der skal være opfyldt, før doseringen må startes.
ValidFrom (0-1) Doseringsstartdato.
PredefinedCondition (0-1) Bruges hvis doseringen er gyldig fra udleveringstidspunktet. Gyldig værdi er Medicine in possession.
FreeText (0-1) Fritekst beskrivelse af betingelse.
EpisodicTreatment Angivelse om at doseringen tilhører en PN-kur
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.
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.
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.
Singular Enhed for dosering i ental, fx kapsel, dråbe 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.
StructureFixed | StructurePRN (0-1) Rod-element for en struktureret dosering. Typen af element afgør om det er en henholdsvis Fast eller PN dosering.
Parameter (0-n) Anvendes ved parametriserede doseringer efter skema.
ParameterName Navn på måleparameteren (fx Blodglukoseværdi).
ParameterLabel (0-1) Label på parametergruppen hvis flere er angivet (fx Natdoser).
ParameterUnit Måleparameterens enhed.
ParameterUnitText Måleparameterens enhed (fx mmol/l).
ParameterSchema Enhed for dosering i ental, fx kapsel, dråbe m.v.
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.
Value Værdi for hvilken Quantity er gældende.
MinimumValue (0-1) Minimumsværdi (inkl.) hvor Quantity er gældende.
MinimumValueInclusive (0-1) Minimumsværdi (inkl.) hvor Quantity er gældende.
MinimumValueExclusive (0-1) Minimumsværdi (eks.) hvor Quantity er gældende.
MaximumValue (0-1) Maksimumsværdi (inkl.) hvor Quantity er gældende.
MaximumValueInclusive (0-1) Maksimumsværdi (inkl.) hvor Quantity er gældende.
MaximumValueExclusive (0-1) Maksimumsværdi (eks.) hvor Quantity er gældende.
AssessedValue (0-1) Tekstbeskrivelse af subjektiv vurdering.
Quantity (0-1) Doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten Value, MinimumValue, MaximumValue eller AssessedValue).
MinimumQuantity (0-1) Minimum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten Value, MinimumValue, MaximumValue eller AssessedValue).
MaximumQuantity (0-1) Maximum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten Value, MinimumValue, MaximumValue eller AssessedValue).
DosagePeriod (1-*) En eller flere doseringsperioder.
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.
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”.
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.
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).
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.
Index (1) Dagens indeks (indenfor doseringsperioden alternativt ugedagsnummer, afhængig af 2. dimension i den valgte profil kode.
Dose (1-*) Dosis.
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.
MinimumTimesPerDay (0-1) Hvor mange gange i døgnet dosis som minimum skal anvendes.
MaximumTimesPerDay (0-1) Hvor mange gange i døgnet dosis maksimalt må anvendes.
Quantity (0-1) Mængde, fx 2
MinimumQuantity (0-1) Mængde som der som minimum skal anvendes.
MaximumQuantity (0-1) Mængde som der maksimalt må anvendes.
Duration (0-1) Varighed som dosis skal anvendes over, fx en dosis på 25 ml gives i løbet af 15 minutter.
MinimumDuration (0-1) Varighed som dosis som minimum skal anvendes over.
MaxmimumDuration (0-1) Varighed som dosis maksimalt må anvendes over.
InfusionRate (0-1) Indløbshastigheden på infusionsvæsker, fx en dosis på 25 ml indgivet med en indløbshastighed på 100 ml/t.
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 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.
UnableToCalculateEndDate (0-1) Tomt element der indikerer at det ikke er muligt at beregne en slutdato.
CalculatedEndDate (0-1) Indholder den beregnede slutdato for perioden i formatet yyyy-MM-dd.
DosageTranslation Indeholder periodedoseringen omsat til textuel representation. Er udelukkende en del af response payload.
fmk/1.6.0/struktureret_dosering.1769667309.txt.gz · Last modified: (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki