Indhold

Komponenter

Dette dokument dækker følgende komponenter på NSP, som sammen med Domibus NSP, er en del af EHMI MeddelelsesRegistrering (EMR)

Konfiguration

I folderen "compose/configuration" findes følgende relevante konfigurationsfiler, som indlæses når docker compose startes op:

adapter.propertiesProperties til MSH Adapter
log4j2.properties

Opsætning af logning i MSH Adapter

msh-adapter-ds.xml

DataSource

Properties i "adapter.properties"

Bemærk, nogle af default-værdierne herunder er forløbige indtil tingene falder mere på plads.

Properties til adapteren selv

Property

Beskrivelse

Default værdi

dk.nsp.msh.adapter.domibus.url.domibus.wspluginURL til Domibus WS pluginhttp://domibus-nsp:8080/domibus/services/wsplugin
dk.nsp.msh.adapter.domibus.usernameBrugernavn til Domibusadmin
dk.nsp.msh.adapter.domibus.passwordPassword til Domibus123456
dk.nsp.msh.adapter.domibus.mpcDomibus MPC (Message Partition Channel)http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/defaultMPC
dk.nsp.msh.adapter.domibus.connectTimeoutHTTP connect timeout til Domibus (ms)60000
dk.nsp.msh.adapter.domibus.readTimeoutHTTP read timeout til Domibus (ms)60000
dk.nsp.msh.adapter.domibus.chunkSizeChunk-størrelse ved filoverførsel8192
dk.nsp.msh.adapter.datasource.jndiJNDI datasource navnjava:jboss/datasources/emr
dk.nsp.msh.adapter.dros.client.endpointDROS ITI-41 endpointhttp://dros:8080/dros/iti41
dk.nsp.msh.adapter.dros.sts.endpointSTS endpoint til tokenhttp://test1-cnsp.ekstern-test.nspop.dk:8080/sts/services/NewSecurityTokenService
dk.nsp.msh.adapter.dros.sts.organizationNameOrganisation navn i STSSundhedsdatastyrelsen
dk.nsp.msh.adapter.dros.sts.organizationCodeOrganisation CVR33257872
dk.nsp.msh.adapter.dros.sts.keystorePathKeystore til STS autentificeringNSP_Test_Service_Consumer_sds.p12
dk.nsp.msh.adapter.dros.sts.keystorePasswordPassword til STS keystoreTest1234
dk.nsp.msh.adapter.dros.sts.systemNameSystemnavn i STSEMR DROS Client
dk.nsp.msh.adapter.dros.homeCommunityIdDROS XDS homeCommunityIdurn:oid:1.2.208.176.43210.8.10
dk.nsp.msh.adapter.dros.httpclient.maxTotalConnectionsDROS Max samlede HTTP connections200
dk.nsp.msh.adapter.dros.httpclient.defaultMaxConnectionsPerRouteDROS Max connections pr. route20
dk.nsp.msh.adapter.dros.httpclient.connectionTimeoutMsDROS HTTP connect timeout (ms)2000
dk.nsp.msh.adapter.dros.httpclient.socketTimeoutMsDROS HTTP socket timeout (ms)5000
dk.nsp.msh.adapter.eds.authUrlEDS Keycloak token endpointhttps://keycloak-test.nspop.dk/auth/realms/ehmi/protocol/openid-connect/token
dk.nsp.msh.adapter.eds.clientIdEDS Keycloak client idfcf6f8a9-81b1-441b-9896-bb08631eade6
dk.nsp.msh.adapter.eds.keystoreFileKeystore til EDS klientdk-ehmi-medcom-eds-testklient.p12
dk.nsp.msh.adapter.eds.keystorePasswordPassword til EDS keystoreWLKk,bp63QwK
dk.nsp.msh.adapter.eds.endpointEDS FHIR endpointhttps://dk-ehmi-eds-service.t0.hosting.kitkube.dk/fhir
dk.nsp.msh.adapter.eds.apinfo.apIdAccess Point IDKvalitetsItAP-test-aarhus
dk.nsp.msh.adapter.eds.apinfo.apIdentifierAccess Point identifierEerDevice-KvalitetsItAP-test-aarhus
dk.nsp.msh.adapter.eds.apinfo.apManufacturerProducent af APKvalitetsIT
dk.nsp.msh.adapter.eds.apinfo.apDeviceNameNavn på AP deviceNSP MSH integrationstestklient
dk.nsp.msh.adapter.eds.httpclient.maxTotalConnectionsEDS max HTTP connections200
dk.nsp.msh.adapter.eds.httpclient.defaultMaxConnectionsPerRouteEDS max connections pr. route20
dk.nsp.msh.adapter.eds.httpclient.connectionTimeoutMsEDS HTTP connect timeout (ms)2000
dk.nsp.msh.adapter.eds.httpclient.socketTimeoutMsEDS HTTP socket timeout (ms)5000

