Differences

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

--- fmk:1.6.0:struktureret_dosering [2026-02-02 10:10] – [Doseringsperioder] chsk
+++ fmk:1.6.0:struktureret_dosering [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 38: / Line 38: @@
     <Fixed>...</Fixed>
     <PRN>...</PRN>
+    <EndDate>...</EndDate>
   </DosagePeriod>
   <DosagePeriod>...</DosagePeriod>
@@ Line 78: / Line 79: @@
 for en doseringsperiode beregnes ud fra gyldighedsdatoen og summen af tidligere perioders varighed.
-Felter til alm. fast og PN doserigner:
+Felter til alm. fast og PN doseringer:
   * ''<ValidFrom>'': Bruges til at angive gyldig-fra på formatet yyyy-MM-dd for hele doseringen. Hvis doseringen er itereret, vil datoen være gældende for den første behandling.
   * ''<UpdateValidFromUponHandover>'': Flag der angiver at FMK skal holde gyldig-fra opdateret, indtil at det ud fra system events formodes at behandlingen er startet. I tilfælde af en itereret behandling hvor ''<UpdateValidFromUponHandover>'' er sat, vil gyldig-fra udelukkende blive opdateret indtil første iteration af behandlingen antages for påbegyndt.
@@ Line 117: / Line 118: @@
 Doseringen kan markeres med et ''IsSelfAdministration''-flag, hvis patienten selv administrerer medicinen. Anvendes typisk ved selvadministreret VKA behandlinger. I tidligere snitflader var selvadministrerede VKA dosering angive med en fritekst-dosering hvor starten af teksten var "Selvstyrende".
-===Parameterskema (Parameter) ===
-Der kan for en dosering  defineres en eller flere parameterskemaer. Se [[fmk:1.6.0:struktureret_dosering:parameterskema|dokumentation af parameterskema]]
@@ Line 138: / Line 134: @@
   * ''<Fixed>'' angiver en fast doseringsstruktur som er gældende for denne doseringsperiode.
   * ''<PRN>'' angiver en PN doseringsstruktur som er gældende for denne doseringsperiode.
+  * ''<EndDate>'' FMK vil beregne slutdatoen for doseringsperioden hvis det er muligt. I tilfælde hvor der ikke er angivet startdato på første doseringsperiode eller slutdato på sidste doseringsperiode vil det ikke være muligt.
 Herunder kan ses et eksempel på en doseringsperiode som den bliver returneret fra FMK. Eksemplet er ikke skema validt eftersom alle elementer fremgår og indhold i elementerne mangler. Hensigten med eksemplet er at vise strukturen.
@@ Line 146: / Line 143: @@
   <PeriodLength>...</PeriodLength>
   <PeriodLengthFreeText>...</PeriodLengthFreeText>
+  <EndDate>...</EndDate>
 </DosagePeriodForResponse>
 </code>
@@ Line 182: / Line 180: @@
   * ''<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
@@ Line 199: / Line 196: @@
   <Profile>...</Profile>
-  <EndDate>...</EndDate>
   <DosageTranslation>...</DosageTranslation>
 </DosageStructureForResponse>
@@ Line 344: / Line 340: @@
 I nedenstående skema kan de mulige værdier for hvert felt under ''<ProfileCode>'' findes (se skema-valide værdier i feltbeskrivelser).
-^ Kode (del) ^ DosageType  ^ PeriodType                 ^ Schedule                            ^ Frequency                    ^
+^ DosageType  ^ PeriodType                 ^ Schedule                            ^ Frequency                    ^
-|            | Fast        | gentaget periode           | med en eller flere daglige doser    | morgen, middag, aften og nat |
+| Fast        | gentaget periode           | med en eller flere daglige doser    | morgen, middag, aften og nat |
-|            | PN          | ikke-gentaget periode      | med en eller flere doser på ugedage | på klokkeslæt                |
+| PN          | ikke-gentaget periode      | med en eller flere doser på ugedage | på klokkeslæt                |
-|            |             | periode uden medicinindtag | valgfri dag i perioden              | i løbet af dagen             |
+|             | periode uden medicinindtag |                                     | i løbet af dagen             |
-|            |             | uspecificeret periode      |                                     | uden døgnbegrænsning         |
+|             | uspecificeret periode      |                                     | uden døgnbegrænsning         |
 Skemaet skal læses, sådan at en dosering er defineret ved at sammensætte en doseringstype, periodetype, skematype og en frekvenstype. Dog er ikke alle sammensætninger gyldige. Fx har en dosering "1 tablet morgen og aften" profilen "fast gentaget periode med en eller flere daglige doser morgen, middag, aften og nat".
@@ Line 357: / Line 353: @@
+===Parameterskema (Parameter) ===
+Der kan for en dosering  defineres en eller flere parameterskemaer. Se [[fmk:1.6.0:struktureret_dosering:parameterskema|dokumentation af parameterskema]]
-==== 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.
+==== Elementer i en struktureret dosering ====
+Elementer hvor andet ikke fremgår, er kardinaliteten 1.
 | **Element** |||||| **Beskrivelse** |
-| ''Precondition'' (0-1)|||||| Betingelse der skal være opfyldt, før doseringen må startes. |
+| ''IsSelfAdministration'' (0-1) |||||| Markerer at lægemidlet er til patientens selvadministration. |
+| ''Precondition'' |||||| Betingelse der skal være opfyldt, før doseringen må startes. |
 | | ''ValidFrom'' (0-1)||||| Doseringsstartdato. |
-| | ''PredefinedCondition'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. Gyldig værdi er ''Medicine in possession''. |
+| | ''UpdateValidFromUponHandover'' (0-1)||||| Bruges hvis doseringen er gyldig fra udleveringstidspunktet. FMK vil opdatere ''ValidFrom'' ved events |
-| | ''FreeText'' (0-1)||||| Fritekst beskrivelse af betingelse. |
+| | ''FreeText'' (0-1)||||| Fritekst beskrivelse af betingelse for PN doseringsstrukturer. |
 | | ''EpisodicTreatment''||||| Angivelse om at doseringen tilhører en PN-kur |
 | | | ''Trigger'' |||| Betingelse der skal være opfyldt, før PN-kuren må startes. |
@@ Line 379: / Line 378: @@
 | | ''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. |
+| ''Parameter'' (0-n) |||||| Anvendes ved parametriserede doseringer efter skema. |
-| ''StructureFixed'' %%|%% ''StructurePRN'' (0-1) |||||| Rod-element for en struktureret dosering. Typen af element afgør om det er en henholdsvis Fast eller PN dosering. |
+| | ''ParameterName'' ||||| Navn på måleparameteren (fx ''Blodglukoseværdi''). |
-| | ''Parameter'' (0-n) ||||| Anvendes ved parametriserede doseringer efter skema. |
+| | ''ParameterLabel'' (0-1) ||||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). |
-| | | ''ParameterName'' |||| Navn på måleparameteren (fx ''Blodglukoseværdi''). |
+| | ''ParameterUnit'' ||||| Måleparameterens enhed. |
-| | | ''ParameterLabel'' (0-1) |||| Label på parametergruppen hvis flere er angivet (fx ''Natdoser''). |
+| | | ''ParameterUnitText'' |||| Måleparameterens enhed (fx ''mmol/l''). |
-| | | ''ParameterUnit'' |||| Måleparameterens enhed. |
+| | ''ParameterSchema'' ||||| Enhed for dosering i ental, fx kapsel, dråbe m.v. |
-| | | | ''ParameterUnitText'' ||| Måleparameterens enhed (fx ''mmol/l''). |
+| | | ''ParametricQuantity'' (1-n) |||| Beskriver en indgang i doseringsskemaet, kan være givet enten ved en enkelt værdi (da anvendes Quantity, alternativt ved et interval hvor MinValue/MaxValue anvendes. Sidste mulighed er AssessedValue som angiver en subjektiv vurdering. |
-| | | ''ParameterSchema'' |||| Enhed for dosering i ental, fx kapsel, dråbe m.v. |
+| | | | ''FromValue'' (0-1) ||| Fra-værdien for hvornår denne ''ParametricQuantity'' er gældende. |
-| | | | ''ParametricQuantity'' ||| Beskriver en indgang i doseringsskemaet, kan være givet enten ved en enkelt værdi (da anvendes Quantity, alternativt ved et interval hvor MinValue/MaxValue anvendes. Sidste mulighed er AssessedValue som angiver en subjektiv vurdering. |
+| | | | ''Criterion'' (0-1) ||| Fritekstkriterie beskrivelse for hvornår denne ''ParametricQuantity'' er gældende. |
-| | | | ''Value'' ||| Værdi for hvilken ''Quantity'' er gældende. |
+| | | | ''Quantity'' (0-1) ||| Doseringsværdi der skal anvendes. |
-| | | | ''MinimumValue'' (0-1) ||| Minimumsværdi (inkl.) hvor ''Quantity'' er gældende. |
+| | | | ''MinimumQuantity'' (0-1) ||| Minimum doseringsværdi der skal anvendes. |
-| | | | ''MinimumValueInclusive'' (0-1) ||| Minimumsværdi (inkl.) hvor ''Quantity'' er gældende. |
+| | | | ''MaximumQuantity'' (0-1) ||| Maximum doseringsværdi der skal anvendes. |
-| | | | ''MinimumValueExclusive'' (0-1) ||| Minimumsværdi (eks.) hvor ''Quantity'' er gældende. |
+| | | | ''Instruction'' (0-1) ||| Fritekstinstruktion hvis der ikke kan angives en mængde. |
-| | | | ''MaximumValue'' (0-1) ||| Maksimumsværdi (inkl.) hvor ''Quantity'' er gældende. |
+| ''DosagePeriod'' (1-n) |||||| Anvendes til at definere en doseringsperiode hvori der kan defineres fast og eller PN dosering. |
-| | | | ''MaximumValueInclusive'' (0-1) ||| Maksimumsværdi (inkl.) hvor ''Quantity'' er gældende. |
+| | ''PeriodLength'' (0-1) ||||| Længden på doseringsperioden i hele dage. |
-| | | | ''MaximumValueExclusive'' (0-1) ||| Maksimumsværdi (eks.) hvor ''Quantity'' er gældende. |
+| | ''PeriodLengthFreeText'' (0-1) ||||| Alternativ til PeriodLength. Angiver tekstuelt hvad er afgør, at en periode afsluttes, typisk et subjektivt kriterie som, fx ''når du ikke længere har ondt''. |
-| | | | ''AssessedValue'' (0-1) ||| Tekstbeskrivelse af subjektiv vurdering. |
+| | ''EndDate'' |||| | Beregnet slutdato for doseringsperioden. Kun en del af svaret fra FMK |
-| | | | ''Quantity'' (0-1) ||| Doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). |
+| | | ''CalculatedEndDate'' (0-1) |||| Slutdatoen, hvis denne kan beregnes |
-| | | | ''MinimumQuantity'' (0-1) ||| Minimum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). |
+| | | ''Unknown'' (0-1) |||| Flag der angiver, at det ikke er muligt at beregne slutdato. |
-| | | | ''MaximumQuantity'' (0-1) ||| Maximum doseringsværdi der skal anvendes, hvis kriteriet er opfyldt (altså enten ''Value'', ''MinimumValue'', ''MaximumValue'' eller ''AssessedValue''). |
+| | ''Fixed'' (0-1) ||||| Doseringsstruktur til angivelse af den faste doseringsstruktur i doseringsperioden. |
-| | ''DosagePeriod'' (1-*) ||||| En eller flere doseringsperioder. |
+| | ''PRN'' (0-1) ||||| Doseringsstruktur til angivelse af PN doseringsstrukturen i doseringsperioden. |
-| | | ''Profile'' |||| Beskriver doseringens karakteristika. |
-| | | | ''ProfileCode'' ||| Kode med 4 dimensioner der angiver hhv. 1) fast/PN/PN-kur behandling 2) engangs/gentaget/tom/uspecificeret 3) dagsdosering/ugedagsdosering 4) morgen/middag/aften/nat/tidspunkt/i løbet af dagen/uden døgnbegrænsning). 3. og 4. dimension kan også være N/A hvis de ikke er relevante i forhold til den anden dimension.|
-| | | | | ''DosageType'' || Angiver typen af hele behandlingen. Gyldige værdier er: ''Fast'', ''PN'' og ''PN-kur''. |
-| | | | | ''PeriodType'' || Angiver typen af doseringsperiode.  Gyldige værdier er: ''Repeating'', ''Non-repeating'', ''Empty'', ''Unspecified''. |
-| | | | | ''Schedule'' || Angiver om de beskrevne doseringer i denne periode skal indtages på specifikke ugedage eller om doseringen er relativ til hvornår borgeren begynder indtagelsen af doseringen. Gyldige værdier er: ''Specific weekdays'' og ''Non-specific weekdays''.  |
-| | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. Gyldige værdier: ''Morning, noon, evening, night'', ''Specific time'', ''During the day'' og ''No frequency limit''. |
-| | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen - kun ved læsninger. |
 | | | ''Restriction'' (0-1) |||| Begrænsning i anvendelsen af lægemidlet. |
 | | | | ''MaximumDailyDose'' (0-1) ||| Maksimal døgndosis, fx ''10'' tabletter. |
