تعبيرات التقرير

يمكن عرض الإجابة عن سؤال في قالب تقرير عن طريق توفير اسمه بين أقواس متعرجة {}، مسبوقًا بعلامة الدولار. يجب وضع أي قيمة سلسلة مضمنة في تعبير ما بين علامتي اقتباس مزدوجتين.

يعرض المثال التالي الإجابة من سؤال نصي يسمى 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

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

أمثلة:

${$date | format:"MM/DD/YYYY"}
$($date | utcOffset:"+08:00"}
$($date | locale:"zh-cn"}

$image

تدرج عنصر صورة في التقرير. استخدم طريقة src لتحديد عنوان URL للصورة.

مثال:

${$image | src:"https://upload.wikimedia.org/wikipedia/commons/1/13/Esri_Headquarters%2C_Building_Q.jpg"}

$map

يُدرج عنصر خريطة في التقرير دون الإشارة إلى سؤال الاستطلاع.

مثال:

${$map | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$shape

تطبع الشكل الهندسي (نقطة أو متعدد الخطوط أو مضلع) للمعلم الحالي على إحدى الخرائط.

أمثلة:

${$shape}
${$shape | map:"10df2279f9684e4a9f6a7f08febac2a9" | mapScale:4000000 | size:200:100}

$attachment

تمثل المرفق الأول أو جميع المرافق للمعلم الحالي.

أمثلة:

${$attachment | getValue:"name"}
${$attachment | getValue:"size"}
${$attachment | size:200:300}

لتكرار جميع المرفقات، قم بتضمين علامات البدء والانتهاء.

${#$attachment}
${$file}
${/}

$file

تمثل الملف الحالي عند تكرار ملفات متعددة لسؤال استطلاع مرفق أو مرفقات معلم.

أمثلة:

${#image1}
${$file | size:460:0}
{/}

${#$attachment}
${$file | getValue:"position"}. ${$file | getValue:"name"}
${/}

$feature

تمثل المعلم الحالي داخل صفيف معالم.

مثال:

{#repeat1}
{$feature | getValue: "position"}
{/}

$layers["<layername>"] أو

$layers[<layerId>]

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

أمثلة:

${$layers["cities"] | where:”1=1 !important” | stats:”count,objectid”}
${#$layers["states"]}...${/}