Checklistor

Stegen i checklistorna nedan förutsätter att tidbokningssystemet redan har stöd för tjänstekontrakten Tidbokning (version 1.1) och Engagemangsindex.

LT = Anslutande landsting/region
NF = Nationella förvaltningen

Förberedelser

Aktivitet	Beskrivning	Ansvarig
Uppstartsmöte	Boka möte med berörda personer inom landstinget/regionen för genomgång av process och stödmaterial.	LT
Etablera Integrationsprojekt	Etablera ett regionalt projekt med deltagare från verksamhet och IT. Utse projektledare och ta fram en projektplan.	LT
Krav, användningsfall och flöden	Dokumentera flöden som skall stödjas, tjänster som skall erbjudas samt specificera verksamhetsregler.	LT
Testplan inklusive testfall, testpersoner, testmottagningar, krav på testmiljö.	Gör upp en testplan. Testfallen skall överensstämma med de användningsfall/flöden som skall gälla för denna integration. Testplanen kommer att efterfrågas i förstudien som landstinget/regionen behöver skicka in vid anslutning till Nationella tjänsteplattformen.	LT
Ta fram skiss på lösning	Beskriv lösningen på en konceptuell och arkitektonisk nivå. Skissen kommer att efterfrågas i förstudien som landstinget/regionen behöver skicka in vid anslutning till Nationella tjänsteplattformen.	LT
Anslut vårdenheter till 1177 Vårdguidens e-tjänster	De vårdenheter som ska erbjuda webbtidbokning måste vara anslutna till 1177 Vårdguidens e-tjänster. Olika landsting/regioner har olika rutiner för hur man ansluter vårdenheter till e-tjänsterna, kontaktuppgifter finns på https://personal.minavardkontakter.se/C125758200576A1B/p/OSAL-7PBHZV?opendocument
Installera tidbokningssystemet i testmiljö	Tidbokningssystemet installeras i landstingets/regionens testmiljö.	LT
Beställa och installera SIHTS funktionscertifikat för test och produktion	SITHS funktionscertifikat måste finnas installerat på de servrar som skall anslutas till Nationella tjänsteplattformen. HSA-id (Serial Number) på certifikatet blir tjänsteproducentens ID, vilket kommer att behöva uppges i vissa beställningsblanketter. Anslutning till SITHS och beställning av certifikat.	LT
Lägga in certifikat i truststore	Nationella tjänsteplattformen uppvisar olika certifikat beroende på vilken miljö som används. Teknisk information om Nationella tjänsteplattformen. Dessa måste läggas in i truststore på landstingets/regionens servrar. Checklista - ansluta till webbtidbokning i 1177 Vårdguidens e-tjänster.	LT
Öppna brandväggar	Brandväggar i test- och produktionsmiljö måste konfigureras så att Nationella tjänsteplattformen når tjänsterna för tidbokning. Teknisk information om Nationella tjänsteplattformen	LT
Skaffa åtkomst till testmiljön av 1177 Vårdguidens e-tjänster	De som ska utföra tester måste beställa åtkomst till testmiljön av 1177 Vårdguidens e-tjänster. Testinformation 1177 Vårdguidens e-tjänster.	LT
Lägga in testpersoner i tidbokningssystemet	Landstingen och regionerna har en egen uppsättning testpatienter och testvårdpersonal som kan användas för tester i testmiljön av 1177 Vårdguidens e-tjänster. Dessa måste läggas in i testmiljön av tidbokningssystemet. Landstingen och regionernas testpersoner i testmiljön för 1177 Vårdguidens e-tjänster.	LT
Konfigurera eventuell regional tjänsteplattform/tjänsteväxel.	Detta gäller endast om landstinget/regionen har en regional tjänsteplattform/tjänsteväxel som tidbokningssysemet ska anslutas till. Om landstinget/regionen ansluter via en regional tjänsteplattform/tjänsteväxel så kommer denna att vara tjänsteproducent i förhållande till Nationella tjänsteplattformen (NTP).	LT

