====== Hent historikken for en lægemiddelordination ======

Servicen kan beregne og returnere en fuld historik for en [[fmk:1.6.0:xml-elementer:Lægemiddelordinationer|lægemiddelordination]]. Servicen udtaler sig om hvilket lægemiddel og hvilken dosering, der var aktuel i den version som var aktiv, hvis man slog op på FMK i en given periode. Historikken starter fra oprettelse af ordinationen frem til og med den nuværende version. Historikken viser også pauseringer og indlæggelser. Hvis patienten er indlagt samtidig med en pausering, vil det optræde som en indlæggelse i historikken.

Det vil fejle, hvis man forespørger på historikken for en [[fmk:generel:privatmarkering|privatmarkeret]] lægemiddelordination, såfremt der ikke er angivet [[fmk:1.6.0:xml-elementer:soap_header_--_specifikt_omkring_samtykke|samtykke]].

==== Forespørgsel ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getdrugmedicationhistoryrequesttype|Request]] 

I forespørgsel angives ''PersonIdentifier'' for patient. Hvis lægemiddelordinationen er udstedt til en organisation angives i stedet ''OrganisationIdentifier'' for denne.

Dernæst angives ''Identifier'' for lægemiddelordination. 

<code xml GetDrugMedicationHistoryRequest.xml>

<GetDrugMedicationHistoryRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <Identifier>1221231331123</Identifier>
</GetDrugMedicationHistoryRequest>

</code>

==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getdrugmedicationhistoryresponsetype|Response]] 

I svaret vises først den angivne ''PersonIdentifier'' eller ''OrganisationIdentifier'' fra request. Dernæst forekommer ''Identifier'' på lægemiddelordinationen. 

Henæst vises historikken som et ''History''-element indeholdende en række kronologisk sorterede ''Period''-elementer. Disse indeholder hver:
  * ''PeriodStartDateTime'', dato og tidspunkt for periodens start
  * ''PeriodEndDateTime'', dato og tidspunkt for periodens slut
  * ''Version'', versionsnummeret for denne historiske version af lægemiddelordinationen
  * ''Drug'', informationer om lægemidlet. Se evt. [[fmk:1.6.0:xml-elementer:Lægemiddel|Lægemiddel]]
  * ''Dosage'', informationer om dosering. Se evt. [[fmk:1.6.0:xml-elementer:Dosering|Doseringer]]
  * Optionelt: ''Paused'', indikation af at lægemiddelordinationen er pauseret i denne periode
  * Optionelt: ''Hospitalized'', indikation af at patienten var indlagt i denne periode. Ved indlæggelse angives også kontakt-information som et <Organisation> element.


