Differences

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

--- fmk:1.6.0:xml-elementer:planlagtadministration [2025-11-17 08:20] – [Indhold] cgza
+++ fmk:1.6.0:xml-elementer:planlagtadministration [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 22: / Line 22: @@
   * Optionelt: ''PlannedAdministrationFixed'' en række doseringsstrukturer for den faste del af administrationsplanen
   * Optionelt: ''PlannedAdministrationPRN'' en række doseringsstrukturer for PN delen af administrationsplanen
+  * Optionelt: ''DispensingEndDate'' en planlagt slutdato for dispensering. Denne er beregnet ud fra doseringsstrukturen på lægemiddelordinationen.
 **Bemærk** Der vil kunne forekomme nogle andre elementer på de planlagte administrationer i nogle services. Fx forekommer et ''ValidWarrant'' element på den planlagte administration, når denne hentes igennem [[fmk:1.6.0:services:hent_dispenseringskort|hent dispenseringskort]] og ''DispensingCardIdentifier'' indgår ikke, da oplysningen er implicit i den situation. Disse afvigelser bør stå i den enkelte services' beskrivelse.
 ==== Bemærkninger ====
 === Tom planlagt administration ===
-Det er muligt at oprette en tom planlagt administration, med dette menes at der hverken angives ''PlannedAdministrationFixed'' eller ''PlannedAdministrationPRN''. Dette kan benyttes til at skabe en relation mellem en lægemiddelordination og et dispenseringskort, signalerende at organisationen bag dispenseringskortet forventer at ville dispensere den pågældnede ordination, men har endnu ikke taget stilling til den egentlige administrationsplan.
+Det er muligt at oprette en tom planlagt administration. Med dette menes, at der hverken angives ''PlannedAdministrationFixed'' eller ''PlannedAdministrationPRN''. Dette kan benyttes til at skabe en relation mellem en lægemiddelordination og et dispenseringskort, signalerende at organisationen bag dispenseringskortet forventer at ville dispensere den pågældnede ordination, men har endnu ikke taget stilling til den egentlige administrationsplan.
-FMK vil råde til at, såfremt det er muligt, benyttes den mulighed ikke. Det er til alles bedste at den egentlige administrationsplan oprettes samtidig, således at administationsplanen bliver synlig for alle parter så hurtigt som muligt. Men såfremt systemet ønsker et workflow hvor alle relevante ordinationer først tilknyttes, og herefter gennemgåes enkeltevis for at oprette administrationsplanen, supporteres dette ved at gøre som nævnt ovenfor.
+FMK vil råde til, at såfremt det er muligt benyttes den mulighed ikke. Det er til alles bedste, at den egentlige administrationsplan oprettes samtidig, således at administrationsplanen bliver synlig for alle parter så hurtigt som muligt. Men såfremt systemet ønsker et workflow, hvor alle relevante ordinationer først tilknyttes, og herefter gennemgåes enkeltvis for at oprette administrationsplanen, supporteres dette ved at gøre som nævnt ovenfor.
 === DosageUnit er optionelt ===
-Dette er primært en fallback, såfremt der hverken på lægemiddelordinationen eller denne PA er angivet en doseringsenhed. I dette tilfælde har FMK faktisk en default til at angive "stk.". Men såfremt dette bliver problematisk i fremtiden, tillader vi os i skemaet at dette felt er optionelt.
+Dette er primært en fallback, såfremt der hverken på lægemiddelordinationen eller den tilhørende planlagte administration er angivet en doseringsenhed. I dette tilfælde har FMK faktisk en default til at angive "stk.". Men såfremt dette bliver problematisk i fremtiden, tillader vi os i skemaet, at dette felt er optionelt.
@@ Line 41: / Line 42: @@
 ===== Oprettet af (Created) =====
-Created-elementet indeholder information omkring aktøren der har oprettet den planlagte administration. Dette element er obligatorisk. Bemærk at den planlagte administration kan være oprettet af en person der ikke er autoriseret sundhedsperson, såfremt personens rolle der giver rettighed hertil og arbejder på vegne af en autoriseret sundhedsperson.
+Created-elementet indeholder information omkring aktøren, der har oprettet den planlagte administration. Dette element er obligatorisk. Bemærk at den planlagte administration kan være oprettet af en person, der ikke er en autoriseret sundhedsperson. Dette er muligt, når personen arbejder på vegne af en autoriseret sundhedsperson.
 Created/DateTime-elementet indeholder tidspunktet for den planlagte administrations oprettelse, som det er registreret af FMK.
@@ Line 49: / Line 50: @@
 ===== Ændret af (Modified) =====
-Elementet Modified indeholder information omkring personen der har oprettet versionen af den planlagte administration, samt tidspunkt.
+Elementet Modified indeholder information omkring personen, der har oprettet versionen af den planlagte administration, samt tidspunkt.
-Er den planlagte administration ændret siden oprettelsen vil der i Modified-elementet blive returneret information omkring personen der har foretaget ændringen, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]].
+Er den planlagte administration ændret siden oprettelsen, vil der i Modified-elementet blive returneret information omkring personen, der har foretaget ændringen, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]].
 Modified/DateTime indeholder tidspunktet for seneste ændring, som det er registreret af FMK.