Anslutning till testmiljö

Aktivitet	Beskrivning	Ansvarig
Skicka in förstudie för anslutning till testmiljö.	Länk till förstudiemall.	LT
Godkännande av förstudie	När förstudien för anslutning till testmiljö är godkänd fyller landstinget/regionen i och skickar in nödvändiga anslutningsblanketter.	NF
Beställ anslutning till tjänstekontrakten för Tidbokning i QA-miljön av Nationella tjänsteplattformen	Tidbokningssystemet måste anslutas som en producent av tjänstekontrakten för tidbokning i QA-miljön av Nationella tjänsteplattformen och etablera samverkan med testmiljön av 1177 Vårdguidens e-tjänster. Så fyller du i Beställning C för Tidbokning. Så fyller du i Beställning D för Tidbokning.	LT
Beställ anslutning till tjänstekontrakten för Engagemangsindex i QA-miljön av Nationella tjänsteplattformen	Tidbokningssystemet måste anslutas som en konsument av tjänstekontrakten för Engagemangsindex i QA-miljön av Nationella tjänsteplattformen och etablera samverkan med Engagemangsindex. Så fyller du i Beställning B för Engagemangsindex. Så fyller du i Beställning D för Engagemangsindex.	LT
Konfigurering av Nationella tjänsteplattformen	Inera konfigurerar tjänsteadresseringskatalogen (TAK) i QA-miljön av Nationella tjänsteplattformens och utför kommunikationstester gentemot tidbokningssystemet.	NF
Mottagningskonton skapas i testmiljön av 1177 Vårdguidens e-tjänster	Vårdenheterna i Beställning D för Tidbokning får konton i testmiljön av 1177 Vårdguidens e-tjänster. OBS! Detta sker enbart vid anslutning till testmiljön. Landstinget/regionen ansvarar själv för att ansluta vårdenheter till produktionsmiljön av 1177 Vårdguidens e-tjänster.	NF
Tidbokningssystemet anslutet till tjänstekontrakten för Tidbokning och Engagemangsindex i QA-miljö	När Inera meddelar att beställningarna är utförda så är tidbokningssystemet anslutet till Nationella tjänsteplattformen och integrerat med testmiljön av 1177 Vårdguidens e-tjänster och Engagemangsindex.	NF
Konfigurera mottagningskonton i testmiljön av 1177 Vårdguidens e-tjänster.	De vårdenheter som ska användas inom testerna måste göras synliga för testpatienterna genom att förses med rätt geografiskt betjäningsområde. Detta görs genom att logga in med landstingets/regionens testvårdpersonalkonto och tilldela den behörigheten lokal administratör på vårdenheterna. Som lokal administratör kan man tilldela en vårdenhet ett geografiskt betjäningsområde. Den lokala administratören måste även aktivera tjänsterna (ärendetyperna) för webbtidbokning på vårdenheterna, så att de kan användas av testpatienterna. Så konfigurerar du testmiljön.	LT

Anslutning till produktionsmiljö

