Introduktion

Formål

Formålet med dette dokument er at beskrive hvordan et udviklingsmiljø, til videreudvikling af DDS registry, kan sættes op, samt hvordan koden bygges, deployes og testes.

I afsnit 3 beskrives de softwaremæssige krav der er til miljøet samt hvordan kode bygges.

I afsnit 4 beskrives deployment-miljøet.

Kodestrukturen, kodemæssige afhængigheder til tredjeparts moduler og de forskellige servicemodulers ansvar og design beskrives i afsnit 6.

Testdesign findes i afsnit 7.

Sammenhæng med øvrige dokumenter

Dette dokument er en del af den samlede dokumentation for DDS projektet.

Dokumentets relation til de øvrige dokumenter er beskrevet i dokumentationsoversigten for projektet: Dokumentdelingsservice (DDS).

Læsevejledning

Læser forventes at have kendskab til Java softwareudvikling med anvendelse af Maven, WildFly applikationsserver og MySQL.

Hvor der i teksten er angivet <component base> refereres til topniveaufolderen for kildekoden for komponenten.

Dokumenthistorik

Definitioner og referencer

Introduktion til DDS Registry

Realisering af DDS registry består af en Java-baseret webservice.

Webservicen tillader dels

• kildesystemer at registrere metadata om patientinformationer i dokumentdelingsservice og dels

• anvendersystemer at lave forespørgsler til dokumentdelingsservice og få metadata om patientinformationer, der er gemt deri, retur

Servicen filtrerer returnerede metadata baseret på borgerens samtykker, validerer brugerens rettigheder, kalder behandlingsrelationsservicen og gemmer eventuelle relevante oplysninger i borgerens Min-log.

For en dybere introduktion til servicen og baggrunden bag, se DDS Registry System Arkitektur.

Opsætning af udviklingsmiljø

det følgende antages at koden er hentet ned fra softwarebørsen el.lign.

Krav til software

Krav til applikationsserveren, operativsystemet og databasen er de samme som til produktionsmiljøet. De specifikke krav kan ses i [Installationsvejledning] afsnit 2.

Derudover er der en række krav til de anvendte udviklingsværktøjer:

Krav til Maven

Maven 3.0.3 eller højere anvendes.

Bygge EAR filen

Følgende software er nødvendig for at bygge projektet

• Maven (min. version 3.0.3)

• WildFly (se Installationsvejledning DDS Registry)

• MySQL (se Installationsvejledning DDS Registry)

Gennemfør følgende steps for at bygge webservicen.

Trin 1:

For at etablere databaser og initielt indhold, køres følgende fra <component base>/dds: 

mvn package –Pschema-setup

Bemærk, at dette trin kun er nødvendigt ved første byg samt ved ændring i databaseskemaer eller initielt indhold.

Trin 2:

Se Installationsvejledning DDS Registry for nødvendige trin til at registrere datasources på WildFly

Trin 3:

DDSRegistry modulet med default properties sættes op ved kørsel af:

mvn package –Pdeploy-ds-appserver

Whitelist og Stamdata datasources hentes fra eksterne afhængigheder beskrevet i 6.1

Trin 4:

Kørsel af integrationstests forberedes ved at tilrette properties-filer. Der eksisterer følgende filer, der kan benyttes som skabelon for tilpasning:

<component base>/dds/environment.properties

<component base>/dds/testclient.properties

Trin 5:

For at bygge projektet, foretage unit- og integrationstest samt pakke og deploye war-filen foretages følgende kommando fra <component base>/dds:

mvn clean install –Ddev -Denvironment-property-file=<sti til tilpasset environment.properties>

Bemærk, at dette afstedkommer deployering til WildFly, herunder at: Service(s) deployeres til WildFly (hvilket kræver skriverettighed i standalone/deployments)

Ønskes byg af projektet gennemført uden deployering til WildFly, kan der, i stedet for bygge-kommandoen ovenfor, køres følgende kommando:

mvn clean install

Integrationstests med interne services

Ud over kald til eksterne registries, afhænger DDS Registry også af følgende services:

Af disse services kræves tilgængelighed til STS, Samtykkeverifikationsservice og minlog-registration, hvor STS er en ekstern service og Samtykkeverifikationsservice og MinlogRegistration-service er projekter i NSI suiten.

For at udføre integrationstests kræves derfor et deployeret byg af Samtykkeverifikationsservice og MinlogRegistration-service på samme WildFly instans, hvor DDS Registry deployeres og testes.

Byg og test af samtykkeverifikationsservice og MinlogRegistration-service kan ses i [SAM-guide] og [minlog-guide].

Kørsel af integrationstests forberedes ved at tilrette properties-filer. Der eksisterer følgende filer, der kan benyttes som skabelon for tilpasning:

• <component base>/dds/environment.properties

• <component base>/dds/testclient.properties

mvn verify –Pexternal-test -Denvironment-property-file=<sti til tilpasset environment.properties> -Dtestclient-property-file=<sti til tilpasset testclient.properties>

mvn clean install -Ddev -Denvironment-property-file=<sti til tilpasset environment.properties> -Dtestclient-property-file=<sti til tilpasset testclient.properties>

mvn clean install

mvn clean install