-Der returneres "ændret af" for seneste ændring. Er der sket ændringer mellem oprettelsen og seneste ændring vil disse ikke blive returneret (f.eks. i form af yderligere ”Modified”-elementer), men skal søges i de tidligere versioner. Modified vil kun være knyttet til versionen af den planlagte administration.
+Der returneres "ændret af" for seneste ændring. Er der sket ændringer mellem oprettelsen og seneste ændring, vil disse ikke blive returneret (f.eks. i form af yderligere ”Modified”-elementer), men skal søges i de tidligere versioner. Modified vil kun være knyttet til versionen af den planlagte administration.
@@ Line 69: / Line 70: @@
 I ''DrugMedication'' elementet findes informationer fra [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordinationen]] som den planlagte administration er tilknyttet. Bemærk at dette kan være en historisk version af lægemiddelordinationen, også selvom man kigger på den seneste version af den planlagte administration.
-Det forventes at de personer som står bag den planlagte administration (og dispenseringskortet som den kan være tilknyttet) holder den planlagte administration up-to-date med lægemiddelordinationen. Det vil i realiteten sige at når lægemiddelordinationen opdateres, vil det være påkrævet at der laves en opdatering af den planlagte administration, såfremt den stadig er relevant for patientens dispensering.
+Det forventes, at de personer, som står bag den planlagte administration (og dispenseringskortet som den kan være tilknyttet), holder den planlagte administration up-to-date med lægemiddelordinationen. Det vil i realiteten sige, at når lægemiddelordinationen opdateres, vil det være påkrævet, at der laves en opdatering af den planlagte administration, såfremt den stadig er relevant for patientens dispensering.
 ===== Dispensingskort =====
-I et ''DispensingCardIdentifier'' element kan der være angivet ID'et på det dispenseringskort som den planlagte administration er tilknyttet. FMK forventer at i de fleste tilfælde vil denne værdi være angivet, da det er et krav at en planlagt administration er tilnyttet et dispenseringskort, såfremt orgnisationen ønsker at foretage en egentlig dispenserings af den planlagte administration for en given periode.
+I et ''DispensingCardIdentifier'' element kan der være angivet ID'et på det dispenseringskort, som den planlagte administration er tilknyttet. FMK forventer, at i de fleste tilfælde vil denne værdi være angivet, da det er et krav, at en planlagt administration er tilknyttet et dispenseringskort, såfremt organisationen ønsker at foretage en egentlig dispenserings af den planlagte administration for en given periode.
 ===== Indtagelsesvejledning =====
-I elementet ''AdministrationInstruction'' kan der angives en indtagelsesvejledning, såfremt dette er relevant. Er oftest benyttet ved apoteket og dosisdispensering, såfremt en given pose fx skal indtages specifikt ved måltid el.lign. Feltet er optionelt såfremt der ikke behøves nogen speciel instruktion i hvordan medicinen bør indtages.
+I elementet ''AdministrationInstruction'' kan der angives en indtagelsesvejledning, såfremt dette er relevant. Er oftest benyttet ved apoteket og dosisdispensering, såfremt en given pose fx skal indtages specifikt ved måltid el.lign. Feltet er optionelt og kan anvendes, når der er behov for en speciel instruktion i, hvordan medicinen bør indtages.
 ===== Doseringsenhed =====