Aktivitet	Beskrivning	Ansvarig
Installation av tidbokningssystem	Tidbokningssystemet installeras i landstingets/regionens produktionsmiljö	LT
Skicka in förstudie för anslutning till produktionsmiljö.	Länk till förstudiemall.	LT
Godkännande av förstudie	När förstudien för anslutning till produktionsmiljö är godkänd fyller landstinget/regionen i och skickar in nödvändiga anslutningsblanketter.	NF
Beställ anslutning till tjänstekontrakten för Tidbokning i produktionsmiljön av Nationella tjänsteplattformen	Tidbokningssystemet måste anslutas som en producent av tjänstekontrakten för tidbokning i produktionsmiljön av Nationella tjänsteplattformen och etablera samverkan med produktionsmiljön av 1177 Vårdguidens e-tjänster. Så fyller du i Beställning C för Tidbokning. Så fyller du i Beställning D för Tidbokning.	LT
Beställ anslutning till tjänstekontrakten för Engagemangsindex i produktionsmiljön av Nationella tjänsteplattformen	Tidbokningssystemet måste anslutas som en konsument av tjänstekontrakten för Engagemangsindex i produktionsmiljön av Nationella tjänsteplattformen och etablera samverkan med Engagemangsindex. Så fyller du i Beställning B för Engagemangsindex. Så fyller du i Beställning D för Engagemangsindex.	LT
Konfigurering av Nationella tjänsteplattformen	Inera konfigurerar tjänsteadresseringskatalogen (TAK) i produktionsmiljön av Nationella tjänsteplattformens och utför kommunikationstester gentemot tidbokningssystemet.	NF
Tidbokningssystemet anslutet till tjänstekontrakten för Tidbokning och Engagemangsindex i produktionsmiljö	När Inera meddelar att beställningarna är utförda så är tidbokningssystemet anslutet till produktionsmiljön Nationella tjänsteplattformen och integrerat med produktionsmiljön av 1177 Vårdguidens e-tjänster och Engagemangsindex.	NF
Verifiering	Landstinget/regionen kan låna en testpatient för att verifiera tjänsten i produktionsmiljön av 1177 Vårdguidens e-tjänster.	LT

Stöddokumentation

Anslutningsblanketter

Så fyller du i Beställning C för Tidbokning

För att ansluta ett system som producent av tjänstekontrakten för Tidbokning (crm:scheduling). Länk till Beställning C.

Fält	Förklaring
Anslutning till QA- eller produktionsmiljö?	Uppge om anslutningen gäller QA (test) eller produktionsmiljön.
System	Uppge namnet på systemet som skall anslutas. Exempelvis "Tieto Flexlab".
Organisation	Namnet på organisationen som ansvarar för installationen av systemet. Exempel: "Landstinget Gävleborg".
Producentsystemets HSA-id	HSA-id (Serial number) på SITHS-certifikatet som finns installerat på den server som kommer att ta emot anropen från Nationella tjänsteplattformen. Exempel: "SE162321000198-0015".
Nätverk	Uppge om anslutningen ska gå över Sjunet eller Internet.
URL	Adress till respektive tjänst som skall anslutas.
Kontaktperson övergripande	Uppge kontaktuppgifter till övergripande ansvarig i landstinget/regionen.
Kontaktperson teknik	Uppge kontaktuppgifter till tekniskt ansvarig i landstinget/regionen.
URL till övervakningstjänst
E-post för automatiska larm	Frivilligt fält. Se förklaring på blanketten.
Tjänstedomän	Skriv "crm:scheduling" eller "Tidbokning".
Tjänster	Uppge vilka tjänstekontrakt som skall anslutas till Nationella tjänsteplattformen. Se Tjänstekontrakt vs. e-tjänst.
RIV-TA version	Skriv "2.1". Tjänstekontrakten i version 1.1 av tjänstedomänen Tidbokning är utvecklade enligt RIV-TA version 2.1.
Tjänstedomänens SLA uppfyllt	SLA-kraven för tjänstedomänen Tidbokning finns specificerade i tjänstekontraktsbeskrivningen.
Övrig information
Datum
Beställare

Så fyller du i Beställning D för Tidbokning

För att etablera samverkan (integrera) med konsument av tjänstekontrakten för Tidbokning (crm:scheduling). Länk till Beställning D

