Kľúčové koncepty
Prehľad dizajnu formulárov
Čo je XLSForm?
rtSurvey používa rozšírenú verziu štandardu XLSForm pre dizajn formulárov, ponúkajúc výkonné funkcie na vytváranie sofistikovaných prieskumov. Táto príručka vás zoznámi s kľúčovými konceptmi dizajnu formulárov v rtSurvey, od základnej štruktúry XLSForm po pokročilé funkcie špecifické pre rtSurvey.
S XLSForms môžete tvoriť formuláre v ľudsky čitateľnom formáte pomocou obľúbeného nástroja Excel, čo ho robí prístupným takmer pre každého. Tento štandard umožňuje jednoduché zdieľanie a spoluprácu pri tvorbe formulárov.
Hoci sú XLSForms vhodné pre začiatočníkov, umožňujú skúseným používateľom vytvárať komplexné formuláre.
rtSurvey poskytuje konzistentný spôsob začlenenia pokročilých funkcií, ako je podmieňujúca logika, do formulárov naprieč rôznymi webovými a mobilnými platformami zberu dát.
Štruktúra XLSForm
XLSForm zvyčajne pozostáva z dvoch hlavných pracovných hárkov:
- survey: Definuje štruktúru a obsah vášho formulára.
- choices: Špecifikuje možnosti odpovedí pre otázky s viacerými možnosťami.
Voliteľný hárok settings môže poskytovať dodatočné špecifikácie formulára.
Je dôležité poznamenať, že povinné stĺpce v hárkoch survey a choices musia byť prítomné, aby formulár správne fungoval. Voliteľné stĺpce v oboch hárkoch poskytujú ďalšiu kontrolu nad správaním každého záznamu vo formulári, ale nie sú nevyhnutné.
Stĺpce vo vašom excelovom zošite sa môžu objaviť v akomkoľvek poradí a voliteľné stĺpce môžu byť prázdne. Je však kľúčové používať presnú syntax a konvencie pomenovania špecifikované v dokumentácii XLSForm, aby formulár fungoval správne.
Hárok survey
Hárok survey je miestom, kde definujete štruktúru vášho formulára a poskytujete obsah. Každý riadok v hárku survey predstavuje otázku alebo prvok vo vašom formulári. Nasledujúce stĺpce sú povinné v hárku survey:
type: Špecifikuje typ záznamu, ktorý očakávate pre otázku.name: Špecifikuje jedinečný názov premennej pre daný záznam. Názvy musia začínať písmenom alebo podčiarkovníkom a môžu obsahovať iba písmená, číslice, pomlčky, podčiarkovníky a bodky. Názvy rozlišujú veľké a malé písmená.label: Obsahuje skutočný text, ktorý vidíte pre otázku vo formulári.
| type | name | label |
|---|---|---|
| today | today | |
| select_one gender | gender | Pohlavie respondenta? |
| integer | age | Vek respondenta? |
Hárok choices
Hárok choices sa používa na špecifikáciu možností odpovedí pre otázky s viacerými možnosťami.
Každý riadok predstavuje možnosť odpovede. Nasledujúce stĺpce sú povinné v hárku choices:
list_name: Zoskupuje sadu súvisiacich možností odpovedí.name: Špecifikuje jedinečný názov premennej pre danú možnosť odpovede.label: Zobrazuje možnosť odpovede presne tak, ako chcete, aby sa objavila vo formulári.
| list_name | name | label |
|---|---|---|
| gender | transgender | Transgender |
| gender | female | Žena |
| gender | male | Muž |
| gender | other | Iné |
Stĺpce, ktoré pridáte do excelovho zošita, či už povinné alebo voliteľné, sa môžu objaviť v akomkoľvek poradí. Voliteľné stĺpce môžu byť úplne vynechané. Riadky alebo stĺpce môžu byť prázdne na zlepšenie čitateľnosti, ale dáta po 20 susediacich prázdnych stĺpcoch alebo riadkoch na hárku sa nespracujú. Všetko formátovanie súborov .xlsx sa ignoruje, takže môžete používať oddeľovacie čiary, tieňovanie a iné formátovanie písma na zlepšenie čitateľnosti formulára.
Jedna vec, ktorú treba mať na pamäti pri tvorbe formulárov v Exceli, je, že použitá syntax musí byť presná. Napríklad, ak napíšete Choices alebo choice namiesto choices, formulár nebude fungovať.
Hárok settings
Hárok settings je voliteľný, ale umožňuje špecifikovať metadáta a správanie na úrovni formulára. Bežné stĺpce v hárku settings zahŕňajú:
| Stĺpec | Popis |
|---|---|
| form_title | Nadpis formulára tak, ako sa zobrazuje používateľom |
| form_id | Jedinečný identifikátor formulára používaný pri správe dát a API volaniach |
| default_language | Predvolený kód jazyka pre viacjazyčné formuláre (napr. ‘sk’ pre slovenčinu) |
| version | Číslo verzie formulára, užitočné na sledovanie zmien |
| instance_name | Výraz na generovanie jedinečného názvu pre každé odoslanie formulára |
| generation | Celé číslo označujúce generáciu formulára. Zvyšujte pri štrukturálnych zmenách |
| family | Identifikátor na zoskupenie súvisiacich formulárov naprieč štrukturálnymi zmenami |
Hárok settings v rtSurvey môže tiež obsahovať ďalšie konfigurácie špecifické pre rozšírené funkcie rtSurvey. Pozrite si dokumentáciu rtSurvey pre úplný zoznam podporovaných nastavení.
Kľúčové komponenty hárku survey
Hárok survey je jadrom dizajnu vášho formulára. Tu je prehľad jeho kľúčových komponentov:
| Komponent | Popis |
|---|---|
| type | Špecifikuje typ otázky (napr. text, integer, select_one) |
| name | Jedinečný identifikátor pre otázku |
| label | Text zobrazený respondentovi |
| hint | Doplňujúce usmernenie pre respondenta |
| appearance | Upravuje, ako sa otázka zobrazuje |
| relevant | Určuje, kedy sa otázka má zobraziť (podmieňujúca logika) |
| constraint | Overuje odpoveď |
| calculation | Vypočítava hodnoty na základe iných odpovedí |
| required | Špecifikuje, či musí byť otázka zodpovedaná |
Každý z týchto komponentov zohráva kľúčovú úlohu pri vytváraní efektívnych a účinných prieskumov.
Typy otázok
XLSForm podporuje viacero typov otázok. Tu sú niektoré možnosti, ktoré môžete zadať do stĺpca type v hárku survey vo vašom XLSForm:
| Typ otázky | Vstup odpovede |
|---|---|
| integer | Vstup celého čísla (tj. bez desatinných miest). |
| decimal | Vstup desatinného čísla. |
| range | Vstup rozsahu (vrátane hodnotenia) |
| text | Voľná textová odpoveď. |
| select_one [options] | Otázka s viacerými možnosťami; možno vybrať iba jednu odpoveď. |
| select_multiple [options] | Otázka s viacerými možnosťami; možno vybrať viacero odpovedí. |
| select_one_from_file [file] | Viacero možností zo súboru; možno vybrať iba jednu odpoveď. |
| select_multiple_from_file [file] | Viacero možností zo súboru; možno vybrať viacero odpovedí. |
| rank [options] | Otázka poradia; zoradiť zoznam. |
| note | Zobraziť poznámku na obrazovke, nevyžaduje žiadny vstup. Skratka pre type=text s readonly=true. |
| geopoint | Zbieranie jednej GPS súradnice. |
| geotrace | Záznam čiary dvoch alebo viacerých GPS súradníc. |
| geoshape | Záznam polygónu viacerých GPS súradníc; posledný bod je rovnaký ako prvý bod. |
| date | Vstup dátumu. |
| time | Vstup času. |
| dateTime | Prijíma vstup dátumu a času. |
| image | Odfotiť alebo nahrať súbor obrázku. |
| audio | Nahrať zvuk alebo nahrať zvukový súbor. |
| background-audio | Zvuk sa nahrával na pozadí počas vyplňovania formulára. |
| video | Nahrať video alebo nahrať video súbor. |
| file | Generický vstup súboru (txt, pdf, xls, xlsx, doc, docx, rtf, zip) |
| barcode | Skenovať čiarový kód, vyžaduje nainštalovanú aplikáciu na skenovanie čiarových kódov. |
| calculate | Vykonať výpočet; pozrite si sekciu Výpočet nižšie. |
| acknowledge | Potvrdzujúca výzva, ktorá nastaví hodnotu na „OK" ak je vybraná. |
| hidden | Pole bez priradeného prvku UI, ktoré možno použiť na uloženie konštanty |
| xml-external | Pridáva odkaz na externý XML dátový súbor |
Popisky
Popisky sú texty zobrazené respondentom pre každú otázku. Sú kľúčové pre jasnú komunikáciu v prieskumoch.
- Základné použitie: V stĺpci
labelzadajte text otázky. - Viacero jazykov: Použite ďalšie stĺpce ako
label::Slovenčinaalabel::Angličtinapre viacjazyčné prieskumy. - Formátovanie: rtSurvey podporuje základné HTML formátovanie v popisoch pre zdôraznenie alebo štruktúru.
Nápovedy
Nápovedy poskytujú respondentom dodatočné usmernenie bez preplnenia hlavného textu otázky.
- Použitie: Pridajte nápovedy do stĺpca
hint. - Viditeľnosť: Nápovedy sú zvyčajne zobrazené pod hlavným textom otázky.
- Viacjazyčné: Rovnako ako popisky, nápovedy možno špecifikovať pre viacero jazykov pomocou stĺpcov
hint::Jazyk.
Vzhľad
Stĺpec appearance v rtSurvey umožňuje prispôsobenie, ako sa otázky zobrazujú.
- Štandardné možnosti: Zahŕňajú ‘multiline’ pre text, ‘horizontal’ pre výberové otázky.
- Rozšírenia rtSurvey:
- Vstup času: Rôzne možnosti zobrazenia hodín (napr.
inline,inline-1line) - Prispôsobenie farieb: Použite funkciu
colors()na zmenu farieb ikon
- Vstup času: Rôzne možnosti zobrazenia hodín (napr.
Relevantnosť
Stĺpec relevant implementuje podmieňujúcu logiku, určujúcu, kedy sa má otázka zobraziť.
- Syntax: Použite výrazy XPath na definovanie podmienok.
- Premenné: Odkazujte na iné názvy otázok pomocou
${question_name}.
Povinné
Stĺpec required špecifikuje, či otázka musí byť zodpovedaná.
- Základné použitie: Použite ‘yes’ alebo ’true’ na povinnosť otázky.
- Pokročilé: Môžete použiť výrazy pre podmienečnú povinnosť.
Opakovania
Opakovania umožňujú, aby bola sada otázok zodpovedaná viackrát.
- Použitie: Použite riadky
begin repeataend repeatna definovanie opakujúcej sa skupiny. - Pomenovanie: Dajte každej opakujúcej sa skupine jedinečný názov.
Médiá
rtSurvey podporuje rôzne typy médií v prieskumoch vrátane obrázkov, zvuku a videa.
- Typy otázok: Použite ‘image’, ‘audio’ alebo ‘video’ v stĺpci type.
- Médiá v popisoch: Odkazujte na mediálne súbory v popisoch pomocou HTML tagov.
Iba na čítanie
Otázky iba na čítanie zobrazujú informácie bez povolenia vstupu od používateľa.
- Použitie: Pridajte ‘readonly’ do stĺpca
appearance. - Výpočty: Často sa používa s typom calculate na zobrazenie vypočítaných hodnôt.
Rozšírenia rtSurvey
rtSurvey rozširuje štandard XLSForm podporou ďalších možností, ako sú rozloženie mriežky, HTML formát a mnohé nové widgety.
Rozloženie mriežky
rtSurvey umožňuje formuláru napodobniť vzhľad tradičných papierových prieskumov komprimovaním viacerých otázok do jedného riadka.