يدعم ArcGIS Survey123 إعداد instance_name في XLSForm. باستخدام إعداد instance_name، يمكن لمؤلف الاستطلاع التحكم في المعلومات المستخدمة لتعريف كل إجابة بشكل فريد في مجلدات الاستطلاع (مثل صندوق الصادر أو المُرسَل) عند الوصول إليها في Survey123 Mobile أو التطبيق الميداني Survey123.
يكون اسم المثيل مفيدًا عند النظر إلى سجل الاستطلاعات المرسلة في مجلد المُرسَل أو لتعريف الاستطلاعات الفردية مثل مثال Survey123 Mobile التالي لصندوق الصادر.
في هذا المثال، تم تطبيق التعبير التالي على اسم المثيل إلى الإجابات عن سؤالين نصيين مفصول بينهما بمسافة كمعرِف لكل سجل استطلاع (في هذه الحالة، الاسم الكامل للشخص):
concat(${first_name}, ' ', ${last_name})
تم تعريف اسم المثيل في ورقة عمل الإعدادات الخاصة بـ XLSForm. عندما يكون عمود instance_name فارغًا، سيتم تطبيق اسم مثيل افتراضي يسرد جميع الإجابات عن الأسئلة الواردة في الاستطلاع. اكتب تعبيرًا في عمود instance_name لتخصيص اسم المثيل. فيما يلي أحد الأمثلة:
${site_name}
format-date(${date_time}, '%Y-%m-%d')
concat(${category}, ' Remarks: ', ${remarks})
concat(${street_number}, ' ', ${street_name}, ' ', ${suburb})
يمكنك استخدام العمليات الحسابية لإنشاء اسم المثيل، مثل:
${first_number} + ${second_number}
يمكنك أيضًا تطبيق تنسيق HTML على اسم المثيل. يجب عليك تسلسل بناء جملة HTML كجزء من اسم المثيل باستخدام وظيفة concat(). في المثال التالي، تم تنسيق اسم المثيل بنص أزرق مائل، مع كتابة الاسم الأخير بخط عريض:
concat('<font color="blue"><i><b>', ${last_name}, '</b>, ', ${first_name}, '</i></font>')
تلميح:
إذا كان بناء جملة HTML يتضمن علامات اقتباس، يجب عليك استخدام علامات اقتباس فردية لإحاطة سلسلة نصية تحتوي على علامات اقتباس مزدوجة، أو العكس، على سبيل المثال، '<font color="yellow">'.
تعرض أسماء المثيل ثلاثة أسطر من النص بحد أقصى.
يستخدم المثال التالي عبارة if() لتطبيق التنسيق الشرطي على اسم المثيل. إذا كانت الإجابة عن سؤال approved هي yes، يكون اسم المثيل ملونًا باللون الأخضر؛ وإلا فباللون الأحمر:
if(${approved}='yes', concat('<font color="green"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'), concat('<font color="red"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'))