Fält	Förklaring
Anslutning till QA- eller produktionsmiljö	Uppge om anslutningen gäller QA (test) eller produktionsmiljön.
Tjänstedomän	Skriv "crm:scheduling" eller "Tidbokning".
Tjänstekontrakt	Uppge vilka tjänstekontrakt som skall användas inom integreringen. Se Tjänstekontrakt vs. e-tjänst .
Tjänsteproducentens HSA-id och namn	HSA-id (Serial number) på SITHS-certifikatet som finns installerat på den server som tar emot anropen från Nationella tjänsteplattformen. Exempel: "SE162321000198-0015".
Tjänstekonsumentens HSA-id och namn	Gäller konsumentens HSA-id. Om konsumenten är 1177 Vårdguidens e-tjänster, skriv "SE2321000016-A29F" för QA (test) och "SE2321000016-92V4" för produktionsmiljön.
Logiska adressater och namn	Uppge HSA-id för verksamheterna vars tidböcker ska anslutas.
Överenskommelse om integration
Övrig information
Datum
Beställare

Så fyller du i Beställning B för Engagemangsindex

För att ansluta ett system som producent av tjänstekontraktet Update i tjänstedomänen Engagemangsindex (itintegration:engagementindex). Länk till Beställning B

Fält	Förklaring
Anslutning till QA- eller produktionsmiljö?	Uppge om anslutningen gäller QA (test) eller produktionsmiljön.
System	Uppge namnet på systemet som ska kommer att uppdatera Engagemangsindex. Exempelvis "Tieto Flexlab".
Organisation	Namnet på organisationen som ansvarar för installationen av systemet. Exempel: "Landstinget Gävleborg".
Tjänstekonsumentens HSA-id	HSA-id (Serial number) på SITHS-certifikatet som finns installerat på den server som kommer att skicka anrop till Nationella tjänsteplattformen. Exempel: "SE162321000198-0015".
Nätverk	Uppge om anslutningen ska gå över Sjunet eller Internet.
IP-adress	Uppge det anslutande systemets externa IP-adress.
Kontaktuppgifter (funktionsbrevlåda)
Kontaktperson teknik
Tjänstedomän	Uppge "itintegration:engagementindex" eller "Engagemangsindex".
Tjänstekontrakt	Skriv "Update", som är tjänstekontraktet som används för att uppdatera Engagemangsindex i Nationella tjänsteplattformen.
Anslutning till aggregerande tjänst
Övrig information
Datum
Beställare

Så fyller du i Beställning D för Engagemangsindex

För att ansluta etablera samverkan (integrera) med producent av tjänstekontrakten för Engagemangsindex (itintegration:engagementindex). Länk till Beställning D

Fält	Förklaring
Anslutning till QA- eller produktionsmiljö	Uppge om anslutningen gäller QA (test) eller produktionsmiljön.
Tjänstedomän	Uppge "itintegration:engagementindex" eller "Engagemangsindex".
Tjänstekontrakt	Skriv "Update", som är tjänstekontraktet som används för att uppdatera nationella Engagemangsindex.
Tjänsteproducentens HSA-id och namn	Tjänsteproducent är Engagemangsindex i Nationella tjänsteplattformen som har HSA-id "T_SERVICES_SE165565594230-1023" i QA och "HSASERVICES-106J" i produktion.
Tjänstekonsumentens HSA-id och namn	HSA-id (Serial number) på SITHS-certifikatet som finns installerat på den server som kommer att skicka anrop till Nationella tjänsteplattformen. Exempel: "SE162321000198-0015".
Logiska adressater och namn	Engagemangsindex i Nationella tjänsteplattformen adresseras på Ineras organisationsnummer, som är "5565594230".
Överenskommelse om integration
Övrig information
Datum
Beställare

Tjänstekontrakt vs. e-tjänst

