Tekniska krav

Den här sidan har flyttats till https://inera.atlassian.net/wiki/spaces/OIIK/pages/3563487627 . Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har lagt till sidan som en favorit i webbläsaren eller i Confluence, se till att byta ut den till den rätta länken https://inera.atlassian.net/wiki/spaces/OIIK/pages/3563487627 . Om du har blivit länkad hit, rapportera gärna till e-tjänsternas support var länken finns så att nationella förvaltningen kan kontakta sidans ägare. Här kan du kontakta supporten: https://etjanster.inera.se/oversikt/flow/4221

Tekniska krav

System ansluts till 1177 Inkorg genom att etablera samverkan med 1177 Vårdguidens e-tjänster genom tjänstekontrakten i tjänstedomänen Patientportal mha Nationella tjänsteplattformen. Anslutande part måste uppfylla förutsättningar och krav som redogörs för i denna dokumentation samt följa tjänstedomänens anvisningar och regler. Mer information om tjänstekontrakt, hur man utvecklar stöd för dem och ansluter till dem, finns på sidan Tjänstekontrakt och Nationella tjänsteplattformen.

Nedanstående tekniska krav är specifika för 1177 Vårdguidens e-tjänster som tjänsteproducent av tjänstekontraktet AddMessage.

  • För meddelanden som innehåller SSO-länkar (Single sign-on) måste innehållet i elementet message.messageText måste vara formaterat i DocBook.

Uppdatering 210503 - Tidigare krav är nu borttaget:

“Den avsändande vårdenhetens HSA-id, som konsumenten uppger i elementet message.organisationUnit.unitId, måste vara ansluten som en mottagning i 1177 Vårdguidens e-tjänster.”

Se: för hur tjänsten agerar beroende på om enheten som skickas in finns i 1177 Vårdguidens e-tjänster eller inte. Ska Tidboken i 1177 Vårdguidens e-tjänster användas, så gäller fortsatt detta krav.

 


Förutsättningar och krav för användning av Inkorgsfunktionen

Nr

Krav

Beskrivning

Anslutande parts åtagande

1177 Vårdguidens åtagande

1

Allmänt

 

 

 

1.1

Information om förändring

Förändringar som har påverkan på parternas åtaganden

Skall informeras till 1177 Vårdguiden med 2 månaders framförhållning.

Skall informeras till anslutande part med 2 månaders framförhållning.

Kommunikation kommer att ske via mejlutskick och även sammanställas på:

1.2

Uppföljning

Uppföljning av anslutande parts åtagande som beskrivs på denna sida

Anslutande part ska tillhandahålla statistik efter behov.

1177 Vårdguiden ska producera data som går att följa upp.

1.3

Varumärke

Varumärket ägs gemensamt av alla Sveriges kommuner och regioner. Mer information finns här: .

 

 

1.4

Användande av infrastruktur i 1177 Vårdguidens e-tjänster

Inloggning och sms- samt e-post-aviseringar

 

Tillgängliggöra funktionerna enligt bestämda SLA:er.

1.5

 

Portalen för 1177 Vårdguiden

 

Tillgängliggöra funktionerna enligt bestämda SLA:er.

1.6

Utbildning

 

 

Information om hur stödtjänsterna ska användas och fungerar tillhandahålls via Invånartjänsters öppna sidor (Confluence). Implementationsstöd ingår vid behov med 2-3 timmar från våra leverantörer (exempelvis förklaringar av DocBook-format med mera). Ingen verksamhetsutbildning ingår.

1.7

Support

1177 Vårdguidens e-tjänsters support

 

1177 Vårdguidens e-tjänsters support svarar invånaren på frågor som rör inloggningen i e-tjänsterna och fram till att invånaren hittar till inkorgsmeddelandet.

E-tjänsternas supports öppettider: alla dagar mellan klockan 06.00-22.00.

1.7.1

 

Anslutande parts support

Tjänstens support ska tillhandahållas av anslutande part och vara tillgänglig måndag-fredag mellan klockan 08.00-16.45.

 

1.7.2

 

Kontakt för anslutande parts support

Anslutande part ska tillhandahålla kontaktuppgifter till tjänstens support innan produktionssättning, enligt mall nedan. Se rubriken Supportväg.

 

1.7.3

 

PowerPoint-presentation

Anslutande part måste tillhandahålla 1177 Vårdguiden en PowerPoint-presentation av tjänsten.

 

1.7.4

 

Supportkedja

Anslutande part ska upprätta en supportorganisation med tydliga kontaktvägar in för alla ärenden. Se rubriken Supportväg.

Supporten för 1177 Vårdguidens e-tjänster har i uppdrag att ta emot och besvara frågor som uppstår fram till att invånaren kommer till den anslutande partens tjänst. Får e-tjänsternas support in ärenden som egentligen ska besvaras av den anslutande partens support (som alltså inte uppstår fram till att invånaren hittar till inkorgsmeddelandet i e-tjänsterna) kommer supporten för 1177 Vårdguidens e-tjänster att hänvisa till den anslutande partens egen support.

1.7.5

 

Uppföljning av supportärenden

Anslutande part ansvarar för att förbättra och/eller åtgärda saker i sina system som leder till många frågor hos 1177 Vårdguidens support.

1177 Vårdguiden kommer att göra regelbundna uppföljningar av hur mycket support varje extern tjänst genererar och hur dessa ärenden tas om hand senare i supportkedjan.

1.8

Införande

Presentation

Vid behov ska anslutande part göra en presentation (på plats, via telefon eller videokonferens) för 1177 Vårdguiden och eventuella övriga parter.

 

1.8.1

 

Införande planering

Anslutande part ska informera 1177 Vårdguiden om sitt införande och rapportera löpande hur det går.

 

1.8.2

 

Stöd vid införande

 

1177 Vårdguiden kommer inte att tillhandahålla något stöd vid införande om det inte avtalas särskilt om det.

1.9

SLA - 1177 Vårdguiden

 

 

Målbilden är 99,8 %.

 

 

 

 

1177 Vårdguiden kommer att göra en uppföljning inför kommande faktureringsperiod och därefter justera prisnivåer.

1.10

Laguppfyllnad

Följsamhet mot relevanta lagar

Anslutande part ansvarar för att de lagar som är relevanta för det system som de ansvarar för följs.

1177 Vårdguiden ansvarar för att de lagar som är relevanta för e-tjänsterna följs.

1.11

Miljöer

 

 

 

1.11.1

 

Testmiljö

Anslutande part sätter upp och ansvarar för sina egna miljöer för test. Den bör vara produktionslik och beständig samt innehålla önskvärd testdata.

1177 Vårdguiden ansvarar för att anslutande part efter godkända beslut får tillgång till testmiljön.

1.11.2

 

Produktionsmiljö

Anslutande part sätter upp och ansvarar för sina egna produktionsmiljöer.

1177 Vårdguiden ansvarar för att anslutande part efter godkända beslut får tillgång till produktionsmiljön.

2

1177 Inkorg

 

 

 

2.1

1177 Inkorg

Möjlighet att skicka meddelande till invånarens inkorg om man har en pågående vårdrelation.

Att tillhandahålla den funktion där personalen kan skapa meddelanden och skicka till invånare.

Anslutande part behöver ansluta systemet som en konsument av tjänstekontrakten inom domänen infrastructure:eservicesupply:patientportal i nationella tjänsteplattformen.

Att tillhandahålla API och bakomliggande teknisk tjänst för att kunna skicka inkorgsmeddelanden och aviseringar.

2.2

Gränssnitt

 

 

 

2.2.1

 

Administrera meddelanden

Anslutande part ansvarar för att utveckla stöd för administrering av meddelanden (ta bort, uppdatera, lägga till och skapa innehåll).

 

2.2.2

 

Gränssnitt för invånare

 

Gränssnittet för invånare att ta del av inkorgsmeddelanden sker via 1177 Vårdguidens e-tjänster.

2.3

Meddelande

 

 

 

2.3.1

 

Meddelandets tekniska uppbyggnad

