Denne guide har som formål at give et overblik over drift af LAR servicen.
Dette dokument er henvendt til driftspersonale på NSP'en.
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.
Dato | Ansvarlig | Beskrivelse |
---|---|---|
20/2-2018 | KvalitetsIT | Initiel version |
Reference | Beskrivelse |
---|---|
SOAP | Simple Object Access Protocol |
FHIR | Fast Health Interoperability Resources |
HAPI | HAPI-FHIR - Open Source FHIR implementation in Java |
DGWS | Den Gode WebService |
LAR servicen udstiller SOAP snitflader til at registrere og læse CAVE oplysninger.
Servicen kræver ingen særlig daglig vedligehold.
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'; |
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
Eksempel på svar på fra status-sidem.
HTTP/1.1 200 OK Connection: keep-alive X-Powered-By: Undertow/1 Server: WildFly/8 Content-Type: application/json Content-Length: 102 Date: Mon, 04 Oct 2021 11:31:27 GMT { "version": "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "OK"} |
Status-siden returnerer altid følgende status kode retur uafhængigt at af de services der integreres med.
200: Applikationen er sund
Såfremt der er problemer med adgang til servicens database, vises nedenstående fejl. Bemærk at man i body kan se, at det er cave servicen der ikke er OK.
HTTP/1.1 200 OK Connection: keep-alive X-Powered-By: Undertow/1 Server: WildFly/8 Content-Type: application/json Content-Length: 103 Date: Mon, 04 Oct 2021 11:31:27 GMT { "version": "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "FAILED"} |
Følgende årsager kan resultere i en FAILED status
Hvis status-siden returnerer en FAILED status, 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.
Alle logfiler findes i standard logfolderen på NSP platformen. Det vil sige at de findes i folderen /pack/wildfly8/standalone/log.
Nedenstående er de relevante logfiler.
Filnavn | Indhold |
---|---|
larservice.log | Applikationslog fra LAR servicen. |
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 personfølsomme data.
Det er muligt at indlæse data fra en CSV-fil direkte ind i LAR.
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.
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.
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):
Property | Default værdi | Beskrivelse |
---|---|---|
larservice.dataimport.inputfile | testMedcomPersTilSDS.csv | Navn på filen der skal indlæses |
larservice.dataimport.qname.wsdl | http://localhost:8082/lar/MedicationAllergyService?wsdl | URL til LAR service |
larservice.dataimport.qname.namespaceuri | http://nsp.dk/medicationallergyservice/2018/11/21/ | LAR service namespace |
larservice.dataimport.qname.localpart | MedicationAllergyService | LAR service navn |
larservice.dataimport.keystore.name | Casper_Rasmussen_Laege.jks | Medarbejdeercertifikat der skal benyttes til indlæsning (niveau 4 SOSI IDkort) |
larservice.dataimport.keystore.password | Test1234 | Kodeord til certifikat |
sts.url | http://test2.ekstern-test.nspop.dk:8080/sts/services/NewSecurityTokenService | URL til SRS service |
code.system.oid.substance | urn:oid:2.16.840.1.113883.6.73 | Det foretrukne OID system for substance koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:2.16.840.1.113883.6.73 |
code.system.oid.patient | urn:oid:1.2.208.176.1.2 | Det foretrukne OID system for patient koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.2 |
code.system.oid.recorder | urn:oid:1.2.208.176.1.3 | Det foretrukne OID system for recorder koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.3 |
code.system.oid.recorder.org | urn:oid:1.2.208.176.1.1 | Det foretrukne OID system for recorder organization koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.1 |
code.system.oid.manifestation | urn:oid:1.2.208.176.2.4.12 | Det foretrukne OID system for manifestation koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.2.4.12 |
code.system.oid.drugId | urn:oid:drug_id | OID for drug id. F.eks. urn:oid:1.2.208.176.2.4.12 |