Tabellen nedan visar vilka tjänstekontrakt som en vårdenhet (logisk adressat) måste anslutas 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	KRÄVS *	KRÄVS	KRÄVS	KRÄVS
GetAvailableDates	Listar datum med bokningsbara tider utifrån sökparametrar	KRÄVS	KRÄVS
GetAvailableTimeslots	Listar bokningsbara tider utirån sökparametrar	KRÄVS	KRÄVS
GetBookingDetails	Visa komplett information om en bokning	KRÄVS *	KRÄVS	KRÄVS	KRÄVS
CancelBooking	Avboka invånare från bokning, orsak kan anges			KRÄVS
UpdateBooking	Ändra tid för en bokning		KRÄVS
MakeBooking	Ny bokning	KRÄVS
GetAllTimeTypes	Listar tillgängliga tidtyper för nybokning	KRÄVS
GetAllHealthcareFacilities	Listar enheter som invånare kan boka om till.	FRIVILLIG	FRIVILLIG
GetAllPerformers	Listar utförare (medarbetare)	FRIVILLIG	FRIVILLIG
GetAllCareTypes	Listar vårdtyper för nybokning	FRIVILLIG **	FRIVILLIG **

* Används inte inom flödet för att boka tid men är obligatoriskt enligt tjänstekontraktsbeskrivning
** Tjänstekontraktet GetAllCareTypes stödjs ej av konsumenten 1177 Vårdguidens e-tjänster

Termer och begrepp

Tabellen nedan är hämtad från version 2.0.1 av dokumentet RIV Tekniska Anvisningar Översikt: http://rivta.se/documents/ARK_0001/

