يخزن الحقل hidden قيمة لا تُعرض أبداً للمستجيب. بخلاف calculate (الذي يحسب قيمة)، يُستخدم hidden لحمل قيمة مُقدَّمة خارجياً — على سبيل المثال معرّف مهمة أو معرّف أسرة ممرر من نظام آخر أو رمز معدِّد محقون عند تشغيل النموذج.

مواصفة XLSForm الأساسية

typenamelabel
hiddenhousehold_id

التسميات غير مطلوبة للحقول المخفية لأنه لا شيء يُصيَّر على الشاشة.

الاستخدامات

تُستخدم الحقول المخفية شائعاً لـ:

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

ضبط قيمة افتراضية

النمط الأكثر شيوعاً هو استخدام hidden مع تعبير default حتى تُضبط القيمة عند فتح النموذج:

typenamedefault
hiddendeployment_code‘ZONE_A_2024’
hiddenform_version‘3.1’

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

  1. استخدم hidden (وليس calculate) عندما تكون القيمة محقونة خارجياً ولا يجب إعادة حسابها.
  2. استخدم calculate عندما تكون القيمة مشتقة من حقول أخرى في النموذج.
  3. اضبط دائماً default إذا كان يجب أن يحتوي الحقل المخفي على قيمة — الحقل المخفي بدون قيمة افتراضية سيكون فارغاً.

القيود

  • تُدرَج الحقول المخفية في البيانات المصدَّرة مثل أي حقل آخر.
  • لا يمكن عرضها شرطياً — هي دائماً موجودة (لكن غير مرئية).
هل كانت هذه الصفحة مفيدة؟