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 (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).

Introduktion til projektet

FSK-servicens formål er at agere som en on-demand datakilde for SFSK. Såfremt en sundhedsprofessionel henter en borgers stamkort, vil FSK-servicen blive kaldt af SFSK, 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)
  
• Fravalg af Genoplivningsforsøg ved Hjertestop Register (FGVHR)

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ældende register-service. Se Guide til anvendere (FSK) for beskrivelse af format for dokumentet, der returneres af FSK.

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

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, SKR og FGVHR 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, PersonalDataCardRegisterClient og FgvhrClient, 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 de pågældende services skal være deployed korrekt på et af NSP's testsystemer (vi bruger typisk "test1" under udvikling). Alternativt kan integration til de enkelte services disables i FSK-servicens application.properties, som det f.eks. er gjort i fsk-test modulet.

Bygge projektet og afvikle unit tests

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

mvn clean install

Der genereres en testrapport.

Adgange

Der er behov for adgange til følgende systemer:

• NSP BitBucket (git)
• Dependencies trækkes fra NSP's Nexus-repository: https://nexus.nspop.dk

Opsætning af udviklingsmiljø

Al kode findes i NSP BitBucket.

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

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/