Indhold
Komponenter
Dette dokument dækker følgende komponenter på NSP, som sammen med Domibus NSP, er en del af EHMI MeddelelsesRegistrering (EMR)
MSH Adapter
Konfiguration
I folderen "compose/configuration" findes følgende relevante konfigurationsfiler, som indlæses når docker compose startes op:
| adapter.properties | Properties til MSH Adapter |
| log4j2.properties | Opsætning af logning i MSH Adapter |
| msh-adapter-ds.xml | DataSource |
Properties i "stub.properties"
Property | Beskrivelse | Default værdi |
|---|---|---|
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.
| Navn | Start-endpoint | Beskrivelse |
|---|---|---|
| Hent beskeder | <serverurl>/msh-adapter/fetch-job/start | Henter 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/start | Gennemgå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/start | Sender kvitteringer tilbage til Domibus for de beskeder, som er afleveret i DROS. Kvitteringerne oprettes under "Gem beskeder". |
| Cleanup Job | <serverurl>/msh-adapter/cleanup-job/start | Sletter 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.
| Type | Endpoint |
|---|---|
| Alarm | <serverurl>/msh-adapter/<job-navn>/alarm |
| Status | <serverurl>/msh-adapter/<job-navn>/status |