Process anslutning
kvalitetsregister till
Mina Vårdkontakter
Dokumentansvarig: Gösta Hiller Datum: 2015-‐05-‐28 Version: 1.0 Processdokument
Sida
2 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
Innehåll Inledning ................................................................................................................................................. 3 Mina Vårdkontakter ............................................................................................................................ 4 Inkorgstjänsten ............................................................................................................................... 4 Uthopp till extern tjänst .................................................................................................................. 4 1. Intresseanmälan/ansökan ............................................................................................................... 6 2. Teknisk anslutning och testning ...................................................................................................... 8 3. Driftsättning, pilot och breddning ................................................................................................. 11 Kostnader .............................................................................................................................................. 12 Bilagor ................................................................................................................................................... 13 Kontaktinformation ............................................................................................................................... 13 Referensdokument-‐ och övriga länkar .................................................................................................. 13 Inkorgstjänsten ................................................................................................................................. 13 2 Processdokument
Sida
3 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
Inledning Detta dokument beskriver processen för att ansluta ett kvalitetsregister till inkorgstjänsten med uthopp till extern tjänst inom Mina Vårdkontakter (MVK). Dokumentet beskriver aktuella aktiviteter som ska genomföras och vem som är ansvarig för vad inom ramen för ett anslutningsprojekt. Aktiviteterna kan variera mellan olika projekt beroende på förutsättningar, val av lösning och vad som ska uppnås med anslutningen. Processen består av följande steg: 1. Intresseanmälan/ansökan 2. Teknisk anslutning och testning 3. Driftsättning, pilot och breddning Dessa tre steg beskrivs mer utförligt i dokumentet Anslutningsdokument Inkorgstjänsten, se kapitel Referensdokument. Övergripande processbild 3 Processdokument
Sida
4 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
Mina Vårdkontakter Inkorgstjänsten Inkorgstjänsten för MVK möjliggör att anslutande system (kvalitetsregistret i detta fall), via Nationella tjänsteplattformen, kan skicka ett meddelande till individer som är registrerade användare i MVK. Inkorgstjänsten består av två interaktioner som används för att kontrollera att en invånare är användare (är registrerad) samt att i förekommande fall skicka själva meddelandet. •
•
IsActiveUser AddMessageToPatientPortalInbox Det skickade meddelandet kan formateras inom vissa givna ramar och kan länka sömlöst till externa system om dessa är anslutna. Avsändaren kan avgöra om denne vill att meddelandet ska aviseras invånaren om möjligt. Om avisering sker och med vilken metod (SMS, e-‐post) kan ske eller ej beror av invånarens inställningar. Tjänsten IsActiveUser returnerar aktiva användares inställningar för avisering så att anslutande system kan avgöra om avisering kan ske. Anslutande system kan också konfigureras för att stödja uthopp/länkning till externt system med sömlös övergång för att låta invånaren kunna agera vidare utifrån meddelandet i inkorgen. Uthopp till extern tjänst Med uthopp till extern tjänst avses länkning till en tjänst som fungerar tillsammans med MVKs inloggning men som inte delar samma grafiska utseende (användaren lämnar i detta fall MKV). För dessa tjänster erbjuds en väg tillbaka in i MVK samt en möjlighet att logga ut. Uthopp kan initieras från inkorgsmeddelandet på två sätt: 1. Genom att använda det särskilda SSOLink-‐objektet som kan konfigureras i meddelandet 2. Genom att använda ULink-‐objektet enligt docBook-‐specifkationen Den 1:a december 2015 kommer den befintliga lösningen för uthoppstjänster i MVK (MVK SSO) att stängas. Under 2015 (kvartal 3) kommer befintliga MVK-‐SSO anslutningar styras om till en annan metod (IdP SSO baserad på SAML2). Nya anslutningar görs mot den nya lösningen. Detta innebär att registerplattformar som har MVK SSO måste byta lösning till IdP SSO innan 1:a december. Det möter dock inga hinder ansluta nya register som baseras på registerplattform som redan är ansluten via MVK SSO. I avvaktan på att den nya lösningen är på plats kan nya registerplattformar åstadkomma länkning (uthopp) genom att använda ULink enligt alternativ två ovan. Med detta alternativ kan vi dock inte garantera sömlös övergång till kvalitetsregister utan invånaren kan bli tvungen all logga in i registret separat. Detta har inte direkt med SSOLink att göra utan beror av vilken IdP och vilket kluster hos CGI som används. Se även nedan länk för information kring tillgänglighet för anslutning till uthoppstjänsterna i MVK: https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=82804874 4 Processdokument
Sida
5 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
Det är relativt enkelt att byta uthoppstjänst. Den största skillnaden mellan SSOLink och ULink för en IdP baserad uthoppstjänst är att med SSOLink lagras basURLen i konfigurationen hos MVK och är därmed enklare att byta om behov skulle uppstå. Med ULink skickas hela URLen i meddelandet och blir då en "död" länk om man skulle byta URL (och inte kan fixa vidarebefordran till den nya URLen) för uthoppsystemet. SSOLink är i detta fall en något enklare lösning om man skulle behöva byta URL. Nedan bild visar hur anslutningen ser ut mellan kvalitetsregistret och MVK och hur systemen interagerar med invånaren. _________________________________________________________________ Schematisk bild över anslutning av kvalitetsregister till MVK med uthoppstjänst Siffrorna i bilden hänvisar till nedan processteg Process: 1. Kvalitetsregistret skickar ett meddelande till invånaren via inkorgstjänsten (Avsändaren kan avgöra om denne vill att meddelandet ska aviseras invånaren om möjligt) 2. Aviseringsprocessen aktiveras när meddelandet hamnar i invånarens inkorg 3. Invånaren loggar in i MVK för att öppna sin inkorg 4. MVK begär identifiering från Identity Provider (IdP) 5. IdP levererar behörighetsintyg (SAML biljett) 6. Invånaren klickar på en länk i inkorgsmeddelandet 7. Invånaren omdirigeras till kvalitetsregistrets webformulär för inmatning. Inmatad data sparas i en lokal area (utökad vårddokumentation) och måste signeras av vårdpersonal från avsändande vårdenhet innan den förs över till kvalitetsregistret. Notera att det är registrets system som är inkopplat ur ett AddMessage-‐perspektiv. 8. Registret begär identifiering från IdP 5 Processdokument
Sida
6 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Version 1.0
Dokumentansvarig
xx
Datum
2015-05-28
9. IdP levererar behörighetsintyg (SAML biljett) Registret kan i sin tur peka tillbaka till MVK så att invånaren kan återvända till MVK, samma identifieringsprocess tillämpas vid behov. 1. Intresseanmälan/ansökan Denna del består av att beskriva tänkt lösning. Fyll i kapitel 1 i referensdokument Anslutningsdokument Inkorgstjänsten. QRCs roll: a)
b)
c)
d)
e)
f)
g)
Ge kvalitetsregister information kring användningen av tjänsterna Kartlägga vad registret vill göra (verksamhetsrelaterade frågor) Kartlägga hur implementationen/anslutningen ska göra, vilka tjänster ska användas? Kartlägga tekniska förutsättningar Sammanställ informationen, punkt b – d ovan Se till att registret får tillgång till rätt dokument Svara på frågor och ge stöd vid ansökan om anslutning till MVK. Tekniska frågor besvaras av Inera, CGI eller MVK. h) Granska ansökan innan den skickas till MVK förvaltningen för godkännande. Beslut ska tas om godkännande innan arbete med anslutning påbörjas. Nedan tabell ger en översiktlig bild över vilka aktiviteter som ska genomföras i detta steg och vilken organisation som är ansvarig. Register/Styrgrupp Beskriv bakomliggande organisation (organisation och kontaktpersoner) IT-‐leverantör Förbered anslutning till NTjPb) Etablera kontakt med Inerac) och ansök ev. om fördjupat stöd av en teknisk anslutnings-‐
koordinator. Ett övergripande stöd ingår som en obligatorisk del i anslutningsprocessen. Beskrivning av tjänsten – syfte, Kartlägga struktur och rutiner nytta och bakgrund. Vad vill för intern infrastruktur, avser registret göra/uppnå med både test-‐ och anslutningen? produktionsmiljö • Enkäter • Finns RTjPb)? Hur ser anslutnings-‐processen ut? • Visa rapporter och diagram • Skaffa nödvändiga SITHS funktionscertifikat • … • Verifiera att anslutning finns till Sjunet eller Internet Flödesbeskrivning – beskriv tänkt flöde för tjänstena) 6 1177 Vårdguiden/MVK Godkänna anslutning av nytt kvalitetsregister till Inkorgstjänsten, utifrån gjord ansökan. Processdokument
Sida
7 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Version 1.0
Dokumentansvarig
xx
Datum
2015-05-28
Ta fram tidplan och planering för genomförande (projektplan) Definiera omfattning – antal meddelanden och aviseringar per månad Definiera innehåll i meddelandena, ange till vilket register invånaren ska vända sig med t ex frågor om innehåll och ange vilken vårdenhet som är avsändare. Informationen ska finnas tillgänglig i meddelandets sidfot. a)
Ange om länk till extern tjänst. Länk till extern tjänst innebär att patienten lämnar MVK och länkas vidare, i detta fall till kvalitetsregistrets webbformulär för inmatning. b)
RTjP = Regional Tjänsteplattform NTjP = Nationell Tjänsteplattform c)
Ansök om anslutning till Tjänsteplattformen hos Inera: http://www.inera.se/TJANSTER-‐-‐PROJEKT/ICC-‐Integration-‐Competence-‐Center/Anslutning-‐till-‐
Tjansteplattformen/ Vid de grönmarkerade delarna i bilden nedan initieras anslutningsstödet. Övergripande stöd Inera ger information om förutsättningarna för en anslutning samt vilka regler och eventuella kostnader som är förknippade med en anslutning. Följande fyra aspekter beaktas: Affärsmässiga frågor Vad kostar det att ansluta till tjänsten? Vad kostar det att använda tjänsten? 2. Juridiska frågor Vilka tjänsteavtal behövs mellan landstinget och Inera? Finns aktuella avtal redan på plats? Notera att dessa frågor kan vara tidskrävande 3. Teknisk anslutning, behov av teknisk anslutningskoordinator 4. Test och kvalitet 1.
7 Processdokument
Sida
8 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
2. Teknisk anslutning och testning Efter godkännande av anslutning till MVK kan kapitel 2 i referensdokument Anslutningsdokument Inkorgstjänsten fyllas i. Dokumentet innehåller en länk till checklista för teknisk anslutning i testmiljö. QRCs roll: •
•
•
Erbjuda en projektplan inklusive aktivitetsmall och schablonmässiga estimat av tid och kostnader Fungera som stöd genom design och implementering, görs mot ersättning Utbilda i docBook alt definiera meddelandena enligt docBook-‐syntax, görs mot ersättning Nedan tabell ger en översiktlig bild över vilka aktiviteter som ska genomföras i detta steg och vilken organisation som är ansvarig. Register/Styrgrupp Tillgänglig för frågor och beslut IT-‐leverantör Etablera testmiljö, ska vara produktionslik (anslut till RTjP) Definiera meddelandena inkl Etablera testmiljöd), ska vara uppgifter om till vilket register produktionslik (anslut till NTjP) invånaren ska vända sig med till 1. Förstudiemall för t ex frågor om innehåll och anslutning till de nationella vilken vårdenhet som är testmiljöerna avsändare. Informationen ska 2. ”Beställning B” för finnas tillgänglig i anslutning av konsument meddelandets sidfot. till de nationella testmiljöerna 3. Testa och verifiera anslutningen för test tillsamman med Inera Etablera samverkan med MVKe) 1. ”Beställning D” för anslutning till de nationella testmiljöerna 2. Testa och verifiera anslutningen för test tillsamman med MVK och Inera Definiera triggerpunkt för Etablera produktionsmiljö utskick av meddelande (anslut till RTjP) (avisering) Definiera triggerpunkt för Etablera produktionsmiljöd) påminnelse, hur många, när i (anslut till NTjP) tiden? Hur hantera om ej svar? 1. Förstudiemall för anslutning till den nationella produktionsmiljön 8 1177 Vårdguiden/MVK Verifiera anslutet system (test-‐ och produktionsmiljö) Konfigurera anslutande systemet b la SSO inställningar Sätta upp testmiljö för acceptanstest Ta fram testpersoner för inloggning i MVK Processdokument
Sida
9 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version 1.0
Datum
2015-05-28
Om länk till extern tjänst, ev. definiera webbformulär för inmatning alt. uppdatera befintligt webbformulära) Definiera testfall, bl a: • Verifiera aktiv användare • Meddelandet formateras korrekt • Avisering fungerar via e-‐
post och sms • Att länkar fungerar som avsett • … Definiera testdata 2. ”Beställning B” för anslutning av konsument till den nationella produktionsmiljön 3. Verifiera anslutningen för produktion tillsamman med Inera Etablera samverkan med MVKe) 1. ”Beställning D” för anslutning till den nationella produktionsmiljön 2. Verifiera anslutningen för produktion tillsamman med MVK och Inera Bevaka, följ upp Ge personligt konto till testarna anslutningsstatus mot NTjP Utveckla stöd för Etablera samverkan med administrering av meddelanden kvalitetsregistrete) (lägga till, ta bort, uppdatera) 1. ”Beställning D” för anslutning till den nationella produktionsmiljön 2. Verifiera anslutningen för produktion tillsamman med kvalitetsregistret och Inera Utforma meddelandeinnehåll enligt reglerna för tolkning av docBookf) Förbereda acceptanstest: Implementera/anslut till f)
Beställa tillgång till fysiska tjänstekontrakt : personer (testare) med tillgång • IsActiveUser (returnerar till MVK testmiljöb) status för användaren, om notifiering, notifieringssätt) • AddMessageToPatientPort
alInbox (skicka meddelandet) Genomför acceptanstesterc) Utveckla funktionalitet för: baserade på definierade testfall • Schemaläggning av och uppdatera testfall med meddelande utfall • Påminnelse (antal, antal dagar mellan påminnelse) 9 Processdokument
Sida
10 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version
1.0
Vad som ska hända om invånaren inte svarar… • Specificera valideringsregler Om länk till extern tjänst, utveckla stöd för uthopp med sömlös övergång g). Kräver stöd för IdPh). Utveckla funktionalitet för att spara ner data i registret (inmatad data ska signeras av vårdpersonal från avsändande vårdenhet innan data sparas ner i kvalitetsregistret) Rätta fel i samband med acceptanstest •
Verifiera rättningar gjorda under acceptanstest och uppdatera testfall med utfall Godkänna genomförda acceptanstester och ge klartecken för produktionssättning Verifiera funktionalitet i produktionsmiljö. Förutsätter att registret har tillgång till fysiska invånare som är anslutna till MVK och som kan användas för verifiering. Leveransgodkänna a)
Formulären bör inte innehålla frågor/svar som kräver vårdinsats. Inmatad data måste signeras av vårdpersonal från avsändande vårdenhet innan den förs över till kvalitetsregistret. b)
För åtkomst till testmiljö se Testinformation Mina vårdkontakter https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=66191423 c)
Acceptanstester görs i MVKs acceptanstestmiljö. Testmiljön måste bokas i förväg om man vill försäkra sig att den är tillgänglig vid aktuell tidpunkt eftersom den används för flera ändamål. Kontakta MVK förvaltning. d)
Process för anslutning av konsument, Beställning B – Inera http://www.inera.se/TJANSTER-‐-‐PROJEKT/ICC-‐Integration-‐Competence-‐Center/Anslutning-‐till-‐
Tjansteplattformen/Anslutning-‐av-‐konsument-‐-‐-‐Bestallning-‐B/ e)
Process för att etablera samverkan, Beställning D – Inera http://www.inera.se/TJANSTER-‐-‐PROJEKT/ICC-‐Integration-‐Competence-‐Center/Anslutning-‐till-‐
Tjansteplattformen/Etablera-‐samverkan-‐-‐-‐Bestallning-‐D/ Notera att Softronic kan säga stopp till register som inte är tekniskt eller organisatoriskt redo och begära omtag f)
Dokumentation för teknisk anslutning till Inkorgstjänsten i MVK och regler för tolkning av meddelandeinnehåll och docBook https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=77627456 Klicka på länken till Anslutningsguide Addmessagetjänst 10 Datum
2015-05-28
Processdokument
Sida
11 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version
1.0
Datum
2015-05-28
g)
Ett antal regler gäller för att implementera uthopp till extern tjänst, se https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=35783048 h)
IdP tillhandahålls av CGI, MVK köper tjänsten av CGI. Kontakta CGI för anslutning. Kontakta [email protected] eller Petter Dahlberg ([email protected]), 08 -‐ 671 66 74 Säkerställa att man hamnar i samma single sign on/samma IdP-‐instans som MVK. Lösningen ställer även krav på redundans, tillgänglighet. Läs mer om anslutning via IdP Se rubrik SAML, anslutning via IdP (Identity Provider) http://eid.primeportal.com/eid/Sidor/Tekniskinformation.aspx Federering och SAML 2.0 Få Single Sign-‐On (SSO) med e-‐legitimation till ditt system http://eid.primeportal.com/eid/Sidor/FedereringochSAML.aspx 3. Driftsättning, pilot och breddning När den tekniska anslutningen är genomförd och godkänd kan kapitel 3 i referensdokument Anslutningsdokument Inkorgstjänsten fyllas i. Dokumentet innehåller enlänk till checklista för teknisk anslutning i produktionsmiljö. QRCs roll: •
Avsluta anslutningsprocessen med kvalitetsregistret Nedan tabell ger en översiktlig bild över vilka aktiviteter som ska genomföras i detta steg och vilken organisation som är ansvarig. Register/Styrgrupp Säkerställ att aktiverad mottagning finns i MVK Upprätta support 2:linjen Lämna över till MVK förvaltning och sin egen support Tips! Se till att patienten ansluter sig till MVK i samband med vårdtillfället för att öka svarsfrekvensen på PROM/PREM a)
Må – Sö, 6 -‐ 22 b)
Må – Fr, 8 – 17 IT-‐leverantör Driftsättning Tillgänglig för supportfrågor 1177 MVK förvaltning Support 1:a linjena) Teknisk supportb) Förvaltningsprocess, SLA Första linjen support ligger hos MVK förvaltning. Alla ärenden registreras i ett ärendehanteringssystem hos förvaltningen. Förvaltningen ska ha en förteckning över anslutna register med tillhörande kontaktuppgifter. Registret ansvarar i sin tur för att upprätta en andra linjen 11 Processdokument
Sida
12 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version
1.0
Datum
2015-05-28
support, i vilken form avgörs från register till register. Registret ansvarar för att besvara och hantera registerrelaterade frågor (innehålls och IT-‐relaterade frågor med hjälp av sin IT-‐leverantör). Registret ska även hantera inkomna synpunkter och förslag på vidareutveckling. Kostnader Det är inte möjligt att fastställa alla kostnader för anslutning av kvalitetsregister till MVK innan ett första pilotprojekt har genomförts. I samband med detta kommer samtliga kostnader att identifieras och kartläggas och utgöra grund för estimat av komman anslutningsprojekt. Samtliga kostnader är till självkostnadspris. Identifierade kostnadsposter: •
•
•
•
QRC IT-‐leverantör (kvalitetsregister) Inera o Kostnader för övergripande stöd – ingår, utövas av kundansvarig. Omfattar en genomgång av förutsättningar för anslutning samt framtagande av en komplett kostnadsbild (anslutningskostnader och löpande driftskostnader). o Kostnader för stöd från teknisk anslutningskoordinator (frivillig) – 1 000 kr/timme löpande räkning o Kostnad för test-‐ och kvalitetsarbete (obligatoriskt) – Inera gör en bedömning av vilka test-‐ och kvalitetssäkringsbehov som föreligger baserat på omfattningen av anslutningen och tar fram ett uppskattat pris. Priset är individuellt och kan komma att variera mellan olika register. Samtliga kostnader är till självkostnadspris. Notera att ny prismodell håller på att tas fram. Är man först ut med att ansluta ett kvalitetsregister från en IT-‐plattform är arbetet mer omfattande än om det ingår i ett breddinförande. MVK o Anslutningskostnad per plattform (engångskostnad) – 25 000 kr, i priset ingår: o Konfigurering av testmiljö o Tillgång till MVKs testmiljöer med personliga konton för att ha möjlighet att testa o Support under testperioden o Konfigurering av produktionsmiljö Notera att MVK kan avbryta anslutningen av register som inte bedöms vara tekniskt eller organisatoriskt redo och begära omtag. o
o
Rörlig kostnad – priset är ännu inte fastställt, priset ska motsvara kostnaden för att skicka ett meddelande (sms) Månatlig kostnad för support och förvaltning kommer att tillkomma, modell och priser är ännu inte fastställd 12 Processdokument
Sida
13 (13)
Anslutning kvalitetsregister till Mina Vårdkontakter
Dokumentansvarig
xx
Version
1.0
Datum
2015-05-28
Prisjusteringar kan förekomma 1 gång per år. Bilagor Mallar: •
•
•
Projektplan anslutning Mina Vårdkontakter – mall (Word) Projektplan anslutning Mina Vårdkontakter – mall (Excell) Testfall – mall Kontaktinformation QRC – [email protected] Inera – Registret kontaktar Inera via sin kundansvarig eller teknisk anslutningskoordinator. QRC kontaktar Inera via Ineras nationella kundservice: http://www.inera.se/KONTAKT_KUNDSERVICE/Kontaktuppgifter-‐och-‐oppettider/ CGI – Registret kontaktar CGI via [email protected] eller Petter Dahlberg ([email protected]), 08 -‐ 671 66 74. Referensdokument-‐ och övriga länkar Inkorgstjänsten Anslutningsdokument Inkorgstjänsten (Läggs upp av MVK förvaltning på nedan länk när det är klart) https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=77627456 Anslutningsguide Addmessagetjänst https://softronic.atlassian.net/wiki/pages/viewpage.action?pageId=77627456 Klicka på länken till Anslutningsguide Addmessagetjänst 13