-I elementet ''DosageUnit'' kan der angives en doseringsenhed for den planlagte dispensering. Oftests vil denne stemme overens med doseringsenheden fra lægemiddelordinationen.
+I elementet ''DosageUnit'' kan der angives en doseringsenhed for den planlagte dispensering. Oftest vil denne stemme overens med doseringsenheden fra lægemiddelordinationen.
-**Bemærk** dog at Apoteket ved dosisdispensering i mange tilfælde altid foretrækker at angive deres doseringer i "Stk." og ikke i formen for lægemidlet fx "Tablet".
+**Bemærk** dog at Apoteket, ved dosisdispensering, i mange tilfælde foretrækker at angive deres doseringer i "Stk." og ikke i formen for lægemidlet fx "Tablet".
 ===== Administrationsplanen =====
 Elementerne ''ValidFrom'', ''PlannedAdministrationFixed'' og ''PlannedAdministrationPRN'' udgør tilsammen den samlede administrationsplan for den pågældende lægemiddelordination.
-''ValidFrom'' markere tidspunktet hvor planen er gyldig fra, det der før 1.6.0 kunne antages at være Doseringsstart. Denne er tilknyttet den enkelte version af den planlagte administration, dvs den kan ændres imellem versioner. Oftest ved opdatering bør denne angives til dags-dato, alternativt til en dato i fremtiden, såfremt administrationen først begynder der.
+''ValidFrom'' markerer tidspunktet for, hvornår planen er gyldig fra, det der før 1.6.0 kunne antages at være Doseringsstart. Denne er tilknyttet den enkelte version af den planlagte administration, dvs. den kan ændres imellem versioner. Ved opdatering bør denne oftest angives til dags-dato, alternativt til en dato i fremtiden, såfremt administrationen først begynder i fremtiden.
-''PlannedAdministrationFixed'' udfyldes med administrationsplaner for den faste del af doseringen. Elementet indeholder en række ''PlannedAdministrationStructure'' elementer, som hver udgør en administrationsperiode af en given længde (eller uendelig). Ligsom på [[fmk:1.6.0:struktureret_dosering|struktureret dosering]] er rækkefølgen på disse vigtig, da den første angivne periode altid er den man starter med, og den sidste angivne "afslutter" administrationsplanen.
+''PlannedAdministrationFixed'' udfyldes med administrationsplaner for den faste del af doseringen. Elementet indeholder en række ''PlannedAdministrationStructure'' elementer, som hver udgør en administrationsperiode af en given længde (eller uendelig). Ligesom på [[fmk:1.6.0:struktureret_dosering|struktureret dosering]] er rækkefølgen på disse vigtig, da den første angivne periode altid, er den der begyndes med, og den sidste angivne "afslutter" administrationsplanen.
 ''PlannedAdministrationPRN'' er magen til ''PlannedAdministrationFixed'', men råder over PN delen af doseringen.
@@ Line 96: / Line 97: @@
   * Optionelt: angivelse af en række ''Day'' elementer.
-**Bemærk** I 1.4.X havde man en dedikeret ''EmptyStructure'' struktur som signalerede at man havde en periode uden en administrationsplan. Dette ændres til at man i 1.6.0 blot udlader at angive nogle eller alle felterne. Hvis der er tale om en fastsat periode, så angives kun ''PeriodLength''. Såfremt der er tale om en tom periode uden slut, angivet et helt tomt element.
+**Bemærk** I 1.4.X havde man en dedikeret ''EmptyStructure'' struktur som signalerede, at man havde en periode uden en administrationsplan. Dette ændres til, at der i 1.6.0 blot udlades at angive nogle eller alle felterne. Hvis der er tale om en fastsat periode, så angives kun ''PeriodLength''. Såfremt der er tale om en tom periode uden slut, angivet et helt tomt element.
-''IterationInterval'' anvendes såfremt administrationsplanen gentages efter et givent interval (angivet i dage). ''NotIterated'' anvendes såfremt sin administrationsplan udpensles i de specifikke dage med ''Day''-elementer hele vejen igennem perioden.
+''IterationInterval'' anvendes, såfremt administrationsplanen gentages efter et givent interval (angivet i dage). ''NotIterated'' anvendes såfremt administrationsplanen skal udpensles i de specifikke dage med ''Day''-elementer hele vejen igennem perioden.
-''PeriodLength'' angiver længden af denne administrationsperiode, såfremt administrationsperioden ikke skal afsluttes (i.e. fortsætte uendeligt), undlades dette element.
+''PeriodLength'' angiver længden af en administrationsperiode. Såfremt administrationsperioden ikke skal afsluttes (i.e. fortsætte uendeligt), undlades dette element.
 ''Day'' elementerne udspecificerer doseringerne på de enkelte dage. Disse elementer indeholder:
