Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

URL

Funktionalitet

<server>/odr/status

Status-side for servicen. Viser om servicen fungerer korrekt, se afsnittet Overvågning.

<server>/odr/alarm

Alarm-side for servicen. Viser om der er valideringsfejl i servicen, se afsnittet Overvågning.

<server>/odr/odr
Webservice-endpoint
<server>/odr/odrAdmin
Webservice admin-endpoint (til brug for brugerflade)
<server>/odr/dksconfig
DCC auto-konfigurations API. Anvendes til konfiguration af NSP'ens DCC.
<server>/odr/wsdl
HTML-side med links til download af WSDL-filer i hhv. DGWS- og IDWS-udgave.
<server>/odr/wsdl/dgws
DGWS WSDL
<server>/odr/wsdl/idws
IDWS WSDL
<server>/odr-operations/odr-slettejob/deceased/start
Baggrundsjob til sletning af døde startes ved kald af denne url. Returnerer altid http status kode 200. Eventuelle fejl skrives i loggen.
<server>/odr-operations/odr-slettejob/migrated/start
Baggrundsjob til oprydning ift. udrejste startes ved kald af denne url. Hvis person har en aktiv registrering, så tjekkes dem om denne person er udrejst. Hvis dette er tilfældet, så sættes VALIDTO-datoen til afviklingstidspunktet.
Returnerer altid http status kode 200. Eventuelle fejl skrives i loggen.
<server>/odr-operations/odr-slettejob/status

Dette kald verificerer databaseadgang.

Der kan returneres følgende fra statussnitfladen:

200: Der er adgang til databasen og jobbet kan anvendes.
5xx: Komponenten melder at den ikke kan anvendes.

Code Block
languagebash
HTTP/1.1 200 OK
Database : OK 


<server>/odr-operations/odr-slettejob/alarm

Dette kald verificerer services, eksterne kald og databaseadgange.

Denne service indeholder kun data, hvis der er alarmer.

200: Komponenten fungerer og der er ingen alarmer.
5xx: Komponenten melder at den ikke kan anvendes.

Følgende er et ekempel på et svar, hvor personinformationservice ikke er tilgængelig.

Code Block
languagebash
HTTP/1.1 500 Internal Server Error
Baggrundsjobbet StackedOperationsService fejlede sidst det blev kørt. Problemet var: Data for CPR-nummeret kunne ikke findes, fordi kaldet til PersonInformation-servicen returnerede en uventet statuskode: 409.
Person Information servicen har fejlet flere gange end tilladt i en given periode.


...

Operation / brugertypeBorgerSundhedsfagligSystem brugerAdmin bruger
CreateOrganDonorRegistrationxx
x
UpdateOrganDonorRegistrationxx
x
DeleteOrganDonorRegistrationxx
x
GetOrganDonorRegistration
x
x
HasOrganDonorRegistration



Baggrundsjob (Slettejob/Oprydningsjob)

Servicens slettejob baggrundsjobs bliver afviklet vha. en udstillet RestControllerudstillede RestControllere, som kaldes vha. simpelt HTTP GET kald.
Dette gøres for at sikre afviklingen af slettejob baggrundsjobs i flere-node drift, hvor en loadbalancer sørger for fordeling af kald til bagvedliggende servere.

Driften vedligeholder en cron, som kalder slettejobbets url'er for baggrundsjobbene i et fast mønster vha. curl.

ODR har følgende baggrundsjobs:

  • OrganDonorDeceasedCleanup - Slettejob til sletning af afdødes registreringer

  • OrganDonorEmigratedCleanup - Oprydningsjov til invalidering af udrejstes registreringer

Følgende parametre bruges til styringen af forbindelsen til PersonInformation servicen, som bruges på tværs af baggrundsjobs. De kan ændres i cleanup.properties for ODR:

NøgleDefault værdiBeskrivelse
personinformation.url

http://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-personinformation/2024/08/01

Den url som jobbet skal bruge, når den skal kalde servicen stamdata-personinformation.
personinformation.maxTotalConnections200Max antal forbindelser som HTTP Connection Manager må lave.

personinformation.defaultMaxConnectionsPerRoute

20

Max antal forbindelser som HTTP Connection Manager må lave pr. rute.

personinformation.error.tolerance

0

Tolerance for hvor mange fejl PersonInformation servicen må have inden den melder tilbage at den ikke virker.

