انتقل إلى المحتوى

استيراد البيانات

تتيح لك صفحة استيراد البيانات رفع البيانات دفعةً واحدة إلى form schema من ملف بامتداد .xls أو .xlsx أو .csv. يرشدك معالج من ثلاث خطوات — رفع ملف، ربط الحقول، النتيجة — خلال رفع الملف، وربط أعمدته بحقول النموذج، ومراجعة النتيجة.

العرض الرئيسي لصفحة استيراد البيانات

الوصول إلى صفحة الاستيراد

  1. انتقل إلى قائمة النماذج واختر form schema.
  2. من عرض بيانات النموذج، انقر على استيراد نماذج في شريط الأدوات.

الخطوة 1 — رفع ملف

تعرض الخطوة الأولى منطقة سحب وإفلات أو منتقي ملفات.

  • الصيغ المقبولة: .xls، .xlsx، .csv
  • الحد الأقصى لحجم الملف: 20 ميغابايت

للرفع:

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

تنسيق ملف الاستيراد

اطّلع على الوصف في القسم أدناه

صيغ الملفات السهلة

يقبل Dino الملف نفسه الذي تحصل عليه أثناء التصدير. لذا، فإن أسهل طريقة للحصول على ملف منسّق بشكل صحيح للاستيراد هي أن تصدّر أولاً بعض بيانات النموذج من الـ form schema نفسه ثم تحذف الصفوف التي تحتوي على البيانات المصدَّرة، مبقياً على رؤوس الأعمدة فقط. في كل الأحوال، تأكد من أن رؤوس أعمدةك واضحة – فسيتم استخدامها كاقتراحات أثناء الربط.

المقاييس المُعرَّفة بواسطة المعرّف

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

الخطوة 2 — ربط الحقول

بعد الرفع، ترى جدولاً يسرد جميع الأعمدة من ملفك. يحتوي كل صف على ثلاثة أعمدة:

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

إجراءات الربط

  • اختيار حقل نموذج – افتح القائمة المنسدلة لعمود واختر الحقل الصحيح. يمكنك البحث داخل القائمة المنسدلة.
  • تجاهل عمود – اختر خيار — تجاهل هذا العمود — في القائمة المنسدلة، أو انقر على زر تجاهل في عمود الحالة. تظهر الأعمدة المتجاهَلة باهتة.
  • استعادة عمود متجاهَل – انقر على زر استعادة في عمود الحالة.

المطابقة التلقائية

عند قراءة الملف، يربط Dino كل عمود يكون رأسه مطابقاً تماماً لاسم حقل نموذج، أو اسم حقل متكرر متبوعاً بـ __N (انظر الشرائح المتكررة). تُترك الأعمدة الأخرى لتربطها بنفسك.

انقر على إعادة الربط للكل لإعادة تعيين كل عمود والسماح لـ Dino بمطابقتها مرة أخرى، وهذه المرة أيضاً بإقران الأعمدة بحقول تتشابه أسماؤها أو تسمياتها. راجع النتيجة وعدّل عمليات الربط حسب الحاجة.

تعمل المطابقة على أفضل وجه مع رؤوس تكون أسماء الحقول، كما في ملف مصدَّر.

التكرار

إذا كان حقل النموذج المحدد حقلاً متكرراً (مثل أرقام هاتف متعددة)، يظهر حقل إدخال التكرار أسفل القائمة المنسدلة. أدخل فهرس التكرار (0، 1، 2، …) لتعيين عمود الملف هذا إلى إحدى حالات المجموعة المتكررة.

ملخص شريط الأدوات

في أعلى منطقة الربط، يمكنك رؤية ثلاث شرائح:

  • إجمالي الأعمدة – عدد أعمدة الملف.
  • مرتبط – الأعمدة التي تم تعيينها إلى حقل نموذج.
  • متجاهَل – الأعمدة التي اخترت تجاهلها.

استخدم حقل ابحث في الأعمدة… لتصفية الجدول حسب اسم عمود الملف.

انقر على رجوع للعودة إلى خطوة الرفع: يُلغى الملف وعمليات الربط، وتختار الملف مرة أخرى.

عند ربط جميع الأعمدة المطلوبة وعدم وجود أخطاء، يُفعَّل زر تطبيق الاستيراد. انقر عليه لبدء الاستيراد. أثناء المعالجة، يظهر مؤشر دوّار.

ربط مكرر

إذا ربطت حقل النموذج نفسه بأكثر من عمود ملف واحد، يظهر خطأ تحقق (الحقل مرتبط بأكثر من عمود) ويظل زر تطبيق الاستيراد معطلاً حتى تصحيح ذلك.

الخطوة 3 — النتيجة

تُبلغك الخطوة الأخيرة بما حدث:

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

