Referimi i vlerave
Sintaksa ${fieldname} përdoret për të referuar vlerën aktuale të një fushe tjetër në formularin tuaj. Mund të përfaqësojë vlerën që u fut, zgjodh ose llogarit, dhe do të shfaqet saktësisht ashtu siç shfaqet në të dhënat e dërguara.
Shembull:
Nëse keni një fushë të quajtur “age” dhe dëshironi të merrni vlerën e saktë të futur në atë fushë, mund të përdorni ${age}.
Kur bëhet fjalë për kufizimet, simboli “.” përdoret për të referuar hyrjen ose zgjedhjen e propozuar të përdoruesit për fushën aktuale. Ai ju lejon të aplikoni kushte ose kufij bazuar në vlerën që përdoruesi po fut ose zgjedh në atë moment.
Shembull:
Nëse dëshironi të kontrolloni nëse vlera e propozuar për fushën aktuale është më e vogël se 3, mund të përdorni kufizimin . < 3.
.. — Referimi i grupit prind
Brenda një grupi ose grupi përsëritjeje, .. referon kontekstin prind. Kjo rrallë nevojitet në praktikë, por përdoret në shprehje të avancuara XPath për të naviguar hierarkinë e formularit.
Ku përdoren referencat
| Kolona | Tipi i referencës | Shembulli |
|---|---|---|
relevant | ${fieldname} | ${consent} = 'yes' |
constraint | . për fushën aktuale, ${fieldname} për të tjerat | . > 0 and . <= ${max_value} |
calculation | ${fieldname} | ${adults} + ${children} |
required | ${fieldname} | ${has_income} = 'yes' |
default | ${fieldname} | ${previous_answer} |
label | ${fieldname} në tekst | "Mosha juaj është ${age} vjeç" |
choice_filter | Emri i kolonës (pa ${}) | district = ${district} |
Në kolonën choice_filter, referoni emrat e kolonave të zgjedhjes direkt (pa ${}), dhe referoni fushat e formularit me ${}. Ngatërrimi i tyre është një burim i zakonshëm gabimesh.
Referimi i vlerave brenda grupeve të përsëritjeve
Brenda një përsëritjeje, ${fieldname} referon fushën në të njëjtën instancë të përsëritjes:
relevant: ${member_age} < 18
Kjo përdor vlerën member_age për instancën aktuale të përsëritjes, jo të gjitha instancat.
Për të referuar një fushë në një instancë specifike të përsëritjes nga jashtë përsëritjes, përdorni indexed-repeat():
indexed-repeat(${member_name}, ${household_members}, 1)
Shikoni Funksionet — Funksionet e fushave të përsëritura për detaje të plota.
Kontrollet e vlerave bosh
Testoni nëse një fushë ka marrë përgjigje:
${fieldname} != '' (fusha nuk është bosh)
${fieldname} = '' (fusha është bosh)
Për numrat, gjithashtu kontrolloni:
${age} > 0 (mosha ka vlerë pozitive — implicitisht jo bosh për kontekstin numerik)
Konvertimi i tipit në referenca
Kur përdorni ${fieldname} në kontekst numerik (p.sh., ${age} + 1), rtSurvey automatikisht konverton vlerën e vargut në numër. Një fushë bosh konvertohet në 0 ose NaN varësisht nga operacioni — përdorni coalesce(${field}, 0) për të caktuar me siguri parazgjedhjen e fushës numerike bosh në zero.