Steg 1 - Ta fram beslutsträdet

För att förenkla det vidare konfigurationsarbetet rekommenderas att verksamheten tar fram och dokumenterar vägarna genom triageringsflödet, uttryckt som ett belutsträd. Konfigurationen kommer därefter att behöva göras i en rad olika administrationsgränssnitt, det är därför till stor hjälp att kunna ha flödesschemat som referens i de olika stegen. Läs mer om Beslutsträd som hjälp i arbetet med flödet.

Steg 2 - Ta fram formulärmallen med dess frågor och följdfrågor

Det krävs några steg för att koppla ihop en formulärmall som ska användas för triagering inför tidbokning:

1. Ta fram en formulärmall där de frågor och följdfrågor som successivt ska leda invånare att boka rätt typ av besök (tidstyp)

2. Ta fram beräkning utifrån de olika frågorna och svaren i formuläret för att peka på ett visst utfall (id på en utgång)

3. Länka från beräkning i formulärmallen till tidbokningstjänst

4. Lägg in URL-parameter vid utdelning av tjänst

Steg 3 - Ta fram beräkning som räknar ut utfallen av frågor/svar

I formulärmallen finns möjlighet att lägga in beräkningar för att ange vilka resultat i formulärets frågor/svar som ska leda till vilket utfall.

Beräkningen skrivs med kod i formulärtjänstens designverktyg, så personer med kunskap om enklare typer av kodning kan göra detta.

Beräkningsskript

Beräkningsskriptet i formulärmallen beräknar fram ett resultat uttryckt som ett tal (0, 1, 2, 3, 4 eller 5).
För respektive resultat kopplas sedan en URL, en beskrivande text samt en knapptext för knapp som leder invånaren vidare.

Formulärtjänsten kopplar svarsalternativen med en indexsiffra, med början på “1”. Första svaret motsvarar “1”, andra svaret motsvarar “2” o s v.
Exempel bild 1 ovan: För att i skriptkod läsa ut vilket svar som invånaren valt för frågan som har id=”Q1”, kan följande kodrad användas:

int svarsQ1 = $q.get("Q1").intValue();

Om invånaren väljer alternativet “Övrigt” så kommer svarsQ1 att få värdet 3, se flödesbild.

Skriptet ska till slut resultera i ett värde (0, 1, 2, 3, 4 eller 5) som motsvarar utgången. Värdet sätts med följande kodrad (där variabeln i tidigare skede tilldelats resultatet):

outcome.set( result );

Här följer ett skript som motsvarar flödesschemat i bild 1

when
    $q: Questions()

then
    double result = 0;
    
    // hämta invånares svar på fråga Q1
    int svarsQ1 = $q.get("Q1").intValue();

    if ( svarsQ1 == 1 ) 
    { 
        // invånare svarade med första svarsalternativet på fråga Q1
        
        // hämta invånares svar på fråga Q3
        int svarsQ3 = $q.get("Q3").intValue();
        if( svarsQ3 == 1 )
        {
            // invånare svarade med första svarsalternativet på fråga Q1
            // invånare ska ledas till utgång 0
            result = 0;
        }
        else
        {
            result = 1;
        }        
    }
    else if ( svarsQ1 == 2 ) 
    {
        int svarsQ2 = $q.get("Q2").intValue();
        int svarsQ4 = $q.get("Q4").intValue();
        int svarsQ7 = $q.get("Q7").intValue();

        if ( svarsQ2 == 1 || svarsQ2 == 2 )
        {
            if ( svarsQ7 == 2  )
            {
                result = 1;
            }
            else if( svarsQ4 == 2  )
            {
                result = 3;
            }
            else
            {
                result = 2;
            }
        }
        else if ( svarsQ2 == 3 || svarsQ2 == 4 )
        {
            if ( svarsQ7 == 2  )
            {
                result = 1;
            }
            else if( svarsQ4 == 2  )
            {
                result = 0;
            }
            else
            {
                result = 4;
            }
        }
    }
    else if ( svarsQ1 == 3 ) 
    {
        int svarsQ6 = $q.get("Q6").intValue();
        if( svarsQ6 == 1 )
        {
            result = 2;
        }
        else if( svarsQ6 == 2 )
        {
            result = 1;
        }
        else
        {
            result = 2;
        }
    }
    else if ( svarsQ1 == 4 ) 
    {
        int svarsQ5 = $q.get("Q5").intValue();
        int svarsQ9 = $q.get("Q9").intValue();
        if( svarsQ9 == 2 )
        {
            result = 1;
        }
        else if( svarsQ5 == 2)
        {
            result = 3;
        }
        else
        {
            result = 4;
        }
    }

    outcome.set( result );   
end

Länk till Formulärtjänstens dokumentation: Steg för steg, konfiguration

