ورقة الاستبيان

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

يمثل كل صف في ورقة survey سؤالاً أو ملاحظة أو مجموعة. وتوفر كل عمود معلومات حول كيفية سلوك ذلك السؤال.

إليك مثال بسيط لكيفية ظهوره:

النوع	الاسم	label	appearance	مطلوب	relevant	constraint	hint
begin_group	page1	صفحة المعلومات الشخصية	field-list
note	startnote	نحن نجري استبيانًا جديدًا، يرجى تعبئة الأسئلة التالية.
text	الاسم	ما هو اسمك الكامل؟		yes			أدخل اسمك الأول واسم العائلة.
integer	age	كم عمرك؟		yes		. >= 0 and . <= 120	يجب أن يكون بين 0 و120.
select_one sex	gender	ما هو جنسك؟			${age} >= 10		اختر خيارًا واحدًا.
end_group

🔑 شرح الأعمدة الرئيسية

1. النوع هذا يحدد نوع السؤال الذي تطرحه. الأنواع الشائعة:

• text – لإدخال نص

• integer أو decimal – للأرقام

• select_one list_name – لأسئلة الاختيار المفرد

• select_multiple list_name – لأسئلة الاختيار المتعدد

• note – لعرض نص ثابت

• begin group / end group – لتنظيم الأسئلة في المجموعات من صفحات أو مجموعات إجابات

select_one gender يعني أن الخيارات تأتي من قائمة باسم gender (التي سيتم تعريفها في ورقة Name).

2. Name

هذا هو اسم المتغير المستخدم داخليًا. يجب أن يكون:

• قصيرًا ووصفيًا

• أحرف صغيرة، بدون مسافات أو أحرف خاصة

• فريدًا داخل النموذج

اسم المتغير هو الكيفية التي ستُشار بها البيانات عند استخدام ميزات relevant وconstraint

3. Label

هذا هو نص السؤال الذي يراه المستخدم. كما يدعم عدة لغات إذا كنت بحاجة لإنشاء استبيان بلغات متعددة (مثل، label::English, label::French).

كن واضحًا وسهل الفهم للمستخدم. على سبيل المثال: “ما هو مسمى وظيفتك الحالية؟”

4. Appearance (اختياري)

تتيح خاصية appearance التحكم في خصائص إضافية لكل عنصر من عناصر النموذج. يدعم ngSurvey عدة خيارات appearance لتوليد مقاييس تقييم، صفحات، صندوق تعليقات، إدخالات مقنعة أو محاذاة مخصصة للحقول.

4. Required (اختياري)

اضبط على yes إذا كان يجب الإجابة على السؤال أو تقديم إجابة قبل المتابعة. إذا تُرك فارغًا يكون السؤال اختياريًا

5. Relevant (اختياري)

تُستخدم في Skip Logic. يظهر السؤال فقط إذا تحققت الحالة.

مثال: relevant: ${age} >= 18 سيظهر السؤال فقط إذا كان العمر 18 أو أكثر.

6. Constraint (اختياري)

تُستخدم للتحقق من صحة الإجابات باستخدام منطق إذا كانت الإجابة تعتمد على إدخال نصي.

مثال: . >= 0 and . <= 100 هذا يضمن أن الإدخال بين 0 و100. تمثل . القيمة إجابة السؤال الحالي.

7. Hint (اختياري)

نص مساعدة يظهر كتعليق توضيحي (?) للمستخدم لتفسير ما هو المتوقع عند تمريره بالمؤشر.