Indhold

Introduktion

...

Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.

Dokument historik

1.4. Definitioner og referencer

Funktionalitet

LAR servicen udstiller SOAP snitflader til at registrere og læse CAVE oplysninger.

...

Servicen kræver ingen særlig daglig vedligehold. 

Opdatering af whitelist database

Servicen den indeholder en whitelist database over CVR numre der har adgang til servicen. 

Indsæt i whitelist databasen

insert into whitelist_config (service_key, service_type, cvr) values ('dk.nsi.larservice', '', 'CVR_NUMMER_DER_SKAL_INDSÆTTES');

Slet i whitelist databasen

delete from whitelist_config where service_key = 'dk.nsi.larservice' and cvr = 'CVR_NUMMER_DER_SKAL_SLETTES';

Overvågning

Servicen udstiller en status side. På denne side fremgår servicens versionsnummer samt status for adgang til databasen. Status siden kan tilgås via http://CAVE/larservice/health

...

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 102
Date: WedMon, 2004 FebOct 20192021 1311:2331:5427 GMT   


{ "minLogOkversion":true,"consentOk":true,"treatmentRelationOk":true,"caveOk":true,"version":"1.0.0-SNAPSHOT "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "OK"}

HTTP statuskode

Status-siden returnerer altid følgende status koder afhængig af servicens statuskode retur uafhængigt at af de services der integreres med. 

200: Applikationen er sund

500: Der er opstået en fejl i applikationen eller en af de services der integreres med.

Fejlfinding

Såfremt der er problemer med adgang til servicens database, vises nedenstående fejl. Bemærk at den giver en HTTP statuskode 500 og at man i body kan se, at det er cave servicen der ikke er OK.

HTTP/1.1 500 Internal Server Error200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 103
Date: WedMon, 2004 FebOct 20192021 1311:3031:1127 GMT   


{ "minLogOkversion":true,"consentOk":true,"treatmentRelationOk":true,"caveOk":false,"version":"1.0.0-SNAPSHOT "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "FAILED"}

Følgende årsager kan resultere i en

...

FAILED status 

• Hvis

...

• servicen, der integreres med ikke er

...

• tilgængelig
• Andre ukende årsager

Hvis status-siden returnerer HTTP en FAILED status 500 , bør man tjekke applikationsloggen, da fejl logges her til. 

Servicen kan genstartes ved at genstarte den docker container, som servicen den kører i. 

...

Nedenstående er de relevante logfiler. 

Krav til backup m.m.

Der bør foretages backup af data på en forsvarlig måde, i tilfælde af behov for en genetablering af data. Disse skal opbevares på en forsvarlig måde, jfr. regler om personhenførbare >>> personhenførbare eller personfølsomme? <<< data.personfølsomme data.

Initiel indlæsning af data

Det er muligt at indlæse data fra en CSV-fil direkte ind i LAR.

Inputfilens format

CVS-filen forventes at have følgende format:

1) første linje indeholder navnene på alle felterne (adskilt af semikolon ";". Felterne er beskrevet i afsnit 4.1.1 i denne guide.

Rækkefølgen af felterne skal være den samme som i tabellen.

2) I de efterfølgende rækker kommer data. De skal også være adskilt med semikolon og komme i samme rækkefølge som i tabellen i afsnit 4.1.1

Felter der er markeret med "Ja" i tabellen er krævede.

Afvikling af indlæsningsprogram

Indlæsningsprogrammet afvikles i en docker container og det skal ske i følgende steps (alle stier er relative i forhold til lar/trunk):

1) Inputfilen kopieres ind i det directory der er volume mountes ind i containeren: i compose/dataimporter/input/

2) I application.properties angives input filen i denne property: larservice.dataimport.inputfile

3) Her efter kan indlæsningen afvikles:

compose/dataimporter/docker-compose up

Resultatet af indlæsningen udskrives i loggen.

Properties

Der findes følgende properties, men det bør ikke være nødvendigt at ændre dem fra kørsel til kørsel (bortset fra larservice.dataimport.inputfile):