Properties til de enkelte baggrundsjobs

dk.nsp.msh.job.fetchjob.batchsizeAntal beskeder pr. fetch batch50
dk.nsp.msh.job.fetchjob.desired.execution.durationØnsket køretid pr. fetch jobPT20S
dk.nsp.msh.job.savejob.batchsizeAntal beskeder pr. save batch50
dk.nsp.msh.job.savejob.retryBatchSizeBatch størrelse ved retry500
dk.nsp.msh.job.savejob.desired.execution.durationØnsket køretid pr. save jobPT20S
dk.nsp.msh.job.savejob.max.retriesMax antal retries3
dk.nsp.msh.job.savejob.retry.backoff.delayDelay mellem retriesPT5M
dk.nsp.msh.job.sendjob.batchsizeAntal beskeder pr. send batch50
dk.nsp.msh.job.sendjob.retryBatchSizeBatch størrelse ved retry500
dk.nsp.msh.job.sendjob.max.retriesMax antal retries3
dk.nsp.msh.job.sendjob.retry.backoff.delayDelay mellem retriesPT5M
dk.nsp.msh.job.sendjob.desired.execution.durationØnsket køretid pr. send jobPT20S
dk.nsp.msh.job.sendjob.domibus.nspPartyIdDomibus partyId ved afsendelse af kvitteringerdomibus-nsp
dk.nsp.msh.job.cleanupjob.batchsizeAntal poster pr. cleanup batch500
dk.nsp.msh.job.cleanupjob.desired.execution.durationØnsket køretid pr. cleanup jobPT20S
dk.nsp.msh.job.cleanupjob.retentionPeriod

Hvor længe EHMI beskeder gemmes.

Der kan angives en periode i ISO-8601 Period-formatet P[n]Y[n]M[n]D (år, måneder og dage).

Eksempler: P1Y (1 år) eller P1Y2M10D (1 år, 2 måneder, 10 dage).

P1Y

Baggrundsjobs

MSH Adapter består i praksis af en håndfuld baggrundsjobs, som tilsammen tager beskeder fra Domibus'en og gemmer dem i en DROS. Undervejs kaldes EDS med "forsendelsestatus" på de enkelte beskeder.

Baggrundsjobbene startes med et HTTP GET kald til deres "start"-endpoint.

NavnStart-endpointBeskrivelse
Hent beskeder<serverurl>/msh-adapter/fetch-job/startHenter beskeder fra den konfigurerede Domibus, gemmer dem lokalt i en database, og markerer dem herefter som "downloaded" i Domibus. Undervejs gemmes der status-beskeder som skal afsendes til EDS.
Gem beskeder<serverurl>/msh-adapter/save-job/startGennemgår beskeder, der er hentet, validerer dem og gemmer dem i DROS. Undervejs gemmes der status-beskeder som skal afsendes til EDS. Beskeder, der er fejlet pga. interne fejl, vil blive forsøgt igen senere, indtil "retry" er overskredet. Herefter vil de overgå til "manuel behandling".
Send beskeder<serverurl>/msh-adapter/send-job/startSender kvitteringer tilbage til Domibus for de beskeder, som er afleveret i DROS. Kvitteringerne oprettes under "Gem beskeder".
Cleanup Job<serverurl>/msh-adapter/cleanup-job/startSletter gamle beskeder som er færdigbehandlede.
EDS opdatering<serverurl>/msh-adapter/eds-update-job/start

Bemærk, stadig under udvikling!

Afvikler køen af beskeder der skal sendes til EDS.

Bemærk, bør kaldes med højest 10 sekunders mellemrum, da beskederne skal afspejle status med minimal forsinkelse (realtime).

Overvågning

Der findes nogle simple status- og alarm-endpoints hvor man kan overvåge baggrundsjobbene. 

I status-endpointet kan man se hvilken version af servicen, der er kørende.

TypeEndpoint
Alarm<serverurl>/msh-adapter/<job-navn>/alarm
Status<serverurl>/msh-adapter/<job-navn>/status