Länkparametrar för externa formulär¶
Länkparametrar används för att påverka hur ett formulär för extern registrering visas och fungerar när det öppnas.
Med hjälp av länkparametrar går det exempelvis att:
- Styra vilket språk som används.
- Begränsa enhetsväljare till delar av organisationen.
- Ange förvalda värden i formuläret.
- Sätta värden på fält som inte visas i formuläret.
Formulärslänkarna för respektive vy finns under Formulärslänkar på ärendetypens administratörssida.
Hur fungerar länkparametrar?¶
Länkparametrar placeras sist i URL:en och separeras med ett &.
Exempel som sätter språket i formuläret till engelska:
https://host.domain.se/AddMatter2.aspx?MatterTypeID=1&CurrentLocale=en-GB
Flera parametrar kan kombineras
Det går att använda flera länkparametrar samtidigt för att styra både språk, organisationsenheter och fältvärden.
Språkval¶
Om formuläret använder språkstöd kan språket styras via länkparametern:
CurrentLocale=språkkod
Exempel:
https://host.domain.se/AddMatter2.aspx?MatterTypeID=1&CurrentLocale=en-GB
Språkkoder¶
| Språk | Kod |
|---|---|
| Svenska | sv-SE |
| Engelska | en-GB |
| Finska | fi-FI |
| Tyska | de-DE |
| Arabiska | Ar |
Bestämma rot för enhetsväljaren¶
Det går att begränsa organisationsväljaren till en viss del av organisationsträdet.
Begränsa primär enhetsväljare¶
RootID=enhets-id
Exempel:
https://host.domain.se/AddMatter2.aspx?MatterTypeID=1&View=MinVy&RootID=10
I exemplet används enhet 10 som rot för organisationsväljaren.
Begränsa ett specifikt organisationsfält¶
Field_fältid_RootID=enhets-id
Exempel:
https://host.domain.se/AddMatter2.aspx?MatterTypeID=1&View=MinVy&Field_5_RootID=10
I exemplet används enhet 10 som rot för organisationsfält med ID 5.
Hitta ID-nummer¶
Enhetens ID visas i organisationsstrukturen.
Sätta fördefinierade värden¶
Länkparametrar kan användas för att ange värden som ska vara förvalda när formuläret öppnas.
I vissa fall kan värden även anges för fält som inte visas i den aktuella vyn. Värdet sparas då när ärendet registreras.
Du hittar fältets id-nummer genom att gå till ärendetypens administratörssida. Där ser du fältets id-nummer i uppställningen.
Flervalsfält¶
Flervalsfält använder följande syntax:
f_fältid=[S[id,id]|A=x]
Där:
- S anger vilka alternativ som ska väljas.
- A=1 lägger till värdena till fältets standardvärde.
- A=0 ersätter fältets standardvärde.
Exempel:
f_14=[S[1,3]|A=0]
I exemplet väljs alternativ 1 och 3 på fält 14.
Måste fältet finnas i vyn?
Nej.
För flervalsfält kan värden sättas både på fält som visas i formuläret och fält som inte ingår i den aktuella vyn.
Ärendeväljare¶
För ett fält av typen Ärendeval används:
f_fältid=ärende-id
Exempel:
f_14=23
Väljer ärende 23 som förvalt värde på fält 14.
Observera
Fältet måste ingå i den aktuella vyn för att standardvärdet ska kunna sättas.
Organisationsfält¶
För ett organisationsfält används:
f_fältid=enhets-id
Exempel:
f_14=23
Väljer enhet 23 som standardvärde på fält 14.
Dolda fält
Om organisationsfältet inte visas i formuläret kommer värdet ändå att sparas på ärendet när registreringen genomförs.
Textrad¶
För ett fält av typen Textrad används:
f_fältid=värde
Exempel:
f_14=Liten+bil
Sätter värdet Liten bil på fält 14.
URL-koda alltid textvärden
Om värdet innehåller mellanslag eller specialtecken bör det URL-kodas innan länken publiceras.
Användarfält¶
För ett användarfält används:
f_fältid=användarnamn
Exempel:
f_14=admin
Väljer användaren admin som standardvärde på fält 14.
Observera
Den angivna användaren måste finnas bland de användare som är valbara i fältet.
Fältet måste också ingå i den aktuella vyn för att standardvärdet ska kunna sättas.
Vanliga användningsområden¶
Länkparametrar används ofta för att:
- Visa formulär på rätt språk.
- Styra vilka organisatoriska enheter som ska kunna väljas.
- Förifylla uppgifter
- Sätta värden på dolda fält för att styra vidare handläggning.
Testa alltid länken innan publicering
Eftersom länkparametrar kan påverka både synliga och dolda fält bör länken alltid testas innan den publiceras till användare.