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
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 findes i samme wildfly modul som servicekonfigurationen
Se yderligere opsætning i installationsvejledningen.
NXRG udstiller en overvågningsside, som findes i listen af komponenter i afsnit 2.
NXRG-overvågningssiden returnerer enten:
Det overvåges om der kan opnås forbindelse til databasen.
TODO
TODO
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. Hvis der er fejl i forbindelse med kaldet, så vil de optræde i listen identificeret ved errors. Property status kan angive enten 'OK' eller 'ERROR'.
patient: Består af patientId (cpr-nummer) samt identifikation af assigningAuthority (er sikker CPR registrets OID).
Succesfuldt 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.
Følgende er et eksempel på et kald til iti-42 med fejl:
nxrg-logging: {"event":{"eventTypeCode":"ITI-42","errors":[{"value":"errorvalue","codeContext":"errorcc","errorCode":"errorcode","severity":"sevirity","location":"errorlocation"}],"status":"ERROR"}, "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"} ] } |