मुख्य अवधारणाएं
फ़ॉर्म डिज़ाइन का अवलोकन
XLSForm क्या है?
rtSurvey फ़ॉर्म डिज़ाइन के लिए XLSForm मानक के एक विस्तारित संस्करण का उपयोग करता है, जो परिष्कृत सर्वेक्षण बनाने के लिए शक्तिशाली सुविधाएं प्रदान करता है। यह मार्गदर्शिका आपको rtSurvey में फ़ॉर्म डिज़ाइन की मुख्य अवधारणाओं से परिचित कराएगी, बुनियादी XLSForm संरचना से लेकर उन्नत rtSurvey-विशिष्ट सुविधाओं तक।
XLSForms के साथ, आप परिचित Excel टूल का उपयोग करके मानव-पठनीय प्रारूप में फ़ॉर्म बना सकते हैं, जिससे यह लगभग सभी के लिए सुलभ हो जाता है। यह मानक फ़ॉर्म लेखन पर आसान साझाकरण और सहयोग को सक्षम बनाता है।
जबकि XLSForms नए उपयोगकर्ताओं के लिए अनुकूल हैं, वे अनुभवी उपयोगकर्ताओं को जटिल फ़ॉर्म बनाने की भी अनुमति देते हैं।
rtSurvey विभिन्न वेब और मोबाइल डेटा संग्रह प्लेटफ़ॉर्म पर फ़ॉर्म में स्किप लॉजिक जैसी उन्नत कार्यात्मकताओं को शामिल करने का एक सुसंगत तरीका प्रदान करता है।
XLSForm संरचना
एक XLSForm में आमतौर पर दो मुख्य वर्कशीट होती हैं:
- survey: आपके फ़ॉर्म की संरचना और सामग्री को परिभाषित करता है।
- choices: बहुविकल्पीय प्रश्नों के लिए उत्तर विकल्प निर्दिष्ट करता है।
एक वैकल्पिक settings वर्कशीट अतिरिक्त फ़ॉर्म विनिर्देश प्रदान कर सकती है।
यह ध्यान रखना महत्वपूर्ण है कि survey और choices वर्कशीट में अनिवार्य कॉलम फ़ॉर्म के सही ढंग से काम करने के लिए मौजूद होने चाहिए। दोनों वर्कशीट में वैकल्पिक कॉलम प्रत्येक प्रविष्टि के व्यवहार पर और नियंत्रण प्रदान करते हैं लेकिन आवश्यक नहीं हैं।
आपकी Excel वर्कबुक में कॉलम किसी भी क्रम में दिखाई दे सकते हैं, और वैकल्पिक कॉलम खाली छोड़े जा सकते हैं। हालाँकि, फ़ॉर्म के सही ढंग से काम करने के लिए XLSForm दस्तावेज़ीकरण में निर्दिष्ट सटीक सिंटैक्स और नामकरण परंपराओं का उपयोग करना महत्वपूर्ण है।
survey वर्कशीट
survey वर्कशीट वह है जहाँ आप अपने फ़ॉर्म की संरचना को परिभाषित करते हैं और सामग्री प्रदान करते हैं। survey वर्कशीट में प्रत्येक पंक्ति आपके फ़ॉर्म में एक प्रश्न या तत्व का प्रतिनिधित्व करती है। survey वर्कशीट में निम्नलिखित कॉलम अनिवार्य हैं:
type: प्रश्न के लिए आप जो प्रविष्टि अपेक्षा करते हैं उसका प्रकार निर्दिष्ट करता है।name: उस प्रविष्टि के लिए अद्वितीय चर नाम निर्दिष्ट करता है। नाम एक अक्षर या अंडरस्कोर से शुरू होने चाहिए और केवल अक्षर, अंक, हाइफ़न, अंडरस्कोर और अवधि हो सकते हैं। नाम केस-संवेदी हैं।label: फ़ॉर्म में प्रश्न के लिए वास्तविक टेक्स्ट शामिल है।
| type | name | label |
|---|---|---|
| today | today | |
| select_one gender | gender | उत्तरदाता का लिंग? |
| integer | age | उत्तरदाता की आयु? |
choices वर्कशीट
choices वर्कशीट का उपयोग बहुविकल्पीय प्रश्नों के लिए उत्तर विकल्प निर्दिष्ट करने के लिए किया जाता है।
प्रत्येक पंक्ति एक उत्तर विकल्प का प्रतिनिधित्व करती है। choices वर्कशीट में निम्नलिखित कॉलम अनिवार्य हैं:
list_name: संबंधित उत्तर विकल्पों के एक सेट को एकसाथ समूहित करता है।name: उस उत्तर विकल्प के लिए अद्वितीय चर नाम निर्दिष्ट करता है।label: उत्तर विकल्प को ठीक वैसे दिखाता है जैसा आप चाहते हैं कि यह फ़ॉर्म पर दिखे।
| list_name | name | label |
|---|---|---|
| gender | transgender | ट्रांसजेंडर |
| gender | female | महिला |
| gender | male | पुरुष |
| gender | other | अन्य |
आपकी Excel वर्कबुक में जो कॉलम आप जोड़ते हैं, चाहे वे अनिवार्य हों या वैकल्पिक, किसी भी क्रम में दिखाई दे सकते हैं। वैकल्पिक कॉलम पूरी तरह से छोड़े जा सकते हैं। पठनीयता में सहायता के लिए पंक्तियां या कॉलम खाली छोड़े जा सकते हैं, लेकिन किसी शीट पर 20 से अधिक आसन्न खाली कॉलम या पंक्तियों के बाद के डेटा को प्रोसेस नहीं किया जाएगा। सभी .xlsx फ़ाइल फ़ॉर्मेटिंग को नजरअंदाज किया जाता है, इसलिए आप फ़ॉर्म को अधिक पठनीय बनाने के लिए विभाजन रेखाएं, शेडिंग और अन्य फ़ॉन्ट फ़ॉर्मेटिंग का उपयोग कर सकते हैं।
Excel में फ़ॉर्म बनाते समय एक बात ध्यान रखने की है कि आपका उपयोग किया गया सिंटैक्स सटीक होना चाहिए। उदाहरण के लिए, यदि आप choices के बजाय Choices या choice लिखते हैं, तो फ़ॉर्म काम नहीं करेगा।
settings वर्कशीट
settings वर्कशीट वैकल्पिक है लेकिन आपको फ़ॉर्म-स्तरीय मेटाडेटा और व्यवहार निर्दिष्ट करने की अनुमति देती है। settings वर्कशीट में सामान्य कॉलम में शामिल हैं:
| कॉलम | विवरण |
|---|---|
| form_title | फ़ॉर्म का शीर्षक जैसा यह उपयोगकर्ताओं को दिखाई देता है |
| form_id | फ़ॉर्म के लिए एक अद्वितीय पहचानकर्ता, डेटा प्रबंधन और API कॉल में उपयोग किया जाता है |
| default_language | बहुभाषी फ़ॉर्म के लिए डिफ़ॉल्ट भाषा कोड (जैसे अंग्रेज़ी के लिए ’en') |
| version | फ़ॉर्म का संस्करण संख्या, परिवर्तन ट्रैक करने के लिए उपयोगी |
| instance_name | प्रत्येक फ़ॉर्म सबमिशन के लिए एक अद्वितीय नाम उत्पन्न करने के लिए अभिव्यक्ति |
| generation | फ़ॉर्म की पीढ़ी को चिह्नित करने वाला पूर्णांक। संरचनात्मक परिवर्तनों के लिए बढ़ाएं |
| family | संरचनात्मक परिवर्तनों में संबंधित फ़ॉर्म को समूहित करने के लिए पहचानकर्ता |
rtSurvey में settings वर्कशीट में rtSurvey की विस्तारित कार्यात्मकताओं के लिए विशिष्ट अतिरिक्त कॉन्फ़िगरेशन भी शामिल हो सकते हैं। समर्थित सेटिंग्स की पूरी सूची के लिए rtSurvey दस्तावेज़ीकरण देखें।
Survey वर्कशीट के मुख्य घटक
survey वर्कशीट आपके फ़ॉर्म डिज़ाइन का मूल है। इसके मुख्य घटकों का अवलोकन:
| घटक | विवरण |
|---|---|
| type | प्रश्न प्रकार निर्दिष्ट करता है (जैसे text, integer, select_one) |
| name | प्रश्न के लिए अद्वितीय पहचानकर्ता |
| label | उत्तरदाता को प्रदर्शित टेक्स्ट |
| hint | उत्तरदाता के लिए अतिरिक्त मार्गदर्शन |
| appearance | प्रश्न कैसे प्रदर्शित होता है उसे संशोधित करता है |
| relevant | निर्धारित करता है कि प्रश्न कब पूछा जाना चाहिए (स्किप लॉजिक) |
| constraint | प्रतिक्रिया को मान्य करता है |
| calculation | अन्य प्रतिक्रियाओं के आधार पर मूल्यों की गणना करता है |
| required | निर्दिष्ट करता है कि प्रश्न का उत्तर देना आवश्यक है या नहीं |
प्रश्न प्रकार
XLSForm कई प्रश्न प्रकारों का समर्थन करता है। ये आपके XLSForm में survey वर्कशीट के type कॉलम में दर्ज करने के कुछ विकल्प हैं:
| प्रश्न प्रकार | उत्तर इनपुट |
|---|---|
| integer | पूर्णांक (यानी, पूरी संख्या) इनपुट। |
| decimal | दशमलव इनपुट। |
| range | Range इनपुट (रेटिंग सहित) |
| text | मुक्त टेक्स्ट प्रतिक्रिया। |
| select_one [options] | बहुविकल्पीय प्रश्न; केवल एक उत्तर चुना जा सकता है। |
| select_multiple [options] | बहुविकल्पीय प्रश्न; कई उत्तर चुने जा सकते हैं। |
| select_one_from_file [file] | फ़ाइल से बहुविकल्पीय; केवल एक उत्तर चुना जा सकता है। |
| select_multiple_from_file [file] | फ़ाइल से बहुविकल्पीय; कई उत्तर चुने जा सकते हैं। |
| rank [options] | Rank प्रश्न; एक सूची क्रमबद्ध करें। |
| note | स्क्रीन पर एक नोट प्रदर्शित करें, कोई इनपुट नहीं लेता। |
| geopoint | एकल GPS निर्देशांक एकत्र करें। |
| geotrace | दो या अधिक GPS निर्देशांकों की एक रेखा रिकॉर्ड करें। |
| geoshape | कई GPS निर्देशांकों का एक बहुभुज रिकॉर्ड करें; अंतिम बिंदु पहले के समान है। |
| date | दिनांक इनपुट। |
| time | समय इनपुट। |
| dateTime | दिनांक और समय इनपुट स्वीकार करता है। |
| image | एक तस्वीर लें या छवि फ़ाइल अपलोड करें। |
| audio | एक ऑडियो रिकॉर्डिंग लें या ऑडियो फ़ाइल अपलोड करें। |
| background-audio | फ़ॉर्म भरते समय बैकग्राउंड में ऑडियो रिकॉर्ड किया जाता है। |
| video | एक वीडियो रिकॉर्डिंग लें या वीडियो फ़ाइल अपलोड करें। |
| file | सामान्य फ़ाइल इनपुट (txt, pdf, xls, xlsx, doc, docx, rtf, zip) |
| barcode | एक barcode स्कैन करें, barcode स्कैनर ऐप इंस्टॉल होने की आवश्यकता है। |
| calculate | एक गणना करें; नीचे Calculation अनुभाग देखें। |
| acknowledge | “OK” पर सेट होने वाला पावती संकेत जो चुने जाने पर सक्रिय होता है। |
| hidden | कोई संबद्ध UI तत्व नहीं वाला एक फील्ड जिसे स्थिरांक संग्रहीत करने के लिए उपयोग किया जा सकता है |
| xml-external | बाहरी XML डेटा फ़ाइल का एक संदर्भ जोड़ता है |
लेबल
लेबल प्रत्येक प्रश्न के लिए उत्तरदाताओं को प्रदर्शित टेक्स्ट है। वे सर्वेक्षण में स्पष्ट संचार के लिए महत्वपूर्ण हैं।
- बुनियादी उपयोग:
labelकॉलम में, प्रश्न टेक्स्ट दर्ज करें। - कई भाषाएं: बहुभाषी सर्वेक्षण के लिए
label::Englishऔरlabel::Frenchजैसे अतिरिक्त कॉलम का उपयोग करें। - फ़ॉर्मेटिंग: rtSurvey लेबल में बुनियादी HTML फ़ॉर्मेटिंग का समर्थन करता है।
संकेत
संकेत मुख्य प्रश्न टेक्स्ट को अव्यवस्थित किए बिना उत्तरदाताओं को अतिरिक्त मार्गदर्शन प्रदान करते हैं।
- उपयोग:
hintकॉलम में संकेत जोड़ें। - दृश्यता: संकेत आमतौर पर मुख्य प्रश्न टेक्स्ट के नीचे प्रदर्शित होते हैं।
- बहुभाषी: लेबल की तरह, संकेत
hint::Languageकॉलम का उपयोग करके कई भाषाओं के लिए निर्दिष्ट किए जा सकते हैं।
Appearance
rtSurvey में appearance कॉलम प्रश्नों के प्रदर्शन के अनुकूलन की अनुमति देता है।
- मानक विकल्प: टेक्स्ट के लिए ‘multiline’, select प्रश्नों के लिए ‘horizontal’ शामिल हैं।
- rtSurvey एक्सटेंशन:
- समय इनपुट: विभिन्न घड़ी प्रदर्शन विकल्प (जैसे
inline,inline-1line) - रंग अनुकूलन: आइकन रंग बदलने के लिए
colors()फ़ंक्शन का उपयोग करें
- समय इनपुट: विभिन्न घड़ी प्रदर्शन विकल्प (जैसे
Relevant
relevant कॉलम स्किप लॉजिक लागू करता है, यह निर्धारित करता है कि कोई प्रश्न कब प्रदर्शित होना चाहिए।
- सिंटैक्स: शर्तें परिभाषित करने के लिए XPath अभिव्यक्तियों का उपयोग करें।
- चर:
${question_name}का उपयोग करके अन्य प्रश्न नामों का संदर्भ लें।
Required
required कॉलम निर्दिष्ट करता है कि किसी प्रश्न का उत्तर देना आवश्यक है या नहीं।
- बुनियादी उपयोग: प्रश्न को आवश्यक बनाने के लिए ‘yes’ या ’true’ का उपयोग करें।
- उन्नत: सशर्त आवश्यकता के लिए अभिव्यक्तियों का उपयोग किया जा सकता है।
Repeats
Repeats आपको एक ही सर्वेक्षण में कई बार प्रश्नों के एक समूह का उत्तर देने की अनुमति देते हैं।
- उपयोग: एक दोहराते हुए समूह को परिभाषित करने के लिए
begin repeatऔरend repeatपंक्तियों का उपयोग करें। - नामकरण: प्रत्येक repeat समूह को एक अद्वितीय नाम दें।
मीडिया
rtSurvey सर्वेक्षण में विभिन्न मीडिया प्रकारों का समर्थन करता है, जिसमें छवियां, ऑडियो और वीडियो शामिल हैं।
- प्रश्न प्रकार: type कॉलम में ‘image’, ‘audio’ या ‘video’ का उपयोग करें।
- लेबल में मीडिया: HTML टैग का उपयोग करके लेबल में मीडिया फ़ाइलों का संदर्भ लें।
Read-only
Read-only प्रश्न उपयोगकर्ता इनपुट की अनुमति दिए बिना जानकारी प्रदर्शित करते हैं।
- उपयोग:
appearanceकॉलम में ‘readonly’ जोड़ें। - गणनाएं: अक्सर गणना किए गए मूल्यों को प्रदर्शित करने के लिए calculate प्रकार के साथ उपयोग किया जाता है।
rtSurvey एक्सटेंशन
rtSurvey grid layout, html format और कई नए widgets जैसी अतिरिक्त क्षमताओं का समर्थन करके XLSForm मानक को विस्तारित करता है।
ग्रिड लेआउट
rtSurvey आपके फ़ॉर्म को पारंपरिक पेपर सर्वेक्षण की तरह दिखने देता है, एक पंक्ति में कई प्रश्नों को संक्षिप्त करके।