Fælles testmiljøer Statens Serum Institut Sektor for National Sundheds-it - Anvenderguide: Visuel adviseringsklient, en funktionel prototype Artillerivej 5 2300 København S Dato: 12.12.2013 Version: 1.0 Udarbejdet af: NSI Resumé NSI har udviklet en funktionel prototype med en visuel brugergrænseflade, der giver ikke-teknikere mulighed for at tilgå adviseringsservicen. Version Ansvarlig Kommentar 1.0 CHG Første udgave Side 1
Indholdsfortegnelse 1 Anvenderguide til den visuelle testdataklient... 3 1.1 Overordnet beskrivelse af hvordan klienten anvendes... 3 1.2 Gennemgang af hvordan klienten anvendes... 3 1.2.1 Trin 1: Vælg ID typen... 4 1.2.2 Trin 2: Angiv ID er... 4 1.2.3 Trin 3: Opret eller opdater ID- listen... 4 1.2.4 Trin 4: Opret abonnement... 4 1.2.5 Trin 5: Hent adviser... 4 2 Dokumentation til teknikere og administratorer... 5 2.1 Konfiguration og sikkerhed... 5 2.2 Fejlhåndtering... 5 2.3 ID- list formater og andet... 5 2.4 Afgrænsninger... 5 3 Baggrundsinformation omkring klienten... 6 3.1 Placering af kildekode... 6 Side 2
1 Anvenderguide til den visuelle testdataklient NSI har udviklet en visuel klient, der er en funktionel prototype til brug for ikke-teknikeres interaktion med adviseringsservicen i de fælles testmiljøer. Klienten giver mulighed for at oprette og vedlige en enkelt liste af ID er (eksempelvis CPR numre), oprette et enkelt abonnement for et givet emne (eksempelvis medicinkortet) samt hente adviseringer som rå XML. 1.1 Overordnet beskrivelse af hvordan klienten anvendes På figuren nedenfor er klienten illustreret med tekstbokse, der beskriver de enkelte trin man skal gennemføre for at anvende klienten. Bemærk at brug af klienten forudsætter at en teknisk administrator har konfigureret klienten korrekt, da den ellers vil fejle ved oprettelse af ID-liste. 1:$Vælg#ID#typen# fra#menuen# 4:#Tryk#på#denne#knap#for# at#opre>e#abonnementet.$ 2A:$ID#værdier#kan# indtastes#manuelt#i# tabellen# 2B:#Man#kan#også#vælge#at# bruge#en#teks7il,#hvis#man#har# mange#id#værdier$ 3:#Tryk#på#denne#knap#for# at#opre>e#eller#opdatere# ID?listen#i#adviserings? servicen$ 5:#Tryk#på#denne#knap#for#at# hente#adviser.$ Klienten består af en enkelt fil, nas-client.jar, og startes op ved at man dobbeltklikker på filen. 1.2 Gennemgang af hvordan klienten anvendes Klienten har kun ét vindue, og alle informationer kan konfigureres fra dette. Det anbefales at man følger nedenstående trin i rækkefølge. Trinene refereret i de følgende afsnit har samme nummer som på figuren ovenfor. Side 3
1.2.1 Trin 1: Vælg ID typen Klienten giver mulighed for at vælge hvilke typer ID er der skal ligge til grund for abonnementet, eksempelvis CPR-numre eller ydernumre. 1.2.2 Trin 2: Angiv ID er Klienten giver mulighed for manuel indtastning af ID er (max 10). Hvis der arbejdes med flere ID er skal de i stedet håndteres i en tekstfil. Brugeren kan indlæse en på forhånd udfyldt tekstfil med ID er ved tryk på knappen Indlæs ID-liste fra tekstfil. De indlæste ID er fremkommer da i tabellen. Værdierne i tabellen kan rettes manuelt ved at klikke på de enkelte værdier, både når man manuelt har indtastet ID er og når man har valgt at indlæse fra en tekstfil. Formatet i tekstfilen: - Der skal være én ID i hver linje - Linjer der begynder med # ignoreres af klienten (nyttigt til at angive kommentarer) Bemærk at det er ID er i tabellen, der anvendes senere, så hvis man retter indholdet manuelt efter at have indlæst en tekstfil er det ikke længere tekstfilen, der er gældende. 1.2.3 Trin 3: Opret eller opdater ID-listen Et tryk på Opret/opdater ID-liste henholdsvis opretter eller opdaterer ID-listen i adviseringsservicen med de ID er der står i tabellen. 1.2.4 Trin 4: Opret abonnement Efter ID-listen er blevet oprettet kan brugeren oprette et abonnement på baggrund af IDlisten og det emne adviseringsklienten er blevet konfigureret med. Når først abonnementet er oprettet kan det ikke ændres, derimod kan ID-listen som er knyttet til abonnementet opdateres efter behov. 1.2.5 Trin 5: Hent adviser Et tryk på Hent adviser henter de adviser som en kilde (eksempelvis FMK) efter abonnementets oprettelse har udsendt under det emne der abonneres på og som matcher en af ID erne i ID-listen. De hentede adviser vises i rå form i tekstfeltet. Der hentes op til 10 adviser ad gangen, hvis der er flere adviser skal de hentes i flere omgange. Bemærk at indholdet i statusvinduet kan markeres med musen og eventuelt kopieres til brug for en tekniker, hvis der går noget galt. Side 4
2 Dokumentation til teknikere og administratorer 2.1 Konfiguration og sikkerhed - Løsningen er et simpelt klientprogram, der konfigureres per installation (dvs. per pc/arbejdsstation). - Klienten er pakket som en zip fil der indeholder en eksekverbar jar-fil, en konfigurationsfil og denne anvenderguide. - For at kunne benytte klienten skal anvender-organisationen selv have et FOCES eller VOCES test-certifikat i PKCS12 format som klienten skal konfigureres med. - Klienten konfigureres ved at tilpasse værdierne i konfigurationsfilen nasclient.properties. Som minimum skal følgende værdier rettes: o dk.nsi.nas-client.certificate.path o dk.nsi.nas-client.certificate.password o dk.nsi.nas-client.organisation.cvr o dk.nsi.nas-client.organisation.name - Som default er klienten konfigureret til at abonnere på FMKs topic og køre mod fælles-testmiljøet TEST1. - Klienten kan også konfigureres til at kunne tilgå adviseringsservicen i produktion (kræver produktions-certifikat og SDN aftale). 2.2 Fejlhåndtering Hvis der opstår fejl vises disse i klientens status-vindue og logges til klientens log fil. 2.3 ID-list formater og andet - Adviseringsservicen understøtter vilkårlige typer af ID-lister og kan derfor ikke foretage nogen validering af de enkle ID er i ID-listen. - Klienten er pre-konfigureret med ID-list typerne for CPR-numre og yder-numre. - CPR-numre skal være 10 tegn, dvs. skal angives uden bindestreg. - Ved CPR-numre hvori der indgår bogstaver er der forskel på store og små bogstaver, f.eks. er disse to CPR-numre ikke identiske: 1234567AA0 1234567aa0. 2.4 Afgrænsninger - Klienten benytter det konfigurerede certifikat til at trække et SOSI idkort hos STSen ved opstart. SOSI idkortet har et udløbstid på 24 timer klienten kan derfor ikke benyttes i mere end 24 timer ad gangen, da kald til adviseringsservicen derefter vil blive afvist. - Klienten nedlægger de ressourcer (abonnement, pullpoint og idliste) den fik oprettet når den lukkes ned. - Der er ikke identificeret særlige forudsætninger for brugerens pc udover at der skal være netværksadgang til internettet, og der skal være installeret Java. - Klienten er testet på Java 6 og 7 på Mac og Windows XP, og formodes at køre på ældre versioner af Java også (dog ikke testet). Side 5
3 Baggrundsinformation omkring klienten Adviseringsservicen er godt dokumenteret, både på det konceptuelle plan rent praktisk med kodeeksempler. Der er som supplement til den tekniske dokumentation behov for en visuel klient, der kan anvendes til at opnå og videregive i egen organisation en forståelse af adviseringsservicens anvendelsesmuligheder. Målet er at fremme forståelsen og brugen af adviseringsservicen, og konkret at illustrere hvordan man kan få et prik på skulderen som følge af handlinger i FMK (f.eks. receptfornyelser og opdateringer af medicinkort). Klienten er udviklet som open source og kan derfor frit videreudvikles eller tilpasses lokale forhold og behov. Nærværende anvenderguide udgør den samlede anvenderorienterede dokumentation fra NSI af klienten. Da klienten er en funktionel prototype ydes der ikke support fra NSI på anvendelse eller konfiguration af klienten. Klienten er udviklet i Java og bygges med Maven. 3.1 Placering af kildekode Klientens kildekode er publiceret på softwarebørsen: https://svn.softwareborsen.dk/nas-client/ Side 6