Indholdsfortegnelse:

Beskrivelse

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 (key:value). 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. 

Eksempel på en query string:

  • 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øgleBeskrivelse
givennameFornavn
familynameEfternavn
streetaddressAdresselinje 1-10
cityBynavn
districtDistrikt
stateStat
postalcodePostnummer
country

Landekode (ISO 3166 1 )

contactTlfnr.
contactsystemMetode til kontakt (telefon)
genderKøn (male/female)
birthdateFødselsdato (format: YYYY-MM-DD). Dato og måned kan udelades
identifer

X-eCPR-nummer, D-eCPR-nummer eller EPID. I søgning er det ikke defineret, hvilken type identifier der er tale om, så der søges på tværs af alle identifier typer.

Bemærk: hvis man ønsker at søge via person-ID eller EPID (som fx X-eCPR-nummer, pas- eller kørekortnummer etc.), skal man i stedet for SearchPerson benytte eCPR - GetPersonById.

Søgning foregår både på aktuelle og historiske data. Fx kan man godt fremsøge en person på en tidligere adresse.

Der laves approksimeret søgning på navn og adresse felter. Dvs. at ovenstående søgning på "Gunther" også finder "Günther" og "Gunter".

Resultatet af søgningen er en liste af personregistreringer med fuld historik på tilknyttet data. Der returneres maksimalt 100 søgeresultater.

Personregistreringer fundet

En eller flere personregistreringer returneres med al stamdata og fuld historik på de enkelte dataelementer.

Personregistrering ikke fundet

Der returneres et tomt response.

Forespørgsel

Request-eksempel (simplificeret):

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

Svar

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>home</Use>
      <Type>both</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>
  </Person>
</SearchPersonResponse>

  1. Teknisk set er der tale om en ISO 3166-1. Under ISO 3166-1 findes der 3 kode-typer: Alpha-2, Alpha-3 og Numeric. Nationalt eCPR håndterer alle tre kode-typer. ↩

Ændringslog

1.02023-12-04Indhold publiceretSDS



  • No labels