...

Projektet bygges med Maven og kræver Java 8 samt en MariaDB-installation for at kunne afvikle unit-tests.

Udover normalt tilgængelige Maven dependencies, afhænger projektet også af interne artefakter. Hvis disse artefakter ikke er udgivet (released) i den påkrævede version i NSP's Nexus repository, skal man selv udtjekke og bygge dem fra NSP's Subversion i den pågældende version. Artefakternes forskellige versioner vil være tilgængelige under et Subversion-tag. Disse artefakter er:

• cpr-subscriber (Maven identifier: dk.sds:cprsubscriber)

For at bygge disse interne artefakter, henvises der til artefakternes dokumentation.

Ændringslog

Byggevejledning

For at bygge projektet og dets deployables (war-filer) uden at køre unit-tests og integrationstests, anvendes følgende Maven kommando:

...

Herunder beskrives servicens tilgang til database samt oprettelse af tabeller og views.

Tilgang til database

Servicen kræver to databaser: en til Livstestamenteregistret og en til Behandlingstestamenteregistret. Derudover afhænger den af adgang til et view i en (replikeret) stamdata-database.består af en database, der både indeholder data for Livstestamenteregistret og for Behandlingstestamenteregistret. 

Servicen konfigureres med 3 datasources1 datasource, som tilgår databaserne databasen vha. separat specificerede brugere.

To brugere En bruger skal henholdsvis give adgang til Livstestamenteregister-databasen og Behandlingstestamenteregister- databasen, og de den skal begge være tildelt følgende rettigheder på deres pågældende databasedatabasen:

• Ved normal drift i produktion: SELECT, INSERT, UPDATE, DELETE
• Yderligere nødvendige rettigheder ved databaseoprettelse og migreringer: CREATE, DROP, ALTER

Databasebrugeren, der tilgår stamdata-view'et, skal være tildelt følgende rettigheder:

• Ved normal drift i produktion: SELECT
• Yderligere nødvendige rettigheder ved databaseoprettelse og migreringer: CREATE VIEW, DROP

Oprettelse af database og tabeller

Datamodellen styres vha. inkrementelle SQL-scripter, der kan findes under compose/database/db/migration. De er inddelt i 3 undermapper:

• ltrbtr:  indeholder scripter indeholder scripts til at køre på servicens Livstestamenteregister-database btr: indeholder scripter til at køre på servicens og Behandlingstestamenteregister-database
• stm: indeholder scripter til at køre på en (replikeret) stamdata-database.

I produktion anvendes scripterne manuelt og skal køres på databasen i inkrementel rækkefølge baseret på versionsnummeret i filnavnet (først V1__(...).sql, dernæst V2__(...).sql, osv.). Hvert script må aldrig køres mere end én gang; der gælder dog en undtagelse for ikke-versionerede scripter, hvis filnavne begynder med R, som står for Repeatable. Disse Repeatable scripter skal køres hver gang deres indhold (checksum) er blevet ændret, men de må først køres efter alle versionerede scripter er blevet kørt. 

Ved initial installation af servicen vil det således være følgende scripter, der skal køres i den nedenstående rækkefølge:

Servicens

...

Behandlingstestamenteregister og Livstestamenteregister-database

• ltrbtr/V1__create_LivingWill.sql
• ltrbtr/V2__create_PropertiesLivingWill.sqlltr/V8__add_PersonIdentifier_index.sql

Servicens Behandlingstestamenteregister-database

• btr/V3__create_TreatmentWill.sql 
• btr/V4__create_PropertiesTreatmentWill.sql
• btr/V5__alter_add_NoForcedTreatmentIfIncapable.sql
• btr/V6__migrate_RelativeAcceptanceRequired_to_AcceptanceNeeded.sql
• btr/V7__add_AcceptanceNeeded_for_all.sql
• btr/V9V8__add_PersonIdentifier_index.sql

(Replikeret) Stamdata-database

• stm/Rbtr/V9__createadd_v2_Person_Simplified_view.sql

• PersonIdentifier_index.sql

Deployment

Komponenten deployes vha. NSP's platform Docker image og konfigurationsfiler mountes i containeren som angivet i projektets Compose-filer.

ltr-btr-service-wildfly indholder de nødvendige konfigurationsfiler til valg af datasourcesdatasource, brugerdefinerede parametre, logning, mm. Wildfly-modulet er integreret i komponentens Docker image.

...

Herunder beskrives properties i ltr-btr-service-wildfly komponentens konfigurationsfiler.

application.properties

log4j.xml

Konfigurerer logning for servicen.

...

Konfiguration af datasources

ltr-btr-service-wildfly komponenten -komponenten kræver adgang til 2 en JNDI datasources-datakilde. Disse Det skal opsættes i Wildfly og refereres henvises til i servicens tjenestens application.properties.

Overblik over komponenter

Se driftsvejledningen for yderligere information.

...