OrganDonorDeceasedCleanup

Baggrundsjobbet kaldes når der skal slettes registreringer for personer der har været erklæret døde de sidste 60 dage (deletion.save.deceased)

Kommando til kald af slettejob:

Code Block
languagebash
titleKommando
curl <server>/odr-operations/odr-slettejob/deceased/start


Følgende parametre til styring af slettejobbet OrganDonorDeceasedCleanup kan ændres i cleanup.properties for ODR:

NøgleDefault værdiBeskrivelse

deletion.desired.execution.duration.deceased

PT20S

Den tid vi ønsker at bruge på sletning ved hvert request. Tiden er ikke garanteret, da vi kun tjekker mod den efter hver StackOperation er udført.

Default værdien er 20 sekunder.

deletion.save.deceased

P60D

Den tid som skal gå før vi sletter data for en afdød person. Dette gøres så vi ikke sletter data, hvis personens status ændres til afdød og derefter tilbage til levende.
Default værdien er 60 dage.

deletion.batchsize.deceased

1000

Max. antal entries (f.eks. CPR) vi behandler pr. batch

personinformation.batchsize.deceased

100

Max. antal CPR vi forespørger på i en enkelt request til

personinformation
personinformation.urlhttp://test1-cnsp.ekstern-test.nspop.dk:8080/stamdata-personinformation/v1Den url som jobbet skal bruge, når den skal kalde servicen stamdata-personinformation.
personinformation.maxTotalConnections200Max antal forbindelser som HTTP Connection Manager må lave.

personinformation.defaultMaxConnectionsPerRoute

20

Max antal forbindelser som HTTP Connection Manager må lave pr. rute.

personinformation.error.tolerance

0

Tolerance for hvor mange fejl PersonInformation servicen må have inden den melder tilbage at den ikke virker.

Der er en max grænse for hvor lang tid jobbet må køre pr. gang (deletion.desired.execution.duration.deceased) og det kan angives her. Når jobbet har kørt den tid der er angivet, så stopper udførslen. Her efter kan jobbet kaldes igen og den vil fortsætte med processeringen, hvor jobbet stoppede sidst.

Parameteren angives som en Duration i ISO-8601 format. Dvs. eksemplet viser 20 sekunder.

...

OrganDonorEmigratedCleanup

Baggrundsjobbet OrganDonorDeceasedCleanupServlet kaldes , når der skal ryddes op registreringer for person der har været erklæret døde de sidste 60 dage (deletion.save.deceased)er udrejste.

Kommando til kald af slettejob:

Code Block
languagebash
titleKommando
curl <server>/odr-operations/odr-slettejob/migrated/start


Følgende parametre til styring af OrganDonorDeceasedCleanup kan ændres i cleanup.properties for ODR:

NøgleDefault værdiBeskrivelse

deletion.desired.execution.duration.deceased

PT20S

Den tid vi ønsker at bruge på sletning ved hvert request. Tiden er ikke garanteret, da vi kun tjekker mod den efter hver StackOperation er udført.

Default værdien er 20 sekunder.

deletion.save.deceased

P60D

Den tid som skal gå før vi sletter data for en afdød person. Dette gøres så vi ikke sletter data, hvis personens status ændres til afdød og derefter tilbage til levende.
Default værdien er 60 dage.

deletion.batchsize.deceased

1000

Max. antal entries (f.eks. CPR) vi behandler pr. batch

personinformation.batchsize.deceased

100

Max. antal CPR vi forespørger på i en enkelt request til personinformation

Der er en max grænse for hvor lang tid jobbet må køre pr. gang (deletion.desired.execution.duration.deceased) og det kan angives her. Når jobbet har kørt den tid der er angivet, så stopper udførslen. Her efter kan jobbet kaldes igen og den vil fortsætte med processeringen, hvor jobbet stoppede sidst.

Parameteren angives som en Duration i ISO-8601 format. Dvs. eksemplet viser 20 sekunder.deceased/startSlettejobbet skal aktiveres hver dag, hvert 15. minut mellem 8-16 - startende kl. 8

Backup

Servicen indeholder ikke nogen backup-mekanismer, og dette skal derfor konfigureres på database-niveau. Der bør foretages backup af data på en forsvarlig måde, i tilfælde af behov for en genetablering af data. Disse data skal opbevares på en forsvarlig måde, jfr. regler om personhenførbare data.