Formål

Dette dokument har til formål at gøre det muligt for andre end den oprindelige leverandør at overtage videreudvikling af Det Fælles Stamkort 1.5 (FSK).

Dokumentationen er rettet mod udviklere og IT-arkitekter, som ikke på forhånd har kendskab til komponenten, og som ikke har adgang til komponentens oprindelige udviklere.

Det forudsættes at læseren har læst dokumentet Design og Arkitektur (FSK).

Ændringslog

Introduktion til projektet

FSK 1.5-servicens formål er at agere som en on-demand datakode for Dokumentdelingsservicen (DDS). Såfremt en sundhedsprofessionel henter en borgers stamkort gennem Dokumentdelingsservicen, vil FSK 1.5 servicen blive kaldt af DDS, og returnere et XML dokument, som er sammenstillet af data fra følgende registre:

• CPR-Enkeltopslag (SCES)
• Organdonorregistret (ODR)
• Livstestamenteregistret (LTR)
• Behandlingstestamenteregistret (BTR)
• Stamkortregistret (SKR)
  

For ODR, LTR og BTR gælder, at der kun returneres information om, hvorvidt der findes data i de pågældende registre eller ej. Såfremt data ønskes hentet fra disse registre skal der foretages til kald direkte til den pågælende register-service. Se Guide til anvendere (FSK) for beskrivelse af format for dokumentet, der returneres af FSK 1.5

Servicen er designet med henblik på udstilling via den nationale serviceplatform (NSP).

Kodebasen består af én WAR-fil / komponent fsk-web.war.

Specielle bemærkninger

Databasevedligehold

Servicen benytter i udviklingssammenhæng Flyway, hvilket gør at databasen i udviklingsmiljøet automatisk opdateres til gældende version.

Klienter til kald af underliggende registre

WSDL'er og XSD'er for SCES, ODR, LTR, BTR og SKR ligger i modulet fsk-schemas. Dette modul genererer JAXB-klasser som defineret i modulets pom.xml. De genererede klasser anvendes af tilsvarende Client-moduler SCESClient, OrganDonorClient, LivingWillClient, TreatmentWillClient og PersonalDataCardRegisterClient, som alle findes her: fsk-service/src/main/java/dk/stamkort/integrations.

Foretage succesfuldt kald af on-demand webservice i udviklingsmiljø

Efter deployment af fsk-web.war til en lokal Wildfly installation i udviklingsmiljøet er det muligt at kalde on-demand webservicen. Dette kan eksempelvis gøres ved at afvikle metoden callOnDemandService i klassen OnDemandServiceITCase inde i IntelliJ, og forinden specificere FSK_TEST_PORT til 8080 i den tilhørende IntelliJ runtime-konfiguration.

Som udgangspunkt er det dog ikke er muligt at få et succesfuldt svar tilbage, med mindre alle underliggende services kan kaldes med succes. Dvs. der skal anvendes et cpr-nummer, der findes i SCES, og både LTR-BTR, ODR og SKR skal være deployet korrekt til Wildfly.  Alternativt kan integration til de enkelte services disables i FSK-servicens application.properties, som det f.eks. er gjort i fsk-test modulet.

Afvikling af unit-tests

For at bygge projektet og afvikle unittests anvendes følgende kommando:

mvn clean install

Der genereres en testrapport.

Adgange

Der er behov for adgange til følgende systemer:

• NSP SVN-repository
• Dependencies trækkes fra NSP's Nexus-repository: https://nexus.nspop.dk

Opsætning af udviklingsmiljø

Al kode findes i NSP SVN.

Efter at projektet er checket ud vil man typisk gøre følgende:

• Opsætte udviklingsmiljø (her antages IntelliJ)

• Bygge war-filen med Maven og køre tests

Bygge WAR filer

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

• En Subversion-klient

• Java 8

• Maven

Gennemfør følgende steps for at bygge WAR filer:

1. Check projektet ud fra SVN

2. For at bygge projektet, foretage unittests samt at bygge war-filer foretages kommandoen: mvn clean install

Deployment med Docker

Når man udvikler kan det være praktisk at deploye applikationen lokalt. Dette kan gøres vha. Docker Compose-filen under compose/development/docker-compose.yml.

docker-compose up -d --build

I forbindelse med udvikling og fejlsøgning kan det være praktisk også at spinne FSK Registry op samt CDA viewer, som giver en brugergrænseflade, der kan anvendes til fremsøgning og hentning af stamkort på udviklingsmiljøet. Der er lavet en docker-compose til dette formål: compose/development/docker-compose-testutils.yml.

Den kan startes med:

docker-compose -f docker-compose-testutils.yml up 

hvorefter CDA viewer er tilgængeligt lokalt på: http://localhost:8081/