-  * Et ''Number'' element som udpeger dags-nummeret hvor der skal gives en dose
+  * Et ''Number'' element som udpeger dags-nummeret, hvor der skal gives en dosis.
-  * En række ''Dose'' elementer der angiver de enkelte doser der skal gives.
+  * En række ''Dose'' elementer der angiver de enkelte doseringer, der skal gives.
-''Dose'' elementerne indeholder et "optionelt" ''Time'' element, som udpeger tidspunktet for dosen fx Morgen. Dernæst et optionelt ''SequenceNumber'' element som typisk anvendes ved dosisdispensering til at skille doser på samme tidspunkt ad i forskellige poser. Og til sidst angives et ''Quantity'' element, som angiver mængden af doseringsenheder der gives på det pågældende tidspunkt.
+''Dose'' elementerne indeholder et "optionelt" ''Time'' element, som udpeger tidspunktet for doseringen fx Morgen. Dernæst et optionelt ''SequenceNumber'' element, som typisk anvendes ved dosisdispensering til at skille doseringer på samme tidspunkt ad i forskellige poser. Og til sidst angives et ''Quantity'' element, som angiver mængden af doseringsenheder, der gives på det pågældende tidspunkt.
 **Bemærk** ''Time'' elementerne er optionelle, men det forventes kun at dette supporteres for PN-delen af administrationsplanen.
+===== Eksempel =====
+<file xml PlannedAdministration.xml>
+<PlannedAdministration>
+    <Identifier>121818135</Identifier>
+    <Version>215618138</Version>
+    <Created>
+        <By>
+            <HealthcareProfessional>
+                <Indentifier source="CPR">2012850101</Indentifier>
+                <Name>Hanne Jensen</Name>
+            </HealthcareProfessional>
+            <Role>Apoteksansat</Role>
+            <Organisation>
+                <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
+                <Type>Apotek</Type>
+                <Name>Aarhus Kobbergade Apotek</Name>
+                <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
+                <TelephoneNumber>00000000</TelephoneNumber>
+                <EmailAddress>ABC@XYZ.com</EmailAddress>
+            </Organisation>
+        </By>
+        <DateTime>2025-04-24T17:01:09Z</DateTime>
+    </Created>
+    <DrugMedication>
+        <Identifier>8183183183</Identifier>
+        <Version>7484358138</Version>
+    </DrugMedication>
+    <ValidWarrant>
+        <Identifier>823823231231</Identifier>
+        <ValidFromDate>2025-04-20</ValidFromDate>
+        <ValidToDate>2026-12-12</ValidToDate>
+    </ValidWarrant>
+    <DosageUnit>
+        <DosageUnitText>stk</DosageUnitText>
+    </DosageUnit>
+    <AdministrationInstruction>Efter måltid</AdministrationInstruction>
+    <ValidFrom>2025-04-24</ValidFrom>
+    <PlannedAdministrationFixed>
+        <PlannedAdministrationStructure>
+            <IterationInterval>1</IterationInterval>
+            <Day>
+                <Number>1</Number>
+                <Dose>
+                    <Time>noon</Time>
+                    <SequenceNumber>1199999</SequenceNumber>
+                    <Quantity>1</Quantity>
+                </Dose>
+                <Dose>
+                    <Time>night</Time>
+                    <SequenceNumber>299999</SequenceNumber>
+                    <Quantity>1</Quantity>
+                </Dose>
+            </Day>
+        </PlannedAdministrationStructure>
+    </PlannedAdministrationFixed>
+</PlannedAdministration>
+</file>