عودة لأعلى

معلمات XLSForm

في هذا الموضوع

  1. عام
  2. الصوت
  3. الرمز الشريطي
  4. الملف
  5. المجموعات
  6. الصور
  7. أسئلة الخريطة
  8. أسئلة اختيار متعدد
  9. نطاق
  10. تكرار
  11. النص
  12. مقياس المسافة

تحتوي بعض أنواع الأسئلة في XLSForm على معلمات إضافية تسمح لك بالتحكم في أسلوب أو سلوك الأسئلة في الاستطلاع. في بعض الحالات، تكمل هذه المعلمات المظاهر التي يدعمها نوع السؤال. توفر الجداول أدناه نظرة عامة على المعلمات التي يمكنك استخدامها في XLSForm، والعمود الموجود في ورقة عمل الاستطلاع الذي يقبل كل معلمة. لا يتم دعم جميع المعلمات في كل من تطبيق ArcGIS Survey123 الميداني وتطبيق الويب. لمزيد من المعلومات حول دعم التطبيق الميداني وتطبيق الويب، راجع موضوع الوثائق لكل معلمة.

يمكنك إضافة معلمات متعددة لسؤال إلى نفس العمود عن طريق فصل المعلمات بمسافات. على سبيل المثال، يمكن أن يحتوي سؤال شكل جغرافي على معلمات كل من map وmethod وlineColor وfillColor في عمود body::esri:style، على النحو التالي:

map="Imagery Hybrid" method=vertex lineColor=#DC143C fillColor=LightYellow

عام

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع أنواع مختلفة من الأسئلة. راجع وصف كل معلمة للحصول على قائمة أنواع الأسئلة التي تدعمها. هذه المعلمات مدعومة فقط في التطبيق الميداني.

عمود XLSFormالمعلمةالوصف
bind::esri:parameterscalculationMode

تحكم في وقت حساب الحساب في السؤال.

أنواع الأسئلة: text | decimal | integer | note | date | time | dateTime | select_one | select_multiple | geopoint | calculate | hidden

القيم: auto | manual | always | whenEmpty

أمثلة:

calculationMode=manual
calculationMode=always
body::esri:styleplaceholderText

حدد النص الذي يظهر في منطقة إدخال السؤال عندما يكون السؤال فارغًا.

أنواع الأسئلة: text | integer | decimal | select_one (مع مظهر الإكمال التلقائي) | barcode

القيم: @[hint] | @[guidance_hint]

أمثلة:

placeholderText=@[hint]
placeholderText=@[guidance_hint]

الصوت

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال الصوت. هذه المعلمات مدعومة فقط في التطبيق الميداني ما لم يُذكر خلاف ذلك في الوصف.

عمود XLSFormالمعلمةالوصف
bind::esri:parameterscodec

حدد برنامج الترميز المفضل للتسجيل الصوتي. يمكن إدخال برامج ترميز متعددة، مفصولة بفواصل. سيُستخدم أول برنامج ترميز متوافق مع الجهاز.

القيمة: <codec name>

مثال:

codec=amr-nb,aac
fileName

حدد اسم الملف.

القيم: <expression>

هذه المعلمة مدعومة فقط في تطبيق الويب.

أمثلة:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-duration

يحدد الحد الأقصى للمدة بالثواني لتسجيل الصوت. المدة الافتراضية في تطبيق الويب هي 600 (10 دقائق).

القيمة: <seconds>

مثال:

max-duration=45
max-size

حدد الحد الأقصى لحجم الملف بالميجابايت للتسجيل الصوتي. الحجم الافتراضي في التطبيق الميداني هو 10 ميجابايت.

القيمة: <megabytes>

مثال:

max-size=5

الرمز الشريطي

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال الرمز الشريطي. هذه المعلمات مدعومة فقط في التطبيق الميداني.

عمود XLSFormالمعلمةالوصف
body::esri:style

barcodeType

حدد أنواع الرموز الشريطية التي يمكن للمستخدمين مسحها ضوئيًا. يمكن تقديم أنواع متعددة، مفصولة بفواصل. عندما لا يتم توفير معلمة barcodeType، يمكن فحص جميع أنواع الرموز الشريطية المدعومة باستثناء aztec وcode39 وdatamatrix وmaxicode وpdf417.

القيم: all | 1d | 2d | <barcode types>

  • all - جميع الأنواع المدعومة باستثناء code39 وpdf417.
  • 1d - جميع الأنواع أحادية البعد باستثناء code39.
  • 2d - جميع الأنواع ثنائية الأبعاد باستثناء pdf417.

