Webbox
Webbox సర్వేలో modal iframe గా బాహ్య వెబ్ పేజీ ఎంబెడ్ చేస్తుంది, గణికులు ఫారం వదలకుండా సూచనలు చూడటానికి లేదా బాహ్య సాధనాలతో ఇంటరాక్ట్ చేయడానికి అనుమతిస్తుంది.
Webbox సర్వేలో బాహ్య వెబ్ పేజీని modal popup (iframe) గా ఎంబెడ్ చేస్తుంది. గణికుడు లేబుల్ లేదా నోట్ టెక్స్ట్లో బటన్ను నొక్కినప్పుడు, పేజీ ఫారంలో full-screen overlay లో తెరుచుకుంటుంది, మరియు వారు దాన్ని మూసివేసినప్పుడు ఖచ్చితంగా వారు ఉన్న చోటికి తిరిగి వస్తారు. ఇది వేరొక browser tab తెరవకుండా సూచన వస్తువులు, మ్యాప్లు, dashboards, లేదా custom సాధనాలు చూపించడానికి అనుమతిస్తుంది.
సింటాక్స్
label లేదా note label కాలమ్లో నేరుగా <webbox> HTML tag చొప్పించండి:
<webbox src='https://example.com/reference' title='Reference Guide'>Open Reference Guide</webbox>
| Attribute | వివరణ |
|---|---|
src | iframe లో లోడ్ చేయవలసిన URL. సింగిల్ మరియు డబుల్ quotes రెండింటికి మద్దతు ఇస్తుంది. |
title | modal header bar లో ప్రదర్శించబడే టెక్స్ట్. plain text కు మద్దతు ఇస్తుంది. |
| (కంటెంట్) | సర్వే ఫీల్డ్లో చూపించబడే క్లిక్ చేయగల బటన్ లేబుల్ |
ప్రాథమిక ఉదాహరణ
| type | name | label |
|---|---|---|
| note | ref_guide | <webbox src='https://docs.example.com/field-guide' title='Field Guide'>📖 Open Field Guide</webbox> |
ఇది “📖 Open Field Guide” అని లేబుల్ చేయబడిన బటన్ రెండర్ చేస్తుంది. నొక్కినప్పుడు, field guide వెబ్సైట్ చూపించే modal తెరుచుకుంటుంది.
మ్యాప్ ఎంబెడ్ చేయడం
| type | name | label |
|---|---|---|
| note | area_map | <webbox src='https://maps.example.com/survey-area' title='Survey Area Map'>🗺 View Map</webbox> |
ఎంబెడ్ చేయబడిన పేజీకి ఫారం విలువలు పాస్ చేయడం
calculation కాలమ్లో concat() ఉపయోగించి URL కి ఫారం ఫీల్డ్ విలువలు జోడించి లేబుల్లో ఫలితం సూచించండి:
| type | name | label | calculation |
|---|---|---|---|
| calculate | webbox_url | concat('https://dashboard.example.com/household?id=', ${household_id}) | |
| note | hh_dash | <webbox src='${webbox_url}' title='Household Dashboard'>Open Dashboard</webbox> |
<webbox> tag లో src attribute calculate ఫీల్డ్ నుండి label లెక్కించబడినప్పుడు ${fieldname} సూచనలకు మద్దతు ఇస్తుంది. పూర్తి URL ని calculate ఫీల్డ్లో నిర్మించి దాన్ని సూచించండి.
రిపీట్ ఇంటరాక్షన్: delete బటన్లు
Webbox లేబుళ్ళలో రిపీట్ సమూహాలు నిర్వహించడానికి ప్రత్యేక యాక్షన్ tags కు కూడా మద్దతు ఇస్తుంది:
<delete-repeat-current>Remove this row</delete-repeat-current>
<delete-repeat-last>Remove last row</delete-repeat-last>
ఇవి నొక్కినప్పుడు రిపీట్ instances తొలగించే బటన్లుగా రెండర్ అవుతాయి. రిపీట్ సమూహంలో (లేదా వెంటనే తర్వాత) note ఫీల్డ్లో వాటిని ఉంచండి:
| type | name | label |
|---|---|---|
| begin_repeat | items | Item |
| text | item_name | Item name |
| note | delete_btn | <delete-repeat-current>✕ Remove this item</delete-repeat-current> |
| end_repeat |
ఎంబెడ్ చేయబడిన పేజీతో కమ్యూనికేషన్ (postMessage)
Webbox iframe మరియు మాతృ ఫారం browser యొక్క postMessage API ఉపయోగించి కమ్యూనికేట్ చేయగలవు. తెరిచినప్పుడు మాతృ iframe కు init సందేశం పంపుతుంది. ఎంబెడ్ చేయబడిన పేజీ దీనితో ప్రతిస్పందించవచ్చు:
delete-repeat-current— ప్రస్తుత రిపీట్ ఇన్స్టెన్స్ తొలగించడాన్ని ట్రిగర్ చేస్తుందిdelete-repeat-last— చివరి రిపీట్ ఇన్స్టెన్స్ తొలగించడాన్ని ట్రిగర్ చేస్తుంది
ఇది custom వెబ్ సాధనాలు (ఉదా. drawing tools, interactive maps) వినియోగదారుడు iframe లోపల చర్య ధృవీకరించినప్పుడు ఫారం చర్యలు ట్రిగర్ చేయడానికి అనుమతిస్తుంది.
ఉత్తమ పద్ధతులు
- సూచన వస్తువులకు (మార్గదర్శకాలు, lookup పట్టికలు, మ్యాప్లు) webbox ఉపయోగించండి — ఫారంలో ఉండాల్సిన డేటా సేకరించడానికి కాదు.
- ఎంబెడ్ చేయబడిన URL పరికర నెట్వర్క్ నుండి యాక్సెస్ చేయగలిగేలా ఉందని నిర్ధారించుకోండి — webbox కనెక్టివిటీ అవసరం.
- ఎంబెడ్ చేయబడిన పేజీ mobile-friendly గా ఉంచండి — modal గరిష్టంగా 800px వెడల్పు మరియు viewport ఎత్తులో 80%.
- వివరణాత్మక బటన్ టెక్స్ట్ ఉపయోగించండి (ఉదా. “View Village Map”) generic labels (“Click here”) కంటే.
- modal మూసివేయడం సర్వేకు తిరిగి వస్తుందని గణికులకు తెలియజేయండి — కొంత మంది వినియోగదారులు iframe overlay ఎలా మూసివేయాలో తెలియకపోవచ్చు.
పరిమితులు
- Webbox ఎంబెడ్ చేయబడిన URL లోడ్ చేయడానికి నెట్వర్క్ కనెక్టివిటీ అవసరం.
- కొన్ని బాహ్య సైట్లు
X-Frame-OptionsలేదాContent-Security-Policyheaders ద్వారా iframes లో ఎంబెడ్ చేయడాన్ని నిరోధిస్తాయి — ఈ సైట్లను webbox తో ఉపయోగించలేరు. - ప్రశ్న నుండి గణికుడు నావిగేట్ చేసినప్పుడు modal మూసివేయబడుతుంది — iframe లో నిల్వ చేయబడని ఏ స్థితైనా పోతుంది.
- Webbox rtSurvey వెబ్ ఫారం పొడిగింపు మరియు ఇతర ODK-అనుకూల క్లయింట్లలో పని చేయకపోవచ్చు.