@@ Line 412: / Line 404: @@
 | | | ''Instruction'' (0-1) |||| Instruktion der præciserer anvendelsen af lægemidlet. Anvendes hvis administrationsvej eller lægemiddelform ikke i sig selv giver tilstrækkelig information. Bemærk at instruktionsteksten ikke må ændre doseringens værdi, fx er det ikke hensigtsmæssigt at angive en struktureret dosering på ''2 dråber'' og i instruktionsteksten angive ''i hvert øje''. |
 | | | | ''FreeText'' ||| Selve fritekst instruktionen, fx ''i højre øje''. |
-| | | ''PeriodLength'' (0-1) |||| Doseringsperiodelængde. Sidste periode behøver ikke en periodelængde, mens alle øvrige perioder skal have en periodelængde som enten antal dage eller fritekst. Er givet implicit ved ikke-gentagede doseringer som antallet af doseringsdage i en periode, men hvis en periode skal afsluttes med et antal dage uden doseringer, inden en ny periode påbegyndes, skal periodelængden angives (eks.: periodelængde = 7, 5 doseringsdage angivet, dermed skal lægemidlet ikke anvendes de sidste 2 dage af perioden). |
+| | | ''IterationInterval'' (0-1) |||| Gentages efter antal dage, for ugentligt gentagede skal IterationInterval være deleligt med 7. |
-| | | ''PeriodLengthFreeText'' (0-1) |||| Alternativ til PeriodLength. Angiver tekstuelt hvad er afgør, at en periode afsluttes, typisk et subjektivt kriterie som, fx ''når du ikke længere har ondt''.  |
-| | | ''IterationInterval'' |||| Gentages efter antal dage, for ugentligt gentagede skal IterationInterval være deleligt med 7. |
 | | | ''Day'' (0-*) |||| De enkelte daglige doser, kan udelades ved tomme doseringsperioder.|