<code xml GetDrugMedicationHistoryResponse.xml>
<GetDrugMedicationHistoryResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <Identifier>1221231331123</Identifier>
    <History>
        <Period>
            <PeriodStartDateTime>2015-01-05T09:46:34.0Z</PeriodStartDateTime>
            <PeriodEndDateTime>2015-01-10T08:46:34.0Z</PeriodEndDateTime>
            <Version>1342404077657004001</Version>
            <Drug>
                <Identifier source="Medicinpriser" date="2015-01-06">28100902276</Identifier>
                <Name>Primcillin</Name>
                <ATC>
                    <Code source="Medicinpriser" date="2015-01-06">J01CE02</Code>
                    <Text>Phenoxymethylpenicillin</Text>
                </ATC>
                <Form>
                    <Code source="Medicinpriser" date="2015-01-06">TABFILM</Code>
                    <Text>filmovertrukne tabletter</Text>
                </Form>
                <Strength>
                    <StrengthItem>
                        <Value>400.0</Value>
                        <UnitCode source="Medicinpriser" date="2015-01-06">MG</UnitCode>
                        <UnitText>milligram</UnitText>
                    </StrengthItem>
                </Strength>
            </Drug>
            <Dosage>
                <Precondition>
                    <StartDate>2023-12-22</StartDate>
                </Precondition>
                <UnitTexts>
                    <Singular>tablet</Singular>
                    <Plural>tabletter</Plural>
                </UnitTexts>
                <StructureFixed>
                    <DosagePeriod>
                        <IterationInterval>1</IterationInterval>
                        <Day>
                            <Index>1</Index>
                            <Dose>
                                <TimeOfDay>morning</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                           <Dose>
                                <TimeOfDay>evening</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                        </Day>
                        <Profile>
                            <ProfileCode>
                                <DosageType>Fast</DosageType>
                                <PeriodType>Repeating</PeriodType>
                                <Schedule>Non-specific weekdays</Schedule>
                                <Frequency>Morning, noon, evening, night</Frequency>
                            </ProfileCode>
                            <ProfileDescription>Fast daglig gentaget dosering med en eller flere doser morgen/middag/aften/nat</ProfileDescription>
                        </Profile>
                        <EndDate>
                            <Unknown/>
                        </EndDate>
                        <DosageTranslation>
                            <ShortText>2 tabletter morgen og aften</ShortText>
                            <LongText>Doseringsforløbet starter lørdag den 22. december 2023 og gentages hver dag:
                            Doseringsforløb:
                            2 tabletter morgen og aften</LongText>
                            <AverageDailyDosage>4</AverageDailyDosage>
                        </DosageTranslation>
                    </DosagePeriod>
                 </StructureFixed>
                 <DosageTranslationCombined>
                    ...
                 </DosageTranslationCombined>
            </Dosage>
        </Period>
        <Period>
            <PeriodStartDateTime>2015-01-10T08:46:34.0Z</PeriodStartDateTime>
            <PeriodEndDateTime>2015-01-12T10:46:34.0Z</PeriodEndDateTime>
            <Version>1616499805421001288</Version>
            <Drug>
                <Identifier source="Medicinpriser" date="2015-01-06">28100902276</Identifier>
                <Name>Primcillin</Name>
                <ATC>
                    <Code source="Medicinpriser" date="2015-01-06">J01CE02</Code>
                    <Text>Phenoxymethylpenicillin</Text>
                </ATC>
                <Form>
                    <Code source="Medicinpriser" date="2015-01-06">TABFILM</Code>
                    <Text>filmovertrukne tabletter</Text>
                </Form>
                <Strength>
                    <StrengthItem>
                        <Value>400.0</Value>
                        <UnitCode source="Medicinpriser" date="2015-01-06">MG</UnitCode>
                        <UnitText>milligram</UnitText>
                    </StrengthItem>
                </Strength>
            </Drug>
            <Dosage>
                <Precondition>
                    <StartDate>2023-12-22</StartDate>
                </Precondition>
                <UnitTexts>
                    <Singular>tablet</Singular>
                    <Plural>tabletter</Plural>
                </UnitTexts>
                <StructureFixed>
                    <DosagePeriod>
                        <IterationInterval>1</IterationInterval>
                        <Day>
                            <Index>1</Index>
                            <Dose>
                                <TimeOfDay>morning</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                           <Dose>
                                <TimeOfDay>evening</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                        </Day>
                        <Profile>
                            <ProfileCode>
                                <DosageType>Fast</DosageType>
                                <PeriodType>Repeating</PeriodType>
                                <Schedule>Non-specific weekdays</Schedule>
                                <Frequency>Morning, noon, evening, night</Frequency>
                            </ProfileCode>
                            <ProfileDescription>Fast daglig gentaget dosering med en eller flere doser morgen/middag/aften/nat</ProfileDescription>
                        </Profile>
                        <EndDate>
                            <Unknown/>
                        </EndDate>
                        <DosageTranslation>
                            <ShortText>2 tabletter morgen og aften</ShortText>
                            <LongText>Doseringsforløbet starter lørdag den 22. december 2023 og gentages hver dag:
                            Doseringsforløb:
                            2 tabletter morgen og aften</LongText>
                            <AverageDailyDosage>4</AverageDailyDosage>
                        </DosageTranslation>
                    </DosagePeriod>
                 </StructureFixed>
                 <DosageTranslationCombined>
                    ...
                 </DosageTranslationCombined>
            </Dosage>
            <Paused/>
        </Period>
        <Period>
            <PeriodStartDateTime>2015-01-15T12:50:34.0Z</PeriodStartDateTime>
            <PeriodEndDateTime>2015-02-18T14:40:34.0Z</PeriodEndDateTime>
            <Version>1343404077657004001</Version>
            <Drug>
                <Identifier source="Medicinpriser" date="2015-01-06">28100902276</Identifier>
                <Name>Primcillin</Name>
                <ATC>
                    <Code source="Medicinpriser" date="2015-01-06">J01CE02</Code>
                    <Text>Phenoxymethylpenicillin</Text>
                </ATC>
                <Form>
                    <Code source="Medicinpriser" date="2015-01-06">TABFILM</Code>
                    <Text>filmovertrukne tabletter</Text>
                </Form>
                <Strength>
                    <StrengthItem>
                        <Value>400.0</Value>
                        <UnitCode source="Medicinpriser" date="2015-01-06">MG</UnitCode>
                        <UnitText>milligram</UnitText>
                    </StrengthItem>
                </Strength>
            </Drug>
            <Dosage>
                <Precondition>
                    <StartDate>2023-12-22</StartDate>
                </Precondition>
                <UnitTexts>
                    <Singular>tablet</Singular>
                    <Plural>tabletter</Plural>
                </UnitTexts>
                <StructureFixed>
                    <DosagePeriod>
                        <IterationInterval>1</IterationInterval>
                        <Day>
                            <Index>1</Index>
                            <Dose>
                                <TimeOfDay>morning</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                           <Dose>
                                <TimeOfDay>evening</TimeOfDay>
                                <Quantity>2</Quantity>
                            </Dose>
                        </Day>
                        <Profile>
                            <ProfileCode>
                                <DosageType>Fast</DosageType>
                                <PeriodType>Repeating</PeriodType>
                                <Schedule>Non-specific weekdays</Schedule>
                                <Frequency>Morning, noon, evening, night</Frequency>
                            </ProfileCode>
                            <ProfileDescription>Fast daglig gentaget dosering med en eller flere doser morgen/middag/aften/nat</ProfileDescription>
                        </Profile>
                        <EndDate>
                            <Unknown/>
                        </EndDate>
                        <DosageTranslation>
                            <ShortText>2 tabletter morgen og aften</ShortText>
                            <LongText>Doseringsforløbet starter lørdag den 22. december 2023 og gentages hver dag:
                            Doseringsforløb:
                            2 tabletter morgen og aften</LongText>
                            <AverageDailyDosage>4</AverageDailyDosage>
                        </DosageTranslation>
                    </DosagePeriod>
                 </StructureFixed>
                 <DosageTranslationCombined>
                    ...
                 </DosageTranslationCombined>
            </Dosage>
            <Hospitalized>
                <Organisation>
                    <Identifier source="SKS">7026320</Identifier>
                    <Type>Sygehus</Type>
                    <Name>Klinisk Mikrobiologisk afdeling</Name>
                    <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                    <AddressLine>Århus N</AddressLine>
                    <TelephoneNumber>+4589495566</TelephoneNumber>
                    <EmailAddress>kontakt@regionmidtjylland.dk</EmailAddress>
                </Organisation>
            </Hospitalized>
        </Period>
    </History>
</GetDrugMedicationHistoryResponse>
</code>