...

...

Anchor
_Toc462245127 _Toc462245127

Afviklede tests

...

Følgende tests er afviklet som en del af komponentudviklingen og i forbindelse med release. Der henvises til \[Testrapport\] for fastholdelse af resultaterne fra gennemførte tests ifm. release.

Anchor
_Toc462245128 _Toc462245128

Unittest

Unittests ligger i:

• *\src\test\java*

...

under de forskellige maven-artefakter, der indgår i Svareksponeringsservice XDS-adaptere. Resultatet af kørte tests opsummeres ved byg, beskrevet i \[Udviklerguide\].

Anchor
_Ref416952058 _Ref416952058

Anchor
_Toc462245129 _Toc462245129

Integrationstest til verifikation af funktionalitet

...

• Dokumentdelingsservices (og dennes afhængigheder til øvrige services, se herunder).
• Svareksponeringsservice XDS-adaptere

Wiki Markup\\ I stamdata skal testbruger være defineret som testperson med autorisationsnr.
Testbrugeren skal være whitelistet til at anvende dokumentdelingsservicen, se afsnit 3.2.3.
Der skal være etableret forbindelse til backend-systemet, hvilket potentielt indebærer oprettelse af laboratoriesvar i Laboratoriedatabanken.
Dokumentdelingsservicen skal være konfigureret til at anvende Svareksponeringsservice XDS-adaptere, som beskrevet i \[Konfiguration\].

Anchor
_Toc462245131 _Toc462245131

Setup

I Figur 1 er vist et setup til integrationstests baseret på en stub for Svareksponerneringsservicen.
Bemærk, at test-klientens tests fungerer uafhængigt af, hvordan de forskellige services er deployeret, hvorfor en vanlig opsætning af Dokumentdelingsservicen i NSP test1-miljø el. lign. kan anvendes.
Image RemovedImage Added

Image Removed

Image Added

...

Testklienten benytter et test-medarbejdercertifikat (MOCES) hentet fra et maven-artefakt etableret i regi af NSI, hvor organisationen bag er whitelistet til at benytte Dokumentdelingsservicen.
I testklienten er med property-fil konfigureret brug af følgende test-bruger, der er oprettet som testperson med autorisationsnummer i testmiljøets stamdata, f.eks. på NSP-miljø test1:
Læge Karl Hoffmann Svendsen, aut.reg.nr. NS362.
I testklienten er hardcoded anvendelse af følgende testpatienter:

...

Denne kan kopieres og tilpasses til aktuelt miljø. Efterfølgende Maven-kommandoer gør brug af tilpassede property-fil gennem argumentet:

-Dtestclient-property-file=<sti til tilpasset testclient.properties>

Er argumentet ikke anført benytter Maven-scripts den oprindelige property-fil.
Integrationstests gennemføres ved at udføre maven-kommando fra integrationtest-directory:

cd integrationtest
mvn verify –Pexternal-test

...

 -Dtestclient-property-file=<sti til tilpasset testclient.properties>

Eksempel:

cd integrationtest
mvn verify -Pexternal-test -Dtestclient-property-file=./src/test/resources/testclient.properties

Integrationstestene understøttes kun ved brug af Svareksponeringsservice stubben "labreportservicestub".
Bemærk, at visse integrationstests kræver konfigurationsændringer og derfor er sat til ignored. Disse kan, efter konfigurationsændring som beskrevet i deres javadoc, køres selvstændigt ved at udkommentere ignore og tilføje argument –Dit.test=<testklasse-navn> til ovenstående maven-kommando.

...

Code coverage-rapport omfattende alene unittests genereres ved at gennemføre følgende trin:

• I kommandoprompt i SXA hovedfolder (folderen med parent pom) udføres:

mvn clean site cobertura:cobertura

• Genereret code coverage-rapport kan nu læses i folderen target/site/cobertura

Anchor
_Toc417550118 _Toc417550118

Anchor
_Toc434997541 _Toc434997541

Anchor
_Toc435777516 _Toc435777516

Anchor
_Toc449964617 _Toc449964617

Anchor
_Toc462245138 _Toc462245138

Code coverage for unittests og integrationstests

...

