Fælles Medicinkort - Dokumentation

User Tools

Site Tools

You are here: start » fmk » generel » struktureret_dosering
fmk:generel: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:generel:struktureret_dosering [2017-11-29 08:26] – [Elementer i strukturerede doseringer] uskfmk:generel:struktureret_dosering [2026-03-06 08:53] (current) – external edit 127.0.0.1
Line 5: Line 5:
 I afsnittet [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse]] findes en beskrivelse af hvorledes der kan dannes menneskeligt læsbare tekster ud fra de strukturerede doseringer.  I afsnittet [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse]] findes en beskrivelse af hvorledes der kan dannes menneskeligt læsbare tekster ud fra de strukturerede doseringer. 
  
-===== Format for strukturerede doseringer =====+For beskrivelse af strukturerede doseringer fra FMK 1.4.4 og tidligere, se [[fmk:generel:struktureret_dosering_144|Struktureret dosering, FMK 1.4.4 og derover]]
  
-//Bemærk at dette afsnit beskriver FMKs strukturerede doseringer som de findes i FMK 1.4.2 og FMK 1.4.4. Antallet af doseringstyper i FMK 1.4.4 og fremefter er reduceret (se [[#Type af dosering]]), men ellers er formatet for struktureret dosering, bortset fra namespace, ens i FMK 1.4.2 og FMK 1.4.4. For 1.2.6 se dokumentet [[fmk:1.2.6:fmk_1.2.6_snitflade|FMK 1.2.6 snitflade]], for 1.4.0 se [[fmk:1.4.0:fmk_1.4.0_snitflade|FMK 1.4.0 snitflade]].//+For beskrivelse af strukturerede doseringer for FMK 1.4.6, se [[fmk:generel:struktureret_dosering_146|Struktureret dosering, FMK 1.4.6 og derover]]
  
-Doseringsinformation på medicinkortet på FMK skal fortrinsvis angives på struktureret form. Strukturerede doseringer kan anvendes til både simple doseringer, f.eks. en engangsdosis, medicinering efter behov (”1 stk ved smerter”), en løbende dosering ("1 stk 3 gange daglig") eller til at opbygge et doseringsskema , evt. til op- eller nedtrapning. +For beskrivelse af strukturerede doseringer for FMK 1.6.0, se [[fmk:generel:struktureret_dosering_160|Struktureret dosering, FMK 1.6.0 og derover]]
  
-Se også [[.dosering:Eksempler på strukturerede doseringer]].+Der findes et antal valideringsregler, der skal overholdes ved oprettelse af strukturerede doseringer. Disse er beskrevet særskilt på denne side: [[Valideringsregler, strukturerede doseringer]]
  