انقر على إغلاق للعودة إلى قائمة بيانات النموذج، حيث تظهر البيانات الجديدة. بعد حدوث خطأ، يعيدك رجوع إلى خطوة الربط لإصلاح المشكلات.

تنسيق الملف

نصف إجراءات استيراد بعض البيانات دفعةً واحدة باستخدام ملف Excel مُنشأ من Google Sheet. تنطبق الإجراءات نفسها على ملفات CSV أو عند العمل مباشرةً مع Excel.

نفترض أنك تريد استيراد بيانات في form يُدعى Projects يحتوي على شريحتين، إحداهما شريحة متكررة:

form المشاريع، بشريحتين إحداهما شريحة متكررة

أُنشئ form المشاريع باستخدام XLSForm التالي. ورقة “survey” هي

type name label
begin group start Start
select_one countries country Country
select_multiple countries country_other Other Countries
text title Project Title
date project_date_start Start date
select_one donors selected_donor Donor
integer budget Budget
boolean isleader Leading applicant
end group
begin repeat indicators Indicators
text indic Indicator description
integer value_indic Value reached
end repeat

وورقة “choices” هي

list_name name label
donors ue UE
donors govita ITALIAN GOVERNMENT
donors un UN
donors pub ALTRI DONATORI PUBBLICI
donors la ENTI LOCALI
donors priv DONATORI PRIVATI
donors other Others
countries AFG Afghanistan
countries ALB Albania
countries DZA Algeria
countries ASM American Samoa

اتّبع هذه الخطوات:

  1. أنشئ ملفاً فارغاً بورقة واحدة فقط (أسماء الملف والورقة لا تهم).
  2. في الصف الأول تحتاج إلى وضع أسماء حقول النموذج وحقول النموذج الخاصة بـ DINO. في هذا المثال، يمكن أن تكون حقول النموذج:
  3. country
  4. country_other
  5. title
  6. project_date_start
  7. selected_donor
  8. budget
  9. isleader
  10. indic (*)
  11. value_indic (*)

انتبه إلى أن الحقول الموجودة ضمن الشرائح المتكررة يجب التعامل معها بشكل مختلف (ولهذا وضعنا نجمة). يُرجى الرجوع إلى القسم المحدد أدناه.

يمكن أن تكون حقول DINO الخاصة:

  1. created_at. تاريخ إنشاء النموذج. حدِّده فقط إذا كنت تريد أن يكون لنماذجك تاريخ إنشاء مختلف عن تاريخ الاستيراد؛
  2. user_data_ref_id. معرّف المستخدم الذي سيُربط بالنموذج. يُطبَّق فقط عندما يستورد مسؤول؛ وبالنسبة للمستخدمين الآخرين تُتجاهل القيمة وتُعيَّن النماذج للمستخدم الذي يستوردها؛
  3. area_id. معرّف مقياس AREA الذي سيُربط بالنموذج؛
  4. [area_name]
  5. case_id. معرّف مقياس CASE الذي سيُربط بالنموذج؛
  6. [case_name]
  7. project_id. معرّف مقياس PROJECT الذي سيُربط بالنموذج؛
  8. [project_name]
  9. [project_code]
  10. location_id. معرّف مقياس LOCATION الذي سيُربط بالنموذج؛
  11. [location_name]
  12. organization_id. معرّف مقياس ORGANISATION الذي سيُربط بالنموذج؛
  13. [organization_name]
  14. form_status_name. اسم أحد حالات form schema. تحصل الصفوف التي تفتقده على الحالة الأولى للـ schema. إذا لم تطابق أي قيمة اسم حالة موجود، لا يُستورد الملف (حالة form غير صالحة)؛
  15. dinoinvalid. يضع علامة على النموذج بأنه غير صالح. استخدم true أو 1 أو yes أو y أو x؛ وأي قيمة أخرى أو خلية فارغة تبقي النموذج صالحاً.

  16. كل صف سيقابل نموذجاً جديداً مختلفاً. لذا، إذا أنشأنا ملفاً برأس واحد + ولنقل 5 صفوف من البيانات، وإذا نجح الرفع، سننشئ 5 نماذج جديدة في DINO.

  17. ليس من الضروري أن يكون لديك عمود لكل حقل في النموذج؛ وليس من الضروري ملء جميع صفوف عمود معين، ولكن إذا كان حقل ما فارغاً في جميع الصفوف، يمكن حذفه،
  18. يجب تنسيق حقول التاريخ بالشكل YYYY-MM-DD كنص (كن حذراً).
  19. يجب أن تحتوي حقول الاختيار الواحد على أحد الخيارات المقبولة كما هو محدد في “choices” (انظر منشئ النموذج أو ملف XLSForm).
  20. يجب تنسيق حقول الاختيار من متعدد وفق النمط التالي: [opt1, opt2] (أي قائمة خيارات بين قوسين مربعين).