1. Cobertura etableres, ved enten:
   1. Download fra fx sourceforge (https://sourceforge.net/projects/cobertura/) og udpakning
   2. Kildekode hentes fra https://github.com/cobertura/cobertura/releases og bygges
2. Ant installeres
   1. Download fra http://archive.apache.org/dist/ant/binaries/apache-ant-1.9.4-bin.tar.gz

   2. I Ant's lib folder bør følgende jars være tilgængelige

      Jar	Fremskaffelse
      asm-5.0.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      asm-analysis-5.0.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      asm-commons-5.0.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      asm-tree-5.0.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      asm-util-5.0.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      cobertura-2.1.1.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      commons-lang3-3.3.2.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      oro-2.0.8.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      slf4j-api-1.7.5.jar	Indeholdende i Cobertura-2.1.1-bin-tar
      slf4j-log4j12-1.6.4.jar	Bør være i lokal m2 folder
      log4j-1.2.16.jar	Bør være i lokal m2 folder

3. Installation af Cobertura modul på WildFly:

   1. Følgende Cobertura afhængigheder kopieres fra cobertura-2.1.1-bin.tar.gz til <wildfly folder>/modules/net/sourceforge/cobertura/main

      Jar	Destination
      <arkiv>/cobertura-2.1.1.jar	<modul-main>/
      <arkiv>/lib/asm-tree-5.0.1.jar	<modul-main>/lib/
      <arkiv>/lib/asm-commons-5.0.1.jar	<modul-main>/lib/
      <arkiv>/lib/asm-util-5.0.1.jar	<modul-main>/lib/
      <arkiv>/lib/asm-analysis-5.0.1.jar	<modul-main>/lib/
      <arkiv>/lib/oro-2.0.8.jar	<modul-main>/lib/

   2. En module.xml fil skabes i samme main mappe med følgende indhold:

      Code Block
      <?xml version="1.0" encoding="UTF-8"?>

...

1. 1. <module xmlns="urn:jboss:module:1.1" name="net.sourceforge.cobertura">

...

1. 1. <resources> <resource-root path="."/>

...

1. 1. <resource-root path="cobertura-2.1.1.jar"/>

...

1. 1. <resource-root path="lib/asm-tree-5.0.1.jar"/>

...

1. 1. <resource-root path="lib/asm-commons-5.0.1.jar"/>

...

1. 1. <resource-root path="lib/asm-util-5.0.1.jar"/>

...

1. 1. <resource-root path="lib/asm-analysis-5.0.1.jar"/>

...

1. 1. <resource-root path="lib/oro-2.0.8.jar"/>

...

1. 1. </resources>

...

1. 1. <dependencies> <module name="asm.asm" />

...

1. 1. <module name="javax.servlet.api" />

...

1. 1. <module name="org.slf4j"

...

1. 1. /> </dependencies>

...

1. 1. </module>

   2. Default udskrives coveragefilen (cobertura.ser) i <wildfly folder>/bin mappen. Ønskes filen udskrevet til en anden mappe skabes filen cobertura.properties i main mappen med indeholdet:

      Code Block
      net.sourceforge.cobertura.datafile=<sti>/cobertura.ser

   3. For at få Cobertura til at skrive coverage af integrationstests, er der to muligheder:

      Metode	Installation og brug
      coberturaFlush.war servicen	coberturaFlush.war er at finde i Cobertura-2.1.1-bin-tar Før kopiering til <WildFly>/standalone/deployments skal følgende linje tilføjes til coberturaFlush.war/META-INF/MANIFEST.MF: Code Block Dependencies: net.sourceforge.cobertura Efter ændring deployeres coberturaFlush.war og servicen udstiller

   "<host>

   1. ”<host>/coberturaFlush/

   flushCobertura"

   1. flushCobertura”. Kald til denne service ved f.eks. Curl får Cobertura til at skrive coverage filen. (Se trin 3.3).

   |

   1. Genstart af WildFly	Cobertura skriver automatisk coverage fil ved genstart af WildFly Denne mulighed kræver følgende ændring i <wildfly folder>/bin/standalone.conf med tilføjelse af: Code Block JAVA_OPTS="$JAVA_OPTS -Djboss.shutdown.forceHalt=false"

   |
   1. Bemærk at når WildFly startes med instrumenteret kode, da startes "optagelse" af code coverage. Ved kald til coberturaFlush servicen skabes et billede af hvordan coverage ser ud nu. Dette billede skrives til <wildfly>/bin/cobertura.ser, hvor filen bliver additivt opdateret, hvis filen findes i forvejen, eller skabes, hvis den ikke findes. "Optagelse" af code coverage bliver først reset ved genstart af WildFly og fjernelse af <wildfly>/bin/cobertura.ser.

   2. Genstart af WildFly

Anchor
_Toc417550120 _Toc417550120

Gennemførelse

...

1. Kontroller, at wildfly bruger-account kan skrive cobertura.ser filen i output folderen (Standard <wildfly>/bin/cobertura.ser eller bestemmes i cobertura.properties)
2. Kontroller, at stien til cobertura.ser er korrekt i filen cobertura/src/main/coberturaScripts/cobertura.properties under SXA-projektets hovedfolder.

3. Coberturas instrumentering af koden sker ved udførsel af følgende i kommandoprompt i SXA-projektets hovedfolder (folderen med parent pom):

   Code Block
   mvn clean install -Dcobertura-build \

...

1. -Pdeploy-to-appserver \

...

1. -Denvironment-property-file=<sti til tilpasset environment.properties>

   Bemærk, at argumentet –Pdeploy-to-appserver aktiverer en maven-profil, der kopierer ear/war-filer til WildFly deployment folder vha. properties. Som alternativ til dette argument kan ear/war-filer deployeres manuelt.

2. Gen-deployer SXA-projektets services på WildFly

3. I samme folder udføres integrationstestene ved:

   Code Block
   mvn verify –Pexternal-test __

...

1. -Denvironment-property-file=<sti til tilpasset environment.properties> \

...

1. -Dtestclient-property-file=<sti til tilpasset testclient.properties>

2. Afslutning af coberturas optagelse gennemføres ved enten:
   1. Shutdown af WildFly, eller
   2. At åbne siden http://<host:port>/coberturaFlush/flushCobertura (fx via curl eller i browser. Bemærk at dette forudsætter at filen coberturaFlush.war blev kopieret og deployeret)

3. Flet code coverage-rapporter ved i kommandoprompt i SXA hovedfolder at udføre:

   Code Block
   cd cobertura/target/coberturaReporting-coberturaReporting

...

1. ant –f cobertura.xml create-report

2. Genereret code coverage-rapport kan nu læses i folderen cobertura/target/coberturaReporting-coberturaReporting/report

...