====== Hent patient relationer ======

Opslaget på relation foregår altid på et CPR-nummer i et ''PersonIdentifier'' element.

Det er muligt at filtrere i resultatet på 2 måder. Enten ved angivelse af specifikke ID'er som ønsket hentet ved brug af ''Identifier'' elementer. Alternativt kan der filtreres på Organisation og Relations-type med anvendelsen af ''OrganisationIdentifier'' og ''Type'' elementer. I begge scenerier kan der angives mere end 1 værdi. Ønskes der ikke filtrering bør ingen af værdierne angives.

For eventuelle fremtidige typer kan det af sikkerhedsmæssige hensyn være nødvendigt at FMK filtrerer på visse typer, f.eks. således at der ikke generelt er adgang for alle sundhedspersoner til at slå op på typer som f.eks. ”under behandling på misbrugscenter”.

Herefter kan der angives et ''IncludeRemovedRelations'' element, dette signalere overfor FMK at man også ønsker at henter historiske relationer som sidenhen er blevet fjernet. Dette kan være hjælpsomt ved tvivlspørgsmål og udbedring af fejlsituationer.

==== Forespørgsel ====

[[fmk:patientregistration-inline_2022_01_01:feltbeskrivelser#GetPatientOrganisationRelationRequestType|Request]]


=== Eksempel: Opslag ud fra organisationsid og type af relation ===

Nedenstående eksempel viser opslag på et antal organisationer og typer af relationer. Der returneres alle registreringer der matcher en af de fire organisations-ID'er og hvor typen af relation er enten "Visiteret til hjemmesygeplejen" eller "Indlagt".

<file xml GetPatientOrganisationRelationRequest.xml>
<GetPatientOrganisationRelationRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <OrganisationIdentifier source="SOR">952581000016000</OrganisationIdentifier>
    <OrganisationIdentifier source="SOR">952591000016003</OrganisationIdentifier>
    <OrganisationIdentifier source="SOR">951681000016008</OrganisationIdentifier>
    <OrganisationIdentifier source="SOR">952081000016007</OrganisationIdentifier>
    <Type>Visiteret til hjemmesygeplejen</Type>
    <Type>Indlagt</Type>
</GetPatientOrganisationRelationRequest>
</file>

=== Eksempel: Opslag ud fra relations-ID  ===

Alternativt kan der slås op på en eller flere ID'er for relationer. De to typer af forespørgsler om nødvendigt kombineres, f.eks. for at se status af eksisterende relationer eller check for ophævede relationer>

<file xml GetPatientOrganisationRelationRequest-2.xml>
<GetPatientOrganisationRelationRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <Identifier>12313213211001001</Identifier>
</GetPatientOrganisationRelationRequest>
</file>

==== Svar ====

[[fmk:patientregistration-inline_2022_01_01:feltbeskrivelser#GetPatientOrganisationRelationResponseType|Response]]

I svaret returneres i dette eksempel tre relationer. 

For hver relation returneres først relationens ID. Herefter hvem der har oprettet relationen i ''CreatedBy'' og evt. hvem der har indrapporteret relationen i ''ReportedBy''. Se evt. [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]].

Har man angivet ''IncludeRemovedRelations'' i sit request, vil det også være muligt at få relationer tilbage som indeholder et ''RemovedBy'' element, som udpeger den person/det system som har fjernet relationen.

I Organisation-elementet herefter returneres information omkring organisationen patienten har en relation til, og endeligt Typen af relation. I øjeblikket understøttes typerne "Visiteret til medicinadministration", "Indlagt" og "Foretrukket apotek".

Hvis patientrelationen har angivet en gyldighedsperiode, forekommer denne som et ''ValidityPeriod''-element. Sidst kan der forekomme yderligere oplysninger i ''PatientRelationMetadata''; i øjeblikket dækker dette kun over foretrukket udleveringssted. Da det endnu ikke er fastlagt, hvordan FMK vedligeholder oplysninger om apotekers tilknyttede udleveringssteder, har det nedenstående eksempel på ''PreferredDeliverySite'' en ukendt source på identifier.

<file xml GetPatientOrganisationRelationResponse.xml>
<GetPatientOrganisationRelationResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <Relation>
        <Identifier>12313213211001001</Identifier>
        <Created>
            <By>
                <HealthcareProfessional>
                    <Identifier source="CPR">1111111118</Identifier>
                    <Name>Karl Karlsen</Name>
                </HealthcareProfessional>
                <Role>Kommunal ansat til medicinhåndtering</Role>
                <Organisation>
                    <Identifier source="SOR">1236661000016007</Identifier>
                    <Type>hjemmeplejeenhed</Type>
                    <Name>Hjemmesygeplejen i Skanderborg kommune</Name>
                    <AddressLine>Adelgade 42</AddressLine>
                    <TelephoneNumber>86504202</TelephoneNumber>
                    <EmailAddress>hjemmesygeplejen@skanderborg.dk</EmailAddress>
                </Organisation>
            </By>
            <DateTime>2013-10-01T00:00:00Z</DateTime>
        </Created>
        <Organisation>
            <Identifier source="SOR">1236661000016007</Identifier>
            <Type>hjemmeplejeenhed</Type>
            <Name>Hjemmesygeplejen i Skanderborg kommune</Name>
            <AddressLine>Adelgade 42</AddressLine>
            <TelephoneNumber>86504202</TelephoneNumber>
            <EmailAddress>hjemmesygeplejen@skanderborg.dk</EmailAddress>
        </Organisation>
        <Type>Visiteret til hjemmesygeplejen</Type>
    </Relation>
    <Relation>
        <Identifier>1215364523002002</Identifier>
        <CreatedBy>
             <HealthcareProfessional>
                <Identifier source="Autorisation>2Q5TK</Identifier>
                <Name>Tess Christoffersen</Name>
                <Information type"SpecialityCode">PSYK</Information>
            </HealthcareProfessional>
            <Organisation>
                <Identifier source="SOR">1000301000016001</Identifier>
                <Type>klinisk enhed</Type>
                <Name>Århus Universitetshospital, Skejby</Name>
                <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                <AddressLine>8200 Århus N</AddressLine>
                <TelephoneNumber>89495566</TelephoneNumber>
            </Organisation>
        </CreatedBy>
        <Organisation>
            <Identifier source="SOR">1000301000016001</Identifier>
            <Type>klinisk enhed</Type>
            <Name>Århus Universitetshospital, Skejby</Name>
            <AddressLine>Brendstrupgårdsvej 100</AddressLine>
            <AddressLine>8200 Århus N</AddressLine>
            <TelephoneNumber>89495566</TelephoneNumber>
        </Organisation>
        <Type>Indlagt</Type>
    </Relation>
    <Relation>
        <Identifier>1243218943710934</Identifier>
        <CreatedBy>
             <HealthcareProfessional>
                <Identifier source="Autorisation">2Q5TK</Identifier>
                <Name>Tess Christoffersen</Name>
                <Information type="SpecialityCode">PSYK</Information>
            </HealthcareProfessional>
            <Organisation>
                <Identifier source="SOR">1000301000016001</Identifier>
                <Type>klinisk enhed</Type>
                <Name>Århus Universitetshospital, Skejby</Name>
                <AddressLine>Brendstrupgårdsvej 100</AddressLine>
                <AddressLine>8200 Århus N</AddressLine>
                <TelephoneNumber>89495566</TelephoneNumber>
            </Organisation>
        </CreatedBy>
        <Organisation>
             <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
             <Type>Apotek</Type>
             <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
             <AddressLine>Drasbeksgade 16</AddressLine>
             <AddressLine>8560 Kolind</AddressLine>
             <TelephoneNumber>86392155</TelephoneNumber>
        </Organisation>
        <Type>Foretrukket apotek</Type>
        <ValidityPeriod>
             <FromDateTime>2025-12-10T10:00:00Z</FromDateTime>
             <ToDateTime>2026-08-01T10:00:00Z<ToDateTime>
        </ValidityPeriod>
        <PatientRelationMetadata>
             <PreferredDeliverySite>
                  <Identifier source=?>[...]</Identifier>
                  <Type>Apoteksudleveringssted</Type>
                  <Name>Superbrugsen Kolind</Name>
                  <AddressLine>Bugtrupvej 1</AddressLine>
                  <AddressLine>8560 Kolind</Adressline>
              </PreferredDeliverySite>
        </PatientRelationMetadata>
    </Relation>
</GetPatientOrganisationRelationResponse>
</file>