تحتوي بعض أنواع الأسئلة في XLSForm على معلمات إضافية تسمح لك بالتحكم في أسلوب أو سلوك الأسئلة في الاستطلاع. في بعض الحالات، تكمل هذه المعلمات المظاهر التي يدعمها نوع السؤال. لا يتم دعم جميع المعلمات في كافة تطبيقات الإرسال (Survey123 Mobile، التطبيق الميداني Survey123 وتطبيق الويب Survey123). لمزيد من المعلومات حول دعم التطبيق، يُرجى الرجوع إلى جداول المعلمات أدناه، وهي مُنظَّمة حسب نوع السؤال وعمود XLSForm في ورقة عمل الاستطلاع الذي يقبل كل معلمة.
يمكنك إضافة معلمات متعددة لسؤال إلى نفس العمود عن طريق فصل المعلمات بمسافات. على سبيل المثال، يمكن أن يحتوي سؤال النطاق على المعلمات startColor و endColor و color في العمود body::esri:style، وذلك على النحو التالي:startColor=Orange endColor=White color=#FF6347
عام
يصف هذا القسم المعلمات التي يمكنك استخدامها في أعمدة XLSForm bind::esri:parameters و body::esri:style لأنواع متعددة من الأسئلة.
يصف الجدول التالي المعامل الذي يمكنك استخدامه في عمود XLSForm bind::esri:parameters لأنواع أسئلة النص، والأعداد الصحيحة، والأعداد العشرية، والملاحظة، والتاريخ، والوقت، والتاريخ والوقت، واختر واحداً والاختيار من متعدد، والموقع الجغرافي، والحساب، والمخفي.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| calculationMode | تحكم في وقت حساب الحساب في السؤال. القيم: auto | manual | always | whenEmpty أمثلة: | تطبيق الويب التطبيق الميداني |
يصف الجدول التالي المعلمة التي يمكنك استخدامها في عمود XLSForm body::esri:style لأنواع أسئلة النص، والأعداد الصحيحة، والأعداد العشرية، واختيار واحدا (بمظهر الإكمال التلقائي)، والاختيار من متعدد (بمظهر الإكمال التلقائي)*، والباركود.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| placeholderText | حدد النص الذي يظهر في منطقة إدخال السؤال عندما يكون السؤال فارغًا. القيم: @[hint] | @[guidance_hint] أمثلة: | Survey123 Mobile التطبيق الميداني |
*مدعوم بواسطة Survey123 Mobile فقط.
الصوت
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters لنوع السؤال الصوت.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| برنامج الترميز | حدد برنامج الترميز المفضل للتسجيل الصوتي. يمكن إدخال برامج ترميز متعددة، مفصولة بفواصل. سيُستخدم أول برنامج ترميز متوافق مع الجهاز. القيمة: <codec name> مثال: | Survey123 Mobile التطبيق الميداني |
| fileName | حدد اسم الملف. القيم: <expression> أمثلة: | تطبيق الويب |
| max-duration | يحدد الحد الأقصى للمدة بالثواني لتسجيل الصوت. المدة الافتراضية في تطبيق الويب هي 600 (10 دقائق). القيمة: <seconds> مثال: | Survey123 Mobile تطبيق الويب التطبيق الميداني |
| max-size | حدد الحد الأقصى لحجم الملف بالميجابايت للتسجيل الصوتي. الحجم الافتراضي في التطبيق الميداني هو 10 ميجابايت. القيمة: <megabytes> مثال: | Survey123 Mobile التطبيق الميداني |
الرمز الشريطي
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لنوع السؤال الباركود.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
حدد أنواع الرموز الشريطية التي يمكن للمستخدمين مسحها ضوئيًا. يمكن تقديم أنواع متعددة، مفصولة بفواصل. عندما لا يتم توفير معلمة barcodeType، يمكن فحص جميع أنواع الرموز الشريطية المدعومة باستثناء aztec وcode39 وdatamatrix وmaxicode وpdf417. القيم: all | 1d | 2d | <barcode types>
الأنواع أحادية البعد: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension الأنواع ثنائية الأبعاد: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded أمثلة: | التطبيق الميداني |
الملف
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters لنوع السؤال الملف.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| fileName | حدد اسم الملف. القيم: <expression> أمثلة: | تطبيق الويب |
| max-size | حدد الحد الأقصى لحجم الملف بالميغا بايت. الحجم الافتراضي هو 10 ميغا بايت. القيمة: <megabytes> مثال: | تطبيق الويب |
المجموعات
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لنوع السؤال بدء مجموعة.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| backgroundColor borderColor | عيّن ألوان الخلفية والحدود لمجموعة أو صفحة. لمزيد من المعلومات، راجع التجميع، الصفحة، وتكرار الألوان. القيم: <HTML color name> | <hex color code> أمثلة:
| Survey123 Mobile التطبيق الميداني |
| عيّن نمط تخطيط الشبكة لمجموعة ما. القيم: dynamic-grid | fixed-grid مثال: | التطبيق الميداني |
الصور
يصف هذا القسم المعلمات التي يمكنك استخدامها في أعمدة XLSForm المحددة لنوع سؤال الصورة.
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| allowAdds | قم بتعطيل إضافة الصور الجديدة عند تحرير السجلات الحالية. القيمة: false مثال: | التطبيق الميداني |
| fileName | حدد اسم الملف. القيم: <expression> أمثلة: | تطبيق الويب التطبيق الميداني |
| max-size | حدد الحد الأقصى لحجم الملف بالميغا بايت. الحجم الافتراضي هو 10 ميغا بايت. القيمة: <megabytes> مثال: | تطبيق الويب |
بالنسبة لسؤال الصورة ذي مظهر تعليق توضيحي، يُنشئ تلقائيًا رسومات توضيحية للتسميات والمربعات المحيطة حول الكائنات المكتشفة. قم بإلحاق هذه الخصائص لتحديد نمط وتنسيق التعليق التوضيحي. الخاصية المطلوبة: <model_name> خصائص اختيارية: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic أمثلة: | التطبيق الميداني | |
قم باكتشاف الكائنات أو تصنيف الصور واستخدم نتائج EXIF في الاستطلاع الخاص بك. الخاصية المطلوبة: <model_name> خصائص اختيارية: minScore | cameraPreview | label | class أمثلة: | التطبيق الميداني | |
قم بإنشاء مربعات محيط أو إضافتها يدويًا وتطبيق تأثيرات التنقيح على المنطقة المستهدفة. الخاصية المطلوبة: <model_name> | @faces | @manual خصائص اختيارية: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale أمثلة: | التطبيق الميداني | |
watermark topLeftWatermark topCenterWatermark topRightWatermark leftCenterWatermark centerWatermark rightCenterWatermark bottomLeftWatermark bottomCenterWatermark bottomRightWatermark | حدد موضع العلامة المائية للصورة. قم بإلحاق الخصائص لتحديد المحتويات والتنسيق. لمزيد من المعلومات، راجع العلامات المائية. الخصائص: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize أمثلة: | التطبيق الميداني |
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لنوع السؤال الصورة.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| allowRename | حدد ما إذا كان بإمكان المستخدمين تحرير اسم الملف يدويًا. القيم: true | false مثال: | التطبيق الميداني |
| fileNameVisible | حدد ما إذا كان اسم الملف مرئيًا في الاستطلاع. القيم: true | false مثال: | التطبيق الميداني |
| footerText | بالنسبة لسؤال الصورة مع مظهر التوقيع، حدد النص الذي سيتم عرضه أسفل النافذة المنبثقة للتوقيع. إذا لم يتم تحديد أي قيمة، فسيظهر التلميح الإرشادي للسؤال أسفل التوقيع. يمكن تغيير هذا إلى تلميح السؤال باستخدام footerText=@[hint]. القيم: <none> | @[hint] أمثلة: | Survey123 Mobile التطبيق الميداني |
| الطريقة | حدد طريقة الالتقاط لسؤال الصورة. القيمة map مدعومة فقط لأسئلة الصور ذات مظهر التعليق التوضيحي. القيم: browse | camera | map أمثلة: | تطبيق الويب التطبيق الميداني |
| palette | بالنسبة لسؤال صورة بمظهر الرسم أو التعليق التوضيحي، حدد لوحة أدوات رسم مخصصة. القيمة: <palette name> مثال: | التطبيق الميداني |
| previewHeight | اضبط ارتفاع معاينة الصورة بعد تحديد الصورة. استخدم previewHeight=0 إذا كنت تريد أن تكون معاينة الصورة بأقصى حجم دون مساحة فارغة غير ضرورية. القيم: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels أمثلة: | التطبيق الميداني |
يصف الجدول التالي المعلمة التي يمكنك استخدامها في عمود XLSForm parameters لنوع السؤال الصورة.
parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| max-pixels | بالنسبة لسؤال الصورة، قم بتعيين الحد الأقصى لحجم الصورة على الحافة الأطول، مع الاحتفاظ بنسبة العرض إلى الارتفاع الأصلية. بالنسبة لسؤال صورة بمظهر التوقيع، قم بتعيين الحد الأقصى لعرض النافذة المنبثقة للتوقيع. بالنسبة لسؤال صورة بمظهر الرسم، اضبط لوحة الرسم على صورة مربعة (1: 1). القيمة: <pixels> أمثلة: | تطبيق الويب التطبيق الميداني |
أسئلة الخريطة
يصف الجدول التالي المعلمات التي يمكنك استخدامها في أعمدة XLSForm المحددة لأنواع النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي.
يصف الجدول التالي المعلمة التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
يرجى تحديد الموقع الذي سيتم استخدامه لإرجاع النتائج المكودة جغرافيًا. القيمة: <locator item ID> مثال: | تطبيق الويب التطبيق الميداني |
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لأنواع النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| height | اضبط ارتفاع معاينة الخريطة. القيم: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels أمثلة: | التطبيق الميداني |
lineColor2 fillColor3 | حدد ألوان الخط والتعبئة للمعلم الخطي أو معلم المضلع. ينطبق هذا على معاينة الخريطة في Survey123 فقط. لمزيد من المعلومات، راجع رموز الشكل الهندسي. القيم: <HTML color name> | <hex color code> مثال: | Survey123 Mobile التطبيق الميداني |
| lineWidth2 | حدد عرض الخط بالبكسل للمعلم الخطي أو المعلم المضلع. ينطبق هذا على معاينة الخريطة في Survey123 فقط. القيمة: <pixels> أمثلة: | Survey123 Mobile التطبيق الميداني |
| map | قم بتعيين خريطة أساس افتراضية. القيم: <map name> | <map item ID> أمثلة: | تطبيق الويب التطبيق الميداني |
mapTools | يمكنك التحكم في أدوات الخريطة المتوفرة لأسئلة النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي. القيم: search | mapSwitcher | zoom | home | locate أمثلة: | التطبيق الميداني |
| method2 | حدد طريقة الالتقاط. عند استخدام طريقة النقاط القممية، يمكن تعيين معلمات إضافية. القيم: sketch | vertex قيم إضافية للنقاط القممية، قابلة للتطبيق فقط في التطبيق الميداني: streaming | beep | haptic | edit أمثلة: | تطبيق الويب التطبيق الميداني |
| minCaptureZoomLevel | حدد الحد الأدنى للمستوى الذي يمكن عنده التقاط الشكل الهندسي. القيمة: <integer> مثال: | تطبيق الويب |
| overlay | قم بعرض مواقع النقاط من سؤال النقطة الجغرافية الأولى داخل مكرر في أي سؤال آخر يتعلق بنقطة جغرافية أو شكل جغرافي أو نطاق جغرافي في الاستطلاع الخاص بك. قم بإلحاق الخصائص لتحديد المحتويات والنمط. القيمة: <repeat name> الخصائص: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize أمثلة: | التطبيق الميداني |
precision | حدد عدد الخانات العشرية التي سيتم التقاطها في سؤال الخريطة وعرضها في لوحة الاستجابة الفردية في الاستطلاع. عندما لا يتم تعيين هذه المعلمة، يتم التقاط جميع الخانات العشرية المتاحة في سؤال الخريطة ولكن ستُعرض ست خانات عشرية فقط في لوحة الاستجابة الفردية. القيمة: <integer> مثال: | تطبيق الويب |
| snapMode | حدد سلوك الانطباق. يمكن انطباق النقاط إلى معالم أخرى، ويمكن انطباق الخطوط والمضلعات إلى معالم أخرى أو نفسها. متاح فقط عندما method=vertex. القيم: feature | self2 مثال: | تطبيق الويب |
| symbol1 | حدد ملف .png لاستخدامه كعلامة نقطية على الخريطة. قم بإلحاق الخصائص لتحديد الموقع والمقياس. القيمة: <file name>.png الخصائص: x | y | scale مثال: | التطبيق الميداني |
1—مدعوم بنوع سؤال النقاط الجغرافية فقط.
2—مدعوم بأنواع أسئلة الشكل الجغرافي والتتبع الجغرافي فقط.
3—مدعوم بنوع سؤال الشكل الجغرافي فقط.
أسئلة اختيار متعدد
يصف الجدول التالي المعلمة التي يمكنك استخدامها في عمود XLSForm parameters لأنواع أسئلة اختيار واحدًا والاختيار من متعدد والتصنيف.
parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| randomize | قم بترتيب الاختيارات عشوائيًا في قائمة الاختيار. القيم: true مثال: | تطبيق الويب التطبيق الميداني |
نطاق
يصف هذا القسم المعلمات التي يمكنك استخدامها في أعمدة XLSForm المحددة لنوع سؤال النطاق. عند الدمج، يجب الفصل بين المعلمات بمسافة.
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style. لمزيد من المعلومات، راجع خيارات النمط.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
startColor endColor color | حدد ألوان شريط التمرير النطاقي:
القيم: <HTML color name> | <hex color code> أمثلة: | Survey123 Mobile تطبيق الويب التطبيق الميداني |
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm parameters لنوع السؤال النطاق. لمزيد من المعلومات، راجع معلمات شريط تمرير النطاق.
parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
start end step | حدد قيم البداية والنهاية والخطوة لشريط تمرير النطاق. القيم: <integer> | <decimal> أمثلة: | Survey123 Mobile تطبيق الويب التطبيق الميداني |
تكرار
يصف هذا القسم المعلمات التي يمكنك استخدامها في أعمدة XLSForm المحددة لنوع سؤال بدء التكرار.
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| allowAdds | اسمح بإضافة سجلات تكرار جديدة. القيم: true | false مثال: | التطبيق الميداني |
| allowUpdates | اسمح بتعديل سجلات التكرار الحالية. القيم: true | false مثال: | التطبيق الميداني |
| query | اسمح بعرض سجلات التكرار الحالية في النموذج. حدد معلمات الاستعلام الإضافية لتصفية السجلات المتاحة. القيم: <none> | "SQL statement" أمثلة: | التطبيق الميداني |
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لنوع السؤال بدء التكرار.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| backgroundColor borderColor | عيّن ألوان الخلفية والحدود لتكرار. لمزيد من المعلومات، راجع التجميع، الصفحة، وتكرار الألوان. القيم: <HTML color name> | <hex color code> أمثلة:
| Survey123 Mobile التطبيق الميداني |
بالنسبة لعنصر التكرار ذي المظهر الجدولي، حدد الوضع الخاص بزر إضافة سجل وخيار النسخ إلى سجل جديد في العرض الجدولي. الوضع الافتراضي هو row. عندما تكون القيمة row، يُلحَق السجل الجديد بالعرض الجدولي. عندما تكون القيمة form، يُفتح السجل الجديد في عرض النموذج. القيم: row | form مثال: | Survey123 Mobile | |
بالنسبة لعنصر التكرار ذي المظهر الجدولي، قم بإظهار أو إخفاء خيار التحرير في عرض النموذج ضمن العرض الجدولي. الوضع الافتراضي هو true. ملاحظة:عندما يحتوي عنصر التكرار على أخطاء، يتم تفعيل خيار التحرير في عرض النموذج حتى في حال ضبط المعلمة editInFormView على القيمة false. القيم: true | false مثال: | Survey123 Mobile | |
بالنسبة لعنصر التكرار ذي المظهر الجدولي، قم بإظهار أو إخفاء خيار نسخ سجل جديد ضمن العرض الجدولي. يتيح هذا الخيار للمستخدمين تكرار سجلٍّ ضمن التكرار. الوضع الافتراضي هو true. تحدد المعلمة addRecordMode كيفية إضافة السجل المكرر. القيم: true | false مثال: | Survey123 Mobile | |
بالنسبة لعنصر التكرار ذي المظهر الجدولي، قم بتمكين أو تعطيل التحرير في العرض الجدولي. الوضع الافتراضي هو true. عندما تكون القيمة false، تكون جميع الخلايا في العرض الجدولي للقراءة فقط. القيم: true | false مثال: | Survey123 Mobile |
يصف الجدول التالي المعلمة التي يمكنك استخدامها في عمود XLSForm body::esri:style للأسئلة الموجودة ضمن التكرارات الجدولية.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
لعرض السؤال بشكل جدولي، اعرضه كعمود في العرض الجدولي. الوضع الافتراضي هو false. القيم: true | false مثال: | Survey123 Mobile |
النص
يصف هذا القسم المعلمات التي يمكنك استخدامها في أعمدة XLSForm المحددة لنوع سؤال النص.
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm bind::esri:parameters.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| التكويد الجغرافي | بالنسبة لسؤال النص بمظهر التكويد الجغرافي، قم بتعيين محدد المواقع لإرجاع النتائج المكودة جغرافيًا من عند استخدام مظهر التكويد الجغرافي. القيمة: <locator item ID> مثال: | تطبيق الويب التطبيق الميداني |
يصف الجدول التالي المعلمات التي يمكنك استخدامها في عمود XLSForm body::esri:style لنوع السؤال النص.
body::esri:style
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
| defaultHeight | بالنسبة لسؤال نصي بمظهر متعدد الخطوط، عيّن الارتفاع الأولي لمربع النص. سيزداد ارتفاع مربع النص ليلائم نص الإجابة. القيمة: <number of lines> مثال: | التطبيق الميداني |
| indicator | بالنسبة لسؤال النص بمظهر التكويد الجغرافي، اسمح للنتائج المكودة جغرافيًا بإظهار الاتجاه والمسافة من موقع الجهاز الحالي. القيم: direction | distance | none أمثلة: | التطبيق الميداني |
| maxResults | بالنسبة لسؤال النص بمظهر التكويد الجغرافي، حدد الحد الأقصى لعدد النتائج المراد إرجاعها. القيمة الافتراضية هي 6. القيمة: <number of results> مثال: | تطبيق الويب التطبيق الميداني |
| proximity | بالنسبة لسؤال النص بمظهر التكويد الجغرافي، حدد ما إذا كانت النتائج المكودة جغرافيًا لا تُظهر النتائج إلا في نطاق نصف قطر معين لموقع الجهاز. القيم: <distance>m | km | ft | mi | yd أمثلة: | التطبيق الميداني |
| اقتراحات | بالنسبة لسؤال نصي بمظهر التكويد الجغرافي، قم بتغيير كيفية تعبئة الاقتراحات. الإعداد الافتراضي هو نعم. القيم: yes | no مثال: | التطبيق الميداني |
مقياس المسافة
يوضح الجدول التالي المعامل الذي يمكنك استخدامه في عمود XLSForm bind::esri:parameters لأنواع أسئلة النص والأعداد الصحيحة والأعداد العشرية، وذلك لجلب القيم من جهاز قياس النطاق.
bind::esri:parameters
| المعلمة | الوصف | إرسال تطبيق |
|---|---|---|
قياس | عند استخدام مظهر النطاق المحدد لسؤال من نوع نص أو عدد عشري أو عدد صحيح، حدّد وحدات القياس التي سيتم تخزينها في قيمة السؤال. قم بإحاطة قائمة القيم بعلامات اقتباس إذا كانت القيم تحتوي على مسافات. القيم: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights أمثلة: | التطبيق الميداني |