This is an old revision of the document!
ReservePersonId
ReservePersonId kan benyttes hvis man ønsker at danne en liste af reserverede person-ID’er til brug i offline-scenarier. Skal et eller flere person-ID’er anvendes til umiddelbart brug for personer der allerede er kendt ved oprettelsen anvendes i stedet CreatePerson. Når et person-ID på denne liste er taget i brug skal servicen UpdatePerson anvendes til at supplere med personinformation, id’er m.v.
I requestet angives en eller flere List-strukturer, som angiver hvilke typer eCPR der ønskes dannet.
OID-elementet angiver, hvilken type Identifier der ønskes oprettet. Skal angives.
Number-elementet angiver hvor mange person-ID’er der ønskes returneret. Angives elementet ikke returneres 1 person-ID.
Gender-elementet angiver til hvilket køn der ønskes person-ID’er. Angives elementet ikke returneres så vidt muligt lige mange til hvert køn.
ForDate-elementet angiver hvorvidt person-ID’er skal svare til en bestemt dato. Angives elementet ikke vælger servicen tilfældigt datoer mellem dags dato og frem til Expiry.
ReservedUntil angiver fra hvilken dato person-ID’er ikke længere er reserverede. Er servicen UpdatePerson ikke kaldt inden denne dato for at opdatere et person-ID med stamdata inden dette tidspunkt slettes denne person, og person-IDet kan principielt anvendes senere til en anden person. Servicen garanterer ikke at person-IDet slettes præcist på dette tidspunkt, men det forventes at ske inden for et døgn efter. ReservedUntil kan højst være 2 år frem i tiden, for at sikre at der undgås unødigt mange person-ID’er uden tilknyttet information, der vil medføre at anvendeligheden af et centralt person-IDregister forringes. Angives ReservedUntil ikke vælges tidspunktet for kaldet + 48 timer. Hvem person-ID’er reserveres til angives i et Modified-element.
Der returneres et antal lister med person-ID’er svarende til forespørgslen. Bemærk at elementet Modified indeholder ReservedUntil, der angiver at person-ID’er er reserveret frem til dette tidspunkt, og skal opdateres inden denne dato såfremt de tages i anvendelse.
Request-eksempel (simplificeret):
<ReservePersonIdRequest> <List> <OID>1.2.208.176.1.6.1.1</OID> <Number>2</Number> <Gender>male</Gender> <ForDate>2018-05-08</ForDate> <ReservedUntil>2018-09-15T00:00:00+02:00</ReservedUntil> </List> <List> <OID>1.2.208.176.1.6.1.1</OID> <Number>3</Number> <Gender>female</Gender> <ForDate>2018-05-08</ForDate> <ReservedUntil>2018-09-15T00:00:00+02:00</ReservedUntil> </List> <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> </Modified> </ReservePersonIdRequest>
Response-eksempel (simplificeret):
<ReservePersonIdResponse> <List> <Person> <Identifier> <PID>a2280f64-138b-4e62-b5b7-84497c74e9ff</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187WO3</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> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>95d5b22a-c070-4295-bd77-28e1ae0c7610</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>male</Value> </Gender> </Person> <Person> <Identifier> <PID>2737a84c-2106-4c1d-86ad-94059eabc55c</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187VX5</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> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>585b65fa-acf5-4396-b3de-aaafc57b1eeb</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>male</Value> </Gender> </Person> </List> <List> <Person> <Identifier> <PID>32d9f1ce-62f6-4626-982a-aa8dbcb332d7</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187HX0</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> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>79df2bdb-c86a-43d1-957f-a7c476592435</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> <Person> <Identifier> <PID>9b23d786-6551-4e8a-b50b-ed0444aed39d</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187SY0</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> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>5451486b-036b-43d5-8334-3caf422261d6</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> <Person> <Identifier> <PID>7131fcaf-beb9-423c-ab84-e8118d9b7277</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <OID>1.2.208.176.1.6.1.1</OID> <OIDLabel>X-eCPR</OIDLabel> <OIDType>eCPR-nummer</OIDType> <Value>0805187XC0</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> <ReservedUntil>2018-09-15T02:00:00+02:00</ReservedUntil> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> </Modified> <Gender> <PID>687429ed-6945-40ce-bbe9-e501cffbbf30</PID> <ValidFrom>2018-05-07T10:37:25+02:00</ValidFrom> <Value>female</Value> </Gender> </Person> </List> </ReservePersonIdResponse>
