...

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])

• MySQL (se [Installationsvejledning])

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] for nødvendige trin til at registrere datasources på WildFly

Trin 3:

DDSRepository 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

Integrationstest

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

...

Service

...

Kræves ved integrationstests

...

STS

...

X

...

Samtykkeverifikationsservice

...

X

...

Behandlingsrelationsservice

...

X

...

MinlogRegistration-service

...

X

Krav til Docker

Docker 18.x eller højere anvendes.

Bygge komponenten

Udfør følgende kommando for at bygge komponenten:

mvn clean install

Det tager lidt tid, da der skal genereres kode ud fra et større antal wsdl-filer.

Integrationstest

Integrationstests for DDS er placeret i deres eget repository, https://svn.nspop.dk/svn/kvalitetsit/dds-integrationtest/. For at køre integrationstesten gøres følgende:

Byg DDS, som beskrevet ovenfor

Udfør følgende kommandoer:

cd compose/development
docker-compose up --build

Vent på at setuppet kommer op.

Check integrationstest-projektet ud fra SVN, kør følgende:

mvn verify -Plocal,integration-tests

Det er muligt at ramme andre miljøer end det lokale ved at udskifte local med test1 eller test2.

Byg af teststubbe til eksterne services

Der er udviklet

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 JBoss instans, hvor DDS Repository 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

Følgende to muligheder kører integrationstestene:

• Når et byg er deployeret til WildFly (enten manuelt eller ved byggekommandoer fra afsnit 3.2), da kan integrationstests gennemføres uden deployering til WildFly ved følgende kommando:

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

• 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> -Dtestclient-property-file=<sti til tilpasset testclient.properties>

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

Byg af teststubbe til eksterne services

Der er udviklet to teststubbe til at hjælpe i udviklingen og test af denne service. De to stubbe erstatter de to eksterne afhængigheder, som servicen har; BRS og HS repository. For begge stubbe gælder, at for at benytte stubben skal wsdl.location/ service.location for den tilsvarende service rettes i DDSRepository.properties, så den peger på lokationen, hvor stubben er deployet.

BRS-stubben er placeret i et separat modul under folderen dds/brs-stub. Fra denne folder bygges og deployeres til WildFly med standard Maven-kommandoen:

mvn clean install

BRS-stubben logger kaldet, men foretager sig intet derudover.

.

BRSXDS-repository-stubben er tilsvarende placeret i et separat modul , blot under folderen dds/xds-repositorybrs-stub. Fra denne folder bygges og deployeres der automatisk til WildFly når DDSRepository bygges med kommandoen:

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

Ønsker man et separat byg af xds-repository-stubben kan og deployeres til WildFly med standard Maven-kommandoen benyttes:

mvn clean install

XDS-repository-stub returnerer de data, der er nødvendige for at afvikle integrationstestene.

Deployment på WildFly

Der henvises til installationsvejledningen [Installationsvejledning] for nærmere instrukser.

Udviklers workstation

Når man udvikler kan det være praktisk at foretage deploy til en lokal WildFly.

NIAB

Det anbefales at benytte NSP-in-a-box (NIAB) til, da denne indeholder en WildFly der er konfigureret på samme måde som den fundet ved operatøren, samt at NIAB anvender et Linux operativsystem.

I forbindelse med anvendelse af NIAB til gennemførelse af integrationstests for DDS, skal følgende konfigureres:

...

Ved upload af kildekode til NIAB anbefales Winscp, som sikrer korrekt håndtering af Windows CR/LF <-> Unix LF håndtering

...

Properties fil under dds/ med navn environment.properties kopieres fra eksisterende og opdateres med rigtige data (NSP filer indeholder NIAB specifikke data)

...

Properties fil for testclient.properties tilrettes evt. med URL

...

Properties fil under dgws/provider/src/main/resources med navn providertest.nspadmin.properties tilrettes

BRS-stubben logger kaldet, men foretager sig intet derudover.

XDS-repository-stubben er tilsvarende placeret i et separat modul, blot under folderen dds/xds-repository-stub. Fra denne folder bygges og deployeres der automatisk til WildFly når DDSRepository bygges med kommandoen:

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

Ønsker man et separat byg af xds-repository-stubben kan standard Maven-kommandoen benyttes:

mvn clean install

XDS-repository-stub returnerer de data, der er nødvendige for at afvikle integrationstestene

...

.

Beskrivelse af systemdesign

...