Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Alias

Beskrivelse

Oversigt

Dokumentdelingsservice (DDS)

DGWS

Den Gode WebService 1.0.1

Design

DDS - Design- og Arkitekturbeskrivelse

Installationsvejledning

DDS - Installationsvejledning

Min-log

MinLog2 - Design og Arkitektur beskrivelse

SAM

MinSpærring - Arkitektur og Design

SAM-guide

MinSpærring - Guide til Udviklere

Minlog-guide

MinLog2 - Min Log Registrering - Guide til udviklere

TODO: tjek om alias bliver brugt

Introduktion til DDS Registry og Repository

...

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.

Unit test (JUnit)

...

Integrationstest

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.

cd integrationstest

mvn verify -Plocal,integration-tests

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


TODO: hvor meget skal med fra gl repository guide i afsnit "Beskrivelse af kildekodens struktur og design" og hvor opdateret er den? Ret evt. intro afsnit

TODO: Og hvad med Cobertura til code coverage. Source koden har referncer her til. Evt. flyttes til test vejledningen?


...

Servicen er implementeret som en Java-webservice.


Beskrivelse af kildekodens struktur og design

TODO Eva

Kodestruktur

Projektet er delt i følgende moduler:

  • dds/common – modul der indeholder de java-komponenter, de to webservices (DDS registry & repository) deler.

  • dds/brs-client – modul der indeholder en webserviceklient til kommunikation med BRS.

  • dds/ddsregistry – modul der indeholder webservice til filtrerede opslag i healthshare (denne service).

  • dds/ddsrepository – modul der indeholder webservice til at hente dokumenter vedrørende specifikke patienter fra healthshare

  • dds/types – modul der indeholder wsdl’er og xml-skemafiler i SOAP 1.2 version. Disse bruges af webservicen, til at snakke med healthshare.

  • dds/integrationtest-util – modul der indeholder java-komponenter, som flere integrationtests deler.

  • dds/client-types - modul der indeholder wsdl’er og xml-skemafiler i SOAP 1.1 version. Disse skal bruges til at lave en klient der kan kontakte DDS repository.

  • dds/cobertura – modul der indeholder komponenter til instrumentering af kode til generering af code coverage rapport.

  • dds/xds-repository-stub – modul der indeholder en stub der kan køres tests imod.

  • dds/ddsregistry-proxy – modul der indeholder en proxy til udviklingsbrug. Proxyen sikrer at der kun bliver gemt data på testpatienter.

Der er afhængigheder til forskellige maven-artefakter, hvoraf følgende er skabt i regi af NSI:

  • dk.nsi,services-common:services-common – modul der indeholder de dele af koden der er fælles for alle komponenterne, herunder interface til opslag i SOR register, DGWS fejlkoder, samt utilities til logning med mere.

  • dk.nsi.services-common:remote-test-resources – Modulet indeholder SQL-scripts og datasource konfigurationer til Stamdata database. Scripts opretter Stamdata databasen og tabellerne med initielt test data.

  • dk.nsi.hsuid:hsuid – modul der indeholder implementering af OIO attributter til identifikation af sundhedsfaglige personer, der er fælles for webservicekomponenter, der anvender DGWS.

  • dk.nsi.dgws:dgws-common – modul der indeholder implementering af DGWS fælles funktionalitet til håndtering af DGWS header og fejlkoder.

  • dk.nsi.dgws:provider – modul der indeholder implementering af DGWS provider funktionalitet, der anvendes af alle komponenter der anvender DGWS i rollen som web service provider.

  • dk.nsi.dgws:remote-test-resources – Modulet indeholder SQL-script og datasource konfiguration til whitelist databasen. Script opretter whitelist databasen med initielt test indhold.

  • dk.nsi.dgws:consumer – modul der indeholder implementering af DGWS consumer funktionalitet, der anvendes af komponenter der anvender DGWS i rollen som web service consumer (aktuelt ConsentAdministration, der kalder Min-log-registration webservicen).

  • dk.nsi.consentservices.verification:consent-verification-client – modul der indeholder funktionalitet til kald af webservice til verifikation af samtykker.

  • dk.nsi.minlog.registration:minlog-registration-client – modul der indeholder funktionalitet til kald af webservice til registrering af hændelser i en borgers Minlog.