على سبيل المثال، يمكن أن يكون الملف الصالح كالتالي:

country country_other title project_date_start budget isleader area_id
ALB [AFG,DZA] Human rights in education 2022-01-28 120000 true 81387ff7-5c7d-44e7-9dc6-76b8d09265ac
ASM A new approach to social justice 2022-02-14 20000 81387ff7-5c7d-44e7-9dc6-76b8d09265ac

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

التعامل مع المقاييس أثناء الاستيراد

أثناء استيراد بعض بيانات النموذج، وفيما يتعلق بالمقاييس، قد ترغب في:

  • إنشاء مقاييس جديدة أثناء الاستيراد
  • إعادة استخدام مقاييس مُنشأة بالفعل

القواعد التي يجب اتباعها لإدارة المقاييس بشكل صحيح هي التالية:

المقياس الإنشاء من الواجهة الإنشاء من الاستيراد الإنشاء + الإسناد من الاستيراد الاستخدام من الاستيراد الإنشاء + الإسناد من الاستيراد (الأب) الاستخدام كأب
حالة الاسم الاسم الاسم المعرّف، أو الاسم (مع خيار إعادة الاستخدام)، أو كلاهما الاسم، في صف آخر من الملف نفسه المعرّف أو الاسم
المنظمة الاسم الاسم الاسم المعرّف، أو الاسم (مع خيار إعادة الاستخدام)، أو كلاهما الاسم، في صف آخر من الملف نفسه المعرّف أو الاسم
الموقع الاسم الاسم الاسم المعرّف، أو الاسم (مع خيار إعادة الاستخدام)، أو كلاهما الاسم، في صف آخر من الملف نفسه المعرّف أو الاسم
منطقة الاسم الاسم الاسم المعرّف، أو الاسم (مع خيار إعادة الاستخدام)، أو كلاهما الاسم، في صف آخر من الملف نفسه المعرّف أو الاسم
المشروع الاسم، الرمز الاسم، الرمز الاسم، الرمز المعرّف، أو الاسم (مع خيار إعادة الاستخدام)، أو كلاهما الاسم والرمز، في صف آخر من الملف نفسه المعرّف أو الاسم

عندما يحتوي صف على معرّف مقياس واسمه معاً، يفوز المعرّف ويُتجاهل الاسم. لا يُنشأ مقياس جديد إلا عندما يُعطى الاسم ويكون المعرّف فارغاً.

تُعيَّن الآباء عبر أعمدة <metric>_parent_id و<metric>_parent_name (على سبيل المثال location_parent_name)، وتنطبق فقط على المقاييس التي ينشئها الاستيراد. يجب أن يكون الأب من نوع المقياس نفسه، وأن يكون إما موجوداً بالفعل أو مُنشأً بواسطة صف آخر من الملف نفسه، بأي ترتيب. الأب الذي لا يطابق شيئاً لا يُنشأ: ويُبلَّغ عن ذلك المقياس باعتباره مقياس بأصل غير صالح.

الشرائح المتكررة

إذا كان لديك حقل في شرائح متكررة، فيجب تسميته بشكل مختلف. يجب تسمية كل حقل في الشريحة المتكررة \<field_name>__X حيث X هو رقم التكرار، من 0 (المقابل لتكرار واحد) إلى N-1 حيث N هو إجمالي عدد تكرارات الشريحة في ذلك النموذج.
على سبيل المثال، لنفترض أن لديك تكراراً واحداً فقط من الشريحة المتكررة وتريد إضافة كلاً من الحقلين “Indicator description” و“Value reached”. ستحتاج إلى إضافة هذين العمودين إلى ملف الاستيراد:

indic__0 value_indic__0
Number of children 100

فمثلاً يمكن أن يكون لدينا:

country budget indic__0 value_indic__0 indic__1 value_indic__1 isleader
ALB 120000 Children 100 true
ASM 20000
AFG 15000 Parents 45 Schools 34 true

الأخطاء

  • معرّفات غير معروفة – إذا أشار عمود إلى مستخدم أو مقياس بمعرّف غير موجود في Dino، لا يُستورد الملف بالكامل (لم يتم استيراد الملف!)، وتسرد النتيجة معرّفات مستخدم غير صالحة أو معرّفات مقياس غير صالحة. تحقق من المعرّفات في ملفك قبل الاستيراد.
  • حالة form غير معروفة – form_status_name الذي لا يطابق أي حالة في الـ schema يوقف الاستيراد أيضاً (حالة form غير صالحة).
  • مقاييس لا يمكن ربطها – يُرفض الصف الذي يسمّي مقياساً لا يستطيع Dino إنشاءه أو العثور عليه، وتعرض النتيجة السبب؛ وتُستورد الصفوف الأخرى.