للقراءة فقط
تُتيح حقول “للقراءة فقط” في rtSurvey عرض معلومات لا يمكن للمستجيب تعديلها. هذه الميزة مفيدة بشكل خاص لعرض البيانات المُعبأة مسبقاً أو النتائج المحسوبة أو المعلومات التي يجب أن تبقى ثابتة طوال الاستطلاع.
الاستخدام الأساسي
لجعل حقل للقراءة فقط، استخدم عمود read_only في XLSForm:
| type | name | label | read_only | default |
|---------|------|----------------------|-----------|---------|
| integer | num | رقم المريض هو: | yes | 5 |
في هذا المثال، رقم المريض مضبوط على 5 ولا يمكن للمستجيب تغييره.
الجمع بين للقراءة فقط والقيم الافتراضية
كثيراً ما تُستخدم حقول “للقراءة فقط” مع القيم الافتراضية لعرض معلومات محددة مسبقاً أو محسوبة:
| type | name | label | read_only | default |
|---------|----------|---------------------|-----------|----------------|
| text | username | المستخدم المسجَّل: | yes | ${current_user}|
| date | today | تاريخ اليوم: | yes | today() |
هنا، يُعرض اسم المستخدم والتاريخ الحالي لكن لا يمكن تعديلهما.
الميزات الخاصة بـ rtSurvey
للقراءة فقط الشرطي
يوسّع rtSurvey وظيفة “للقراءة فقط” بالمنطق الشرطي:
| type | name | label | read_only |
|---------|----------|-----------------|--------------------------|
| integer | age | العمر: | ${role} = 'viewer' |
| text | comments | التعليقات: | selected(${status}, 'closed') |
في هذه الأمثلة:
- حقل “العمر” للقراءة فقط إذا كان دور المستخدم “viewer”.
- يصبح حقل “التعليقات” للقراءة فقط إذا كانت الحالة “closed”.
حالة القراءة فقط الديناميكية
يُتيح rtSurvey تغيير حالة “للقراءة فقط” ديناميكياً:
| type | name | label | read_only |
|-----------|----------|----------| ----------------------|
| text | address | العنوان: | ${edit_mode} = 'false' |
هذا يُتيح التبديل بين أوضاع التعديل والقراءة فقط بناءً على شروط أو إجراءات مستخدم معينة.
أفضل الممارسات لاستخدام حقول القراءة فقط
- الوضوح: أشر بوضوح إلى الحقول التي هي للقراءة فقط عبر إشارات مرئية أو تسميات.
- الاتساق: استخدم حقول “للقراءة فقط” باتساق عبر استطلاعك.
- التحقق: حتى لو كانت حقول “للقراءة فقط” لا يمكن تعديلها، أدرجها في عملية التحقق من البيانات.
- الأداء: توخَّ الحذر مع الحسابات المعقدة في حقول “للقراءة فقط”، لأنها قد تؤثر على وقت تحميل النموذج.
- إمكانية الوصول: تأكد من تمييز حقول “للقراءة فقط” بشكل صحيح لقارئات الشاشة.
تقنيات متقدمة
حقول القراءة فقط المحسوبة
استخدم حقول “للقراءة فقط” لعرض الحسابات بناءً على ردود أخرى:
| type | name | label | read_only | calculation |
|-----------|----------|-----------------|-----------|------------------------|
| calculate | bmi | مؤشر كتلة الجسم:| yes | ${weight} / (${height} * ${height}) |
عرض البيانات التاريخية
يمكن لحقول “للقراءة فقط” عرض بيانات من استطلاعات سابقة أو مصادر خارجية:
| type | name | label | read_only | default |
|---------|----------------|------------------------|-----------|----------------------------|
| text | last_visit_date| تاريخ آخر زيارة: | yes | ${pulldata('visits', 'date', 'id', ${patient_id})} |
اعتبارات إدارة البيانات
- تُدرَج حقول “للقراءة فقط” في تصديرات البيانات، وعادةً مع علامة تشير إلى حالتها.
- عند تحديث السجلات الموجودة، تحتفظ حقول “للقراءة فقط” بقيمها الأصلية ما لم تُستبدَل صراحةً من الخلفية.
سلوك التطبيق المحمول
- يحترم تطبيق rtSurvey المحمول إعدادات “للقراءة فقط”، بما في ذلك منطق القراءة فقط الشرطي.
- يدعم وضع عدم الاتصال بالكامل وظيفة “للقراءة فقط”، بما فيها الحقول الديناميكية والمحسوبة.
القيود المعروفة
- قد يكون لبعض شروط القراءة فقط الديناميكية المعقدة تأثير طفيف على الأداء في الأجهزة منخفضة الأداء.
- قد لا تمنع حقول “للقراءة فقط” جميع أشكال التلاعب بالبيانات في ملفات البيانات المصدَّرة، لذا يُوصى بالتحقق على جانب الخادم للبيانات الحيوية.
استكشاف مشكلات حقول القراءة فقط
- الحقل قابل للتعديل بشكل غير متوقع: تحقق من أخطاء الصياغة في عمود
read_onlyأو المنطق الشرطي. - القيم المحسوبة لا تتحدث: تحقق من منطق الحساب وتأكد من تسمية جميع الحقول المُشار إليها بشكل صحيح.
- مشكلات الأداء: حسّن الحسابات المعقدة أو فكر في مناهج بديلة لعرض بيانات القراءة فقط.