Anvendere af Nap-reference-web og nap-reference-facade er primært gæstesystemudviklere, derfor er denne guide målrettet disse.
Nap-reference-web er bygget med Angular 9.1.7 og fungerer som illustration på:
Brug af NAP SDK
Applikationens hovedfunktionalitet er at vise aftaledokumenter for den patient, der er i kontekst i det værtssystem, den er indlejret. Således er der ingen funktionalitet, hvis ikke der findes en NAPbridge på global scope, som når applikationen åbnes i en almindelig browser.
Da angular frameworket lægger sig op af model-view-controller pattern er dette også implementeret i nap-reference-web. Således bliver komponenter, templates og style sheets genereret med `ng g c`.
Derfor er der simple komponenter til at vise aftaler, hjælp, fejl osv.
Services håndterer forretningslogikken og bliver genereret med `ng g s`.
Derfor er der simple services til håndtering af authentication, applikationsfejl og konfigurering osv.
Der ligger en .npmrc, som sørger for at hente dependencies fra
https://nexus.nspop.dk/nexus/repository/nsp-npm/.
Nap-reference-web benytter sig af en konfigurations fil (assets/configurtation.json), som loades via configuration-servicen. Denne konigurationsfil bliver således overskrevet i de forskellige docker-compose setups.
Da NSP web applikationer kan blive deployet på vilkårlige paths, er det vigtigt at applikationen fungerer med relative paths. Derfor blive base i index.html sat dynamisk i app.module.
Nap-reference-web benytter sig af testframeworket Karma, da der kommer pr default med angular. Karma hiver Istanbul indtil at genere test-coverage rapporter. Testene køres i en headless chromium browser.
Jenskinsfilen beskriver en jenkins pipeline, som anvender NSPs eget docker-image til afvikle tests. Derudover ligger der en folderstruktur under compose, som skal anvendes til at verificere at byggene virker og som bruges til release opsætning.
Kode dokumentationen bliver generet med TSDoc.
Nap-reference-web implementerer version 1 af eventkataloget.
Starten en trusted session hvor brugerens SAMLassertion overføres.