Tjänstekontrakt och Nationella tjänsteplattformen

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.

* Releasepaketen innehåller underlag för att utveckla webbtjänster utifrån tjänstekontrakten i domänen. Detta underlag består bland annat av följande:

• WSDL-filer (Web Services Description Language) Beskrivning av webbtjänster i XML-format
• XSD-filer (XML Schema Definition) Beskrivning av XML-dokuments struktur
• TKB (Tjänstekontraktsbeskrivning) Dokument som kompletterar de maskinläsbara beskrivningarna 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

Anslutningsprojekt skickar in förstudie till Inera avseende anslutning till de nationella testmiljöerna

Beställningen granskas och godkänns av Inera tillsammans med förvaltningen av 1177 Vårdguidens e-tjänster.

Anslutningsprojekt ansluter systemet till tjänstekontrakten i testmiljön av Nationella tjänsteplattformen

Anslutningsprojekt integrerar systemet med testmiljön av 1177 Vårdguidens e-tjänster

Om systemet ska skicka anrop till tjänstekontrakt ska det anslutas som konsument. Om systemet ska svara på anrop till tjänstekontrakt ska det anslutas som producent.