-Der kan angives et antal doseringsperioder med efterfølgende strukturerede doseringer på en lægemiddel­ordination, hvor følgende krav skal overholdes:  +Endvidere beskrives håndteringen af tomme perioder (EmptyPeriods) i et særskilt afsnit: [[Håndtering af EmptyPeriods i responses]]
- +
-  * Doseringerne skal efterfølge hinanden uden ”huller”. Skal der i en periode ikke foretages en dosering skal dette eksplicit angives ved at oprette en periode med en tom doseringsstruktur.  +
- +
-  * Med undtagelse af følgende regel må doseringer ikke være overlappende: Doseringer der ikke indeholder doser efter behov må overlappe doseringer der udelukkende indeholder doser efter behov. I så fald skal PN doseringens start- og slutdatoer være sammenfaldende med start- og slutdato for en eller to af de øvrige doseringer.  +
- +
-  * Doseringer med flere perioder angives altid med samme enhed.  +
- +
-  * Doseringer indeholdende PN og ikke-PN skal oprettes som to overlappende perioder. For doseringer hvor dette ikke er gjort vil FMK splitte doseringen.  +
- +
-===== Elementer i strukturerede doseringer ===== +
- +
-Doseringen på struktureret form angives som defineret i XML-skemaet Structures (navngivet DosageStructures.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.  +
- +
-| Structures ||||| Rod-elemetet for en eller flere den strukturerede doseringer  | +
-|  | UnitText |||| Enheden for dosering. 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 |||| Såfremt enheden for dosering skal angives en ental og flertal anvendes UnitTexts i stedet for UnitText. Enhederne angives i felterne herunder. | +
-| | | Singular ||| Enhed for dosering i ental, f.eks. kapsel, dråbe m.v. | +
-| | | Plural ||| Enhed for dosering i flertal, f.eks. kapsler, dråber m.v. | +
-| | Structure |||| Rod-elemetet for en enkelt struktureret dosering (en doserings-periode) | +
-| | | IterationInterval ||| Værdien angiver efter hvor mange dage doseringen i de følgende Day-elementer skal gentages. F.eks. angiver 1 at doseringen er den samme hver dag, 7 at doseringen er den samme hver uge. | +
-| | | NotIterated ||| I stedet for et IterationInterval kan der angives at doseringen ikke er itereret. Angives dette gentages doseringen ikke. Doseringer der ikke er itererede anvendes f.eks. ti en engangsdosis, en op- eller nedtrapning eller ved en ren dosering efter behov (dvs. hvor der ikke er et antal mulige daglige doseringer efter behov, men hvor doseringen kan tages efter behov uden begrænsning). I tidligere skemaversioner er den tilsvarende konstruktion lavet ved at IterationInterval er sat til 0. | +
-| | | StartDate ||| Dato for hvornår doseringen skal begynde (inklusiv). | +
-| | | StartDateTime ||| [[fmk:1.4.4:tidsangivelser_i_doserings-_og_behandlingsperioder_udgar|Ikke muligt efter FMK 1.4.2]] Alternativt dato og tidspunkt for hvornår doseringen skal begynde. Denne variant anvendes først og fremmest ved overførsel af information fra EPJ-systemer. Bemærk, at tiden skal kun sættes hvor det er klinisk relevant, og ikke blot fordi kildesystemet angiver værdien med dato og tid (inklusiv). | +
-| | | EndDate ||| Dato for hvornår doseringen skal ophøre (inklusiv). | +
-| | | EndDateTime ||| [[fmk:1.4.4:tidsangivelser_i_doserings-_og_behandlingsperioder_udgar|Ikke muligt efter FMK 1.4.2]] Alternativt dato og tidspunkt for hvornår doseringen skal ohøre. Denne variant anvendes først og fremmest ved overførsel af information fra EPJ-systemer. Bemærk, at tiden skal kun sættes hvor det er klinisk relevant, og ikke blot fordi kildesystemet angiver værdien med dato og tid (inklusiv). | +
-| | | DosageEnding­Undetermined ||| I stedet for EndDate og EndDateTime kan dette element anvendes. Doseringen er således gyldig til lægemiddel­ordi­na­tion­ens ophørsdato, indtil læge­middel­­ordinationen ændres eller seponeres, eller indtil der ikke findes flere Day-elementer med en dosis. I tidligere skemaversioner er den tilsvarende konstruktion lavet ved at EndDate og EndDateTime er udeladt. | +
-| | | Supplementaty­Text ||| Eventuel supplerende fritekst. F.eks. ”2 dråber daglig i højre øje” hvis f.eks. administrations­vej eller lægemiddel­form ikke i sig selv giver tilstrækkelig information. Bemærk at den supplerende tekst ikke må ændre dosering­ens værdi, f.eks. er det ikke hensigts­mæssigt at angive en struktureret dosering på "2 dråber" og i den supplerende tekst angive "i hvert øje". | +
-| | | Day ||| Et eller flere Day-elementer der grupperer doseringer på dage. Doseringer foretaget samme dag skal således grupperes under samme Day-element, og forekommer der flere Day-elementer skal disse sorteres efter dagsnummer (hvilket dog ikke kan valideres i skemadefinitionen, men valideres ved kald til FMK). | +
-| | | | DayNumber || Værdien angiver dagens nummer i forløbet. Er doseringen gentaget (dvs. at et Iteration­Interval er angivet) skal dagens nummer være mindre eller lig med denne. DayNumber anvendes til itererede doseringer (f.eks. ”1 tablet daglig”) og til ikke-itererede doseringer , dvs. hvor doseringen ikke gentaget (NotIterated er anvendt). Herved angives en ikke-gentagen dosering, f.eks. en en­gangs­dosering (”til injektion ved lægen”) eller f.eks. en op- eller nedtrapning ("Dag 1: 2 tablet, Dag 2: 1 tabletter). | +
-| | | | Dose || Hver dag der optræder i doseringen indeholder en eller flere doseringer. | +
-| | | | | Time | En dosis kan optionelt være angivet til at ske til et bestemt tidspunkt, hvilket angives i Time-elementet. Time kan indeholde en af de faste tekster ”morning”, ”noon”, ”evening” og ”night” eller et tidspunkt. Tidspunkt skal kun anvendes, når det har klinisk betydning hvornår de enkelte doser gives. Dvs. der kan angives tider for dosering af lægemidlet, der skal ikke angives tider hvor disse udelukkende gælder administration. Se evt. mere om tidspunkter i doseringer på [[fmk:generel:dosering:former_for_daglige_doser|Former for daglige doser]]. Forekommer elementet ikke skal den angive dosis tages en gang daglig (evt. efter behov). | +
-| | | | | Quantity | Den numeriske dosis angives i Quantity-elementet. Dosisangives i intervallet, 0.00 - 99999999.99. Enheden er defineret samlet for alle doseringer i UnitText. | +
-| | | | | MinimalQuantity | Som alternativ til en numerisk dosis kan der angives et interval i MinimalQuantity- og MaximalQuantity-elementerne. Begge er inklusive, og skal altid angives. Eksempelvis for en dosering ”1-2 tabletter ved smerter” | +
-| | | | | MaximalQuantity |Se herover | +
-| | | | | IsAccording­ToNeed | Flaget angiver at denne dosis kan tages efter behov (som en del af en PN-dosering). | +
-| | | AnyDay ||| Som alternativ til Day kan der angives et enkelt AnyDay-element. Indholdet af AnyDay svarer til Day, bortset fra at DayNumber ikke defineres, og IsAccordingToNeed skal forekomme. AnyDay anvendes i de tilfælde hvor doseringsstrukturen skal angive en dosering der kan ske vilkårlig, dvs. at det er en udelukkende PN-dosering. I tidligere skemaversioner er den tilsvarende konstruktion lavet ved at DayNumber er sat til 0. Et AnyDay-element med iterationsinterval 1 eller et som ikke er itereret har samme betydning som et tilsvarende Day-element. **Eksempel:** Et AnyDay-element, som indgår i et iterationsinterval på 7 og har Quantity 2 betyder "2 tabletter en gang om ugen, efter behov".  | +
-| | | //DosageTranslation// ||| //Doseringsoversættelse for den enkelte strukturerede dosering elementet findes på. Findes kun på skema ved opslag på FMK.// | +
-| | | | //ShortText// || //Kort doseringsoversættelse// | +
-| | | | //LongText// || //Lang doseringsoversættelse// | +
-| | | | //AverageDailyDosage// || //Gennemstnitlig dagsdosis, alternativ minimal og maximal:// | +
-| | | | //MinimalAverageDailyDosage// || //Minimum gennemsnitlig dagsdosis// | +
-| | | | //MaximalAverageDailyDosage// || //Maksimal gennemsnitlig dagsdosis// | +
-| | EmptyStrucure |||| Elementet angiver en periode uden dosering | +
-| | | StartDate ||| Som StartDate herover | +
-| | | StartDateTime ||| [[fmk:1.4.4:tidsangivelser_i_doserings-_og_behandlingsperioder_udgar|Ikke muligt efter FMK 1.4.2]] Som StartDateTime herover | +
-| | | EndDate ||| Som EndDate herover | +
-| | | EndDateTime ||| [[fmk:1.4.4:tidsangivelser_i_doserings-_og_behandlingsperioder_udgar|Ikke muligt efter FMK 1.4.2]] Som EndDateTime herover | +
-| | | DosageEnding­Undetermined ||| Som DosageEnding­Undetermined herover | +
-| | DosageTranslationCombined |||| // Doseringsoversættelse for den samlede strukturerede dosering. Findes kun på skema ved opslag på FMK, og returneres kun hvis der er mere end et enkelt Structure-element.// | +
-| | | //ShortText// ||| //Kort doseringsoversættelse for den samlede dosering (produceres typisk ikke, idet max. længde for dette felt er 70 tegn).// | +
-| | | //LongText// ||| //Lang doseringsoversættelse for den samlede dosering // | +
-| | | //AverageDailyDosage// ||| //Gennemstnitlig dagsdosis for den samlede dosering, alternativ minimal og maximal:// | +
-| | | //MinimalAverageDailyDosage// ||| //Minimum gennemsnitlig dagsdosis for den samlede dosering// | +
-| | | //MaximalAverageDailyDosage// ||| //Maksimal gennemsnitlig dagsdosis for den samlede dosering// | +
- +
-==== Doseringsoversættelser i den strukturerede dosering ==== +
- +
-Doseringsoversættelserne er generelt beskrevet under [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse]]. +
- +
-Ved opslag på medicinkort eller lægemiddelordination vil FMK returnere en eller flere doserings­oversættelser.  +
- +
-Elementet ”Structure” vil indeholde doseringsoversættelser for den periode af den strukturerede dosering som elementet findes på. Findes der mere end en enkelt struktureret dosering vil elementet ”Structures” desuden indeholde en samlet doseringsoversættelse for alle perioder. Er der kun en enkelt struktureret dosering vil elementet være udleladt.   +
- +
-Der blive returneret en lang tekst i LongText-elementerne. Denne indeholder doseringstiderne, en evt. dosering efter behov samt en linje for hver dag der doseres, dvs. en linje for hver Day-element i den strukturerede dosering. +
- +
-For en del af de hyppigst anvendte typer af doseringer kan doseringsstrukturen oversættes til en kort tekst i ShortText-elementet. Dette vil dog ikke altid være muligt, f.eks. for komplicerede doseringer eller doseringer der generelt falder uden for de strukturer der hyppigst anvendes i taksten.  +
- +
-For doseringer der ikke er efter behov (dvs. at elementet IsAccordingToNeed ikke forekommer) kan der beregnes en [[Gennemsnitlig daglig dosering]]. Værdien for den gennemsnitlige daglige dosering angives i elementet AverageDailyDosage, og enheden herfor i elementet UnitText. Såfremt der doseringen helt eller delvist er angivet i intervaller (i MinimalQuantity og MaximalQuantity) returneres i stedet en minimum- og maksimum­værdi i MinimalAverageDailyDosage og MaximalAverageDailyDosage. +
- +
-==== Supplerende tekst ==== +
- +
-Der kan være nødvendigt at dosering suppleres med fritekst, f.eks. "2 dråber daglig i venstre øje". Der er her egentlig ikke tale om en ren dosering, men en dosering suppleret med en administrationsvej, en betingelse eller en vejledning. Det er herved vigtigt at doseringen i strukturen ikke ændres, f.eks. er doseringen "2 dråber daglig i begge øjne" ikke lovlig, idet friteksten "i begge øjne" fordobler den angivne dosering. Teksten skal i stedet være f.eks. "4 dråber daglig (2 dråber i hvert øje)", hvor teksten i parentes er en fritekst.  +
- +
-==== Doseringstidspunkter ==== +
- +
-De eksakte doseringstidspunkter i Time-elementet udgør en særlig udfordring i forhold til entydig definition. Et givet klokkeslæt skal præsenteres ens, uafhængigt af om det er sommer- eller vintertid. Værktøjerne (f.eks. Axis, kan ikke skelne). Vi definerer derfor, at der skal angives en tidszone for doseringstidspunkter. Følgende lidt specielle fortolkning anvendes derudover: +
- +
-  * Ved skrivning af doseringstidspunkter kompenseres kun for tidszonen, IKKE for eventuel Sommertid. +
- +
-  * Ved læsning af data gælder selvfølgelig vice versa. +
- +
-Rent praktisk vil dette betyde at skrevne og læste tidspunkter skal justeres med en time hvis man på læse- eller skrivetidspunktet befinder sig i sommertid. +
- +
-==== Type af dosering ==== +
- +
-Ved opslag på en dosering der er angivet på struktureret vis vil FMK afgøre doseringens type og returnere denne, se herunder. Ved oprettelse eller opdatering af en lægemiddelordination vil den angivne type blive valideret såfremt den er angivet på den strukturerede dosering, er den ikke ens med den af FMK beregnede dosering vil FMK returnere en fejlbesked.  +
- +
-=== Doseringstyper, før FMK 1.4.4 === +
- +
-FMK anvender nedenstående definitioner af typer af doseringer: +
- +
-| engangs  | En dosering med kun en enkelt dosis, der ikke gives efter behov. | +
-| temporær | En dosering med en slutdato eller en dosering der ikke er gentaget (elementet NotIterated er anvendt i stedet for IterationInterval). Desuden skal doseringen ikke helt eller delvist gives efter behov. | +
-| fast | En itereret dosering uden slutdato, der ikke helt eller delvist gives efter behov. | +
-| efter behov | En dosering der udelukkende gives efter behov. Doseringen kan evt. have en begrænsning på en maksimal dagsdosis. | +
-| kombineret | En dosering der både gives (temporært eller fast) og efter behov. | +
-| ikke angivet | Anvendes for doseringer oprettet gennem versioner før FMK 1.4, og hvor det ikke er muligt at bestemme typen, dvs. at doseringen er som fritekst eller som ”efter skema i lokalt system”. Der kan ikke oprettes doseringer med typen ”ikke angivet” via FMK 1.4. | +
- +
-=== Doseringstyper, fra FMK 1.4.4 og efterflg. === +
- +
-FMK 1.4.4 og derover anvender nedenstående definitioner af typer af doseringer: +
- +
-| fast | En dosering, der ikke helt eller delvist gives efter behov. | +
-| efter behov | En dosering der udelukkende gives efter behov. Doseringen kan evt. have en begrænsning på en maksimal dagsdosis. | +
-| kombineret | En dosering der både gives fast og efter behov. | +
-| ikke angivet | Anvendes for doseringer oprettet gennem versioner før FMK 1.4, og hvor det ikke er muligt at bestemme typen, dvs. at doseringen er som fritekst eller som ”efter skema i lokalt system”. Der kan ikke oprettes doseringer med typen ”ikke angivet” via FMK 1.4.4. | +
- +
-Doseringer oprettet i tidl. versioner af FMK med type 'engangs' eller 'temporær' vil ved læsning via FMK 1.4.4 have typen 'fast'.+
fmk/generel/struktureret_dosering.1511943968.txt.gz · Last modified: (external edit)
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki