Skjult
Skjulte felter gemmer værdier, der aldrig vises for respondenten — bruges til at overføre kontekst, forudfylde data eller gemme mellemresultater.
Et hidden-felt gemmer en værdi, der aldrig vises for respondenten. I modsætning til calculate (som beregner en værdi) bruges hidden til at bære en eksternt leveret værdi — for eksempel et opgave-ID, et husholdnings-ID sendt fra et andet system, eller en interviewerkode indsat ved formularens åbning.
Grundlæggende XLSForm-specifikation
| type | name | label |
|---|---|---|
| hidden | household_id |
Labels er ikke påkrævet for skjulte felter, da intet gengives på skærmen.
Anvendelser
Skjulte felter bruges typisk til:
- At sende et forudtildelt ID fra undersøgelsesstyringssystemet (f.eks. husholdnings-ID, sagsnummer, opgavekode)
- At gemme formularversionen eller udrulningsmetadata
- At injicere interviewerspecifik konfiguration ved formularåbning
- At bære data fra en overordnet formular til en underordnet formular i kædede arbejdsprocesser
- At gemme en værdi afledt af URL-parametre, når formularen åbnes via et weblink
Angivelse af en standardværdi
Det mest almindelige mønster er at bruge hidden med et default-udtryk, så værdien indstilles, når formularen åbnes:
| type | name | default |
|---|---|---|
| hidden | deployment_code | ‘ZONE_A_2024’ |
| hidden | form_version | ‘3.1’ |
Referencering af et skjult felt i beregninger
Skjulte værdier kan refereres ligesom ethvert andet felt ved hjælp af ${feltnavn}:
| type | name | label | calculation |
|---|---|---|---|
| hidden | zone_code | ||
| calculate | label_prefix | concat(’[’, ${zone_code}, ‘] ‘) | |
| note | intro | ${label_prefix} Velkommen til husholdningsundersøgelsen |
Brug af hidden med forudfyldning / URL-parametre
Ved lancering af en webformular via URL kan du sende parametre, der udfylder skjulte felter. Dette giver dig mulighed for at forudindlæse et husholdnings-ID eller en opgavekode uden at intervieweren skal skrive det:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
Feltet med navnet household_id udfyldes automatisk med H00123.
Bedste praksis
- Brug
hidden(ikkecalculate), når værdien injiceres eksternt og ikke bør genberegnes. - Brug
calculate, når værdien afledes af andre felter i formularen. - Angiv altid en
default, hvis det skjulte felt skal have en værdi — et skjult felt uden standard vil være tomt. - Navngiv skjulte felter tydeligt for at skelne dem (f.eks. præfiks med
_hidden_eller brug en ensartet navnekonvention).
Begrænsninger
- Skjulte felter inkluderes i de eksporterede data ligesom ethvert andet felt.
- De kan ikke vises betinget — de er altid til stede (men usynlige).
- Brug
calculatei stedet, hvis du har brug for et felt, der beregner dynamisk.