System som ansluts till tjänstekontrakten för Tidbokning måste uppdatera Engagemangsindex. Engagemangsindex är en nationell stödtjänst som genom att det uppdateras av vårdens verksamhetssystem, vet hos vilka informationsägare som patienter har olika typer av engagemang. Ett engagemang kan t.ex. vara en bokad tid, en kallelse, en remiss eller ett formulär för patienten att fylla i.
Integrationen mellan verksamhetssystemen och Engagemangsindex görs med genom tjänstekontrakt. Tjänstekontrakten för Engagemangsindex finns härhär http://rivta.se/domains/itintegration_engagementindex.html.
Tjänstedomänen Tidboknings anvisningar för uppdatering av Engagemangsindex finns i domänens tjänstekontraktsbeskrivning.
Engagemangsindex och aggregerande tjänster
Tack vare att Engagemangsindex vet i vilka system en patients engagemang finns, slipper en e-tjänst fråga alla system om de har några engagemang för den inloggade patienten när e-tjänsten vill visa upp patientens samtliga engagemang av en viss typ. E-tjänsten kan istället anropa en aggregerande tjänst i Nationella tjänsteplattformen som först frågar Engagemangsindex var patientens har sina engagemang och därefter hämtar detaljer om engagemangen från källsystemen. Den aggregerande tjänsten sammanställer sen ett svar till e-tjänsten.
En förutsättning för att en aggregerande tjänst ska fungera är att verksamhetssystem håller Engagemangsindex uppdaterat med aktuell information om patienters engagemang.
| Varning |
|---|
1177 Vårdguidens e-tjänster använder i dagsläget inte en aggregerande tjänst för att hämta tidbokningsinformation eftersom så få tidbokningssystem uppdaterar Engagemangsindex. Den aggregerande tjänsten för tidbokningsinformation skulle bara hitta en bråkdel av patientens bokade tider. För att 1177 Vårdguidens e-tjänster ska kunna hämta och visa upp patientens nationella kalender måste tidbokningssystemen börja uppdatera Engagemangsindex. |
Utan Engagemangsindex: En e-tjänst som 1177 Vårdguidens e-tjänster skulle behöva upprepa ovanstående procedur drygt 2200 gånger (en gång per ansluten vårdenhet) för att visa upp en nationell vy av den inloggade patientens bokade tider.
Med Engagemangsindex: E-tjänsten skulle kunna anropa en aggregerande tjänst som sammanställer ett svar med patientens samtliga bokade tider. I exemplet ovan hade patienten bara bokade tider i tre system.
...
som går att ladda ned här: http://rivta.se/domains/crm_scheduling.html.
Elektroniska kallelser och bokningsbekräftelser
Varje gång ett tidbokningssystem uppdaterar Engagemangsindex med information om en bokad tid eller kallelse får 1177 Vårdguidens e-tjänster en notifiering från Engagemangsindex. Notifieringen berättar om ett engagemang (en bokning eller en kallelse) den bokade tiden eller kallelsen har skapats, ändrats eller tagits bort . Notifieringen talar också om var detaljer om engagemanget kan hämtas. Utifrån denna information skapar av tidbokningssystemet. Av notifieringen framgår också vilket tidbokningssystem som gjorde uppdateringen. Utifrån dessa uppgifter kan 1177 Vårdguidens e-tjänster hämta nödvändiga uppgifter för att skapa ett anpassat meddelande i den aktuella patientens inkorg. Om . Meddelandet informerar patienten om händelsen (t.ex. att hen fått en kallelse eller att en bokad tid har bokats om). Läs mer på sidan Tidsatt och öppen kallelse.
Om patienten gjort den inställningen, får hen patienten ett sms och/eller ett mejl från 1177 Vårdguidens e-tjänster som talar om att ett nytt meddelande finns att läsa i inkorgen. På så vis förses patienterna med aktuell information om sina bokade tider och kallelser.
Aviseringsflöde: 1177
| Varning | ||
|---|---|---|
| ||
Enligt tjänstedomänen Tidboknings regelverk ska anslutna tjänsteproducenter (tidbokningssystem) uppdatera Engagemangsindex. Vid behov finns det möjlighet att aktivera en funktion i 1177 Vårdguidens e-tjänster som skapar ett |
...
Så presenteras tidbokningssystemens uppdateringar av Engagemangsindex i 1177 Vårdguidens e-tjänster
| Innehållsförteckning | ||
|---|---|---|
|
inkorgsmeddelanden till den berörda invånaren när Engagemangsindex uppdateras med en |
...
kallelse eller bokad tid. Funktionen aktiveras per tidbokningssystem genom beställning till den nationella förvaltningen för 1177 Vårdguidens e-tjänster |
...
- En tidsatt kallelse har en bokad tid.
- Skapas på initiativ från vården.
- Invånaren uppmanas att själv boka en tid som passar.
- Kallelsetexten visas direkt i kallelsen i invånarens inkorg.
- Inställningar i tidbokningssystemet avgöra om kallelsen är av- och/eller ombokningsbar.
- Invånaren startar om- eller avbokning direkt från inkorgen.
- Mottagningen läggs automatiskt till i invånarens lista.
Nedan visas ett exempel på en traditionell papperskallelse och hur den skickats som en elektronisk kallelse till 1177 Vårdguidens e-tjänster:
| View file | ||||
|---|---|---|---|---|
|
Engagemangsindex uppdateras med en öppen (ej tidsatt) kallelse
Ett tidbokningssystem skapar en ny post i Engagemangsindex med kategorin ”invitation” och tiden saknar start- och sluttid = 1177 Vårdguidens e-tjänster skapar meddelandet ”Du har fått en kallelse…”.
- En öppen kallelse saknar start- och sluttid.
- Skapas på initiativ från vården.
- Invånaren uppmanas att själv boka en tid som passar.
- Kallelsetexten visas direkt i kallelsen i invånarens inkorg.
- Invånaren startar bokning direkt från inkorgen.
- Mottagningen läggs automatiskt till i invånarens lista.
Engagemangsindex uppdateras med en bokad tid
Ett tidbokningssystem skapar en ny post i Engagemangsindex med kategorin ”booking” = 1177 Vårdguidens e-tjänster skapar meddelandet ”Din bokade tid…”.
När en invånare bokar tid via telefon eller besök får invånaren en bekräftelse i sin inkorg i 1177 Vårdguidens e-tjänster.
Engagemangsindex uppdateras med ett borttag av en bokning
Ett tidbokningssystem tar bort en post ur Engagemangsindex med kategorin ”booking” = 1177 Vårdguidens e-tjänster skapar meddelandet ”Din avbokade tid…”.
När personal på mottagningen avbokar en tid får invånaren ett meddelande om detta i sin inkorg i 1177 Vårdguidens e-tjänster.
Obs! Denna funktionalitet försvinner i samband med nästa uppdatering av e-tjänsterna. När tidbokningsposter tas bort ur Engagemangsindex kommer inte längre något meddelande skapas i inkorgen hos 1177 Vårdguiden.
Engagemangsindex uppdateras med ett borttag av en kallelse
Ett tidbokningssystem tar bort en post ur Engagemangsindex med kategorin ”invitation” = 1177 Vårdguidens e-tjänster skapar meddelandet ”Din kallelse är inte längre aktuell…”.
Obs! Denna funktionalitet försvinner i samband med nästa uppdatering av e-tjänsterna. När tidbokningsposter tas bort ur Engagemangsindex kommer inte längre något meddelande skapas i inkorgen hos 1177 Vårdguiden.
...
. Beställningen måste läggas av den aktuella regionen i ett mail till
Det är av högsta vikt att det aktuella landstinget eller regionen säkerställt att tidbokningssystemet följer tjänstedomänen Tidboknings anvisningar för uppdatering av Engagemangsindex, innan beställning på aktivering av elektroniska kallelser och bokningsbekräftelser i produktionsmiljö. Felaktig uppdatering av Engagemangsindex kan resultera i felaktig information i de meddelanden som skapas i invånarnas inkorgar i 1177 Vårdguidens e-tjänster. Anvisningarna finns i tjänstedomänen Tidboknings tjänstekontraktsbeskrivning som finns att ladda ned på http://rivta.se/domains/crm_scheduling.html. |
Så fungerar det:
1. Vårdenheten gör en ändring i tidbokningssystemet.
Det kan till exempel handla om att en kallelse skapas eller att en bokad tid bokas om.
2. Tidbokningssystemet uppdaterar Engagemangsindex med information om ändringen.
Detta görs genom ett anrop till tjänsten Update i Nationella tjänsteplattformen.
3. Engagemangsindex notifierar 1177 Vårdguidens e-tjänster om ändringen.
Engagemangsindex gör detta genom ett anrop till tjänsten ProcessNotifications hos 1177 Vårdguidens e-tjänster. Anropet innehåller en kopia av tidbokningssystemets anrop till tjänsten Update.
4. 1177 Vårdguidens e-tjänster kontrollerar om elektroniska kallelser och bokningsbekräftelser är aktiverade för tidbokningssystemet.
1177 Vårdguidens e-tjänster tar värdet som tidbokningssystemet uppgett i XML-elementet sourceSystem i sitt anrop till tjänsten Update och matchar det mot en databas med tidbokningssystem som använder elektroniska kallelser och bokningsbekräftelser. Om värdet (tidbokningssystemets HSA-id) inte finns i databasen, ignoreras notifieringen.
5. 1177 Vårdguidens e-tjänster hämtar detaljer om den bokade tiden eller kallelsen.
1177 Vårdguidens e-tjänster anropar tjänsten GetBookingDetails i Nationella tjänsteplattformen. 1177 Vårdguidens e-tjänster adresserar anropet till den logiska adressat som tidbokningssystemet uppgett i XML-elementet logicalAddress i sitt anrop till tjänsten Update. Som Id för den bokade tiden eller kallelsen uppger 1177 Vårdguidens e-tjänster det värde som tidbokningssystemet uppgett i XML-elementet businessObjectInstanceIdentifier i sitt anrop till tjänsten Update.
6. 1177 Vårdguidens e-tjänster skapar ett meddelande i patientens inkorg.
Innehållet i meddelandet skapas utifrån de uppgifter som 1177 Vårdguidens e-tjänster erhållit i notifieringen från Engagemagsindex och i bokningsdetaljerna från tidbokningssystemet.