För att underlätta, rekommenderas att ett beslutsträd tas fram för att enklare skapa scriptet. Se exempel: Beslutsträd som hjälp i arbetet med flödet

...

Kontrollera beräkningen

Beräkningen kan kontrolleras genom en förhandsgranskningsvy. Genom att välja vad invånaren kan svara, blir resultatet olika baserat på vad som är inlagt i scriptet. Se mer i Formulärtjänstens dokumentation [länk].

Steg 4 - Länka från beräkning i formulärmallen till tidbokningstjänst

Utgångarna (0, 1, 2, 3, 4, 5) som beräknats fram via beräkningsskriptet kan sedan kopplas till en samling av konfigurationer som dirigerar invånare vidare till andra tjänster/uthopp. De olika 6 konfigurationerna ges ett namn och konfigureras i ett administrationsverktyg som tillhandahålls av förvaltningen för Formulärtjänsten (kallad externalApplication-konfiguration).

Varje sådan samling av utgångskonfigurationer består först av en generell del där det unika namnet anges, tillsammans med en standard-vidarelänkning, i fallet att invånaren väljer att avbryta sin inmatning

...

Därutöver, för varje beräknad utgång (0, 1, 2, 3, 4, 5) kan sedan en vidarelänkning konfigureras. I exemplet nedan konfigureras vad som ska hända om beräkningen resulterade i värdet 0, d v s utgång 0.

...

Konfigurationen ovan för utgång 0 ledet exempelvis till denna slutsida i formulärtriageringen (bilden nedan).
När invånaren klickar på knappen “Boka tid” leds invånaren till den länk som konfigurerats i outcomeBelowOneUrl

...

Exempel på länkning

Innan ni startar

För att sätta upp en tidbokningstjänst med formulär för att guida invånaren behöver ni ha kunskap om hur tidbokningstjänster konfigureras och delas ut i 1177 personalverktyg samt hur formulär sätt upp i 1177 formulärhantering. Vi föreslår att ni sätter ihop ett team med dessa kompetenser till att börja med. Behöver ni ändå hjälp längs vägen är ni välkomna att kontakta e-tjänsternas förvaltning på https://www.inera.se/kontakta-oss/felanmalan-och-anvandarstod/

Förutsättningar

För att lägga till guidning till en tidbokningstjänst behöver ni först:

• Säkerställa att tidbokningstjänsten finns i 1177 personalverktyg och att den är utdelad och aktiverad. Läs mer om att skapa, dela ut och aktivera tidbokningstjänster här.

• Säkerställa att den mottagning tjänsten är utdelad till är ansluten till 1177 tidbokning. Läs mer om att ansluta mottagningar till 1177 tidbokning här.

• Ta reda för id för samtliga tidstyper som är aktuella för mottagningen (både för QA och produktion). Den här informationen kommer du behöva i senare steg.

Steg 1 - Ta fram beslutsträdet

För att förenkla det vidare konfigurationsarbetet rekommenderas att verksamheten tar fram och dokumenterar vägarna genom flödet, uttryckt som ett beslutsträd. Beslutsträdet kommer du behöva i senare steg. Det finns möjlighet att ange upp till 31 olika länkar/utgångar. Läs mer om Beslutsträd som hjälp i arbetet med flödet.

Steg 2 - Ta fram länk till de tidstyper som utgångarna ska leda till

I exemplet nedan vill verksamheten, baserat på utgången, leda invånaren till att boka tid för tidstypen med tidstypsId tidstypskod = 12345 hos mottagningen med HSAId = SE2321000156-1234. Samtidigt vill verksamheten gömma villkorstexten i tidbokningsflödet:

https://tidbok.1177.se/make?configid=c3fb8b23-466b-45b2-bc35-b7b42565ebf7&hsaid=SE2321000156-1234&timetypeCode=12345&terms=false

Förklaring av länkens olika delar

1. Bas-URL:

https://tidbok.1177.se/make?configid=c3fb8b23-466b-45b2-bc35-b7b42565ebf7

Denna del av URL:en pekar till e-tjänsten “Boka tid direkt”. När regional administratör skapar en ny “Boka tid direkt” tjänst skapas också ett unikt id - configid. För att ta reda på vilket configid som skapats kan man gå till mottagning där “Boka tid direkt” delats ut och högerklicka på länken, därefter kopiera/spara länk-adressen.

...

2.

2. HSAId för mottagningen

Andra delen av URL:en pekar ut för vilken mottagning som tidbokningen gäller, baserat på mottagningens HSAId:

&hsaid=SE2321000156-1234

...

3. Tidstypskod

Tredje delen pekar ut vilken tidstyp som tidbokningen ska gälla för. När denna parameter läggs på URL:en så kommer invånaren inte själv att kunna välja tidstyp. Detta id är genererat av- och finns i verksamhetssystemet.