Utforma meddelandeinnehåll enligt reglerna för tolkning av DocBook, se Tjänstekontraktsbeskrivning för tjänstedomänen PatientPortal.

Meddelandets formatering kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.

2.3.2

 

Ekonomiskt ansvarig organisation

Varje meddelande måste innehålla en identifikation den verksamhet som är ekonomiskt ansvarig för meddelandet. Det anges i fältet accountableOrganisation.

 

2.3.3

 

Kontaktinformation i meddelandet

Varje meddelande måste innehålla tydlig information om vart man vänder sig om man har frågor om innehållet.

Att kontaktinformation finns med i meddelandet kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.

2.3.4

 

Avsändande vårdenhet i meddelandet

Varje meddelande måste innehålla tydlig information om vilken vårdenhet som är avsändare.

Att avsändande vårdenhet finns med i meddelandet kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.

2.3.5

 

Loggning av skickade meddelanden

Anslutande part måste kunna redogöra för vilka meddelanden som skickats: till vem, från vem och när.

1177 Vårdguiden loggar vad som har skickats, till vem och på vilket sätt.

2.3.7

 

Länkar i meddelandet

Länkar till tjänster som kräver inloggning får endast skickas ut om tjänsterna ingår i samma inloggningsfederation som 1177 Vårdguidens e-tjänster.

1177 Vårdguiden tillhandahåller möjligheten att presentera SSO-länkar för invånaren.

2.4

Avisering

 

 

 

2.4.1

 

Aviseringsfrekvens

Undvik avisering på meddelanden som enbart innehåller information och där invånaren inte behöver agera. Det finns annars en risk för att invånaren blir "immun" mot aviseringar och inte agerar när det behövs.

 

2.4.2

 

Sändning av mejl- och/eller sms

Sändande part beslutar om avisering ska ske (om invånaren har det aktiverat) eller ej.

1177 Vårdguiden tillhandahåller infrastruktur för att kunna avisera invånare via mejl och sms.

2.4.3

 

Mottagande av mejl och/eller sms

 

1177 Vårdguiden tillhandahåller gränssnitt där invånaren själv kan ställa in om och vilka aviseringsalternativ hen vill ha.

2.4.4

 

Tidpunkt för aviseringar

Sändande part ansvarar för att sända inkorgsmeddelanden till invånare under passande tider på dygnet (undvik nattetid).

1177 Vårdguiden aviserar invånare om inkorgsmeddelanden i samma stund som de kommer till invånarens inkorg (oavsett tid på dygnet).

2.5

Köhantering

Köhantering

Anslutande part ska kunna hantera att 1177 Vårdguiden har servicefönster eller tekniska problem och då kunna lägga meddelanden på kö för att skicka dem senare.

1177 Vårdguiden ska tillhandahålla information om planerade servicefönster samt information vid större driftstörningar via Inera.se. 1177 Vårdguiden bedömer när det är aktuellt att informera om driftstörningar, och på vilket sätt.

2.6

Tjänstekontrakt i NTjP

AddMessage

Ansluten part använder sig av tjänstekontraktet på det sätt som är avsett enligt tjänstekontraktsbeskrivningen som finns på Inera.se.

1177 Vårdguiden förvaltar tjänstekontraktet och tjänstedomänen AddMessageToPatientPortal och tillhandahåller information om detta via Inera.se.

2.7

Kvalitetssäkring

Godkännande av tester innan produktionssättning

Anslutande part ansvarar för att utföra sina egna tester.

Att granska anslutande parts testdokumention för att se att den uppfyller DocBook-format och andra givna kriterier enligt det testprotokoll som tillhandahålls av 1177 Vårdguiden. 1177 Vårdguiden granskar och godkänner även ett exempelmeddelande för att se att det uppfyller de krav på meddelandeinnehåll som ställs från 1177 Vårdguiden.

3

Krav på externt system vid SSO-länkar i meddelanden

 

 

 

3.1

SSO - Single Sign On - inom 1177 Vårdguidens federation

Invånarens inloggning i federationen för 1177 Vårdguiden.

