Innehållsförteckning | ||
---|---|---|
|
...
4. Anslut systemet till QA-miljön av Nationella tjänsteplattformen
Anslutande part ansluter systemet till tjänstekontrakten i tjänstedomänen Patientportal i QA-miljön av Nationella tjänsteplattformen. Information om tjänstekontrakt och Nationella tjänsteplattformen finns på sidan Tjänstekontrakt och Nationella tjänsteplattformen.
5. Beställ testkonton i 1177 Vårdguidens e-tjänster
Testmiljön av 1177 Vårdguidens e-tjänster är skyddad. För att komma åt den krävs att den som ska utföra testerna har ett personligt konto. Läs mer på sidan Testmiljöer.
6. Utför tester
Implementera lösningen genom att skicka inkorgsmeddelanden i testmiljön av 1177 Vårdguidens e-tjänster. Vid behov av råd eller hjälp med felsökning, kontakta supporten för 1177 Vårdguidens e-tjänster på e-tjanster@1177.se. Uppge att ärendet gäller inkorgsfunktionen och beskriv felet.
7. Skicka in testprotokoll
Anslutande part skickar in ifyllt testprotokoll till förvaltningen för 1177 Vårdguidens e-tjänster på e-tjanster@1177.se.
View file | ||||
---|---|---|---|---|
|
8. Anslut systemet till produktionsmiljön av Nationella tjänsteplattformen
Info |
---|
Detta steg kan utföras förutsatt testprotokollet godkänts av förvaltningen för 1177 Vårdguidens e-tjänster. |
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
Avtal för produktion tecknas mellan 1177 Vårdguidens e-tjänster, anslutande part och Inera.
Teknisk dokumentation
Inkorgsfunktionen är baserad på tjänstekontrakten IsActiveUser och AddMessageToPatientPortalInbox i tjänstedomänen Patientportal. 1177 Vårdguidens e-tjänster är anslutet till Nationella tjänsteplattformen som producent av dessa tjänstekontrakt i Nationella tjänsteplattformen. Anslutande system ska anslutas som konsument av tjänstekontrakten i Nationella tjänsteplattformen.
För att komma igång är initialt två konfigurationsparametrar aktuella, varav den ena är obligatorisk.
Tjänstekontrakt | Syfte |
---|---|
IsActiveUser | Används för att kontrollera om en invånare är användare av den nationella patientportalen 1177 Vårdguidens e-tjänster |
Systemid används för att identifiera konsumentssystemet hos producenten. 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.
Ett vanligt användningsområde för denna tjänsteinteraktion är att låta användaren hitta tillbaka till konsumentsystemet via inkorgsmeddelandet. Returnerar även aktiv användares inställningar för avisering. | |
AddMessageToPatientPortalInbox | Används för att adressera meddelanden till en invånare genom den nationella patientportalen 1177 Vårdguidens e-tjänster. |
Meddelanden som skickas genom AddMessageToPatientPortalInbox kan formateras inom vissa givna ramar och kan länka sömlöst till externa system om dessa är anslutna. 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
med hjälp av en uthoppslänk. Uthoppslänken kan konfigureras på två olika sätt:- Med ovan nämnda bas-URL samt att eventuella övriga url-parameter skickas med anropet.
- Genom att konfigurera länken direkt i meddelandetexten inom DocBook-elementet ulink.
Om DocBook-formatet
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
.
Anslutande system kan också konfigureras för att stödja uthopp/länkning med sömlös övergång (SSO) för att låta invånaren kunna agera vidare utifrån meddelandet i inkorgen
För att komma igång är initialt två konfigurationsparametrar aktuella, varav den ena är obligatorisk.
Parameter | Beskrivning | Obligatorisk |
---|---|---|
systemId | Erhålls av förvaltningen för 1177 Vårdguidens e-tjänster | Ja |
bas-URL | Delges förvaltningen för 1177 Vårdguidens e-tjänster tekniska förvaltning om anslutande part avser använda konfigurerbara länkar i meddelandet | Nej |
Systemid används för att identifiera konsumentssystemet hos producenten. 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.
Ett vanligt användningsområde för denna tjänsteinteraktion är att låta användaren hitta tillbaka till konsumentsystemet via inkorgsmeddelandet i 1177 Vårdguidens e-tjänster med hjälp av en uthoppslänk. Uthoppslänken kan konfigureras på två olika sätt:
- Med ovan nämnda bas-URL samt att eventuella övriga url-parameter skickas med anropet.
- Genom att konfigurera länken direkt i meddelandetexten inom DocBook-elementet ulink.
Om DocBook-formatet
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.
Sektion | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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ö.
Fördjupad teknisk dokumentation
Inledning
Inkorgstjänsten för 1177 Vårdguidens e-tjänster möjliggör att anslutande system via Nationella tjänsteplattformen kan skicka ett meddelande till individer som är registrerade användare 1177 Vårdguidens e-tjänster.
Inkorgstjänsten består av två interaktioner som används för att kontrollera att en invånare är användare (är registrerad) samt att i förekommande fall skicka själva meddelandet.
- IsActiveUser
- AddMessageToPatientPortalInbox
Beskrivning
Det skickade meddelandet kan formateras inom vissa givna ramar och kan länka sömlöst till externa system om dessa är anslutna. Avsändaren kan avgöra om denne vill att meddelandet ska aviseras invånaren om möjligt. Om avisering sker och med vilken metod (SMS, e-post) kan ske eller ej beror av invånarens inställningar.
Tjänsten IsActiveUser returnerar aktiva användares inställningar för avisering så att anslutande system kan avgöra om avisering kan ske.
Anslutande system kan också konfigureras för att stödja uthopp/länkning med med sömlös övergång (SSO) för att låta invånaren kunna agera vidare utifrån meddelandet i inkorgen
Se också bifogad anslutningsguide:
View file | ||||
---|---|---|---|---|
|
Övergipande information om tjänstekontrakten:
Tjänstedomän:
infrastructure:eservicesupply:patientportal
http://www.rivta.se/domains/infrastructure_eservicesupply_patientportal.html
|
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 | ||||
---|---|---|---|---|
|
Supportväg
Supporten för 1177 Vårdguidens e-tjänster (1:a linjens support) har i uppdrag att ta emot och registrera ärenden samt svara på generella frågor om en tjänst, göra en initial felbedömning och samla in information för vidare felsökning. Det ska finnas information i det anslutande systemet om var användaren vänder sig med sina frågor om tjänsten.
Anslutande system förväntas upprätta en 2:a linje support som kan ta emot ärenden av följande karaktär:
- 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).
Här ser vi helst att det upprättas en kontaktväg in för alla ärenden, en så kallad Single Point of Contact (SPOC). Det kommer att vara den kontaktväg som e-tjänsternas 1:a linje support skickar ärenden till.
Skicka kontaktuppgifter till 2:a linjens support och en presentation om tjänsten (se mall för exempel på hur en sådan mall kan se ut) 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.
Supportinformation | (Anslutande system anger) |
---|---|
Vilka tjänster används? | (Inkorgsfunktion och/eller uthoppsfunktion) |
Telefon (SPOC) | |
E-post (SPOC) (gärna funktionsbrevlåda) | |
Tillgänglighet (ange vilka dagar och tider er del av supportkedjan är tillgänglig): | |
Information som 1:a linjens support ska samla in vid en felanmälan för att felsökning ska kunna utföras: Nedanstående punkter är standardinformation som 1:a linjens support samlar in vid felanmälningar. Ni ska ange om ytterligare information ska samlas in för felsökning hos er. 1. Personnummer 2. Beskrivning: Vilket felmeddelande uppstår? 3. Vilken webbläsare och version används? 4. Vilket operativsystem och version används? 5. Skärmdump som visar felet 6. Datum och tidpunkt för felet: 7. Eventuellt den mottagning det gäller |
Beskrivning av supportkedjan
- 1:a linjens support för 1177 Vårdguidens e-tjänster tar emot och registrerar ärenden.
Vid ärenden som 1:a linjen ej kan/ska besvara sänder de vidare till 2:a linjens support (hos anslutande system) med av er i förväg efterfrågade uppgifter från anmälaren. 1:a linjens support stänger ärendet i sitt ärendehanteringssystem.
2:a linjens support ansvarar för att svara anmälaren. Vidare kontakt sker mellan 2:a linjen och anmälaren. 2:a linjens support informerar om att de har tagit över ärendet. Vid misstanke att det kan dröja med åtgärd/återkoppling i ärendet ansvarar 2:a linjens support om att informera anmälaren om det.
De gånger en anmälare hör av sig om statusuppdatering/följdfråga till 1:a linjens support skickar 1:a linjen en statusförfrågan till 2:a linjens support.
2:a linjens support återkopplar till anmälaren med kopia till 1:a linjens support som uppdaterar sitt ärende – viktigt att 2:a linjens support sänder med ärendenummer i svaret/ärenderaden så att 1:a linjens ärende uppdateras.
...