دوال لوحة المعلومات و Break By

عند بناء عنصر مخطط في لوحة العرض، تجمع بين ثلاثة مفاهيم:

1. المتغيّر -سؤال من إعداد اللوحة (مثل Q1).
2. الدالة (Function) -طريقة تجميع الإجابات على ذلك المتغيّر (count، exists، أو nps حيث يُسمح).
3. Break By (اختياري) -تقسيم المقياس حسب متغيّر آخر، أو حسب نفس السؤال لعرض صف أو عمود لكل خيار إجابة.

تشرح هذه الصفحة ماذا تفعل كل دالة، وكيف يغيّر Break By شكل النتيجة، وكيف تختلف أسئلة الاختيار المتعدد عن الاختيار الواحد.

أين تُعدَّل الإعدادات

في منشئ اللوحة، افتح إضافة عنصر أو تعديل عنصر → إضافة مقاييس (متغيّر + دالة) → اختيار Break By (اختياري). نفس قواعد المقاييس تنطبق على اللوحة وعلى صفحة إضافة/تعديل العنصر.

---

أنواع العناصر والدوال المدعومة

نوع العنصر	COUNT	EXISTS	NPS	Break By
مخطط أعمدة / دائري / خط / مساحة	نعم	نعم	لا	نعم
مخطط NPS	لا	لا	نعم (فقط)	لا
نص غني (مقاييس مضمّنة)	نعم	نعم	نعم	لكل مقياس

---

دعم COUNT و EXISTS و NPS حسب نوع السؤال

COUNT و EXISTS متاحان لجميع أنواع الأسئلة التي تخزّن إجابات في إعداد اللوحة، على عناصر الأعمدة والدائري والخط والمساحة والنص الغني (وليس على عنصر مخطط NPS المخصص الذي يستخدم NPS فقط).

العائلة	COUNT	EXISTS	NPS	Break By (كبُعد)	Break By = نفس السؤال
الاختيار (single_choice، multiple_choice، القوائم المنسدلة)	نعم	نعم	لا	نعم	نعم -توزيع
مقياس NPS (nps_scale، nps_advanced)	نعم	نعم	نعم	نعم	نعم
صف NPS متعدد (bindable)	نعم	نعم	نعم	لا	لا
سؤال متابعة داخلي في NPS متقدم	نعم	نعم	لا	نعم	نعم
التقييم (rating_single، rating_advanced)	نعم	نعم	لا	نعم	نعم
النص، الرفع، الوسائط، جهة الاتصال، اختبار النموذج	نعم -عدد المستجيبين الذين أجابوا	نعم	لا	لا	لا
نص متعدد / رفع متعدد لكل صف	نعم (لكل صف)	نعم	لا	لا	لا
الترتيب (كل أنواع الترتيب)	نعم	نعم	لا	نعم	نعم
text_multiple / upload_multiple (بدون مرجع صف)	لا	لا	لا	لا	لا
nps_multiple / rating_multiple (بدون مرجع صف)	لا	لا	لا	لا	لا

كيف تُقرأ COUNT على أنواع الحضور

متغيّرات النص والرفع والوسائط وجهة الاتصال واختبار النموذج تقيس هل أجاب أحد، وليس توزيع نص الإجابة أو الملفات.

الإعداد	نتيجة COUNT
بدون Break By	إجمالي المستجيبين بإجابة غير فارغة قابلة للعد (يُستبعد الفارغ و N/A).
Break By = سؤال آخر	المستجيبون الذين أجابوا على سؤال القيمة، مجمّعون حسب شرائح Break By (مثل إرسالات جهة الاتصال حسب المنطقة).
Break By = نفس السؤال	غير مدعوم -لا توجد قائمة خيارات للتقسيم. استخدم Break By على متغيّر اختيار أو NPS أو تقييم أو ترتيب.

متى تستخدم أي دالة