Anslutande part ska skapa en egen SP-Connector med IdP.

Att se till att 1177 Vårdguidens e-tjänster är ansluten till utvald IdP (Identity Provider).

3.2

SLO - Single Log Out

Invånarens utloggning från federationen för 1177 Vårdguiden.

Anslutande part ska ha en knapp som använder Single Log Out-funktionen som tillhandahålls av federationen.

Anslutande part ska vid förfrågan verifiera utloggningen enligt det protokoll som finns nedan (steg 9 i anslutningsprocessen).

1177 Vårdguidens e-tjänster kommer att använda sig av samma utloggningsfunktion.

3.3

Navigering

 

 

 

3.3.1

 

Funktion för att återgå till 1177 Vårdguidens e-tjänster

Anslutande part ska ha en funktion som tar invånaren från tjänsten till 1177 Vårdguidens e-tjänster. Det ska vara en länk där det står "Till 1177 Vårdguiden".

 

3.3.2

 

Förändring av länk

Anslutande part ska ha möjlighet att anpassa "Till 1177 Vårdguiden"-länken två gånger per år vad gäller text, utseende med mera utan kostnad för 1177 Vårdguiden.

1177 Vårdguiden aviserar eventuella förändringar av länk minst 2 månader innan.

3.3.3

 

Uthopp i samma fönster

Tjänsten ska öppnas i samma fönster som 1177 Vårdguidens e-tjänster.

 

3.3.4

 

Vem som är inloggad

Det ska tydligt framgå i tjänsten vem som är inloggad (förnamn och efternamn) utifrån information i SAML-biljett.

 

3.4

Logotyp

Användande av 1177 Vårdguidens logotyp

Att inte använda 1177 Vårdguidens logotyp

 

3.5

SLA - anslutade part

 

Anslutande part ska ha sin tjänst (drift av tjänst) tillgänglig i en omfattning som minst motsvarar det SLA som gäller för 1177 Vårdguidens e-tjänster.

1177 Vårdguiden siktar på 99,8 % tillgänglighet.

3.6

Säkerhet

Uppfylld säkerhetsnivå

Starka nyckellängder på certifikat, ciphers, mm. A-rating krävs enligt test som kan utföras på följande sida:

Uppföljning och säkerhetsanalys av anslutna tjänster.

3.7

Information om avsändare

Avsändare och kontaktväg

Den anslutande partens tjänst ska ha sin supports kontaktväg/-ar tydligt synliga i tjänstens gränssnitt. Vem som är avsändare och står bakom tjänsten ska också framgå. 1177 Vårdguidens e-tjänsters supports kontaktuppgifter ska inte framgå i tjänstens gränssnitt.

1177 Vårdguiden ansvarar för supporten för 1177 Vårdguidens e-tjänster. Supporten ansvarar fram till dess att invånaren har klickat på länken till anslutande system som finns i inkorgsmeddelandet, därefter ansvarar anslutande part. E-tjänsternas support svarar inte på frågor om innehållet i inkorgsmeddelandet utan detta måste framgå i inkorgsmeddelandet.

3.8

Driftstörningar

Driftstörningar

Anslutande part måste informera om planerade driftavbrott till supporten för 1177 Vårdguidens e-tjänster. Om det är en oplanerad driftstörning ska anslutande part skicka information om driftstörningen till supporten för 1177 Vårdguidens e-tjänster.

1177 Vårdguiden kommer att informera om planerade driftstörningar samt delge anslutande part information om oplanerade avbrott via Inera.se(alla intressenter kan prenumerera på information via Inera.se). 1177 Vårdguiden bedömer när det är aktuellt att informera om driftstörningar, och på vilket sätt.

3.9

Felsida

När anslutande system har servicefönster eller tekniska problem ska en felsida med relevant information visas.

När anslutande system har servicefönster eller tekniska problem ska en felsida med relevant information visas. Där ska stå vem som ansvarar för systemet (vårdgivare eller organisation) och var man vänder sig för frågor.

1177 Vårdguiden ansvarar för att felsida visas för 1177 Vårdguidens e-tjänster vid driftstörningar.