Introduktion

Formål

Dette dokument beskriver hvordan man kommer i gang med at tilpasse eller videreudvikle EMR - EHMI MeddelelsesRegistrering.

Læsevejledning

Læser forventes at have kendskab til Java softwareudvikling med anvendelse af Maven, konfiguration af WildFly og brug af docker-compose.

Komponentens struktur

Selve komponenten er delt op i følgende moduler:

• msh_common: Fælles kode, bl.a. til status- og alarm-endpoints og oprettelse af http-klienter.
• msh_integration_tests: Integrationstests mod en kørende service. Lige pt. understøttes kun localhost, da der afventes installation på NSPs testmiljøer.
• msh_services: Selve service-koden, inklusiv baggrundsjobs, DAO'er, EHMI-besked-generering og Domibus-service (klienten til Domibus ligger under "msh_integrations").
• msh_adapter: Web-modul der udstiller snitflader til at starte baggrundsjobs, aflæsning af status'er og alarm'er samt indlæsning af konfiguration.
• msh_integrations: Integrationer til DROS, Domibus og EDS-service.
• msh_schema: Domibus- og EHMI-skemaer til generering af Java-kode.

Komponenten indeholder følgende integrationer, som alle ligger under "msh_integrations":

• Domibus-integration, baseret på WSDL-fil fra "msh_schema" og jakarta.xml.ws.
• EDS-integration som er FHIR-baseret.
• DROS-integration baseret på IHE-frameworket og Apache CXF.

Opsætning af udviklingsmiljø

Projektet ligger som nspop git-repository på følgende adresse: 

• https://git.nspop.dk/projects/COM/repos/ehmi-message-handler/browse

Som en del af projektet, leveres der også en konfiguration af Domibus, som skal anvendes af NSP. Den findes også i git:

• https://git.nspop.dk/projects/COM/repos/domibus-access-point/browse

EMR er udviklet i java 21 og kan bygges med.

mvn clean install

Som en del af bygget afvikles der unit tests.

Afvikling

Maven bygger war-filerne, som kan deployes med docker compose. Dette gøres lokalt med kommandoen:

docker-compose -f compose/development/docker-compose.yaml up --build

Herefter vil EMR MSH Adapter services være tilgængelig under http://localhost:8092/msh-adapter/.

Bemærk, der ligger pt. også en "Stub" services i projektet. Den er kommenteret ud i Docker Compose, og var tiltænkt test på "test1". Den skal aldrig ud i produktion, og vil muligvis helt udgå på et senere tidspunkt.

Det er muligt at sætte en remote debugger op på port 5056.

Integrationstests

Integrationstesten kan afvikles op imod et kørende system på localhost med følgende kommando:

mvn verify -pl msh_integration_tests -Pintegration-test

Pt. er det et udestående omkring at definerer profiler, så testen kan køre mod udviklingsmiljøerne på test1 og test2, da disse i skrivende stund endnu ikke er deployed.

Projektstruktur

For nærmeste beskrivelse af projektets struktur og opbygning, se Design- og Arkitekturbeskrivelsen.

Database

Databasemodellen styres ved hjælp af liquibase. Det betyder, at når der skal laves ændringer til databasen, så må man ikke rette i de eksisterende skemafiler. I stedet skal der laves nye filer, der beskriver ændringerne.