Komponenter

Dette dokument dækker følgende komponenter på NSP:

NSP XDS Registry
Type: Webservice
Filnavn: nxrg.war
Url: <serverurl>/nxrg
Servicecheckurl: <serverurl>/nxrg/status
Versionurl: <serverurl>/nxrg/health returnerer en json struktur med denne

Konfiguration

Servicekonfiguration

Grundlæggende konfiguration foregår ved redigering i filen nxrg.properties, der placeres i følgende WildFly modul:

/pack/wildfly/modules/sds/nxrg/configuration/main/

Moduldefinitionen er at finde i sourcekoden til nxrg under:

/compose/configuration/module.xml

I filen skal følgende properties være definerede:

Property	Beskrivelse
datasource.jndi.name	JNDI navnet på den datasource der giver adgang til NXRG databasen.
liquibase.changelog.file	Angiver den changelog fil som liquibase skal anvende. Property er ikke krævet. Hvis der skal afvikles integrationstest mod det miljø der installeres skal denne sættes til liquibase-changelog-test.xml. Denne kan også sættes via en environmentvariabel i formen liquibase_changelog_file.
nxrg.allowed.mimetype	Tilladt MimeType på DocumentEntries i requests til ITI-42, ITI-57 og ITI-61.

log4j konfiguration

Log4j konfiguration findes i samme wildfly modul som servicekonfigurationen

Se yderligere opsætning i installationsvejledningen.

Overvågning

NXRG udstiller en overvågningsside, som findes i listen af komponenter i afsnit 2.

5.1. Fortolkning af HTML overvågningsside

NXRG-overvågningssiden returnerer enten:

HTTP 200, hvis servicen i øjeblikket kører fint.
HTTP 203, hvis der er opstået en fejl der kræver indgriben.

5.2. Overvågningstyper

Det overvåges om der kan opnås forbindelse til databasen.

Eksempler på status-sider

200 OK

TODO

203 Non-authoritative Information

TODO

Forretningslogning

NXRG laver forretningslogninger ved hvert kald af de udbudte ITI-services. I det følgende gennemgåes formaterne for hver service.

Alle forretningslogninger har samme prefix nxrg-logging: for at hjælpe med at adskille disse logninger fra de andre.

Loglinjen er formatteret som json og alle logninger har følgende to indgange:

event: Består af eventTypeCode, der identificerer den kaldte service

patient: Består af patientId (cpr-nummer) samt identifikation af assigningAuthority (er sikker CPR registrets OID).

Logning for ITI-42

Kald til service iti-42 giver anledning til en logningslinje på følgende format:

nxrg-logging: 
{"event":{"eventTypeCode":"ITI-42","errors":null,"status":"OK"},
 "patient":{"patientId":"123456789","patientIdAssigningAuthority":"1.2.208.176.1.2"},
 "submissionSet":{"uniqueId":"8102339895577611423.916480571554153626.1623046582550"},
 "documentEntries":[
   {"entryUUid":"urn:uuid:b836d6a8-8514-479d-ae8f-bdd544edaaaa","replacesEntryUuid":null},
   {"entryUUid":"urn:uuid:b836d6a8-8514-479d-ae8f-bdd544edbbbb","replacesEntryUuid":"urn:uuid:ffffd6a8-8514-479d-ae8f-bdd544edbbbb"}
 ]
}

Iti-42 logninger har følgende egenskaber:

submissionSet: Identifikation (uniqueId) af det submissionset, der indeholder informationen i iti-42 kaldet.

documentEntries: En liste af entryUUid'er, der oprettes. Hvis en documentEntry i kaldet giver anledning til replace på en anden documentEntry, så angives dette uuid i egenskaben replacesEntryUuid.