الأنواع أحادية البعد: codabar | code128 | code39 | code93 | ean13 | ean8 | itf | upca | upce | upceanextension

الأنواع ثنائية الأبعاد: aztec | datamatrix | maxicode | pdf417 | qrcode | rss14 | rssexpanded

أمثلة:

barcodeType=qrcode,aztec,code128
barcodeType=ean8,itf
barcodeType=2d
barcodeType=pdf417

الملف

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال الملف.

عمود XLSFormالمعلمةالوصف
bind::esri:parametersfileName

حدد اسم الملف.

القيم: <expression>

هذه المعلمة مدعومة فقط في تطبيق الويب.

أمثلة:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-size

حدد الحد الأقصى لحجم الملف بالميغا بايت. الحجم الافتراضي هو 10 ميغا بايت.

القيمة: <megabytes>

هذه المعلمة مدعومة في التطبيق الميداني وتطبيق الويب.

مثال:

max-size=5

المجموعات

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال بدء المجموعة. هذه المعلمات مدعومة فقط في التطبيق الميداني.

عمود XLSFormالمعلمةالوصف
body::esri:style

backgroundColor

borderColor

عيّن ألوان الخلفية والحدود لمجموعة أو صفحة. لمزيد من المعلومات، راجع التجميع، الصفحة، وتكرار الألوان.

القيم: <HTML color name> | <hex color code>

أمثلة:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

layout

عيّن نمط تخطيط الشبكة لمجموعة ما.

القيم: dynamic-grid | fixed-grid

مثال:

layout=fixed-grid

الصور

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال الصورة. هذه المعلمات مدعومة فقط في التطبيق الميداني ما لم يُذكر خلاف ذلك في الوصف.

عمود XLSFormالمعلمةالوصف
bind::esri:parametersallowAdds

قم بتعطيل إضافة الصور الجديدة عند تحرير السجلات الحالية.

القيمة: false

مثال:

allowAdds=false
fileName

حدد اسم الملف.

القيم: <expression>

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

أمثلة:

fileName=concat("JobID-", ${job_id})
fileName=concat(${asset_id}, "_", 
  format-date(now(), "%Y%m%d%H%M%S"))
max-size

حدد الحد الأقصى لحجم الملف بالميغا بايت. الحجم الافتراضي هو 10 ميغا بايت.

القيمة: <megabytes>

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

مثال:

max-size=5

smartAnnotation

بالنسبة لسؤال الصورة ذي مظهر تعليق توضيحي، يُنشئ تلقائيًا رسومات توضيحية للتسميات والمربعات المحيطة حول الكائنات المكتشفة. قم بإلحاق هذه الخصائص لتحديد نمط وتنسيق التعليق التوضيحي.

الخاصية المطلوبة: <model_name>

خصائص اختيارية: minScore | cameraPreview | label | class | boundingBoxes | outlineWidth | fontSize | font | bold | italic

أمثلة:

smartAnnotation=modelname
  &cameraPreview=true&minScore=0.52
smartAnnotation=modelname&
  cameraPreview=true&minScore=0.52
  &class=classname1,classname2
  &label=false&bold=true

smartAttributes

قم باكتشاف الكائنات أو تصنيف الصور واستخدم نتائج EXIF في الاستبيان الخاص بك.

الخاصية المطلوبة: <model_name>

خصائص اختيارية: minScore | cameraPreview | label | class

أمثلة:

smartAttributes=modelname
  &cameraPreview=true&minScore=0.45
smartAttributes=modelname
  &cameraPreview=true
  &class=classname1,classname2
  &label=false

redaction

قم بإنشاء مربعات محيط أو إضافتها يدويًا وتطبيق تأثيرات التنقيح على المنطقة المستهدفة.

الخاصية المطلوبة: <model_name> | @faces | @manual

خصائص اختيارية: minScore | cameraPreview | label | class | effect | symbol | fillColor | scale

أمثلة:

redaction=modelname
  &cameraPreview=true&effect=blur
redaction=@manual&effect=blockout
redaction=@faces&cameraPreview=true
  &class=classname1,classname2
  &label=false@effect=symbol&symbol=🐻

watermark

topLeftWatermark

topCenterWatermark

topRightWatermark

leftCenterWatermark

centerWatermark

rightCenterWatermark

bottomLeftWatermark

bottomCenterWatermark

bottomRightWatermark

