المتغيرات

نظرة عامة

تتيح لك المتغيرات في NueForm إنشاء تجارب نماذج ديناميكية ومخصصة. يمكنك الإشارة إلى إجابات المستجيبين ومعاملات URL ومتغيرات النموذج المخصصة في أي مكان في عناوين أسئلتك وأوصافها وشاشات الترحيب وشاشات الشكر باستخدام صيغة الاستبدال {variableName}.

أنواع المتغيرات

يدعم NueForm ثلاثة أنواع من المتغيرات:

1. متغيرات الإجابات

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

كيفية الإعداد:

1. حدد سؤالًا في مُنشئ النماذج.
2. في إعدادات السؤال، ابحث عن حقل متغير الإجابة.
3. أدخل اسم متغير (مثل name أو company أو rating).
4. تُخزن إجابة المستجيب على ذلك السؤال الآن كـ {name} أو {company} أو {rating}.

مثال:

• السؤال 1: "ما اسمك؟" (متغير الإجابة: name)
• عنوان السؤال 2: "سررت بلقائك، {name}! ما الذي أتى بك اليوم؟"

عندما يكتب المستجيب "سارة" للسؤال 1، سيعرض السؤال 2: "سررت بلقائك، سارة! ما الذي أتى بك اليوم؟"

تحويل القيم:

2. متغيرات URL

متغيرات URL هي قيم تُمرر إلى النموذج عبر معاملات استعلام URL. تكون متاحة فورًا عند تحميل النموذج، قبل الإجابة على أي أسئلة.

كيفية الاستخدام:

أضف معاملات استعلام إلى رابط نموذجك:

https://nueform.io/f/my-form?firstName=John&company=Acme&source=email

تصبح هذه المعاملات متاحة تلقائيًا كمتغيرات:

• {firstName} يتحول إلى "John"
• {company} يتحول إلى "Acme"
• {source} يتحول إلى "email"

حالات الاستخدام:

• ملء حقول النموذج مسبقًا ببيانات معروفة.
• تخصيص التحيات: "مرحبًا {firstName}، لدينا بعض الأسئلة لك."
• تتبع مصادر الإحالة في بيانات ردودك.
• توجيه المستجيبين باستخدام قفزات منطقية بداية بناءً على معاملات URL.

3. متغيرات النموذج

متغيرات النموذج هي متغيرات محددة مسبقًا باسم ونوع وقيمة افتراضية. تُعرّف على مستوى النموذج ويمكن تعديلها بواسطة إجراءات المتغيرات في القفزات المنطقية.

كيفية التعريف:

تُعرّف متغيرات النموذج في تعريفات متغيرات النموذج ولها الخصائص التالية:

كيف يتم تعديلها:

تُعدّل متغيرات النموذج من خلال إجراءات المتغيرات على القفزات المنطقية. عندما يتطابق شرط قفزة منطقية، تُنفذ إجراءات المتغيرات المرتبطة بها:

مثال: بناء حاسبة نقاط

1. عرّف متغير نموذج: score (النوع: number، الافتراضي: 0).
2. على كل سؤال، أضف قفزات منطقية مع إجراءات متغيرات:
   • إذا كان التقييم >= 4، أضف 10 إلى score.
   • إذا كان التقييم >= 2، أضف 5 إلى score.
3. على شاشة الشكر: "مجموع نقاطك {score} من 50."

صيغة الاستبدال

تعمل صيغة {variableName} في المواقع التالية:

كيف يعمل الاستبدال

1. يفحص النظام النص بحثًا عن أنماط {variableName} (أقواس معقوفة مفردة مع أحرف كلمة بداخلها).
2. يبحث عن اسم المتغير في خريطة المتغيرات الحالية.
3. إذا وُجد، يُستبدل الرمز بقيمة المتغير.
4. إذا لم يُوجد، يُستبدل الرمز بسلسلة فارغة.

اكتشاف المتغيرات

يكتشف NueForm تلقائيًا جميع المتغيرات المُشار إليها عبر نموذجك من خلال فحص:

• رموز {variableName} في جميع حقول النص (العناوين، الأوصاف، شاشات الترحيب/الشكر).
• الحقول ذات البادئة url: في شروط القفزات المنطقية.
• أسماء المتغيرات في إجراءات القفزات المنطقية.
• تصريحات answerVariable على الأسئلة.
• تعريفات المتغيرات على مستوى النموذج.

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

ترتيب حل المتغيرات

عند حل رمز {variableName}، يتحقق NueForm من المتغيرات بهذا الترتيب:

1. متغيرات URL — المُمررة عبر رابط النموذج.
2. متغيرات الإجابات — المُعيّنة من إجابات المستجيب على الأسئلة التي تم تكوين answerVariable لها.
3. متغيرات النموذج — المُعرّفة على مستوى النموذج والمُعدّلة بإجراءات القفزات المنطقية.

إذا وُجد نفس اسم المتغير في مصادر متعددة، تأخذ متغيرات URL الأولوية.

أمثلة

ترحيب مخصص

الرابط: https://nueform.io/f/feedback?name=Sarah&product=Widget

عنوان الترحيب: "مرحبًا {name}!" وصف الترحيب: "نود سماع أفكارك حول {product}."

النتيجة: "مرحبًا Sarah!" / "نود سماع أفكارك حول Widget."

أسئلة متابعة ديناميكية

السؤال 1: "ما دورك؟" (متغير الإجابة: role) السؤال 2: "بصفتك {role}، ما أكبر تحدٍّ تواجهه؟"

عرض النقاط المحسوبة

متغير النموذج: score (رقم، الافتراضي: 0) إجراءات القفزة المنطقية: إضافة نقاط بناءً على الإجابات وصف شاشة الشكر: "حصلت على {score} نقطة! شكرًا لإكمال الاختبار."

التوجيه المشروط مع متغيرات URL

الرابط: https://nueform.io/f/survey?plan=enterprise

قفزة منطقية البداية:

• الشرط: url:plan يساوي "enterprise"
• الوجهة: الانتقال إلى أسئلة خاصة بالمؤسسات
• الإجراء: تعيين plan_name إلى "Enterprise"

أفضل الممارسات

1. استخدم أسماء وصفية: اختر أسماء متغيرات تدل بوضوح على ما تخزنه (مثل customer_name بدلًا من n).
2. عيّن قيمًا افتراضية: لمتغيرات النموذج، قدم دائمًا قيمة افتراضية ذات معنى في حالة عدم تعديل المتغير أبدًا.
3. اختبر مع معاملات URL: عند استخدام متغيرات URL، اختبر نموذجك بتركيبات معاملات مختلفة لضمان عمل جميع المسارات بشكل صحيح.
4. تعامل مع المتغيرات المفقودة بأناقة: إذا كان متغير URL قد لا يُقدم، صمم نصك بحيث يُقرأ بشكل طبيعي حتى عندما يتحول المتغير إلى سلسلة فارغة.