Koppla ihop formulärmallen med tidbokning

Det krävs några steg för att koppla ihop en formulärmall med tidbokning

1. 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)

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

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

Steg 1 - 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 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

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 2 - Länka från beräkning i formulärmallen till tidbokningstjänst

Varje utgång (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 externalAppplication).

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

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

I exemplet nedan vill verksamheten, baserat på utgången leda invånaren till att boka tid för tidstypen med tidstypsId = 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

BasURL:

Steg 3 - lägg in URL-parameter vid utdelning av tjänst

[beskrivning av detta steg]

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

?externalApplication=TRIAGE_VARMLAND

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: