يمكن عرض الإجابة عن سؤال في قالب تقرير عن طريق توفير اسمه بين أقواس متعرجة {}، مسبوقًا بعلامة الدولار. يجب وضع أي قيمة سلسلة مضمنة في تعبير ما بين علامتي اقتباس مزدوجتين.
يعرض المثال التالي الإجابة من سؤال نصي يسمى firstname:
${firstname}
بالإضافة إلى عرض الإجابة عن سؤال في تقرير، يمكن استخدام الكلمات الرئيسية لعرض المعلومات المفيدة الأخرى. يعرض ما يلي التاريخ والوقت الحاليين عند طباعة تقرير:
${$date}
النتيجة هي صفيف، يمكن تكرار الصفيف باستخدام # كعلامة بدء و/ كعلامة انتهاء داخل الأقواس المتعرجة. يطبع ما يلي جميع ملفات الصور على سطور منفصلة:
${#image1}
${$file}
${/}
يمكنك أيضًا استخدام التعبيرات لتحسين طريقة عرض الإجابات. يمكن أن يكون التعبير اسم سؤال فرديًا أو كلمة رئيسية (كما هو موضح بالأعلى)، أو عملية حسابية تتضمن سؤالًا واحدًا أو أكثر أو كلمات رئيسية، أو اسم سؤال أو كلمة رئيسية تتضمن طرقًا ومعلمات لتقييد النمط على الإجابة أو تطبيقه. يستخدم التعبير التعليق التوضيحي التالي:
${questionname or keyword | method:parameter}
قد يتضمن التعبير طرقًا ومعلمات متعددة أو لا يتضمن أيًا منها على الإطلاق. قد تكون المعلمات إما قيمًا من أسئلة أخرى، أو قيمة ثابتة.
يعرض التعبير التالي حساب سؤال رقم يسمى floweringtrees مقسومًا على سؤال رقم يسمى totaltrees. عند الإشارة إلى أسئلة متعددة في التعبير نفسه، لا تحتاج أسماء الأسئلة الفردية إلا إلى تسميتها مباشرة ولا تحتاج إلى أقواس متعرجة إضافية:
${floweringtrees / totaltrees}
يعرض التعبير التالي قيمة الإحداثي السيني من سؤال الموقع، حيث تكون getValue هي الطريقة وx هي المعلمة:
${location | getValue:"x"}
يُقيم التعبير التالي على أنه صحيح إذا كانت الإجابة عن سؤال يسمى fruitcolor لا تساوي red:
${if fruitcolor!="red"}The fruit is not red.${/}
يمكن ربط السلاسل في تعبير بربطها بعلامة الجمع. يستخدم التعبير التالي هذا التسلسل لتمرير محتويات سؤال يسمى field_0 إلى خدمة إنشاء رموز الاستجابة السريعة، وإنشاء رمز استجابة سريعة لإجابة السؤال:
${$image | src:"https://barcode.tec-it.com/barcode.ashx?code=QRCode&data="+field_0}
تتوفر أمثلة على التعبيرات لكل نوع من الأسئلة في المواضيع التالية:
- تعبيرات النص
- تعبيرات العدد
- تعبيرات الصور والمرفقات الأخرى
- تعبيرات الخريطة (تشمل، النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي)
- تعبيرات التاريخ والوقت والتاريخ-الوقت
- تعبيرات الاختيار
- تعبيرات التكرار
طرق التعبير
لا تدعم جميع أنواع الأسئلة التعبيرات والطرق. يسرد الجدول التالي الطرق والمعلمات التي يمكنك استخدامها مع أنواع الأسئلة المتنوعة:
الطريقة | المعلمة | نوع سؤال Connect | نوع سؤال مصمم الويب | الوصف |
---|---|---|---|---|
getValue | - | جميع أنواع الأسئلة | جميع أنواع الأسئلة | يسترجع قيمة البيانات الأولية من طبقة المعالم، أو صورة أولية من مرفق. |
getValue | س، ص، ع، wkid | نقطة جغرافية | خريطة | يسترجع إحداثيات س و ص و ع بشكل فردي في إسناد مكاني محدد. معلمة wkid اختيارية، وستكون قيمتها هي نفسها الإسناد المكاني لطبقة المعالم إذا تم حذفها. |
getValue | الطول والمساحة والوحدة ونوع القياس | التتبع الجغرافي والشكل الجغرافي | خريطة | يرجع طول خط متعدد أو محيط أو مساحة مضلع، في وحدات معينة ويحدد ما إذا كانت القياسات مستوية أم جيوديسية. نوع القياس الافتراضي هو قياس جيوديسي. |
getValue | الاسم والحجم | صورة، ملف صوتي، ملف | صورة، توقيع، ملف صوتي، ملف | يرجع اسم الملف أو حجم المرفق. |
getValue | العرض، الارتفاع، س، ص، التاريخ، الوقت، الاتجاه | صورة | صورة، توقيع | يُرجع العرض والارتفاع قيمة العدد الصحيح لعرض الصورة وارتفاعها بالبكسل، وترجع إحداثيات س، وص، والتاريخ، والوقت، والاتجاه القيم المقروءة من الصورة EXIF، إذا كانت موجودة. |
getValue | count | بدء التكرار، صورة، ملف صوتي، ملف | تكرار، صورة، توقيع، ملف صوتي، ملف | يرجع العدد الإجمالي للتكرارات أو المرفقات. |
getValue | موضع | بدء التكرار، صورة، ملف صوتي، ملف | تكرار، صورة، توقيع، ملف صوتي، ملف | إرجاع عدد صحيح مساوٍ للموضع الأول المفهرس في الصفيف. |
getValue | المدة | ملف صوتي، ملف | ملف صوتي، ملف | إرجاع طول التسجيلات الصوتية في ثوانٍ. تنبيه:لا يتم إرجاع المدة في الاستجابات المجمعة في تطبيق الويب عند استخدام Safari. |
المظهر | متعدد السطور | النص | نص متعدد السطور | يحتفظ بفواصل الأسطر في السلسلة. إذا لم يتم تحديد أي قيمة مظهر، يتم إرجاع سلسلة سطر واحد. |
المظهر | نقاط | select_multiple | اختيار متعدد | يرجع الإجابة بتنسيق نقطي. |
محدد | اسم الاختيار | select_one وselect_multiple | اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف | يرجع خانة اختيار تم التأشير عليها إذا كانت قيمة الحقل تساوي اسم الاختيار، وإلا، فيتم إرجاع خانة اختيار لم يتم التأشير عليها. |
محدد | اسم الاختيار | select_one وselect_multiple | اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف | إذا كان مجال القيمة المكودة موجودًا، فيتم إرجاع صحيح إذا كانت قيمة الحقل تساوي اسم الاختيار، وإلا فيتم إرجاع خطأ. |
countSelected | - | select_one وselect_multiple | اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف | يرجع عدد الخيارات المحددة. |
selectedAt | فهرس | select_one وselect_multiple | اختيار متعدد، اختيار واحد، شبكة اختيار واحد، قائمة منسدلة، مقياس Likert، تصنيف | يرجع السلسلة في موضع الفهرس في قائمة الاختيار. يبدأ الفهرس من الصفر. |
محلي | كود اللغة | التاريخ، التاريخ والوقت، البداية، النهاية، عشري | التاريخ، التاريخ والوقت، الرقم | يرجع قيم التاريخ والوقت والرقم المعربة. |
تنسيق | تنسيق السلسلة | التاريخ، التاريخ والوقت، العدد الصحيح، عدد عشري، البداية، النهاية | التاريخ، التاريخ والوقت | يرجع سلسلة تاريخ منسقة. |
utcOffset | قيمة الإزاحة | التاريخ، التاريخ والوقت، البداية، النهاية | التاريخ، التاريخ والوقت | تُرجع قيمة التاريخ أو التاريخ والوقت التي تمت إزاحتها بواسطة قيمة الإزاحة بالتوقيت العالمي المنسق. |
mapSettings | معرف عنصر خريطة الويب، مقياس الخريطة | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | يحدد خريطة الأساس ومقياس الرسم عند طباعة صورة الخريطة. قديم:تم استبدال هذه الطريقة بـ map وmapScale. |
نطاق الخريطة | xmin، ymin، xmax، ymax، wkid | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | تحديد نطاق الخريطة الثابت عند طباعة صورة الخريطة. تُعد المعلمة wkid اختيارية، وسيتم تعيينها على 4326 (WGS84) في حال حذفها. |
الخريطة | معرّف عنصر خريطة الويب | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | تحدد خريطة الأساس عند طباعة صورة الخريطة. |
mapScale | مقياس الخريطة | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | تحدد مقياس رسم الخريطة عند طباعة صورة الخريطة. |
mapFilters | معرف الطبقة في خريطة الويب JSON، معلمات الاستعلام | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | يُحدد عامل تصفية واحد أو أكثر لطبقات المعالم في خريطة الويب عند طباعة صورة الخريطة. |
استدارة | درجات | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي والصورة | الخريطة والصورة | تحديد زاوية دوران الخريطة أو الصورة. |
معلومات الرسم | الطبقة الحالية، عنوان URL لطبقة المعالم | النقطة الجغرافية والتتبع الجغرافي والشكل الجغرافي | خريطة | لتحديد معلومات الرسم عند طباعة صورة الخريطة، بما في ذلك الرمز والتسمية والشفافية. |
src | عنوان URL للصورة | - | - | لتحديد عنوان URL للمصدر لعنصر صورة ديناميكي. |
الحجم | العرض، الارتفاع، أقصى عرض، أقصى ارتفاع | صورة | صورة | لتحديد حجم الصورة المطبوعة. |
دائري | حفظ الأماكن | عدد عشري، نقطة جغرافية، شكل جغرافي، تتبع جغرافي | رقم | يقرب الرقم العشري إلى خانات عشرية محددة. |
useGrouping | منطق | عشري | رقم | إذا كانت القيمة صواب، تُرجع رقمًا بفواصل تجميع محددة بواسطة الإعدادات المحلية، وإذا كانت خطأ، فلن يتم استخدام فواصل. |
toFixed | حفظ الأماكن | عدد عشري، نقطة جغرافية، شكل جغرافي، تتبع جغرافي | رقم | يحدد عددًا ثابتًا من الأرقام بعد الفاصل العشري. ستملأ الصفر إذا لزم الأمر لتلبية عدد ثابت من الأرقام. |
attachmentsDefExp | تعبيرات SQL | صورة، ملف صوتي، ملف | صورة، توقيع، ملف صوتي، ملف | تحدد مرفقات السؤال أو المعلم الحالي باستخدام الكلمة الأساسية $attachment. |
الكلمات الأساسية للتعبير
يسرد الجدول التالي جميع الكلمات الأساسية التي يمكن استخدامها في أحد التعبيرات:
كلمة أساسية | الوصف |
---|---|
$date | تدرج التاريخ والوقت الحاليين عند طباعة التقرير. افتراضيًا، تُخرج التاريخ الحالي باستخدام تنسيق موقعك المحلي. أمثلة:
|
$image | تدرج عنصر صورة في التقرير. استخدم طريقة src لتحديد عنوان URL للصورة. مثال:
|
$map | يُدرج عنصر خريطة في التقرير دون الإشارة إلى سؤال الاستطلاع. مثال:
|
$shape | تطبع الشكل الهندسي (نقطة أو متعدد الخطوط أو مضلع) للمعلم الحالي على إحدى الخرائط. أمثلة:
|
$attachment | تمثل المرفق الأول أو جميع المرافق للمعلم الحالي. أمثلة:
لتكرار جميع المرفقات، قم بتضمين علامات البدء والانتهاء.
|
$file | تمثل الملف الحالي عند تكرار ملفات متعددة لسؤال استطلاع مرفق أو مرفقات معلم. أمثلة:
|
$feature | تمثل المعلم الحالي داخل صفيف معالم. مثال:
|
$layers["<layername>"] أو $layers[<layerId>] | تسند أي طبقة حسب الاسم أو المعرف في خدمة المعالم نفسها كطبقة الاستطلاع. أمثلة:
|