...
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.
| Varningnote |
|---|
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.
...
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 , som till exempel informerar patienten om att hen fått en kallelse eller att en bokad tid har bokats om. 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 | ||||||
|---|---|---|---|---|---|---|
| ||||||
För att ett tidbokningssystems uppdateringar av Engagemangsindex ska generera inkorgsmeddelanden i 1177 Vårdguidens e-tjänster måste tidbokningssystemet vara vitlistat i 1177 Vårdguidens e-tjänster. Vitlistning av tidbokningssystem beställs hos den nationella supporten för 1177 Vårdguidens e-tjänster. Beställningen måste läggas av det aktuella landstinget eller 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å vitlistning av tidbokningssystem i produktionsmiljö. Felaktig uppdatering av Engagemangsindex kan resultera i felaktig information i de meddelanden som skapas i patienternas 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å går det till:
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 tidbokningssystemet är "vitlistat".
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. Om värdet (tidbokningssystemets HSA-id) inte finns i databasen, ignoreras notifieringen.
5. Förutsatt att tidbokningssystemet är vitlistat, hämtar 1177 Vårdguidens e-tjänster 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
...
Se Anslutningsguidenerhållit i notifieringen från Engagemagsindex och i bokningsdetaljerna från tidbokningssystemet.