• COUNT -عندما تحتاج «كم عدد» (إجماليات أو أعداد لكل شريحة).
• EXISTS -عندما تحتاج فقط نعم/لا (1 / 0) لكل شريحة أو إجمالًا.

معلومات جهة الاتصال هي متغيّر لوحة واحد للسؤال كاملًا (وليس متغيّرات منفصلة لكل حقل). يمكن أن تكون جهة الاتصال قيمة في المقياس (مثل COUNT(Contact) مقسّمًا حسب المنطقة) لكن لا يمكن اختيارها كبُعد Break By.

---

كيف تُقرأ COUNT و EXISTS و Break By

الدالة	بدون Break By	Break By = سؤال آخر	Break By = نفس السؤال
COUNT	إجمالي واحد	صف أو عمود لكل شريحة	صف أو عمود لكل خيار إجابة
EXISTS	1 أو 0	0 / 1 لكل شريحة	0 / 1 لكل خيار
NPS	درجة NPS + شرائح المروّجين/المحايدين/المنتقدين (مخطط NPS أو NPS() في النص الغني فقط)	-	-

على المخططات، النتيجة العددية الواحدة (scalar) هي رقم واحد؛ النتيجة السلسلية (series) هي قيمة لكل تسمية Break By. NPS لا يستخدم Break By على عنصر مخطط NPS.

---

أنواع أسئلة الاختيار (COUNT + EXISTS)

تنطبق هذه القواعد على متغيّرات الاختيار لـ COUNT و Break By التوزيعي:

نوع السؤال	ما يمكن للمستجيب اختياره
اختيار واحد / قائمة منسدلة (واحد)	خيار واحد
اختيار متعدد / قائمة منسدلة (متعدد)	خيار واحد أو أكثر

---

الدوال المتاحة اليوم

الدالة	قيمة API	ماذا تقيس	هل يُسمح بـ Break By؟	أنواع العناصر
COUNT	count	عدد الإجابات التي تُحسب في المقياس	نعم	المخططات، النص الغني
EXISTS	exists	هل توجد أي إجابة قابلة للعد (1 أو 0)	نعم	المخططات، النص الغني
NPS	nps	مؤشر صافي الترويج على متغيّرات مقياس NPS	لا	مخطط NPS؛ رموز NPS() في النص الغني

COUNT

الدالة الافتراضية لمعظم المخططات.

الإعداد	النتيجة
متغيّر فقط (بدون Break By)	رقم واحد -كم مستجيبًا أعطى إجابة قابلة للعد على ذلك السؤال (تُستبعد الفارغة و N/A).
Break By = نفس السؤال	مخطط توزيع -عمود لكل خيار إجابة. هذه الطريقة المعيارية لعرض «كيف تتوزع الإجابات».
Break By = سؤال آخر	عمود لكل خيار في سؤال التقسيم -المستجيبون الذين أجابوا على سؤال القيمة، مجمّعون حسب سؤال Break By (مثل الرضا حسب المنطقة).

EXISTS

علم نعم/لا للوجود:

• بدون Break By: يعيد 1 إذا أعطى مستجيب واحد على الأقل إجابة قابلة للعد على سؤال القيمة؛ وإلا 0.
• مع Break By: يعيد سلسلة من 0 أو 1 لكل بُعد تقسيم -1 عندما يجيب مستجيب واحد على الأقل في ذلك التقسيم على سؤال القيمة (أو عندما اُختير الخيار في التقسيم بنفس السؤال).

لتوزيع الإجابات، يُفضَّل COUNT مع Break By = نفس السؤال. عرض النسبة المئوية مع EXISTS يستخدم نسبة ثنائية (100% / 0% لكل عمود). تظهر خيارات إظهار الصفر والنسبة عند تعيين Break By.

---

Break By عمليًا

Break By لا يغيّر أي استجابات تُدرج في الحساب. يغيّر فقط كيف تُجمَّع النتيجة على المخطط.