حدد موضع العلامة المائية للصورة. قم بإلحاق الخصائص لتحديد المحتويات والتنسيق. لمزيد من المعلومات، راجع العلامات المائية.

الخصائص: text | color | outlineColor | outlineWidth | haloColor | size | font | bold | italic | margin | image | imageSize

أمثلة:

watermark="Example Text
  &outlineColor=White"
bottomLeftWatermark="Example Text
  &bold=true"
topRightWatermark="@[latitude longitude]
  &size=20"
body::esri:styleallowRename

حدد ما إذا كان بإمكان المستخدمين تحرير اسم الملف يدويًا.

القيم: true | false

مثال:

allowRename=false
fileNameVisible

حدد ما إذا كان اسم الملف مرئيًا في الاستطلاع.

القيم: true | false

مثال:

fileNameVisible=true
footerText

بالنسبة لسؤال الصورة مع مظهر التوقيع، حدد النص الذي سيتم عرضه أسفل النافذة المنبثقة للتوقيع. إذا لم يتم تحديد أي قيمة، فسيظهر التلميح الإرشادي للسؤال أسفل التوقيع. يمكن تغيير هذا إلى تلميح السؤال باستخدام footerText=@[hint].

القيم: <none> | @[hint]

أمثلة:

footerText
footerText=@[hint]
method

حدد طريقة الالتقاط لسؤال الصورة. القيمة map مدعومة فقط لأسئلة الصور ذات مظهر التعليق التوضيحي.

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

القيم: browse | camera | map

أمثلة:

method=camera
method=map
method=browse,camera,map
palette

بالنسبة لسؤال صورة بمظهر الرسم أو التعليق التوضيحي، حدد لوحة أدوات رسم مخصصة.

القيمة: <palette name>

مثال:

palette=SiteLayout
previewHeight

اضبط ارتفاع معاينة الصورة بعد تحديد الصورة. استخدم previewHeight=0 إذا كنت تريد أن تكون معاينة الصورة بأقصى حجم دون مساحة فارغة غير ضرورية.

القيم: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

أمثلة:

previewHeight=3lines
previewHeight=120pixels
parametersmax-pixels

بالنسبة لسؤال الصورة، قم بتعيين الحد الأقصى لحجم الصورة على الحافة الأطول، مع الاحتفاظ بنسبة العرض إلى الارتفاع الأصلية.

بالنسبة لسؤال صورة بمظهر التوقيع، قم بتعيين الحد الأقصى لعرض النافذة المنبثقة للتوقيع.

بالنسبة لسؤال صورة بمظهر الرسم، اضبط لوحة الرسم على صورة مربعة (1: 1).

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

القيمة: <pixels>

أمثلة:

max-pixels=1500
max-pixels=400

أسئلة الخريطة

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع أنواع أسئلة النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي. هذه المعلمات مدعومة فقط في التطبيق الميداني ما لم يُذكر خلاف ذلك في الوصف.

عمود XLSFormالمعلمةالوصف
body::esri:styleheight

اضبط ارتفاع معاينة الخريطة.

القيم: <lines> | <lines>lines | <percentage of screen height>% | <pixels>pixels

أمثلة:

previewHeight=6lines
previewHeight=250pixels

lineColor²

fillColor³

حدد ألوان الخط والتعبئة للمعلم الخطي أو معلم المضلع. ينطبق هذا على معاينة الخريطة في Survey123 فقط. لمزيد من المعلومات، راجع خيارات النمط.

القيم: <HTML color name> | <hex color code>

مثال:

lineColor=Black 
fillColor=#9EFFF5
lineWidth²

حدد عرض الخط بالبكسل للمعلم الخطي أو المعلم المضلع. ينطبق هذا على معاينة الخريطة في Survey123 فقط.

القيمة: <pixels>

أمثلة:

lineWidth=3
map

قم بتعيين خريطة أساس افتراضية.

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

القيم: <map name> | <map item ID>

أمثلة:

map="World Topography"
map=de26a3cf4cc9451298ea173c4b324736

mapTools

يمكنك التحكم في أدوات الخريطة المتوفرة لأسئلة النقاط الجغرافية والتتبع الجغرافي والشكل الجغرافي.

هذه المعلمة مدعومة فقط في التطبيق الميداني.

القيم: search | mapSwitcher | zoom | home | locate

أمثلة:

mapTools=zoom
mapTools=search,locate

method²

حدد طريقة الالتقاط. عند استخدام طريقة النقاط القممية، يمكن تعيين معلمات إضافية.

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

القيم: sketch | vertex

