Extern dialog för Samtycke och vårdrelation
Innehållsförteckning 1 INLEDNING 4 1.1 Allmänt... 4 1.2 Konventioner... 4 1.3 Referenser... 4 3 Webbsidegränssnittet 5 3.1 Förutsättningar... 5 3.2 Gränssnittsspecifikation... 5 3.3 Anropa webbsidan... 6 4 Flöden och logik i sidan 8 4.1 Intyga patientrelation... 8 4.2 Nödsituation... 9 Sid 2/9
Revisionshistorik Version Författare Kommentar 1.0 Roger Öberg Ny mall på dokumentet Sid 3/9
1 INLEDNING 1.1 Allmänt tillhandahåller en webbsida som kan nyttjas externt för autentiserade slutanvändare. Webbsidan är en kombinationssida som erbjuder registrering av samtycke och/eller vårdrelation, samt eventuell nödöppning då patientens samtycke inte kan inhämtas. En aktör som är autentiserad mot autentiseringstjänst kan, via ett externt system, bli omdirigerad till denna sidas URL i en webbläsare. Sidan har funktionalitet för att återdirigera användaren tillbaka till en given sida då registreringen är klar. 1.2 Konventioner I detta dokument finns vissa typografiska markeringar för att klargöra instruktioner. Dessa bör tolkas enligt följande: Kursiv [Ref nr] Används vid hänvisning till ett specifikt namn, adress, eller annat värde som inte är löpande text. Referensangivelse 1.3 Referenser Referensnr Namn Adress Sid 4/9
3 Webbsidegränssnittet 3.1 Förutsättningar För att nå säkerhetstjänsters webbsida måste anropande klient vara autentiserad mot en autentiseringstjänst och uppvisa en giltig SAML-biljett som finns sedan tidigare i slutanvändarens webbsession/webbläsare. Det anropande systemet behöver ha kännedom om vad som skall registreras, eftersom denna information är några av de parametrar som skickas till webbsidan. avgör inte vad det externa systemet önskar registrera och inte. 3.2 Gränssnittsspecifikation En webbsida, dvs. en servlet publiceras i säkerhetstjänster där det ingår följande obligatoriska requestparametrar till webbsidan *: Inparameter patpnr patnamn returnurl Förklaring Personnummer på patienten (string). nyttjar denna färdigformaterade sträng som underlag till registreringen av vårdrelation/samtycke. Färdigformaterad uppgift om patientens namn (string). Komplett URL att redirect:a till när säkerhetstjänster genomfört registreringen, alternativt avbrutit den (string). Observera att om URL:en innehåller parametrar så måste dessa vara samlade i endast en parameter för att inte webbläsaren skall tolka dessa felaktigt tillsammans med övriga inparametrar till sidan. Korrekt exempel: http://www.example.com?myparameters=a B Felaktigt exempel: http://www.example.com?myparameter1=a&myparameter2=b vrelstate smtstate Markering om vårdrelation redan existerar (boolean). Vid true existerar patientrelation och bara text visas. Vid false krävs ett aktivt val av slutanvändaren för att skapa en patientrelation. Markering om samtycke redan existerar (boolean). Vid true existerar samtycke och bara text visas i samtyckesdelen. Vid false så krävs aktiv markering om registrering från slutanvändaren. emergencystate Avläses endast om smtstate är false: Markering om nödåtkomst finns redan registrerat i säkerhetstjänster. Sid 5/9
showlf lfstate lfmessage Utparameter dialogok lfstate Vid true visas texten "Samtycke finns".vid false så registeras ett samtycke enligt smtstate. Ett nödsamtycke registreras enbart om användaren väljer nödsituation och smtstate är false samt emergencystate är false Markering om LF-samtycksdelen skall visas. Vid true så visas kryssruta för markering om samtycke till läkemedelsförteckningen. Vid false presenteras inte denna kryssruta. Avläses endast om showlf är true. Markering om LF-samtycke finns. Om denna flagga är true så kryssas rutan i som förval och kan ej ändras av användaren. Om flaggan är false så kan den aktivt kryssas i, men det är inget krav. Om showlf är false presenteras inte LF-kryssrutan och denna flagga är då ointressant. Avläses endast om showlf är true. Meddelande som skrivs ut under "Samtycke läkemdelsförteckning" i röd text. (string). Denna inparameter är inte obligatorisk. Förklaring Markering om registrering genomfördes eller ej (boolean). Om flaggan är true är registrering genomförd. Om false så har användaren avbrutit. Anger om kryssrutan för LF-samtycke var ikryssad eller inte då användaren registrerade/avbröt i webbsidan. Vid true så kryssade användaren i rutan eller så fanns redan LFsamtycket. Vid false så fanns inte LF-samtycket och registrerades heller inte av användaren. *) Alla booleska värden skickas med värdet true eller false. 3.3 Anropa webbsidan För att nå webbsidan görs en redirect till en av systemet känd URL med ovanstående inparametrar. svarar med en redirect tillbaka till den URL som angavs i inparametern returnurl. Ett exempel på URL som det anropande systemet använder för redirect: Sid 6/9
https://sakerhetstjanster.example.com:8443/com.logica.se.bif.externalpages.web/registercarerel ationandconsent.do?smtstate=false&lfstate=false&patpnr=191212121415&showlf=true&lfm essage=samtyckesaknas&emergencystate=false&patnamn=anders Andersson&returnURL=http%3A%2F%2Fwww.example.com&vrelState=false Alla parametrar skall skickas med teckenuppsättning UTF-8 och måste innehålla värden som är tolkningsbara för en webbläsare. validerar alla inparametrar och dess format och presenterar ett felmeddelande för användaren om någon parameter är felaktig. Dessutom presenteras ett felmeddelande om användarens SAML-biljett saknar obligatoriska attribut som krävs för att registrera vårdrelation/samtycke gällande användaren. validerar också så att inparametrarna avser att minst en av följande saknas: - Vårdrelation - Samtycke (antingen för journalföring eller nödsituation) - Samtycke för läkemedelsförteckningen Om alla dessa tre är markerad som redan existerande så presenteras ett felmeddelande, eftersom användaren då aldrig skall anlända till denna sida. Sid 7/9
4 Flöden och logik i sidan Användaren som når webbsidan behöver information om patienten i fråga och går in på Intyga patientrelation eller väljer Nödsituation. Normalflödet för sidan är uppdelat i två steg: Först presenteras en registrering för vårdrelation om den saknas, som använder måste välja. Sedan presenteras registrering för samtycke om det saknas, samt även samtycke till läkemedelsförteckningen om det saknas ("LF-samtycke"). 4.1 Intyga patientrelation En knapp visas: Jag är delaktig i vården av denna patient och behöver information samt en knapp med text Nödsituation. Om det finns markering att vårdrelation redan existerar så visas inte knappen för "Jag är delaktig...". Information under Intyga patientrelation visas ej. Användaren klickar på knappen Jag är delaktig i vården av denna patient och behöver information, om inte vårdrelation redan föreligger Denna knapp försvinner nu, medan texten Jag är delaktig ligger kvar. Nu har vårdrelation registrerats i säkerhetstjänster. Samtyckesdelen visas. Om det finns markering att samtycke finns, samt att LF-samtycke redan finns, eller att det inte skall visas alls, så är registreringen klar och användaren blir istället omdirigerad tillbaka till angiven URL. Om samtycke saknas: Användaren väljer mellan All behörig personal på vårdenheten eller Endast mig. "Endast mig" är defaultmarkerat i startläget. Endast ett val kan göras Användaren väljer mellan Till och med och 1 vecka framåt "1 vecka framåt" är defaultmarkerat i startläget. Endast ett val kan göras. Vid klick i fältet Till och med: markeras tillhörande radioknapp Om "Samtycke läkemedelsförteckning" skall visas: Användaren klickar på Gäller endast mig om så är fallet. Om LF- samtycke redan fanns så är kryssrutan ikryssad och låst. Kryssrutan blir nu ikryssad. Användaren kan lämna kryssrutan icke-ikryssad om LF-samtycke inte har inhämtats från patienten. Användaren klickar på Patienten ger samtycke. Om registrering av samtycke lyckas, gör en redirect tillbaka till den URL som angavs i inparametern returnurl. Utparametrarna dialogok och lfstate skickas med. Sid 8/9
4.2 Nödsituation Knappen Nödsituation kan klickas när som helst oavsett vad användaren hittils gjort i sidan. Användaren klickar på knappen Nödsituation. Ny sida visas med en knapp med texten Nödsituation föreligger och jag intygar patientrelation. Användaren klickar på knappen Nödsituation föreligger och jag intygar patientrelation En vårdrelation registreras om vrelstate är false. Ett samtycke av typen "forcering steg 1" registreras om smtstate och emergencystate är satt till false. Om det lyckas gör en redirect tillbaka till den URL som angavs i inparametern returnurl. Utparametrarna dialogok och lfstate skickas med. Vid nödsituationsregistrering så blir alltid returparametern lfstate false, dvs. användaren markerar aldrig aktivt att ett LF-samtycke finns. Sid 9/9