Hidden
Piilotetut kentät tallentavat arvoja, joita ei koskaan näytetä vastaajalle — niitä käytetään asiayhteyden välittämiseen, tietojen esitäyttöön tai väliaikaisten tulosten tallentamiseen.
hidden-kenttä tallentaa arvon, jota ei koskaan näytetä vastaajalle. Toisin kuin calculate (joka laskee arvon), hidden-kenttää käytetään kuljettamaan ulkopuolelta annettua arvoa — esimerkiksi tehtävätunnusta, toisesta järjestelmästä välitettyä kotitalouksien tunnusta tai luetteloijakoodia, joka injektoidaan lomaketta käynnistettäessä.
XLSForm-perusmäärittely
| type | name | label |
|---|---|---|
| hidden | household_id |
Otsikoita ei tarvita piilotuille kentille, koska mitään ei renderöidä näytölle.
Käyttötarkoitukset
Piilotettuja kenttiä käytetään yleisesti:
- Kyselynhallintajärjestelmästä ennalta määritetyn tunnuksen välittämiseen (esim. kotitaloustunnus, casenumero, tehtäväkoodi)
- Lomakkeen version tai käyttöönottometatietojen tallentamiseen
- Luetteloijakohtaisen konfiguraation injektoimiseen lomakkeen käynnistyksen yhteydessä
- Tietojen kuljettamiseen ylätason lomakkeesta alatason lomakkeeseen linkitetyissä työnkuluissa
- URL-parametreista johdetun arvon tallentamiseen, kun lomake avataan verkkolinkin kautta
Oletusarvon asettaminen
Yleisin malli on käyttää hidden-kenttää default-lausekkeen kanssa, jolloin arvo asetetaan lomakkeen avautumisen yhteydessä:
| type | name | default |
|---|---|---|
| hidden | deployment_code | ‘ZONE_A_2024’ |
| hidden | form_version | ‘3.1’ |
Piilotetun kentän viittaaminen laskuissa
Piilotettuja arvoja voidaan viitata kuten mitä tahansa muuta kenttää ${fieldname}-syntaksilla:
| type | name | label | calculation |
|---|---|---|---|
| hidden | zone_code | ||
| calculate | label_prefix | concat(’[’, ${zone_code}, ‘] ‘) | |
| note | intro | ${label_prefix} Tervetuloa kotitalouskyselyyn |
Piilotetun kentän käyttö esitäyttö- / URL-parametreilla
Kun verkkolomake avataan URL:n kautta, voit välittää parametreja, jotka täyttävät piilotetut kentät. Tämä mahdollistaa kotitaloustunnuksen tai tehtäväkoodin esilataamisen ilman, että luetteloija kirjoittaa sen:
https://your-server.com/form/FORMID?household_id=H00123&zone_code=NORTH
household_id-niminen kenttä täytetään automaattisesti arvolla H00123.
Parhaat käytännöt
- Käytä
hidden-kenttää (eicalculate), kun arvo injektoidaan ulkoapäin eikä sen tulisi uudelleenlaskea. - Käytä
calculate-kenttää, kun arvo johdetaan lomakkeen muista kentistä. - Aseta aina
default-arvo, jos piilotetun kentän on oltava arvo — piilokenttä ilman oletusta on tyhjä. - Nimeä piilotetut kentät selkeästi niiden erottamiseksi (esim. etuliite
_hidden_tai johdonmukainen nimeämiskäytäntö).
Rajoitukset
- Piilotetut kentät sisältyvät vietyihin tietoihin kuten mikä tahansa muu kenttä.
- Niitä ei voi näyttää ehdollisesti — ne ovat aina läsnä (mutta näkymättömiä).
- Jos tarvitset dynaamikesti laskevan kentän, käytä
calculate-kenttää.