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.

Meddelanden som skickas genom AddMessageToPatientPortalInbox kan formateras inom vissa givna ramar enligt Om DocBook-formatet.

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. 

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:

1. Med ovan nämnda bas-URL samt att eventuella övriga url-parameter skickas med anropet.
2. 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.

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.

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.

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.

<?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>

<?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ö.

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.

Beskrivning av supportkedjan

1. 1:a linjens support för 1177 Vårdguidens e-tjänster tar emot och registrerar ärenden.

2. 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.

3. 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.

4. 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.

5. 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.