Flera av 1177 Vårdguidens e-tjänster kräver att e-tjänsten kan kommunicera med system eller applikationer i vården. För att ta webbtidbokning som exempel så hämtar 1177 Vårdguidens e-tjänster lediga och bokade tider från den aktuella vårdenhetens tidbokningssystem och visar upp dem för användaren. När användaren valt en ledig tid och bokat den måste informationen i tidbokningssystemet uppdateras. Den tid som tidigare var ledig i tidbokningssystemet är nu bokad och ska därför inte visas för andra användare. Denna typ av informationsutbyte kräver att 1177 Vårdguidens e-tjänster och vårdsystemen är integrerade (sammankopplade) med varandra.
Med tanke på den uppsjö av vårdsystem som används av landstingens och regionernas olika verksamheter vore det nästintill omöjligt att sätta upp och upprätthålla en koppling mellan 1177 Vårdguidens e-tjänster och varje enskilt vårdsystem. Vårdsystemen är dessutom ofta programmerade i olika språk och använder olika semantik för samma saker. För att klara av dessa utmaningar har 1177 Vårdguidens e-tjänster anslutit till den gemensamma tekniska arkitektur som utvecklas och förvaltas av Inera Arkitektur och Regelverk. Det innebär att 1177 Vårdguidens e-tjänster och vårdsystemen kommunicerar med varandra via tjänstekontrakt installerade i Ineras nationella tjänsteplattform. Dessa begrepp förklaras bland annat i dokumentet T-boken i kortform på rivta.se, samlingssidan för all teknisk information som gäller den gemensamma tekniska arkitekturen.
När ett system försöker kontakta ett annat är det i själva verket plattformen det får kontakt med.
Tjänsteplattformen dirigerar sedan meddelandet vidare till rätt tjänst hos respektive vård- eller omsorgsgivare.
Den Nationella tjänsteplattformen underlättar integrationer genom att vara navet mellan system och tjänster.
Utveckla stöd för tjänstekontrakt
Tjänstekontrakt är grupperade utifrån de processer eller informationsbehov det stödjer. En sådan gruppering benämns tjänstedomän. Tabellen nedan visar vilka tjänstedomäner vars tjänstekontrakt e-tjänster och stödfunktioner i 1177 Vårdguidens e-tjänster använder.
| E-tjänst i 1177 Vårdguidens e-tjänster | Tjänstedomän vars tjänstekontrakt används | Externt system är * | Releasepaket, källkod och specifikationer ** |
|---|---|---|---|
| Webbtidbokning | crm:scheduling | Producent | http://rivta.se/domains/crm_scheduling.html |
| Listning | crm:carelisting | Producent | http://rivta.se/domains/crm_carelisting.html |
| Inkorgsfunktionen | infrastructure:eservicesupply:patientportal | Konsument | http://rivta.se/domains/infrastructure_eservicesupply_patientportal.html |
| Profilfunktionen | infrastructure:eservicesupply:patientportal | Konsument | http://rivta.se/domains/infrastructure_eservicesupply_patientportal.html |
| Erbjuden e-tjänst | eservicesupply:eoffering | Konsument | http://rivta.se/domains/eservicesupply_eoffering.html |
* System som skickar anrop till tjänstekontrakten är konsument. System som svarar på anrop till tjänstekontrakten är producent.
** Releasepaketen innehåller underlag för att utveckla webbtjänster utifrån tjänstekontrakten i domänen. Detta underlag består bland annat av:
- WSDL-filer (Web Services Description Language) Specifikationer för utveckling av webbtjänster.
- XSD-filer (XML Schema Definition) Specifikationer av XML-meddelanden inom webbtjänsterna.
- TKB (Tjänstekontraktsbeskrivning) Dokument med regler och förtydliganden som kompletterar de maskinläsbara specifikationerna i filerna ovan.
Ansluta till tjänstekontrakt i Nationella tjänsteplattformen
Processen för att ansluta system till tjänstekontrakt i Nationella tjänsteplattformen finns beskriven på Ineras webbplats. Kortfattat ser processen ut så här
1. Förstudie avseende anslutning till de nationella testmiljöerna skickas till Inera
Anslutningsprojekt skickar in förstudie avseende anslutning till de nationella testmiljöerna.
Vid mottagen förstudie kallas anslutningsprojektet till ett telefonmöte med Inera och förvaltningen av 1177 Vårdguidens e-tjänster på vilket förutsättningar och krav för integrationen gås igenom tillsammans.
Beställningen granskas och godkänns av Inera tillsammans med förvaltningen av 1177 Vårdguidens e-tjänster.
2. Systemet ansluts till i testmiljön av Nationella tjänsteplattformen
Anslutningsprojektet beställer anslutning till aktuella tjänstekontrakt i testmiljön av Nationella tjänsteplattformen.
3. Systemet integreras med testmiljön av 1177 Vårdguidens e-tjänster
Anslutningsprojektet beställer integrering mellan det nu anslutna systemet och testmiljön av 1177 Vårdguidens e-tjänster via Nationella tjänsteplattformen. Detta kallas även för att etablera samverkan.
4. Integrationen testas
Anslutningsprojektet genomför tester i testmiljön av 1177 Vårdguidens e-tjänster.
5. Förstudie avseende anslutning till de nationella produktionsmiljöerna skickas till Inera
Anslutningsprojektet skickar in en ny version av den ursprungliga förstudien och kompletterar den med resultatet av utförda tester.
6. Systemet ansluts till produktionsmiljön av Nationella tjänsteplattformen
Anslutningsprojektet beställer anslutning till aktuella tjänstekontrakt i produktionsmiljön av Nationella tjänsteplattformen.