flowchart LR
  V[متغيّر القيمة + الدالة] --> R{Break By؟}
  R -->|لا| S[قيمة واحدة -scalar]
  R -->|نفس السؤال| D[سلسلة -عمود لكل خيار]
  R -->|سؤال آخر| X[سلسلة -عمود لكل تقسيم]

أهداف شائعة للمؤلف

الهدف	الدالة	Break By	شكل المخطط
كم شخصًا أجاب؟	COUNT	-	قيمة واحدة
توزيع الإجابات	COUNT	نفس السؤال	عمود لكل خيار
مقياس حسب شريحة (منطقة، فريق، …)	COUNT	سؤال آخر	عمود لكل شريحة
هل أجاب أحد أصلًا؟	EXISTS	-	1 أو 0
وجود حسب شريحة	EXISTS	سؤال آخر	0/1 لكل شريحة
كم أرسلوا معلومات الاتصال؟	COUNT	سؤال آخر (مثل المنطقة)	عدد لكل شريحة
كم أجابوا (نص حر)؟	COUNT	-	إجمالي واحد

نفس السؤال = توزيع

في لوحات بأسلوب XEBO، توزيع الإجابات ليس دالة منفصلة. هو COUNT مع Break By = نفس المتغيّر المستخدم في القيمة.

---

أسئلة الاختيار المتعدد

في الاختيار المتعدد والقائمة المنسدلة متعددة الخيارات، يمكن للمستجيب اختيار عدة خيارات. مع Break By = نفس السؤال، يحسب COUNT الاختيارات لكل خيار (إذا اختار شخص A و B، يزيد كل من A و B بمقدار 1).

الدالة	بدون Break By	Break By = نفس السؤال
COUNT	مستجيبون مميزون بـ اختيار واحد على الأقل	اختيارات لكل خيار
EXISTS	1 إذا اُختير أي خيار	لكل خيار: 1 إذا اُختير مرة، وإلا 0

مثال: 3 مستجيبين -R1 يختار A+B، R2 يختار A، R3 يختار B+C.

الخيار	COUNT (توزيع)
A	2 (R1 + R2)
B	2 (R1 + R3)
C	1 (R3)

استخدم COUNT عندما يجب أن تعكس الأعمدة كم مرة اُختير كل خيار (بما في ذلك إجماليات الاختيار المتعدد لكل خيار).

---

خيارات العرض (ليست دوال)

هذه الإعدادات تؤثر على تسميات المخطط، وليس على التجميع الأساسي:

الخيار	التأثير
إظهار العدد	الأعمدة تعرض الأرقام الخام (افتراضي).
إظهار النسبة المئوية	الأعمدة تعرض النسبة من الإجمالي (لمخططات السلسلة / التوزيع).
إظهار القيم الصفرية	تضمين خيارات الإجابة ذات 0 استجابة ليظهر القائمة الكاملة على المحور.

---

دوال مخططة لاحقًا

خارطة الطريق تتبع قائمة دوال XEBO. هذه غير متاحة في منشئ اللوحة بعد:

الدالة	تتطلب
SUM، AVG، MIN، MAX، CSAT	نقاط التقييم (Score points) على كل خيار في منشئ الاستبيان (نفس فكرة «Recode» في XEBO)
DIFF، MULTIPLY، DIVIDE، SQRT، FLOOR	عناصر بصيغ رياضية + نقاط التقييم

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

---

نصائح

1. مخطط توزيع → COUNT + Break By = نفس السؤال.
2. مقارنة شرائح → COUNT + Break By = متغيّر إعداد آخر.
3. إجماليات خيارات الاختيار المتعدد → COUNT + Break By = نفس السؤال.
4. بعد تغيير خيارات الاستبيان (إضافة/حذف/إعادة ترتيب)، أعد حفظ إعداد اللوحة إذا كنت تستخدم نطاق استجابات مثبت حتى تبقى التسميات متوافقة.