توكنات العرض

رموز العارض

رمز العارض هو أحد أنواع رموز الوصول الثلاثة في Survanta. وهو للقراءة فقط: يفتح صفحةً تعرض نتائج الاستبيانات لزائرٍ لا يملك حسابًا في Survanta. ولا يمكن للزائر مطلقًا تقديم أي إجابة أو تعديلها.

الغرض

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

من ينشئه

ينشئ مستخدم مؤسسة مخول بصلاحية إدارة توكنات العارض رمز العارض من لوحة التحكم. ويحتاج موظفو المنصة إلى صلاحية System المطابقة وسياق مؤسسة محددة.

ما يراه الزائر

يفتح الزائر صفحة نتائج للقراءة فقط. تعرض جدولًا بالإجابات المقدَّمة، بأعمدة مثل الاستبيان وتاريخ التقديم والحالة وعدد الإجابات. يظهر ترقيم الصفحات عند وجود إجابات كثيرة. ويظهر زر التصدير فقط إذا كان التصدير مُفعّلًا. وإذا كانت تفاصيل الإجابة الكاملة مُفعّلة، يرتبط كل صف بصفحة تفاصيل.

ما يستطيع الزائر فعله

يستطيع الزائر فعل ما تسمح به الإمكانات المُفعّلة فقط، وضمن نطاق الرمز فقط:

• عرض الإجابات المقدَّمة — قراءة جدول النتائج.
• عرض تفاصيل الإجابة الكاملة — فتح صفحة تفاصيل لإجابة واحدة.
• عرض قوالب الإجابات — رؤية قوالب الإجابات.
• عرض الإجابات المقدَّمة الخاصة به — يُرجع هذا نتيجة فارغة لرابط عارض بلا حساب، لأن الرمز لا يحدّد هوية مُجيب.
• تصدير الإجابات — تنزيل تصدير بصيغة JSON للإجابات.

ما لا يستطيع الزائر فعله

• تقديم إجابة جديدة أو تعديل أي إجابة.
• رؤية بيانات خارج نطاق الرمز.
• رؤية استبيانات أو بيانات تخص أي مؤسسة أخرى.
• رؤية عناصر تنقّل أو شاشات لوحة التحكم.

خطوات الإنشاء

1. افتح لوحة التحكم.
2. في الشريط الجانبي، افتح روابط ورموز الوصول (Access Links & Tokens) واختر رموز العارض.
3. افتح صفحة إنشاء رمز عارض (Create Viewer Token).
4. اضبط نطاق الاستبيان، واختر الإمكانات المراد تفعيلها، واضبط أي حقول اختيارية أخرى.
5. اختر إنشاء.
6. في الصفحة الصادرة، استخدم زر نسخ لنسخ الرابط الذي يظهر مرة واحدة (أو فتح لمعاينته).
7. شارك الرابط المنسوخ مع جمهورك المستهدف عبر قناة آمنة.

دليل الحقول

لا تُعرَض على صفحة الزائر إلا الإمكانات المُفعّلة.

انتهاء الصلاحية

حقل ينتهي في إلزامي. ترفض الخدمة القيمة المفقودة أو الماضية أو المتجاوزة للحد الأقصى. لا يمكن للرمز المنتهي فتح صفحة النتائج.

رمز المرور

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

الإلغاء

يمكنك إلغاء رمز العارض في أي وقت من لوحة التحكم. الإلغاء إجراء من نوع POST محميّ بمكافحة التزوير (antiforgery). بمجرد الإلغاء، لا يمكن للرمز فتح صفحة النتائج الخاصة به بعد ذلك.

حد الخطة

يحكم عدد رموز العارض النشطة وغير المنتهية حد رموز المشاهدين. وعند تخفيض الخطة، تحتفظ المصالحة بأقدم الرموز المسموحة وتلغي الرموز الأحدث الزائدة؛ ولا تستهلك الرموز المنتهية السعة.

عرض الرابط لمرة واحدة

يظهر الرابط الخام مرة واحدة فقط، في الصفحة الصادرة، مباشرةً بعد إنشائه، مع زرّي نسخ وفتح. ولا يمكن استرجاعه لاحقًا أبدًا، ولا يُخزَّن بصورته الخام أبدًا؛ إذ يُحتفظ بقيمة مجزّأة (hash) فقط. تعرض صفحات القوائم والتفاصيل بيانات وصفية آمنة فقط — الاسم والنطاق والحالة ونافذة التوافر وسعة الاستخدام — ولا تعرض الرابط الخام أو قيمته المجزّأة أبدًا. إذا فقدت الرابط، أنشئ رابطًا جديدًا وألغِ القديم.

مثال عملي

تريد منح عميل خارجي وصولًا للقراءة فقط إلى نتائج مسموح بها. أنشئ رمز عارض، واضبط نطاق الاستبيان (جميع الاستبيانات المسموح بها، أو استبيانًا واحدًا محددًا)، وفعّل عرض الإجابات المقدَّمة واختياريًا عرض تفاصيل الإجابة الكاملة وتصدير الإجابات، وانسخ الرابط الذي يظهر مرة واحدة، وأرسله إلى العميل. يمكنه قراءة النتائج لكنه لا يستطيع مطلقًا تقديم أي شيء أو تغييره.

المسار العام الناتج

https://example.com/viewer/{token}

عند تفعيل تفاصيل الإجابة الكاملة، يُوصَل إلى إجابة واحدة عبر:

https://example.com/viewer/{token}/details/{responseId}

عند تفعيل التصدير، يُوصَل إلى تصدير JSON عبر:

https://example.com/viewer/{token}/responses/export

يُملأ العنصر النائب {token} بالقيمة التي تظهر مرة واحدة في الصفحة الصادرة.

استكشاف الأخطاء وإصلاحها