...
Med tanke på den uppsjö av vårdsystem som används av landstingens och regionernas olika verksamheter verksamheterna i landstingen och regionerna 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 sinsemellan olika semantik benämningar 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 nedan. Mer information finns i dokumentet T-boken i kortform som kan laddas ned på rivta.se, samlingssidan för all teknisk information som gäller den gemensamma tekniska arkitekturen.
Grundläggande begrepp
Nationella tjänsteplattformen håller koll på vilka system som innehåller olika typer av vårdinformation och vilka system som får hämta, ändra eller ta bort den. Detta är möjligt tack vare att landsting, regioner och andra organisationer inom hälso- och sjukvården ansluter sina verksamhetssystem till Nationella tjänsteplattformen för att tillgängliga olika typer av vårdrelaterad information.
Ett system som hämtar, ändrar eller tar bort information i ett annat system via Nationella tjänsteplattformen kallas konsument.
Konsumenten En konsument behöver inte veta vilket system som innehåller den efterfrågade informationen den är intresserad av. Konsumenten behöver bara uppge ägare av informationen, den så kallade logiska adressaten, så dirigerar Nationella tjänsteplattformen begäran vidare till rätt system. Det system som Nationella tjänsteplattformen dirigerar konsumentens begäran till kallas producent. Producenten kan vara det system som innehåller den begärda informationen men det kan också vara en regional tjänsteplattform - en lokal version av den Nationella tjänsteplattformen.
...
För att kunna tolkas, administreras och versionshanteras behöver de tjänstekontrakt som stödjer en viss process eller informationsbehov grupperas. En sådan gruppering benämns tjänstedomän.
Utveckla stöd för tjänstekontrakt
Tabellen nedan visar vilka tjänstekontrakt som används inom olika e-tjänster och stödfunktioner i 1177 Vårdguidens e-tjänster. När ett system ska anslutas till en e-tjänst i 1177 Vårdguidens e-tjänster ska systemet förses med stöd för tjänstekontrakten i den senaste versionen av aktuell tjänstedomäns releasepaket.
...
| Info |
|---|
* Releasepaketen innehåller underlag för att utveckla webbtjänster utifrån tjänstekontrakten i domänen. Detta underlag består bland annat av:
|
...
Att 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 när den tillämpas på Nedan följer uppgifter som anslutande part behöver känna till för att kunna lägga beställningar på att integrera med e-tjänster i 1177 Vårdguidens e-tjänster.
Tjänstekontrakten i domänen Tidbokning (crm:
...
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.
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.
7. Systemet integreras med produktionsmiljön av 1177 Vårdguidens e-tjänster
...
scheduling)
Tjänstekontrakten i domänen Tidbokning används inom webbtidbokning i 1177 Vårdguidens e-tjänster. Anslutande system ska anslutas som producent av tjänstekontrakten.
Adressering
Tjänstekontrakten i domänen Tidbokning tillämpar verksamhetsadressering. Vårdenhetens HSA-id används som logisk adressat.
Nödvändiga tjänstekontrakt
Tabellen nedan visar vilka tjänstekontrakt som en producent måste ansluta till för att kunna erbjuda respektive tidbokningstjänst i 1177 Vårdguidens e-tjänster.
| Tjänstekontrakt | Beskrivning | Boka tid | Omboka tid | Avboka tid | Visa bokade tider | ||||||||||||||||||||||||||
| GetSubjectOfCareSchedule | Listar en invånares bokningar |
|
|
|
| ||||||||||||||||||||||||||
| GetAvailableDates | Listar datum med bokningsbara tider utifrån sökparametrar |
|
| ||||||||||||||||||||||||||||
| GetAvailableTimeslots | Listar bokningsbara tider utirån sökparametrar |
|
| ||||||||||||||||||||||||||||
| GetBookingDetails | Visa komplett information om en bokning |
|
|
|
| ||||||||||||||||||||||||||
| CancelBooking | Avboka invånare från bokning, orsak kan anges |
| |||||||||||||||||||||||||||||
| UpdateBooking | Ändra tid för en bokning |
| |||||||||||||||||||||||||||||
| MakeBooking | Ny bokning |
| |||||||||||||||||||||||||||||
| GetAllTimeTypes | Listar tillgängliga tidtyper för nybokning |
| |||||||||||||||||||||||||||||
| GetAllHealthcareFacilities | Listar enheter som invånare kan boka om till. |
|
| ||||||||||||||||||||||||||||
| GetAllPerformers | Listar utförare (medarbetare) |
|
| ||||||||||||||||||||||||||||
| GetAllCareTypes | Listar vårdtyper för nybokning |
|
|
* Används inte inom flödet för att boka tid men är obligatoriskt enligt tjänstedomänens tjänstekontraktsbeskrivning
** Tjänstekontraktet GetAllCareTypes stödjs ej av konsumenten 1177 Vårdguidens e-tjänster
1177 Vårdguidens e-tjänster som konsument av tjänstekontrakten i domänen Tidbokning
| Miljö av Nationella tjänsteplattformen | HSA-id för 1177 Vårdguidens e-tjänster som konsument |
|---|---|
| QA-miljö | SE2321000016-A29F |
| Produktionsmiljö | SE2321000016-92V4 |
Tjänstekontrakten i domänen Listning (crm:carelisting)
Tjänstekontrakten i domänen Listning används inom listningstjänsten i 1177 Vårdguidens e-tjänster. Anslutande system ska anslutas som producent av tjänstekontrakten.
Adressering
Tjänstekontrakten i domänen Listning tillämpar systemadressering. Länskod används som logisk adressat.
Nödvändiga tjänstekontrakt
En producent av tjänstekontrakten för Listning måste ansluta till tjänstedomänens samtliga 5 tjänstekontrakt.
1177 Vårdguidens e-tjänster som konsument av tjänstekontrakten i domänen Listning
| Miljö av Nationella tjänsteplattformen | HSA-id för 1177 Vårdguidens e-tjänster som konsument |
|---|---|
| QA-miljö | SE2321000016-A29F |
| Produktionsmiljö | SE2321000016-92V4 |
Tjänstekontrakten i domänen Patientportal (infrastructure:eservicesupply:patientportal)
Tjänstekontrakten i domänen Patientportal används inom inkorgsfunktionen och profilfunktionen i 1177 Vårdguidens e-tjänster. Anslutande system ska anslutas som konsument av tjänstekontrakten.
Adressering
Tjänstekontrakten i domänen Patientportal tillämpar systemadressering. HSA-id för 1177 Vårdguidens e-tjänster används som logisk adressat.
Nödvändiga tjänstekontrakt
En konsument av tjänstekontrakten för Patientportal måste ansluta till tjänstekontraktet AddMessageToPatientPortalInbox. Det är frivilligt att ansluta till tjänstekontraktet IsActiveUser.
1177 Vårdguidens e-tjänster som producent av tjänstekontrakten i domänen Patientportal
| Miljö av Nationella tjänsteplattformen | HSA-id för 1177 Vårdguidens e-tjänster som producent |
|---|---|
| QA-miljö | SE2321000016-A29F |
| Produktionsmiljö | SE2321000016-92V4 |
Tjänstekontrakten i domänen Erbjuden e-tjänst (eservicesupply:eoffering)
Tjänstekontrakten i domänen Erbjuden e-tjänst används inom tjänsten i 1177 Vårdguidens e-tjänster med samma namn: Erbjuden e-tjänst. Anslutande system ska anslutas som konsument av tjänstekontrakten.
Adressering
Tjänstekontrakten i domänen Erbjuden e-tjänst tillämpar systemadressering. HSA-id för 1177 Vårdguidens e-tjänster används som logisk adressat.
Nödvändiga tjänstekontrakt
Domänen innehåller bara ett tjänstekontrakt: GetAvailableEServices.
1177 Vårdguidens e-tjänster som producent av tjänstekontrakten i domänen Erbjuden e-tjänst
| Miljö av Nationella tjänsteplattformen | HSA-id för 1177 Vårdguidens e-tjänster som producent |
|---|---|
| QA-miljö | SE2321000016-A29F |
| Produktionsmiljö | SE2321000016-92V4 |