Formålet med dette dokument er at beskrive de tests, som er udviklet og afviklet forud for release af DDS Registry.
Følgende typer af test bruges indgår i udviklingsarbejdet:
Unittests, der verificerer, at de individuelle enheder i kildekoden virker efter hensigten, herunder måling af code coverage.
Integrationstest, der verificerer at de individuelle enheder kan integreres og arbejde sammen, til verifikation af funktion og deployment.
Performancetest, der verificerer at servicen performer med hensyn til svartider og er stabil under et specifikt load, som i nogle tilfælde kan anvendes med samme mål som integrationstests.
Endurancetests, der verificerer at servicen fungerer under længerevarende belastning og ikke har f.eks. memory leaks, som kan udføres i stagning/produktionslignende miljø.
For de typer af tests og det også beskrevet i hvilket omfang der er særlige krav til testdata, og hvorledes etablerede testdata kan vedligeholdes.
Dokumentet henvender sig til udviklere og testere. Læseren forventes at have kendskab til Java software udvikling, herunder unittesting, med anvendelse af Maven, JBoss applikationsserver og MySQL.
Version | Dato | Ansvarlig | Beskrivelse |
1.0 | 29.06.2012 | Systematic | Initiel udgave |
1.1 | 21.08.2012 | Systematic | Beskrivelse af keystores i afsnit 2.2.1 uddybet, Maven-kommando i afsnit 2.2 opdateret. Integrationstests med specielle forudsætninger er nu beskrevet i afsnit 2.2.2 og 2.2.3. Opdateret placeringen af environment fil. |
1.1a | 19.04.2012 | Systematic | Opdateret placeringen af flere tests, grundet refaktorering af kode Udgave til Release Candidate 1 |
1.2 | 19.06.2013 | Systematic | Kvalitetssikret |
1.3 | 23.05.2014 | Systematic | Rettelser som konsekvens af opsplitning af tidl. NPI-mavenprojekt i selvstændige komponenter. |
1.4 | 28.11.2014 | Systematic | Nationalt Patientindeks (NPI) erstattet med Dokumentdelingsservice (DDS) |
1.5 | 14.01.2015 | Systematic | Nye kommandoer til maven og ændring af npi og npiservices til dds |
1.6 | 05.05.2015 | Systematic | Kodereferencer er opdaterede pga. navneskifte fra NPI til DDS |
1.7 | 17.12.2016 | Systematic | Opdateret header billede |
1.8 | 3.10.2017 | Systematic | Forældet reference til TRP/0009 erstattet med TRP/0112. |
1.9 | 13.06.2018 | Systematic | Migreret til NSPOP SVN |
1.10 | 12.11.2018 | KvalitetsIT | Flyttet dokumentation til Confluence |
Definition | Beskrivelse |
DDS | Dokumentdelingsservice |
NSI | National Sundheds-IT |
NSP | Den nationale service platform (inden for sundheds-IT) |
SHAK | Sygehusafdelingsklassifikation |
SOR | Sundhedsvæsenets organisationsregister |
STS | Security Token Service |
Alias | Beskrivelse |
UdviklerGuide | Guide til Udviklere DDS Registry (SSE/11734/PHB/0010) |
TestRapport | Testrapport Dokumentdelingsservices (SSE/11734/TRP/0112) |
Følgende tests er afviklet som en del af komponent udviklingen. Der henvises i øvrigt til [UdviklerGuide] for udførselsvejledning og [TestRapport] for resultat.
DDS Registry\s unittests ligger i:
dds\ddsregistry\application\src\test\java\dk\nsi\ddsregistry\adhocquerywrapper\AdhocQueryRequestWrapperTest.java
dds\ddsregistry\application\src\test\java\dk\nsi\ddsregistry\adhocquerywrapper\AdhocQueryResponseWrapperTest.java
dds\ddsregistry\application\src\test\java\dk\nsi\ddsregistry\impl\DDSRegistryLogicTest.java
dds\common\src\test\java\dk\nsi\ddsservices\invocation\treatmentrelation\TreatmentRelationInvokerTest.java
dds\common\src\test\java\dk\nsi\ddsservices\lookup\authorisationcode\AuthorisationCodeCheckerTest.java
dds\common\src\test\java\dk\nsi\ddsservices\ws\impl\UserCheckTest.java
AdhocQueryRequestWrapperTest verificerer at udtræk af patient id fra AdhocQueryRequest er korrekt.
AdhocQueryResponseWrapperTest tester metoder på AdhocQueryResponseWrapper til filtrering af AdhocQueryResponse ud fra samtykker.
DDSRegistryLogicTest tester den implementerede forretningslogik i DDS Registry, fejlhåndtering og delvist tilgængelighed af de backend services DDS Registry bruger.
TreatmentRelationInvokerTest tester integrationen mod behandlingsrelationsservicen.
AuthorisationCodeCheckerTest tester rettighedsstyring i forhold til autorisationstabellen, som i testen er en in-memory-database.
UserCheckTest tester valideringens- og autorisationslogikken til rettighedsstyring ifm. HSUID-roller.
Integrationstestene til DDS Registry er ligger i eget svn repository: https://svn.nspop.dk/svn/kvalitetsit/dds-integrationtest/
Der er udviklet integrationstests, der matcher user stories og test cases i dokumentet DDS - Guide til anvendere.
Keystores benyttes i forbindelse med integrationstestene.
Integrationstestene er afhængige af pre-installeret testdata for:
Whitelist
Stamdata (SOR-data og autorisationsregister-data)
Integrationstests opretter selv sine testdata i form af spærringer og dokumenter.
Testene kan afvikles mod følgende miljøer:
Testen afvikles manuelt med følgende kommando:
mvn verify -P<miljø>,integration-test
Performancetests
Performancetesten af baseret på requests fra integrationstesten. Ved integrationstesten gemmes to DDS Registry soap requests, per default under c:\dds. Dette kan konfigureres vha. environment property filen, som findes under dds\environment.properties, ved at sætte property’en soaprequest.log.dir.
Herefter skal databasen på test target (fx NIAB) initieres hvilket gøres fra performance folderen med:
mvn initialize -Pperf-setup
Selve performancetestene er lavet i JMeter og er gemt under:
performance\src\main\test\resources\jmeter\regSQHealthcareProfessionalDataSpecNegConsentOrgHavingDataSpecPosConsentAndOnBehalfOfPerf.jmx
performance\src\main\test\resources\jmeter\regSQHealthcareProfessionalPerformingConsentOverridePerf.jmx
Hvis man har valgt at sætte soaprequest.log.dir property’en til noget andet end c:\dds skal filnavet i jmx-filen ligeledes ændres. Dette gøres i JMeter ved at redigere ’Filename’ under ’DDSRegistry’ > Loop Controller > SOAP/XML-RPC Request”.
Verificer at test target URL er konfigureret korrekt (hostname:port) i JMeter SOAP/XML dialog.
Der bør udføres check fra JMeter at request til test target fungerer korrekt inden den automatiske test gennemføres og der genereres chronos rapporter.
Performance tests gennemføres fra en workstation med adgang til test target med kommandoen:
mvn verify –Pddsregistry-data chronos-report:report
mvn verify –Pddsregistry-consentoverride chronos-report:report
Chronos HTML reporter findes under performance\target\site (folderne css og images medtages).
Efter at havde kørt performancetesten kan load data fjernes fra databasen på test target med.
mvn initialize -Pperf-teardown
Test dataene bliver skabt af DDSPerfTestSetup.sql sql-scriptet som ligger under performance\src\main\test\resources\sql\DDSPerfTestSetup.sql
Der er ikke kørt nogen separat endurance test på DDS Registry.
Der er ingen særlige testdata eller krav til testdata for disse tests.