-| | | | ''Index'' (1) ||| Dagens indeks (indenfor doseringsperioden alternativt ugedagsnummer, afhængig af 2. dimension i den valgte profil kode. |
+| | | | ''WeekdayLabel'' (0-1) ||| Specifik ugedag, fx tirsdag, hvor dose skal indtages. |
+| | | | ''Index'' (0-1) ||| Dagens indeks, hvor 1 er første dag i doseringsperioden. Det kan ikke antages, at 1 er mandag. |
 | | | | ''Dose'' (1-*) ||| Dosis. |
 | | | | | ''TimeOfDay'' (0-1) || Tidspunkt for dosis, fx ''morning'' eller ''10:00''. |
-| | | | | ''TimesPerDay'' (0-1) || Antal gange doseringen gentages på en dag (kun for doseringer af typen ''i løbet af dagen'' d.v.s. profiltypen *.*.*.3. |
+| | | | | ''TimesPerDay'' (0-1) || Antal gange doseringen gentages på en dag |
-| | | | | ''MinimumTimesPerDay'' (0-1) || Hvor mange gange i døgnet dosis som minimum skal anvendes. |
+| | | | | ''MaximumTimesPerDay'' (0-1) || Antal gange dosis maksimalt må indtages. |
-| | | | | ''MaximumTimesPerDay'' (0-1) || Hvor mange gange i døgnet dosis maksimalt må anvendes. |
+| | | | | ''MinimumTimesPerDay'' (0-1) || Antal gange dosis som minimum skal indtages. |
+| | | | | ''DuringTheDay'' (0-1) || Dosis skal indtages i løbet af dagen, tidspunkt ikke specificeret. |
+| | | | | ''Unlimited'' (0-1) || Dosis må indtages ubegrænses i løbet af dagen. |
 | | | | | ''Quantity'' (0-1) || Mængde, fx ''2'' |
 | | | | | ''MinimumQuantity'' (0-1) || Mængde som der som minimum skal anvendes. |
@@ Line 432: / Line 425: @@
 | | | | | ''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. |
+| | | ''Empty'' (0-1) |||| Angiver at der for denne doseringsstruktur ikke er dosis der skal indtages.|
-| | | | ''UnableToCalculateEndDate'' (0-1) ||| Tomt element der indikerer at det ikke er muligt at beregne en slutdato.  |
+| | | ''Unspecified'' (0-1) |||| Angiver at der for denne doseringsstruktur endnu ikke er bestemt dosis, men det forventes der skal defineres en dosis.|
-| | | | ''CalculatedEndDate'' (0-1) ||| Indholder den beregnede slutdato for perioden i formatet ''yyyy-MM-dd''.  |
+| | | ''Profile'' |||| Beskriver doseringsstrukturen. |
-| | | ''DosageTranslation'' |||| Indeholder periodedoseringen omsat til textuel representation. Er udelukkende en del af response payload. |
+| | | | ''ProfileCode'' ||| Kode med 4 dimensioner der beskriver doseringsstrukturen. |
+| | | | | ''DosageType'' || Angiver typen af behandlingen. |
+| | | | | ''PeriodType'' || Angiver typen af doseringsperioden. |
+| | | | | ''Schedule'' || Angiver om doseringser er på specifikke ugedage eller relativ til periodensstart. |
+| | | | | ''Frequency'' || Angiver hvornår på dagen en dosis skal indtages. |
+| | | | ''ProfileDescription'' ||| Tekstuel beskrivelse af doseringsprofilen. |
+| | | ''DosageTranslation'' |||| Indeholder doseringsstrukturen omsat til textuel representation. |