قيم إضافية للنقاط القممية، قابلة للتطبيق فقط في التطبيق الميداني: streaming | beep | haptic | edit

أمثلة:

method=vertex
method=vertex,streaming
method=vertex,streaming,haptic
minCaptureZoomLevel

حدد الحد الأدنى للمستوى الذي يمكن عنده التقاط الشكل الهندسي.

هذه المعلمة مدعومة فقط في تطبيق الويب.

القيمة: <integer>

مثال:

minCaptureZoomLevel=17

overlay

قم بعرض مواقع النقاط من سؤال النقطة الجغرافية الأولى داخل مكرر في أي سؤال آخر يتعلق بنقطة جغرافية أو شكل جغرافي أو نطاق جغرافي في الاستطلاع الخاص بك. قم بإلحاق الخصائص لتحديد المحتويات والنمط.

القيمة: <repeat name>

الخصائص: view | preview | icon | iconColor | iconOutlineColor | iconSize | label | labelColor | labelOutlineColor | fontSize

أمثلة:

overlay=campsites&preview=true
overlay=hydrants&label=asset_id&icon=hydrant&iconColor=Red

precision

حدد عدد الخانات العشرية التي سيتم التقاطها في سؤال الخريطة وعرضها في لوحة الاستجابة الفردية في الاستطلاع. عندما لا يتم تعيين هذه المعلمة، يتم التقاط جميع الخانات العشرية المتاحة في سؤال الخريطة ولكن ستُعرض ست خانات عشرية فقط في لوحة الاستجابة الفردية.

هذه المعلمة مدعومة فقط في تطبيق الويب.

القيمة: <integer>

مثال:

precision=4

snapMode

حدد سلوك الانطباق. يمكن انطباق النقاط إلى معالم أخرى، ويمكن انطباق الخطوط والمضلعات إلى معالم أخرى أو نفسها. متاح فقط عندما method=vertex.

هذه المعلمة مدعومة فقط في تطبيق الويب.

القيم: feature | self²

مثال:

snapMode=feature
snapMode=self
snapMode=self,feature
symbol¹

حدد ملف .png لاستخدامه كعلامة نقطية على الخريطة. قم بإلحاق الخصائص لتحديد الموقع والمقياس.

القيمة: <file name>.png

الخصائص: x | y | scale

مثال:

symbol=meter.png?x=0.6&y=0.1&scale=1.5

¹ مدعوم بنوع سؤال النقاط الجغرافية فقط.

² مدعوم بأنواع أسئلة الشكل الجغرافي والتتبع الجغرافي فقط.

³ مدعوم بنوع سؤال الشكل الجغرافي فقط.

أسئلة اختيار متعدد

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع أنواع الأسئلة select_one وselect_multiple والتصنيف. هذه المعلمة مدعومة في التطبيق الميداني وتطبيق الويب.

عمود XLSFormالمعلمةالوصف
parametersrandomize

قم بترتيب الاختيارات عشوائيًا في قائمة الاختيار.

القيم: true

مثال:

randomize=true

نطاق

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال النطاق. هذه المعلمات مدعومة في التطبيق الميداني وتطبيق الويب.

عمود XLSFormالمعلمةالوصف

body::esri:style

startColor

endColor

color

حدد لون شريط التمرير في بداية النطاق ونهايته. استخدم معلمة color لتحديد اللون المستخدم لملء الفراغ بين بداية شريط التمرير والقيمة المحددة. يجب فصل المعلمات بمسافة. لمزيد من المعلومات، راجع خيارات النمط.

القيم: <HTML color name> | <hex color code>

أمثلة:

startColor=Blue endColor=Red
startColor=Orange endColor=White color=#FF6347
endColor=#262626 color=Yellow

المعلمات

start

end

step

حدد قيم البداية والنهاية والخطوة لشريط تمرير النطاق. يجب فصل المعلمات بمسافة. لمزيد من المعلومات، راجع معلمات النطاق.

القيم: <integer> | <decimal>

أمثلة:

start=0 end=50 step=5
start=10.25 end=1 step=0.25

تكرار

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال بدء التكرار. هذه المعلمات مدعومة فقط في التطبيق الميداني.

عمود XLSFormالمعلمةالوصف
bind::esri:parametersallowAdds

اسمح بإضافة سجلات تكرار جديدة.

القيم: true | false

مثال:

allowAdds=true
allowUpdates

اسمح بتعديل سجلات التكرار الحالية.

القيم: true | false

مثال:

