Fælles Medicinkort - Dokumentation

This is an old revision of the document!

SearchPerson

Søgning foregår ved angivelse af en “query string”, som indeholder en række kriterier der skal være opfyldt ved angivelse af key/value-par. Hvis der søges på mere end ét kriterium, skal de adskilles med “ AND ”, og hvis der indgår mellemrum i en søgestreng, skal den omkranses af gåseøjne: Fx således:

givenname:Gunther AND birthdate:12-12 AND streetaddress:“Vej 12”

Der kan også benyttes '*' som “wildcard”. Nøglerne der kan angives ifm. søgning er:

Nøgle	Beskrivelse
givenname	Fornavn
familyname	Efternavn
streetaddress	Adresselinje 1-10
city	Bynavn
district	Distrikt
state	Stat
postalcode	Postnummer
country	Landekode (ISO 3166)
contact	Kontaktoplysning, fx email, tlfnr. osv.
contactsystem
gender	Køn (male/female)
birthdate	Fødselsdato (format: YYYY-MM-DD). Dato og måned kan udelades

Bemærk: hvis man ønsker at søge via person-ID (Identifier), skal man i stedet for SearchPerson benytte GetPersonById.

Søgning foregår både på aktuelle og historiske data. Fx kan man godt fremsøge en person på en tidligere adresse. Resultatet af søgningen er en liste af Person-strukturer med fuld historik på tilknyttet data. Der returneres maksimalt 100 søgeresultater.

Request-eksempel (simplificeret):

<SearchPersonRequest>
  <Query>givenname:Gunther AND birthdate:12-12</Query>
</SearchPersonRequest>

Response-eksempel (simplificeret):

<SearchPersonResponse>
  <Person>
    <Identifier>
      <PID>f08abf84-a3aa-4a69-be1b-b7adccb3e00f</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <OID>1.2.208.176.1.6.1.1</OID>
      <OIDLabel>X-eCPR</OIDLabel>
      <OIDType>eCPR-nummer</OIDType>
      <Value>1212901TX9</Value>
      <Validity>16</Validity>
    </Identifier>
    <Modified>
      <By>
        <Person>
          <AuthorisationIdentifier>AB01C</AuthorisationIdentifier>
          <Name>Jens Jensen</Name>
          <PersonIdentifier>1234567890</PersonIdentifier>
        </Person>
        <Role>Læge</Role>
        <Organisation>
          <Name>Andeby hospital</Name>
          <Type>Hospital</Type>
          <Identifier>
            <Identifier>1234123412</Identifier>
            <Source>SOR</Source>
          </Identifier>
        </Organisation>
      </By>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
    </Modified>
    <Gender>
      <PID>079fe782-fbae-4157-b3e2-2bfd20d1b340</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <Value>male</Value>
    </Gender>
    <Name>
      <PID>fb0ff49d-073d-45b6-9f08-0438278b2a36</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <Use>official</Use>
      <Text>Gunther Weber</Text>
      <FamilyName>Weber</FamilyName>
      <GivenName>Gunther</GivenName>
    </Name>
    <BirthDate>
      <PID>b8eaf7ad-7293-4b8a-a61b-71fac9b2ad29</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <Value>1990-12-12</Value>
    </BirthDate>
    <Contact>
      <PID>39c4d998-b15c-45ae-9df4-e62b97cbf7a1</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <System>phone</System>
      <Use>mobile</Use>
      <Value>22334455</Value>
    </Contact>
    <Address>
      <PID>e7820236-22d0-4522-ba1f-76fd633250f3</PID>
      <ValidFrom>2018-05-07T10:21:28+02:00</ValidFrom>
      <Use>temp</Use>
      <Type>postal</Type>
      <Text>Sommerhusvej 42</Text>
      <City>Thisted</City>
      <PostalCode>7620</PostalCode>
      <Country>DNK</Country>
      <CountryName>Danmark</CountryName>
    </Address>
  </Person>
  <Person>
    <Identifier>
      <PID>cacdfb80-49dd-472a-8354-11c647dddf24</PID>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <OID>1.2.208.176.1.6.1.1</OID>
      <OIDLabel>X-eCPR</OIDLabel>
      <OIDType>eCPR-nummer</OIDType>
      <Value>1212701XG7</Value>
      <Validity>16</Validity>
    </Identifier>
    <Modified>
      <By>
        <Person>
          <AuthorisationIdentifier>AB01C</AuthorisationIdentifier>
          <Name>Jens Jensen</Name>
          <PersonIdentifier>1234567890</PersonIdentifier>
        </Person>
        <Role>Læge</Role>
        <Organisation>
          <Name>Andeby hospital</Name>
          <Type>Hospital</Type>
          <Identifier>
            <Identifier>1234123412</Identifier>
            <Source>SOR</Source>
          </Identifier>
        </Organisation>
      </By>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <ValidTo>2018-05-07T10:27:49+02:00</ValidTo>
    </Modified>
    <Modified>
      <By>
        <Person>
          <AuthorisationIdentifier>AB01C</AuthorisationIdentifier>
          <Name>Jens Jensen</Name>
          <PersonIdentifier>1234567890</PersonIdentifier>
        </Person>
        <Role>Læge</Role>
        <Organisation>
          <Name>Andeby hospital</Name>
          <Type>Hospital</Type>
          <Identifier>
            <Identifier>1234123412</Identifier>
            <Source>SOR</Source>
          </Identifier>
        </Organisation>
      </By>
      <ValidFrom>2018-05-07T10:27:49+02:00</ValidFrom>
    </Modified>
    <Gender>
      <PID>44550ca5-88ba-4f45-96a8-22a0732895d5</PID>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <Value>male</Value>
    </Gender>
    <Name>
      <PID>1a691815-a383-4d91-a405-e364830c6460</PID>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <Use>official</Use>
      <Text>Gunther Weber</Text>
      <FamilyName>Weber</FamilyName>
      <GivenName>Gunther</GivenName>
    </Name>
    <BirthDate>
      <PID>5882a28b-9f40-4257-9ef1-2ffa26a1383a</PID>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <Value>1970-12-12</Value>
    </BirthDate>
    <Address>
      <PID>15f8c77d-5972-4a1d-a249-0e33ba08c995</PID>
      <ValidFrom>2018-05-07T10:26:02+02:00</ValidFrom>
      <Use>home</Use>
      <Type>physical</Type>
      <Text>Strassenbahn 42</Text>
      <City>Hamburg</City>
      <PostalCode>20095</PostalCode>
      <Country>DEU</Country>
      <CountryName>Tyskland</CountryName>
    </Address>
    <Address>
      <PID>ca949b88-e570-45bb-8b8d-b474314b2c0e</PID>
      <ValidFrom>2018-05-07T10:27:49+02:00</ValidFrom>
      <Use>temp</Use>
      <Type>postal</Type>
      <Text>Sommerhusvej 84</Text>
      <City>Thisted</City>
      <PostalCode>7620</PostalCode>
      <Country>DNK</Country>
      <CountryName>Danmark</CountryName>
    </Address>
  </Person>
</SearchPersonResponse>