&timetypeCode=12345

...

4. Villkorstext

Fjärde delen av URL:en styr huruvida villkorstexten ska visas eller gömmas i tidbokstjänsten. Värdet false betyder att villkorstexten göms

&terms=false

Steg

...

3 - Dessa uppgifter lämnar ni regional samordnare för 1177 formulärhantering

Frågorna till den guidade tidbokningen skapas i ett frågeformulär i 1177 formulärhantering. Det är även där som uppgifter om önskade informationstexter, knapptexter samt utgångslänkarna från steg 2 ovan konfigureras. Som ett stöd för både “beställaren” av det guidade formulärflödet för administratören för Formulärflöden i 1177 formulärhantering kan dessa uppgifter sammanställas i ett excelark som finns hos 1177 formulärhantering.

Steg 4 - Görs av regional samordnare i 1177 formulärhantering

Aktiviteterna i detta steg görs av personer med kunskap om 1177 formulärhantering. Se manualen i 1177 formulärhantering för detaljer: Formulärflöde / Guidningsformulär

1. Ta fram formulärmallen med dess frågor, följdfrågor samt beräkningsformel

2. Bestäm om guidningsflödet ska innehålla en “försättssida” samt en “bekräftelse”-sida (se detaljer i manualen för 1177 formulärhantering)

3. I 1177 formulärhanterings applikation Formulärflöde konfigureras de olika utgångarna till 1177 tidbokning. Utgångarna baseras på resultatet från beräkningsformeln ovan

   1. Utgångarna består av en informationstext, knapptext samt url till önskad utgång. Url tas fram i steg 2 ovan.

   2. Det är i Formulärflöde som “ingångslänken” till det guidande flödet genereras

Steg 5 - Skapa och dela ut uthoppstjänst i 1177 personalverktyg

För att tillgängliggöra formuläret för invånare behöver formuläret publiceras som en uthoppstjänst på mottagningens kontaktkortsida i 1177.

Först behöver formuläret omvandlas till en nåbar e-tjänst/uthoppstjänst. Detta görs i formulärtjänstens designverktyg, där mallen skapades.

Image Removed

Därefter delas uthoppstjänsten ut.

Hur det görs finns mera information på denna sida i Personalverktygets manual.

I steg 7 i länken ovan väljs tjänstetypen ”FORM” i ID kolumnen

...

Vidare i steg 16 så anges URL-parametern.

Den totala länken ska till slut bli:

https://formular.1177.se/etjanst/<unikt id>?externalApplication=KALMAR_SE2321000073-F3P4

där <unikt id> är det unika Id som genererades när du skapade en ”erbjuden e-tjänst” i formulär-admin.

...

1. Skapa en ny uthoppstjänst med tjänstetypen Boka tid med guidning via formulär (kod = FORMSCHEDULING).

2. Dela ut uthoppstjänsten till den mottagning där länken ska finnas för invånaren i 1177.

3. Lägg till URL-parameter (läs mer nedan) till uthoppstjänsten.

Du kan läsa mer om hur du skapar, delar ut och konfigurerar URL-parameter för uthoppstjänster här.

...

...

Läs mer hos Formulärtjänstens dokumentation:

Uthoppslänk på mottagningens startsida i inloggat läge

Exempel på URL-parameter

förklara delarna i url:en

...

Tips och trix

...

Problem / behov

...

Lösning

...

Vid konfigurering av beräkningen i formulärmallen, går det inte att peka på samma utgång från flera frågor/svarsalternativ

Frågan och svarsalternativen behöver kopieras och kan inte gå ihop till samma.

Dvs inte:

...

Utan:

...

Steg 6 - Dölj befintlig tidbokningstjänst

När ni delat ut uthoppstjänsten på mottagningens sida i 1177 kan ni behöva dölja den tidbokningstjänst ni hade sedan tidigare för att undvika att invånaren ser två olika länkar till tidbokning. Här finns information om hur man gör för att dölja en ärendetyp.

Tips vid införande

• Tänk på att använda ett enkelt språk i formuleringar och ordval i formuläret​

• Iterera frågorna, gärna med olika kompetenser, även någon som inte kan verksamheten ​

• Rita gärna upp frågor/val och utgångar (t.ex. på whiteboard eller i Miro)​

• Se till att det finns tider att boka​

  • Extra viktigt när invånare tagit sig tid att svara på frågor​

• Sträva mot att endast erbjuda EN ingång till tidsbokning på mottagningens sida i 1177. Om några tidstyper kräver guidning, lägg in allt i formuläret. Flera ingångar till att boka tid gör det svårt för invånaren att veta vilken som ska väljas.

• Om möjligt, testa formuläret med invånare​