Term	Förkortning	Beskrivning
Tjänstekontrakt		Kontrakt som beskriver ett nationellt standardiserat gränssnitt som förekommer mellan tjänstekomponenter i en tjänsteorienterad arkitektur. Tjänstekontraktet är oberoende av transport och kuvertering. Tekniskt sett realiseras detta i form av ett tjänsteschema samt en porttyp i en WSDL. Ett tjänstekontrakt beskriver en Utförare (Responder) eller en Initiativtagare (Initiator) i en Tjänsteinteraktion. Ex: Tjänstekontraktet för utförarrollen i tjänsteinteraktionen GetCareContacts heter "GetCareContactsResponder ".
Tjänsteschema		Ett XML-Schema (tjänsteschema) med element för tjänstekontraktets in- och ut meddelanden. Ett tjänstekontrakt identifieras i runtime av tjänsteschemats namnrymd, dvs schemats target namespace. T.ex. "urn:riv: clinicalprocess:logistics:logistics:GetCareContacts :1".
Tjänstedomän		En övergripande, verksamhetsbaserad indelningsgrund för nationellt standardiserade tjänsteinteraktioner. I Riv Tekniska Anvisningar ingår tjänstedomän som en del i uppbyggnaden av namnrymder. Arkitektur och regelverk förvaltar en domänstruktur som baseras på VIFO-kartan.
Tjänstekomponent		Avgränsad mängd programvara som kan utvecklas, integreras, testas, driftsättas och förvaltas fristående. Tjänstekomponenter kan vara såväl tjänstekonsumenter som tjänsteproducenter.
Initiativtagare		Tjänstekomponent som initierar en tjänsteinteraktion. Om tjänsteinteraktionen är av typen Uppdrag-Resultat exponerar initiativtagaren ett tjänstekontrakt för att möjliggöra mottagandet av resultat som sänds av Utföraren i tjänsteinteraktionen.
Utförare		Tjänstekomponent som en initiativtagare interagerar med i en tjänsteinteraktion.
Tjänstekonsument	TjK	Informationssystem där aktörens agerande leder till automatiskt informationsutbyte med andra system (tjänsteproducenter). En tjänstekonsument kan t ex vara en eTjänst, ett verksamhetssystem, en partneringång eller en tjänsteplattform. Tjänstekonsumenten agerar som initiativtagare i en interaktion.
Ursprunglig tjänstekonsument		Den tjänstekonsument som är den ursprungliga initiativtagaren till en interaktion. Distinktionen är betydelsefull t ex när flera tjänsteplattformar är involverade i ett meddelandeutbyte. Information om vilket system som är ursprunglig tjänstekonsument tillhandahålls i http-headern ”xrivta-original-serviceconsumer-hsaid”, se referens [R14]
Tjänsteproducent	TjP	Tjänsteproducenter uppvisar ett tekniskt gränssnitt som möjliggör för tjänstekonsumenter att genom frågemeddelanden förändra eller begära information. En tjänsteproducent kan t ex vara ett verksamhetssystem, partnerutgång, en tjänsteplattform, en aggregerande tjänst eller en stödtjänst. Tjänsteproducenten agerar som utförare i en interaktion gentemot tjänstekonsumenten. Den kan i sin tur skicka meddelanden vidare till andra utförare.
Tjänsteplattform Gemensam instans Regional instans	TP NTP RTP	Tjänsteplattform är ett samlingsnamn för de komponenter som utgör plattform för tjänstebaserad integration över huvudmannagränser. Tjänsteplattformen finns i en nationell gemensam instans (NTP), och i ett flertal regionala (sk regional tjänsteplattform, RTP).
Stödtjänst		Stödtjänster är tjänsteproducenter som tillhör den tekniska domänen, eller hanterar information som inte är bunden till någon specifik verksamhetsprocess.
Virtualiseringsplattform	VP	Komponent inom en tjänsteplattform som ansvarar för att exekvera virtuella tjänster.
Tjänsteadresseringskatalog	TAK	Tjänsteadresseringskatalogen är en stödtjänst som erbjuder administration och åtkomst av information som ligger till grund för den adressering och behörighetskontroll som utförs i en virtualiseringsplattform. Det finns i normalfallet en instans av en TAK inom ramen för varje tjänsteplattform.
Källsystem	KS	Det verksamhetssystem där originalinformationen skapas (t.ex. en driftsinstans av ett journalsystem). Agerar adressat för viss typ av logisk adressering.
Aggregerande tjänst	AgT	En aggregerande tjänst är en integrationstjänst som för en viss individ/patient sammanställer en nationell eller regional vy av informationen av den typ som är aktuell för tjänsten i fråga. Principerna för aggregerande tjänster är beskrivet i Tboken ([R2]). För information om realisering av en aggregerande tjänst på en specifik tjänsteplattform hänvisas till respektive tjänsteplattformsförvaltning.
Aggregeringsplattform	AgP	Komponent inom en tjänsteplattform som ansvarar för att exekvera aggregerande tjänster.
Engagemangsindex	EI	En stödtjänst där det finns uppdaterade nationella index över vilka informationsägare som har information av vilket slag kring en viss invånare/patient. På så sätt erhåller aggregerande tjänster information om vilka verksamheter eller källsystem som behöver adresseras för att samla in information. Engagemangsindex har även en tjänstedomän som innehåller de tjänstekontrakt som används för att nå informationen. Engagemangsindex är utförligt beskrivet i T-boken ([R2]). För detaljer, se även aktuell Tjänstekontraktsbeskrivning för EI.
Virtuell tjänst		Integrationstjänst i en tjänsteplattform som är i en nationell ställföreträdare för alla lokala tjänsteproducenter som uppfyller ett tjänstekontrakt. Den uppträder som om det fanns en gemensam tjänsteproducent, men dirigerar vidare frågemeddelanden till respektive informationsägares tjänsteproducent och förmedlar svarsmeddelandet i retur. Det sker med hjälp av en logisk adress som tjänstekonsumenten bifogar frågemeddelandet.
Logisk adress	LA	Adresseringsbegrepp i RIV-TA. Genom en indirekt adressering åstadkoms lös koppling mellan tjänstekonsumenter och tjänsteproducenter.
Verksamhetsbaserad logisk adress		Logisk adress som baseras på verksamhet eller organisation. Vanligen används verksamhetens HSA-id som adress.
Källsystemsbaserad logisk adress		Logisk adress som baseras på IT-system (källsystem). Det aktuella systemets HSA-id används som adress.