Dynamický typ otázky
Dynamický typ otázky umožňuje určiť typ otázky a widget poľa za behu na základe odpovede API alebo vypočítanej hodnoty.
Funkcia Dynamický typ otázky umožňuje určiť vstupný widget a správanie overenia poľa za behu namiesto v čase návrhu formulára. Toto je pokročilé rozšírenie rtSurvey používané, keď typ dát na zber závisí od konfigurácie na strane servera, odpovede API alebo predchádzajúcej hodnoty poľa.
Bežným prípadom použitia je konfigurovateľný kontrolný zoznam inšpekcie, kde server definuje, ktoré polia sú požadované, aký typ sú (text, integer, select atď.) a aké možnosti sú dostupné — bez prestavby formulára pre každú konfiguráciu.
Ako to funguje
Pole označené ako dynamický typ otázky používa callapi() na načítanie svojej konfigurácie z API. Odpoveď API definuje:
- Typ vstupu na renderovanie (text, integer, select_one atď.)
- Dostupné voľby (pre typy select)
- Pravidlá overovania
Pole je interne označené specialFeature: isDynamicQuestionType, čo hovorí formulárovému enginu, aby použil odpoveď API na konštrukciu widgetu namiesto statickej definície formulára.
Nastavenie
Krok 1: Načítanie konfigurácie poľa
Použite pole calculate s callapi() na načítanie dynamickej konfigurácie:
| type | name | label | appearance | calculation |
|---|---|---|---|---|
| calculate | field_config | callapi | callapi('POST', 'https://api.example.com/field-config', 1, 2, 0, '$.config', 10000, 0, '', '', '{"form_id": "##form_id##", "field_id": "inspection_result"}') |
Krok 2: Odkazovanie konfigurácie v dynamickom poli
Dynamické pole používa callapi-verify() vo svojom appearance alebo constraint na prepojenie s načítanou konfiguráciou:
| type | name | label | appearance |
|---|---|---|---|
| text | inspection_result | Výsledok inšpekcie | callapi-verify(dynamicParams) |
Formulárový engine číta field_config a dynamicky určuje, či renderovať inspection_result ako pole text, integer alebo select_one.
Formát odpovede API
API by malo vrátiť JSON objekt opisujúci konfiguráciu poľa. Typická odpoveď:
{
"config": {
"type": "select_one",
"choices": [
{"value": "pass", "label": "Vyhovuje"},
{"value": "fail", "label": "Nevyhovuje"},
{"value": "na", "label": "Nevzťahuje sa"}
],
"required": true,
"constraint": ". != ''"
}
}
Príklad: Konfigurovateľný formulár inšpekcie
Formulár inšpekcie, kde sú položky kontrolného zoznamu a ich typy odpovedí načítané zo servera na základe kategórie inšpekcie:
| type | name | label | appearance | calculation |
|---|---|---|---|---|
| select_one inspection_type | insp_type | Typ inšpekcie | ||
| calculate | checklist_config | callapi | callapi('POST', 'https://api.example.com/checklist', 1, 2, 0, '$.items', 10000, 0, '', '', '{"type": "##insp_type##"}') | |
| text | item_1 | Položka 1 | callapi-verify(dynamicParams) | |
| text | item_2 | Položka 2 | callapi-verify(dynamicParams) | |
| text | item_3 | Položka 3 | callapi-verify(dynamicParams) |
Server vráti správny typ widgetu, popisok, voľby a overenie pre každú položku na základe insp_type.
Najlepšie postupy
- Používajte dynamické typy otázok iba keď sa štruktúra poľa skutočne líši za behu — pre statické formuláre používajte štandardné typy otázok.
- Uistite sa, že konfiguračné API odpovedá rýchlo (do 2 sekúnd) a je dostupné v terénnej sieti.
- Vždy definujte rozumnú zálohu vo formulári pre prípad, keď je API nedostupné — jednoduché pole
texts poznámkou je lepšie ako nefunkčný widget. - Verzujte schému odpovede API — zmeny formátu odpovede ovplyvnia všetky aktívne formuláre používajúce daný koncový bod.
- Pred nasadením testujte každú kombináciu typov polí, ktoré API môže vrátiť.
Obmedzenia
- Dynamické typy otázok vyžadujú sieťové pripojenie na načítanie konfigurácie.
- Plný rozsah typov widgetov dostupných dynamicky závisí od verzie klienta rtSurvey — testujte vašu cieľovú verziu.
- Toto je pokročilé rozšírenie rtSurvey bez ekvivalentu v štandardnej špecifikácii XLSForm.
- Chyby ladenia sú ťažšie sledovateľné, pretože definícia poľa čiastočne žije vo formulári a čiastočne v odpovedi API.