نافذة المعاينة — معاينة الكتلة في النافذة المنبثقة
PreviewModal — نافذة إعدادات مشتركة لجميع شاشات Wave-2، تعرض نتيجة عمل الكتلة في الوقت الحقيقي. تفتح بواسطة زر «فتح في نافذة منبثقة» على شاشات الإعدادات.
لماذا تحتاج إلى ذلك
عندما تقوم بإعداد الكتلة (استراتيجية، فلاتر، جمهور) — ترغب في فهم أي المنتجات ستظهر في النتائج مع هذه الإعدادات. تتيح لك PreviewModal التحقق من ذلك دون نشر الكتلة على الموقع ودون التبديل بين لوحة الإدارة والواجهة الأمامية.
علامة التبويب الأساسية — قائمة المنتجات
العلامة الأولى — Basic. تعرض جدول المنتجات الذي سيعيده API مع الإعدادات الحالية للكتلة:
- يتم تحميل البيانات بالتدريج عبر مكون
NewBlockPreviewTable. - في الجدول — معاينة للبطاقات (الاسم، الصورة، العلامة، بيانات وصفية مختصرة).
- يتم تحديث القائمة تلقائيًا عند تغيير إعدادات الكتلة على الشاشة الرئيسية.
علامة التبويب التحقيق — التشخيص
العلامة الثانية — Investigate — ضرورية للتصحيح. هنا يمكنك رؤية ما حدث "تحت الغطاء" عند تشكيل النتائج:
| الحقل | ماذا يعني |
|---|---|
| appliedAudienceRule | ما هو قاعدة الجمهور التي تم تطبيقها على الطلب الحالي. انظر فلتر الجمهور. |
| warnings | التشخيص — على سبيل المثال، "مجموعة الخصائص فارغة"، "تم اختيار منتجات غير من الفئة المختارة". |
| fallbackUsed | علامة: هل تم تشغيل مسار الاحتياطي (عرض المنتجات الرائجة). |
| contextEcho | صدى سياق الطلب — ما الذي حصلت عليه النظام فعليًا (معرف المستخدم، السلة، الفئات المختارة، إلخ). |
إذا لم يعد الخادم أي حقل — يتم ببساطة إخفاء القسم المعني في Investigate، دون أخطاء. تم ذلك لتطوير API بشكل سلس.
معرف المستخدم المحاكي — معاينة "باسم" المستخدم
تحت حقل المعاينة يوجد إدخال Simulated user ID. أدخل معرف أي مستخدم — ستقوم المعاينة ببناء النتيجة كما لو أن الطلب جاء منه. مفيد لـ:
- التحقق من التوصيات الشخصية (التوصيات الشخصية، الشراء المتكرر) لعميل معين؛
- إعادة إنتاج شكوى من نوع "لدي منتجات غير صحيحة في الكتلة" — أدخل معرفه وانظر ماذا سيرى.
بدون تحديد معرف المستخدم المحاكي، تستخدم المعاينة سياقك الإداري الخاص، وقد تكون النتائج للكتل المخصصة فارغة أو غير ذات صلة.
حق الوصول blocks.preview
يتم التحكم في الوصول إلى نقطة النهاية الإدارية لمعاينة الكتلة بواسطة حق منفصل blocks.preview في شجرة الحقوق.
هذا يسمح بـ:
- منح دور يقوم بتحرير الكتل، دون الوصول إلى المعاينة (على سبيل المثال، لمديري المحتوى "فقط النموذج").
- إخفاء بيانات حساسة عن بعض الإداريين، والتي قد تتكشف من خلال Investigate (سياق الطلب، صدى المعلمات).
للمطورين وQA — امنح دائمًا blocks.preview. لمديري المحتوى — فقط إذا كانوا بحاجة لرؤية النتائج الفعلية للكتلة قبل النشر.