Indholdsfortegnelse:

Beskrivelse

Personregistreringen der skal opdateres identificeres med et X-eCPR-nummer.

Man kan nøjes med at inkludere opdateringer, tilføjelser og invalidering på de enkelte dataelementer som man ønsker at berøre med opdateringen.

Hvis man medsender opdateringer der ikke ændrer værdien af det, der allerede er registreret for det pågældende element, vil elementet ikke blive opdateret; dvs at der ikke dannes en ny version af dataelementet. 

Hvis man ønsker at opdatere et element medsendes PID på det element der skal opdateres.

Hvis PID ikke medsendes bliver elementet behandlet som en tilføjelse; dvs at der oprettes et nyt dataelement.

Hvis man kun medsender PID, og ingen værdi, bliver elementet invalideret (ValidTo sættes).

Parametre

En eller flere elementer, fx:

  • EPID
  • Navn
  • Fødselsdato
  • Køn
  • Adresse
  • Telefonnummer

Bemærk at det er aftalt, for navn, kun at bruge Use:official, og dermed kan der kun forekomme ét aktivt navn ad gangen.

Opdatering: For hvert element der ønskes opdateret medsendes elementets PID og den ønskede værdi.

Tilføjelse: For hvert nyt element der ønskes oprettet medsendes den ønskede værdi.

Invalidering: For hvert element der ønskes invalideret medsendes kun elementets PID

Resultat

Personregistreringen er opdateret

Der returneres en personregistrering med alle data, både nye og historiske. 

Fejlsituation: EPID ikke unikt
Servicen returnerer en fejl fordi det pågældende EPID allerede er registreret på en anden personregistrering.
Der returneres en besked om at EPID'et allerede er tilknyttet en personregistrering. "Værdien findes i forvejen \[VÆRDI\](OID)"

Fejlsituation: Identifier forsøges tilføjet, hvor der allerede er angivet en identifier med samme OID

Servicen returnerer en fejl fordi der allerede er registreret en Identifier af det pågældende Identifier type på den pågældende personregistrering. Findes der allerede en Identifier af den pågældende type og kaldes operationen uden angivelse af PID vil kaldet fejle.

Fejlsituation: Gender / Birthdate forsøges tilføjet, hvor der allerede er angivet Gender / Birthdate

Gender- og Birthdate-elementer kan opdateres, men hver af de to elementer kan kun forekomme en gang som aktuel version. Findes der allerede Gender eller Birthdate og kaldes operationen uden angivelse af PID vil kaldet fejle.

Fejlsituation: Name forsøges tilføjet, hvor der allerede er angivet et Name med den specifikke Use

Name-elementet kan forekomme flere gange, men der må højst forekomme ét aktivt navn for hver anvendelse, som er angivet i Use-elementet. Findes der allerede et Name med den specificerede use og kaldes operationen uden angivelse af PID vil kaldet fejle.

Fejlsituation: Forsøg på opdatering af systemgenererede parameterværdier

Det er ikke tilladt at udfylde ValidFrom/ValidTo, CountryName, OIDLabel og Name.Text i requests, da disse alle er værdier der sættes af Nationalt eCPR.

Forespørgsel

Request-eksempel (simplificeret) kommentarer indsat med rødt i eksemplet: 

<UpdatePersonRequest>
  <Person>
    <Identifier> - Opdaterer ingenting da det er den samme værdi som eksisterer på personregistreringen i forvejen
      <PID>cacdfb80-49dd-472a-8354-11c647dddf24</PID>
      <OID>1.2.208.176.1.6.1.1</OID>
      <Value>1212701XG7</Value>
      <Validity>16</Validity>
    </Identifier>
    <Modified> - Identificerer hvem der foretager opdateringen af personregistreringen
      <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>
    </Modified>
    <Name>
      <PID>1a691815-a383-4d91-a405-e364830c6460</PID> - Opdaterer navnet fra Gunther til Günther. Værdien Gunther får sat en ValidTo. Gunther kan stadig fremsøges.
      <Use>official</Use>
      <FamilyName>Weber</FamilyName>
      <GivenName>Günther</GivenName>
    </Name>
    <Address>
      <PID>15f8c77d-5972-4a1d-a249-0e33ba08c995</PID> - Fjerner den angivne adresse. Dvs. at ValidTo sættes. Adressen kan stadig fremsøges
    </Address>
    <KeyIdentifier> - Identificerer hvilken personregistrering der skal opdateres vha. X-eCPR-nummeret
      <OID>1.2.208.176.1.6.1.1</OID>
      <Value>1212701XG7</Value>
    </KeyIdentifier>
  </Person>
</UpdatePersonRequest>

Svar

Response-eksempel (simplificeret):

<UpdatePersonResponse>
  <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>
</UpdatePersonResponse>

Ændringslog

1.02023-11-08Indhold publiceretSDS





  • No labels