...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Innehållsförteckning | ||
|---|---|---|
|
Inkorgsfunktionen i 1177 Vårdguidens e-tjänster gör det möjligt för externa system som t.ex. kvalitetsregister, journalsystem och andra verksamhetssystem att skicka meddelanden till invånare med konto i 1177 Vårdguidens e-tjänster. Inkorgsfunktionen är baserad på tjänstekontrakten IsActiveUser och AddMessageToPatientPortalInbox i tjänstedomänen Patientportal.
Riktlinjer
Följande riktlinjer är ett underlag vid bedömning av vilka typer av tjänster som tillåts ansluta till Inkorgsfunktionen i 1177 Vårdguidens e-tjänster.
För regioner:
- Tjänsten ska rymmas inom 1177 Vårdguidens övergripande erbjudande och bidra till det värde som e-tjänsterna ska skapa för användaren, läs mer https://www.inera.se/tjanster/1177-vardguidens-e-tjanster/.
- Den aktör som står bakom tjänsten ska ha ett avtal med en region och ansökan ska också komma från en region.
- Anslutande aktör ska ha en organisation för utvecklings- och anslutningsprocessen med kontaktperson och tidplan.
- Det ska finnas en tilltänkt support- och förvaltningsorganisation i regionen för tjänsten.
- Tjänsten ska leva upp till och följa förutsättningar och krav för användning av inkorgsfunktionen (se nedan).
- Inkorgsfunktionen är avsedd för kommunikation mellan enskild patient/invånare och ansvarig mottagning med tydlig koppling till patients/invånares egen hälsa. Det kan till exempel vara ett hälsoformulär inför ett besök eller efter nyligen genomgången behandling. Ett annat exempel är meddelanden från en tjänst inom 1177 Vårdguiden som invånaren själv har initierat.
- Varje meddelande måste innehålla tydlig information om vilken mottagning/vårdenhet som är avsändare, vad syftet med meddelandet är, vad det innehåller och hur eventuella svar ska användas.
- Inkorgsfunktionen får endast användas då mottagningen och patienten/invånaren har en etablerad relation och en pågående kontakt.
- Inkorgsfunktionen är inte avsedd att användas som en allmän informationskanal eller för enkätutskick riktade brett till olika patientgrupper inom vården.
- Inkorgsfunktionen får inte användas för att söka deltagare till läkemedels- eller forskningsstudier. Däremot får en mottagning, med tydlig koppling till patients/invånares egen hälsa, som är med i ett forskningsprojekt söka deltagare bland sina egna patienter via ett meddelande via inkorgsfunktionen.
För kvalitetsregister:
- Tjänsten ska rymmas inom 1177 Vårdguidens övergripande erbjudande och bidra till det värde som e-tjänsterna ska skapa för användaren, läs mer: https://www.inera.se/tjanster/1177-vardguidens-e-tjanster/.
- Kvalitetsregistret ska följa anslutningsprocessen som är beskriven här: http://qrcstockholm.se/register/intro-registerutveckling/1177-vardguiden-e-tjanster/.
- Anslutande aktör ska ha en organisation för utvecklings- och anslutningsprocessen med kontaktperson och tidplan.
- Det ska finnas en tilltänkt support- och förvaltningsorganisation för tjänsten.
- Tjänsten ska leva upp till och följa förutsättningar och krav för användning av inkorgsfunktionen (se nedan).
- Inkorgsfunktionen är avsedd för kommunikation mellan enskild patient/invånare och ansvarig mottagning med tydlig koppling till patients/invånares egen hälsa. Det kan till exempel vara inrapportering av PROM/PREM.
- Varje meddelande måste innehålla tydlig information om vilken mottagning/vårdenhet som är avsändare, vad syftet med meddelandet är, vad det innehåller och hur svaren ska användas.
- Inkorgsfunktionen får endast användas då mottagningen och patienten/invånaren har en etablerad relation och en pågående kontakt.
- Inkorgsfunktionen är inte avsedd att användas som en allmän informationskanal eller för enkätutskick riktade brett till olika patientgrupper inom vården.
- Inkorgsfunktionen får inte användas för att söka deltagare till läkemedels- eller forskningsstudier. Däremot får en mottagning, med tydlig koppling till patients/invånares egen hälsa, som är med i ett forskningsprojekt söka deltagare bland sina egna patienter via ett meddelande i inkorgsfunktionen.
Förutsättningar och krav för användning av Inkorgsfunktionen
...
Skall informeras till anslutande part med 2 månaders framförhållning.
Kommunikation kommer att ske via mejlutskick och även sammanställas på:
https://invanartjanster.atlassian.net/wiki/x/noG_Gg
...
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.
...
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:
- IsActiveUser
- AddMessageToPatientPortalInbox
...
3.3.2
...
Tekniska krav
System ansluts till Inkorgsfunktionen genom att etablera samverkan (integrera) med 1177 Vårdguidens e-tjänster genom tjänstekontrakten i tjänstedomänen Patientportal i 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 AddMessageToPatientPortalInbox.
- Vid godkänd intresseanmälan kommer det anslutande systemet (konsumentsystemet) att registreras i 1177 Vårdguidens e-tjänster och tilldelas ett system-ID. Detta system-ID ska konsumentsystemet skicka med inom elementet sourceSystem i sina anrop till tjänsten AddMessageToPatientPortalInbox i Nationella tjänsteplattformen. Enligt tjänstekontraktet är det frivilligt för ett konsumentsystem att uppge ett värde i elementet sourceSystemmen vid integration med 1177 Vårdguidens e-tjänster är värdet alltså alltid obligatoriskt.
- Enligt tjänstekontraktet är det frivilligt för det anslutande systemet (konsumentsystemet) att uppge elementet message.messageDescription i sina begäran till tjänsten AddMessageToPatientPortalInbox. Vid integration med 1177 Vårdguidens e-tjänster är dock elementet och ett värde i det obligatoriskt.
- 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.
- 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.
Kostnad
Anslutningsavgift
...
- Konfigurering av 1177 Vårdguidens e-tjänsters testmiljö
- Tillgång till testmiljön av 1177 Vårdguidens e-tjänster med personliga konton för möjlighet att testa
- Hjälp och support under testperioden
- Konfigurering av 1177 Vårdguidens e-tjänsters produktionsmiljö
- Hjälp och support i produktionsmiljön av 1177 Vårdguidens e-tjänster
- Hantering av supportärenden från första linjens support
- Koordinering av anslutningar och problem
- Konfigurering av Nationella tjänsteplattformen
...
- Framtida drift
- Drift av Nationella tjänsteplattformen
- Behöver en anslutande part extra hjälp och support för att få det egna systemet att fungera får detta köpas separat
Prismodell för användande av tjänst
...
Principer för prismodellen
Prismodellen innebär att anslutande part betalar per skickat meddelande. Detta utifrån att ett skickat meddelande initierar eventuell sms-avisering samt inloggning.
I pris per meddelande ingår följande:
- Kostnad för sms-avisering
- Kostnad för SAML-biljett vid inloggning
- 1:a linjens support
- 2:a linjens support
- Förvaltningsresurs/er i 1177 Vårdguidens förvaltning
Observera att en anslutningsavgift på 25 000 kronor tillkommer i samband med den tekniska anslutningen (engångsavgift). Se mer information om vad som ingår i anslutningsavgiften ovan.
Pris per skickat meddelande och anslutet system:
Meddelande nr 1 – 49 999 kostar 3.1 kr/meddelande, därefter:
Meddelande nr 50 000- 499 999 kostar 2.4 kr/meddelande, därefter:
Meddelande nr 500 000 och uppåt kostar 1,4 kr/meddelande
Exempel: 75 000 skickade meddelanden från ett anslutet system per kvartal kostar totalt 214 999kr (49 999* 3,1+ 25001*2.4)
...
Litet system
...
Mellansystem
...
Stort system
...
Allmänt om prismodellen
Förvaltningen drivs utan vinstsyfte, men har en marginal för oförutsedda utgifter som behöver göras för att vidmakthålla förvaltningen. De gemensamma kostnaderna revideras löpande för att motsvara de faktiska kostnaderna.
Modellen tar INTE höjd för Ineras overhead (exempelvis Nationella tjänsteplattformen och generell overhead)
Modellen tar inte höjd för eventuella framtida investeringar som kan behöva göras i programvaror och infrastruktur för att hantera en ökad last och framtidens krav.
Teknisk dokumentation
Inkorgsfunktionen är baserad på tjänstekontrakten i tjänstedomänen Patientportal. 1177 Vårdguidens e-tjänster är anslutet till Nationella tjänsteplattformen som producent av dessa tjänstekontrakt. Anslutande system ska anpassas till tjänstekontrakten för att kunna anlutas till Nationella tjänsteplattformen som konsument av dessa. Läs mer på Tjänstekontrakt och Nationella tjänsteplattformen.
...
Används för att kontrollera om en invånare är användare av den nationella patientportalen 1177 Vårdguidens e-tjänster. Returnerar även aktiv användares inställningar för avisering.
...
Används för att adressera meddelanden till en invånare genom den nationella patientportalen 1177 Vårdguidens e-tjänster.
Uthoppslänkar (SSO)
Anslutande system kan konfigureras för att stödja uthopp/länkning med sömlös övergång (SSO) för att på så sätt låta invånaren hitta tillbaka till konsumentsystemet via en uthoppslänk i inkorgsmeddelandet. Uthoppslänken kan konfigureras på två olika sätt:
- Genom att inkludera XML-elementet message.ssoLink och dess underlement.
- Genom att konfigurera länken direkt i meddelandetexten inom DocBook-elementet ulink.
Avsändaren kan avgöra om denne vill att meddelandet ska aviseras invånaren om möjligt. Om avisering sker, och i så fall med vilken metod (sms och/eller e-post), beror på invånarens personliga inställningar i 1177 Vårdguidens e-tjänster.
För att komma igång är initialt två konfigurationsparametrar aktuella, varav den ena är obligatorisk.
...
Erhålls av förvaltningen för 1177 Vårdguidens e-tjänster.
Används för att identifiera konsumentssystemet hos 1177 Vårdguidens e-tjänster. Systemid är obligatoriskt att skicka med i elementet som heter sourceSystem, som är en del av tjänstekontraktet AddMessageToPatientPortalInbox. Systemid används också som ett id-begrepp för att hitta igen den konfigurerade bas-URL:en, om konsumenten valt att använda sig av en sådan.
...
Informationsmappning mellan tjänstekontrakten och invånarens vyer
Detta avsnitt visar hur 1177 Vårdguidens e-tjänster presenterar innehållet i XML-meddelanden som skickas genom tjänstekontaktet AddMessageToPatientPortalInbox. Tabellen under bilderna visar mappningen mot de ingående elementen i XML-meddelandet.
Inkorg
I inkorgen visas ärenden och meddelanden. I den övergripande listan visas vad som kallas huvudärenden. Klickar man på ett ärende eller meddelande öppnas det och man ser meddelandets detaljer. I den detaljerade vyn ser man även ”trådade” meddelanden. Ett huvudärende kan ha flera ”trådade” meddelanden.
Konsumenten kan själv styra rubriken eller beskrivningen av meddelandet. Detta görs genom att sätta ett värde för elementet messageDescription. Sätter man inget värde är default-värdet Meddelande. Ett meddelande är markerat som oläst i inkorgen tills användaren öppnat det och tittat på dess detaljer.
...
Meddelande
När man klickat på ett meddelande i inkorgen visas dess detaljer. Den större delen av vad som visas är förstås själva meddelandet. Som konsument kan man även styra utseende av andra detaljer. Rubriken för meddelandets detaljerade information tas även den från vad som konsumenten anger i messageDescription enligt ovan. Däremot är defaultvärdet blankt om man inte anger något, alltså inte "Meddelande", som i listan med huvudärenden. Man kan även ange information om mottagningen som står som avsändare för meddelandet. Detta görs genom att ange värden i (underelementen till) elementet organisationUnit. Inkorgsmeddelandet visar den information som konsumenten anger. Det hämtas alltså ingen information från HSA eller 1177 Vårdguidens e-tjänsters register av mottagningar.
...
Avsändande vårdenhets namn. Klick tar invånaren till vårdenhetens kontaktkort i 1177 Vårdguidens e-tjänster. Detta förutsätter att avsändande vårdenhets HSA-id (message.organisationUnit.unitId) är anslutet till 1177 Vårdguidens e-tjänster.
...
Formatering av meddelanden
Konsument har möjlighet att formatera text i elementet message.messageText i det standardiserade layout-formatet DocBook (vid användning av SSO-länk i 1177 Vårdguidens e-tjänster är DocBook-formatering av texten ett krav). DocBook är ett ganska rikligt format (http://www.docbook.org/tdg5/en/html/docbook.html). Därför finns en avgränsning till ett antal utvalda element och ett antal utvalda kombinationer av dessa. Tabellen nedan redovisar möjliga kombinationer av element i DocBook-formatet som stöds av tjänsten. Annan användning av DocBook kommer resultera i att texten ”##### Mismatched Element in Source #####” visas i inkorgsmeddelandet.
...
Element
...
Parent
...
Child
...
article
...
NA
...
info, para, section, bibliography, variablelist
...
info
...
article, section
...
title
...
section
...
article
...
info, title, para, bibliography, variablelist
...
para
...
article, section
...
ulink
...
bibliography
...
article, section
...
NA
...
variablelist
...
article, section
...
title, varlistentry
...
title
...
info, section, variablelist
...
NA
...
ulink
...
para
...
NA
...
varlistentry
...
variablelist
...
term, listitem
...
term
...
varlistentry
...
NA
...
listitem
...
varlistentry
...
NA
Entity encoding
Text som skickas i elementet messageText i DocBook-format måste vara ”entity encoded” så att DocBooks XML-taggar inte uppfattas som del av SOAP-meddelandets XML-struktur. Nedan är ett exempel på ett XML-meddelande före och efter entity encoding.
...
| width | 50% |
|---|
| Kodblock | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0"?>
<article>
<section>
<title>article.section.title</title>
<info>
<title>article.section.info.title</title>
</info>
<para>article.section.para</para>
<para>
<ulink url="http://www.exampleurl.com">article.section.para.ulink</ulink>
</para>
<bibliography>article.section.bibliography</bibliography>
</section>
<section>
<title>article.section.title</title>
<variablelist>
<title>article.section.variablelist.title</title>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
</variablelist>
</section>
</article> |
...
| width | 50% |
|---|
| Kodblock | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0"?>
<article>
<section>
<title>article.section.title</title>
<info>
<title>article.section.info.title</title>
</info>
<para>article.section.para</para>
<para>
<ulink url="http://www.exampleurl.com">article.section.para.ulink</ulink>
</para>
<bibliography>article.section.bibliography</bibliography>
</section>
<section>
<title>article.section.title</title>
<variablelist>
<title>article.section.variablelist.title</title>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
<varlistentry>
<term>article.section.variablelist.varlistentry.term</term>
<listitem>article.section.variablelist.varlistentry.listitem</listitem>
</varlistentry>
</variablelist>
</section>
</article> |
Kodexempel
Bifogade kodexempel nedan ovan kan kopieras, användas och återanvändas fritt. Kodexemplen underhålls dock inte av 1177 Vårdguidens e-tjänsters förvaltning. 1177 Vårdguidens e-tjänsters förvaltning tar heller inte ansvar för att kodexemplen fungerar i konsumerande systems miljö.
| View file | ||||
|---|---|---|---|---|
|
Process för anslutning
...
| Info | ||
|---|---|---|
| ||
Informationen på denna sida avser anslutning till inkorgsfunktionen som ska ersättas av den fristående tjänsten 1177 Inkorg. Denna sida finns kvar tills ny sida för 1177 Inkorg är komplett. |
| Infoga utdrag | ||||||
|---|---|---|---|---|---|---|
|
Inkorgsfunktionen i 1177 Vårdguidens e-tjänster gör det möjligt för externa system som t.ex. kvalitetsregister, journalsystem och andra verksamhetssystem att skicka meddelanden till invånare med konto i 1177 Vårdguidens e-tjänster. Inkorgsfunktionen är baserad på tjänstekontrakten IsActiveUser och AddMessageToPatientPortalInbox i tjänstedomänen Patientportal. Det finns uppställda /wiki/spaces/OVET/pages/63307879 som måste uppfyllas för att ett system ska få skicka meddelanden till invånare. Innan ni påbörjar processen är det viktigt att ni läser igenom och uppfyller de krav som ställs. |
1. Intresseanmälan och planering av anslutningenVid intresse av att ansluta till Inkorgsfunktionen ska den regionala förvaltningen för 1177 Vårdguidens e-tjänster i |
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Anslutande part ansluter systemet till tjänstekontrakten i tjänstedomänen Patientportal i produktionsmiljön av Nationella tjänsteplattformen. Information om tjänstekontrakt och Nationella tjänsteplattformen finns på sidan Tjänstekontrakt och Nationella tjänsteplattformen.
9. Skicka kontaktuppgifter till 2:a linjens support och en presentation om tjänsten
Se Supportväg.
10. Teckna avtal
...
...
...
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 tjänsten i e-tjänsterna) kommer supporten för 1177 Vårdguidens e-tjänster att hänvisa till den anslutande partens egen support. Därefter stängs ärendet hos e-tjänsternas support.
Den anslutande parten ansvarar för support för tjänsten. Vid misstanke att det kan dröja med åtgärd/återkoppling i ärendet ansvarar den anslutande partens support om att informera anmälaren om det. Kontaktuppgifter till den anslutande partens egen support ska tydligt framgå i tjänstens gränssnitt. Varje inkorgsmeddelande måste innehålla tydlig information om vart man vänder sig om man har frågor om innehållet.
Anslutande systems supportuppdrag innefattar exempelvis:
- Allmänna frågor om tjänsten
- Felanmälan som kräver teknisk felsökning i tjänsten
- Synpunkter och förbättringsförslag på tjänsten
- Landstings- och regionsspecifika frågor om tillämpning och användning (exempelvis frågor om urval och ”Hur gör jag”-frågor).
Anslutande part ska upprätta en supportorganisation med tydliga kontaktvägar in för alla ärenden. Det kommer även att vara den kontaktväg som e-tjänsternas support hänvisar invånare vidare till. Vi ser helst att kontaktvägen består av både mejl och telefonnummer till den anslutande partens support. Dessa uppgifter inklusive en presentation om tjänsten (se ett exempel på hur en sådan presentation kan se ut) ska skickas till förvaltningen för 1177 Vårdguiden, e-tjanster@1177.se. Detta ska skickas 4 veckor innan tjänsten blir tillgänglig för användare.
...
...
...
Tillgänglighet (ange vilka dagar och tider er del av supportkedjan är tillgänglig):
...