allowUpdates=false
query

اسمح بعرض سجلات التكرار الحالية في النموذج. حدد معلمات الاستعلام الإضافية لتصفية السجلات المتاحة.

القيم: <none> | "SQL statement"

أمثلة:

query
query="severity='high'"
body::esri:style

backgroundColor

borderColor

عيّن ألوان الخلفية والحدود لتكرار. لمزيد من المعلومات، راجع التجميع، الصفحة، وتكرار الألوان.

القيم: <HTML color name> | <hex color code>

أمثلة:

backgroundColor=LightBlue
borderColor=#4682B4
backgroundColor=#C7FFC7 borderColor=#3C6D9E

النص

يحتوي الجدول التالي على معلمات XLSForm التي يمكنك استخدامها مع نوع سؤال النص. هذه المعلمات مدعومة فقط في التطبيق الميداني ما لم يُذكر خلاف ذلك في الوصف.

عمود XLSFormالمعلمةالوصف
bind::esri:parametersgeocode

بالنسبة لسؤال النص بمظهر التكويد الجغرافي، قم بتعيين محدد المواقع لإرجاع النتائج المكودة جغرافيًا من عند استخدام مظهر التكويد الجغرافي.

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

القيمة: <locator item ID>

مثال:

geocode=36ff9e8c13e042a58cfce4ad87f55d19

قياس

بالنسبة للسؤال النصي بمظهر مقياس المسافة، قم بتعيين القياسات التي سيتم تخزينها في السؤال. قم بإحاطة قائمة القيم بعلامات اقتباس إذا كانت القيم تحتوي على مسافات.

القيم: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

أمثلة:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"
body::esri:styledefaultHeight

بالنسبة لسؤال نصي بمظهر متعدد الخطوط، عيّن الارتفاع الأولي لمربع النص. سيزداد ارتفاع مربع النص ليلائم نص الإجابة.

القيمة: <number of lines>

مثال:

defaultHeight=5
indicator

بالنسبة لسؤال النص بمظهر التكويد الجغرافي، اسمح للنتائج المكودة جغرافيًا بإظهار الاتجاه والمسافة من موقع الجهاز الحالي.

القيم: direction | distance | none

أمثلة:

indicator=none
indicator=direction
indicator=direction,distance
maxResults

بالنسبة لسؤال النص بمظهر التكويد الجغرافي، حدد الحد الأقصى لعدد النتائج المراد إرجاعها. القيمة الافتراضية هي 6.

القيمة: <number of results>

هذه المعلمة مدعومة أيضًا في تطبيق الويب.

مثال:

maxResults=10
proximity

بالنسبة لسؤال النص بمظهر التكويد الجغرافي، حدد ما إذا كانت النتائج المكودة جغرافيًا لا تُظهر النتائج إلا في نطاق نصف قطر معين لموقع الجهاز.

القيم: <distance>m | km | ft | mi | yd

أمثلة:

proximity=3km
proximity=1000ft
suggestions

بالنسبة لسؤال نصي بمظهر التكويد الجغرافي، قم بتغيير كيفية تعبئة الاقتراحات. الإعداد الافتراضي هو نعم.

القيم: yes | no

مثال:

suggestions=no

مقياس المسافة

يحتوي الجدول التالي على معلمة XLSForm التي يمكنك استخدامها مع أنواع الأسئلة النصية والعشرية وأسئلة الأعداد الصحيحة لاسترداد القيم من مقياس المسافة. هذه المعلمات مدعومة فقط في التطبيق الميداني ما لم يُذكر خلاف ذلك في الوصف.

عمود XLSFormالمعلمةالوصف
bind::esri:parameters

قياس

بالنسبة للسؤال النصي بمظهر مقياس المسافة، قم بتعيين القياسات التي سيتم تخزينها في السؤال. قم بإحاطة قائمة القيم بعلامات اقتباس إذا كانت القيم تحتوي على مسافات.

القيم: height | azimuth | horizontalDistance | slopeDistance | inclination | multipleHeights

أمثلة:

measurement=height
measurement=height,azimuth,horizontalDistance
measurement="multipleHeights,Height 1,Height 2"

هل تريد إبداء ملاحظات على هذا الموضوع؟

في هذا الموضوع
  1. عام
  2. الصوت
  3. الرمز الشريطي
  4. الملف
  5. المجموعات
  6. الصور
  7. أسئلة الخريطة
  8. أسئلة اختيار متعدد
  9. نطاق
  10. تكرار
  11. النص
  12. مقياس المسافة