توكنات البوابة

رموز البوابة

يحمل رمز البوابة النطاق TenantActiveSurveys. يفتح صفحة هبوط على مستوى المؤسسة تعرض الاستبيانات النشطة المؤهلة لتدفق البوابة العام، بحيث يستطيع الزائر اختيار أحدها والإجابة عليه.

الغرض

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

من ينشئه

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

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

يفتح الزائر صفحة هبوط بعنوان مثل "اختر استبيانًا". تعرض هذه الصفحة استبيانات المؤسسة النشطة والمنشورة حاليًا على هيئة بطاقات. وعندما لا توجد استبيانات نشطة، تعرض صفحة الهبوط رسالة حالة فارغة بدلًا من البطاقات.

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

• رؤية قائمة الاستبيانات المؤهّلة في صفحة الهبوط.
• اختيار استبيان وتحديد فتح الاستبيان لبدئه.
• الإرسال بشكل مجهول عند تفعيل AllowAnonymousSubmission. ويستطيع مستخدم مؤسسة مؤهل إرسال مصادقة JWT حتى تُنسب إليه الاستجابة ذات المصدر العام.
• العودة إلى البوابة وإكمال استبيان آخر.
• التقديم مرة أخرى إذا فعّلت خيار التقديمات المتعددة.

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

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

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

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

دليل الحقول

لا توجد عمدًا قائمة منسدلة للاستبيان في هذه الصفحة: فرمز البوابة على مستوى المؤسسة، بينما تبقى أهلية الاستبيان العام في الخادم هي المرجع.

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

إذا ضبطت ينتهي في، تتوقف البوابة عن الفتح بعد تلك اللحظة. لا يمكن للرمز المنتهي فتح صفحة الهبوط الخاصة به.

رمز المرور

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

الإلغاء

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

حد الخطة

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

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

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

مثال عملي

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

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

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

عندما يفتح الزائر استبيانًا محددًا من صفحة الهبوط، يُوصَل إلى صفحة الاستبيان عبر:

https://example.com/portal/{token}/open/{surveyId}

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

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