مرجع XLSForm

هذه الصفحة لمن يبني ملف XLSForm لاستيراده إلى CommonLynk. وهي تبيّن ما تقرؤه المنصة من كل ورقة، وعمل كل عمود ومفتاح، وما لا تدعمه وما يحدث له، وأين تختلف CommonLynk عن ODK وKoboToolbox وSurveyCTO.

قوائم أنواع الأسئلة والدوال والأعمدة والمفاتيح وقيم احتساب الدرجات في هذه الصفحة مولَّدة من المنصة نفسها، فهي تصف ما تفعله اليوم. وللاطلاع على شرح متدرّج لبناء نموذج، راجع «بناء نموذج» و«منطق التخطي واحتساب الدرجات».

ما تقرؤه CommonLynk من الملف

يُستورد ملف ODK أو KoboToolbox أو SurveyCTO العادي كما هو. وكل ما تضيفه CommonLynk اختياري، ومسمّى على طريقة تسمية تلك الأدوات لإضافاتها، فيبقى ملف CommonLynk قابلًا للفتح فيها.

في ورقة الأسئلة تُطبَّق على السؤال قيمة كل عمود من الأعمدة التالية. وتأخذ أعمدة التسمية والتلميح ورسالة القيد عمودًا لكل لغة، كما يشرح «بناء نموذج».

• appearance
• calculation
• choice_filter
• constraint
• constraint_message
• default
• hint
• label
• name
• read_only
• relevant
• repeat_count
• required
• type

أما أي عمود آخر يحمل قيمة في صف سؤال فيُحفظ مع ذلك السؤال: يظهر في تبويب التصميم للنموذج، ويُذكر في صفحة الاستيراد على أنه محفوظ غير مطبَّق، ويُكتب من جديد عند تصدير النموذج. فلا يضيع شيء مما كتبته في الطريق.

اسم السؤال هو هويته: يشير إليه منطق التخطي، ويطابق عليه التحديث، ويُسمّى به كل عمود في التصدير. اكتبه بأحرف لاتينية صغيرة وأرقام وشرطات سفلية، مبتدئًا بحرف؛ وتُحوَّل الأحرف الكبيرة إلى صغيرة، ويصبح أي حرف آخر شرطة سفلية. ولكل صف اسم إلا الملاحظة.

ثلاثة مسارات بثلاثة معانٍ

لا يُطبَّق الملف المطابق لآخر ملف بُني منه النموذج مرة أخرى إلا إذا اخترت «طبّق هذا الملف مرة أخرى» عند التحديث، وبدونه يقول الاستيراد إنه لم يتغيّر شيء. اختره عندما يتحسّن مستورد المنصة وينبغي إعادة بناء النموذج من الملف نفسه. ولا يُنشئ استيراد الملف نفسه مرتين في النشاط أو المشروع نفسه شيئًا في المرة الثانية.

أنواع الأسئلة

كل نوع سؤال في CommonLynk، وأنواع XLSForm التي تُستورد على أنها هو، وما يكتبه التصدير له.

النوع الذي يُبنى في CommonLynk فقط يُصدَّر بأقرب صيغة له في XLSForm. فإذا استُورد من جديد نموذجًا جديدًا صار النوع الذي تُستورد به تلك الصيغة لا النوع الأصلي: يصبح سؤال ليكرت سؤال اختيار، ورقم الهاتف نصًا قصيرًا. ولا يغيّر تحديث نموذج له ردود نوع أي سؤال موجود فيه.

تُفتح المجموعات والتكرارات وتُغلق بهذه الأنواع، مكتوبة بشرطة سفلية أو بمسافة:

• begin_group · begin group
• end_group · end group
• begin_repeat · begin repeat
• end_repeat · end repeat

أي نوع آخر يُتجاوز ويُذكر في صفحة الاستيراد، ولا يُحفظ صفه. ويشمل ذلك أنواع البيانات الوصفية هذه:

• start
• end
• today
• deviceid
• username

تسجّل CommonLynk وقت بدء كل رد ووقت إرساله ومن أرسله، دون الحاجة إليها.

ورقة commonlynk

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

• setting
• value

هذه المفاتيح تُعدّ ملاحظاتك الخاصة: تُذكر في صفحة الاستيراد ولا تُطبَّق أبدًا، وأي مفتاح آخر تضيفه يُعامَل بالطريقة نفسها:

• domains
• id
• indices
• instance_name
• items_per_domain
• note
• notes
• purpose
• purpose_ar
• purpose_en
• respondent
• version

أنواع النماذج، للمفتاح form_type:

فئات المستجيبين، للمفتاح subject:

أعمدة الأسئلة الخاصة بـ CommonLynk

أعمدة اختيارية في ورقة الأسئلة، قيمة واحدة لكل سؤال. ولا تُطبَّق إلا على صف محدَّد للاحتساب: فالنقاط أو مفتاح الإجابة في صف غير محتسب يُحفظان ويُذكران، ولا يُطبَّقان.

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

احتساب الدرجات

يُحتسب للنموذج درجة بإحدى أربع طرق. حدّدها بمفتاح الاحتساب في ورقة commonlynk، أو في إعدادات النموذج.

ويقبل مفتاح الاحتساب هذه الكلمات أيضًا، وتصبح كل منها طريقة احتساب:

كيف يضيف السؤال إلى مجموع التقييم

يضيف سؤال الاختيار قيمة الخيار المختار مقسومة على أعلى قيمة بين خياراته، مضروبة في نقاطه. فالخيار المسمّى 0 أو 1 أو 2 وهكذا قيمته ذلك الرقم، والخيار المسمّى «نعم» بالإنجليزية قيمته 1 والمسمّى «لا» قيمته 0، والمطابقة على الاسم لا على التسمية الظاهرة. فإذا كانت الخيارات من 0 إلى 2 والنقاط 6، أضاف السؤال 0 أو 3 أو 6. وإذا ساوت النقاط أعلى خيار أضاف السؤال القيمة نفسها: فتسعة أسئلة خياراتها من 0 إلى 3 ونقاط كل منها 3 يتراوح مجموعها بين 0 و27.

أما السؤال المُدخَل، وهو الرقم أو سؤال ليكرت أو التقييم المبني في CommonLynk، فيضيف قيمته كما أُدخلت مضروبة في نقاطه. فللنقاط نفسها معنيان إذن: أقصى ما يضيفه سؤال الاختيار، ومضاعِف لقيمة السؤال المُدخَل.

سؤال الاختيار المحتسب الذي ليست خياراته أرقامًا ولا «نعم» و«لا» لا يمكن احتساب درجته، وكذلك سؤال الاختيار المتعدد: يذكره الاستيراد، ولا يضيف شيئًا.

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

المفتاح scale_max في ورقة commonlynk هو أعلى درجة يمكن أن يبلغها النموذج كله. وهو تحقّق لا إعداد: يجمع الاستيراد ما يمكن أن تبلغه الأسئلة المحتسبة ويذكر أي اختلاف. وهو غير «الحد الأقصى لمقياس التقييم» في إعدادات النموذج، فذاك أعلى مقياس السؤال الواحد، ويُستعمل للسؤال المُدخَل الذي لا حد أعلى خاصًا به.

التحديث الذي يغيّر طريقة احتساب درجة النموذج يعيد احتساب ردوده المكتملة في الاستيراد نفسه، وتُعلَّم أي قيمة مؤشر محسوبة منها لتُحسب من جديد.

المجالات والأسئلة العكسية

المجال وسم على الأسئلة لا مجموعة: فقد يُحتسب سؤالان في مجموعة واحدة في مجالين مختلفين. سمِّ مجال السؤال المحتسب في عمود المجال. ثم يخزّن كل رد مكتمل درجة لكل مجال بجانب درجة النموذج، تظهر في صفحة الرد، وتُصدَّر بجانب الدرجة، وتُكتب من جديد عند التصدير، ويمكن للمؤشر أن يقرأ مجالًا واحدًا بدلًا من الدرجة الكلية.

تعطي ورقة commonlynk_domains كل مجال تسميته: صف لكل مجال، فيه المفتاح وعمود تسمية لكل لغة، واختياريًا الحد الأعلى الذي يمكن أن يبلغه المجال، ويُتحقَّق منه كما يُتحقَّق من scale_max ولا يُخزَّن، كما في المثال أدناه. ودون هذه الورقة يُسمّى المجال باسم مجموعته إذا لم تحوِ المجموعة غيره، وإلا طلب الاستيراد تسمية. ومع الورقة، يُذكر عمود المجال الذي يسمّي مفتاحًا غير مدرج فيها ولا يُطبَّق.

السؤال المحدَّد عكسيًا يسير في الاتجاه المعاكس: الإجابة الأعلى هي الأفضل. ولا يُحتسب إلا في مجاله، ويُعرض بجانب درجة النموذج، ولا يُضاف إليها ولا يُطرح منها أبدًا، فلا تتجاوز الدرجة الكلية المعلنة. وإذا كانت كل الأسئلة المحتسبة عكسية، كوّنت هي درجة النموذج.

في المثال أعلاه، تكوّن أسئلة الخطر درجة النموذج من 28، وتُعرض أسئلة الحماية، المحدَّدة عكسيًا، بجانبها من 8.

التعبيرات

تُقرأ أعمدة الإظهار والقيد والحساب بقواعد واحدة، وتُقيَّم بالطريقة نفسها في الصفحة، وعلى الهاتف دون اتصال، وعلى الخادم. والدالة المقبولة في عمود منها مقبولة في العمودين الآخرين.

يمكن أن يستعمل التعبير إجابات أخرى وأرقامًا ونصًا بين علامتي اقتباس وعمليات حسابية ومقارنات وأداتي الوصل «و» و«أو» والأقواس. وفي القيد تمثّل النقطة الإجابة التي يُتحقَّق منها. والسؤال الذي لم يُجَب يجعل نتيجة الحساب فارغة لا صفرًا، ولاحتساب الفراغ صفرًا صرّح بذلك بدالة الشرط.

• ${name}
• 'text'
• + - * div mod
• = != > >= < <=
• and or
• ( )
• .

وهذه هي الدوال التي تقيّمها:

وفي الحساب فقط، تعطي هذه الصيغة تسمية الخيار المختار في سؤال، كما يكتبها ODK:

• jr:choice-name(${q}, '${q}')

قراءة التكرار كاملًا

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

لعدّ الإدخالات التي تطابق شرطًا، اكتب داخل التكرار حسابًا يساوي 1 عند المطابقة و0 في غيرها، ثم اجمعه بدالة الجمع بعد التكرار:

التواريخ

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

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

ما لا تدعمه المنصة وما يحدث له

الجزء الذي لا تقيّمه المنصة يُذكر في صفحة الاستيراد، ويبقى باقي الصف ساريًا، ويُحفظ نصك الأصلي مع السؤال ويُكتب من جديد عند تصدير النموذج. وإلى أن تغيّره، يتوقف ما يحدث على العمود:

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

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

الاختلافات عن ODK وKoboToolbox وSurveyCTO

حيث يتصرف هنا ملف يعمل في تلك الأدوات تصرفًا مختلفًا، ولماذا. وكل اختلاف مقصود ما لم يقل صفه غير ذلك.

سلوك العمل دون اتصال الذي يغيّر طريقة البناء

• يُتحقَّق من القيد على الهاتف كلما تغيّرت الإجابة، وقبل الشاشة التالية، وعند الإرسال، حتى دون اتصال، ثم يتحقق منه الخادم مرة أخرى.
• تتبع دالة اليوم القواعد المذكورة في «التواريخ»: فهي دون اتصال يوم إعطاء الإجابة، لا يوم وصول الرد إلى الخادم.
• لا ينتقل إلى هواتف الجمع مع النموذج إلا الأعمدة التي تقرؤها دالة سحب البيانات فيه. أرفق مجموعة البيانات قبل النشر: فالنموذج الذي تنقصه مجموعة بياناته لا يمكن نشره ولا تفعيله. واستبدال مجموعة البيانات ينشر إصدارًا جديدًا من النموذج، وتحتفظ الردود بالبيانات التي مُلئت بها.
• السؤال المسمّى باسم حقل من حقول ملف فئة المستجيبين في النموذج يُملأ مسبقًا من سجل المستجيب، ثم ينتقل ذلك الحقل إلى هواتف الجمع لكل من في القائمة. غيّر اسم السؤال إن لم يكن بحاجة إلى ملء مسبق.