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

الوصول إلى صفحة الاستيراد
- انتقل إلى قائمة النماذج واختر form schema.
- من عرض بيانات النموذج، انقر على استيراد نماذج في شريط الأدوات.
الخطوة 1 — رفع ملف
تعرض الخطوة الأولى منطقة سحب وإفلات أو منتقي ملفات.
- الصيغ المقبولة:
.xls،.xlsx،.csv - الحد الأقصى لحجم الملف: 20 ميغابايت
للرفع:
- (اختياري) اترك خيار إعادة استخدام المقاييس الموجودة بنفس الاسم محدَّداً (وهو الوضع الافتراضي) بحيث يُربط أي مقياس في الملف يطابق اسمه مقياساً موجوداً في النظام بذلك المقياس الموجود بدلاً من إنشاء نسخة مكررة. ألغِ تحديده لإنشاء مقاييس جديدة دائماً.
- اسحب ملفاً إلى المنطقة المتقطعة أو انقر على اختر ملفاً للتصفح.
- بمجرد قراءة الملف، ينتقل المعالج إلى ربط الحقول من تلقاء نفسه.
تنسيق ملف الاستيراد
اطّلع على الوصف في القسم أدناه
صيغ الملفات السهلة
يقبل Dino الملف نفسه الذي تحصل عليه أثناء التصدير. لذا، فإن أسهل طريقة للحصول على ملف منسّق بشكل صحيح للاستيراد هي أن تصدّر أولاً بعض بيانات النموذج من الـ form schema نفسه ثم تحذف الصفوف التي تحتوي على البيانات المصدَّرة، مبقياً على رؤوس الأعمدة فقط. في كل الأحوال، تأكد من أن رؤوس أعمدةك واضحة – فسيتم استخدامها كاقتراحات أثناء الربط.
المقاييس المُعرَّفة بواسطة المعرّف
إذا قدّم عمود مقياس في ملفك معرّف المقياس (UUID)، فسيُربط ذلك الصف بالمقياس الموجود بهذا المعرّف ولن يُنشأ مقياس جديد. يأخذ المعرّف الأولوية على اسم المقياس، لذا يحدث ذلك بغض النظر عن خيار إعادة استخدام المقاييس الموجودة بنفس الاسم (الذي ينطبق فقط على المطابقة بالاسم).
الخطوة 2 — ربط الحقول
بعد الرفع، ترى جدولاً يسرد جميع الأعمدة من ملفك. يحتوي كل صف على ثلاثة أعمدة:
- عمود الملف – الرأس الأصلي من ملفك.
- الحقل – قائمة منسدلة تختار منها حقل النموذج المقابل.
- الحالة – تُظهر ما إذا كان العمود مرتبطاً أو متجاهَلاً أو به خطأ.
إجراءات الربط
- اختيار حقل نموذج – افتح القائمة المنسدلة لعمود واختر الحقل الصحيح. يمكنك البحث داخل القائمة المنسدلة.
- تجاهل عمود – اختر خيار — تجاهل هذا العمود — في القائمة المنسدلة، أو انقر على زر تجاهل في عمود الحالة. تظهر الأعمدة المتجاهَلة باهتة.
- استعادة عمود متجاهَل – انقر على زر استعادة في عمود الحالة.
المطابقة التلقائية
عند قراءة الملف، يربط Dino كل عمود يكون رأسه مطابقاً تماماً لاسم حقل نموذج، أو اسم حقل متكرر متبوعاً بـ __N (انظر الشرائح المتكررة). تُترك الأعمدة الأخرى لتربطها بنفسك.
انقر على إعادة الربط للكل لإعادة تعيين كل عمود والسماح لـ Dino بمطابقتها مرة أخرى، وهذه المرة أيضاً بإقران الأعمدة بحقول تتشابه أسماؤها أو تسمياتها. راجع النتيجة وعدّل عمليات الربط حسب الحاجة.
تعمل المطابقة على أفضل وجه مع رؤوس تكون أسماء الحقول، كما في ملف مصدَّر.
التكرار
إذا كان حقل النموذج المحدد حقلاً متكرراً (مثل أرقام هاتف متعددة)، يظهر حقل إدخال التكرار أسفل القائمة المنسدلة. أدخل فهرس التكرار (0، 1، 2، …) لتعيين عمود الملف هذا إلى إحدى حالات المجموعة المتكررة.
ملخص شريط الأدوات
في أعلى منطقة الربط، يمكنك رؤية ثلاث شرائح:
- إجمالي الأعمدة – عدد أعمدة الملف.
- مرتبط – الأعمدة التي تم تعيينها إلى حقل نموذج.
- متجاهَل – الأعمدة التي اخترت تجاهلها.
استخدم حقل ابحث في الأعمدة… لتصفية الجدول حسب اسم عمود الملف.
انقر على رجوع للعودة إلى خطوة الرفع: يُلغى الملف وعمليات الربط، وتختار الملف مرة أخرى.
عند ربط جميع الأعمدة المطلوبة وعدم وجود أخطاء، يُفعَّل زر تطبيق الاستيراد. انقر عليه لبدء الاستيراد. أثناء المعالجة، يظهر مؤشر دوّار.
ربط مكرر
إذا ربطت حقل النموذج نفسه بأكثر من عمود ملف واحد، يظهر خطأ تحقق (الحقل مرتبط بأكثر من عمود) ويظل زر تطبيق الاستيراد معطلاً حتى تصحيح ذلك.
الخطوة 3 — النتيجة
تُبلغك الخطوة الأخيرة بما حدث:
- يخبرك شريط بما إذا كان الاستيراد ناجحاً، أو جزئياً (رُفضت بعض الصفوف) أو انتهى بـ خطأ (لم يُستورد شيء).
- تعرض العدّادات الصفوف المستوردة، الصفوف المرفوضة، الصفوف في الملف والمقاييس المنشأة.
- تعرض قوائم المشكلات صفوف الملف المتأثرة والسبب. استخدم ابحث حسب الصف أو الخطأ لتصفية القوائم الطويلة.
انقر على إغلاق للعودة إلى قائمة بيانات النموذج، حيث تظهر البيانات الجديدة. بعد حدوث خطأ، يعيدك رجوع إلى خطوة الربط لإصلاح المشكلات.
تنسيق الملف
نصف إجراءات استيراد بعض البيانات دفعةً واحدة باستخدام ملف Excel مُنشأ من Google Sheet. تنطبق الإجراءات نفسها على ملفات CSV أو عند العمل مباشرةً مع Excel.
نفترض أنك تريد استيراد بيانات في form يُدعى Projects يحتوي على شريحتين، إحداهما شريحة متكررة:

أُنشئ 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 |
اتّبع هذه الخطوات:
- أنشئ ملفاً فارغاً بورقة واحدة فقط (أسماء الملف والورقة لا تهم).
- في الصف الأول تحتاج إلى وضع أسماء حقول النموذج وحقول النموذج الخاصة بـ DINO. في هذا المثال، يمكن أن تكون حقول النموذج:
- country
- country_other
- title
- project_date_start
- selected_donor
- budget
- isleader
- indic (*)
- value_indic (*)
انتبه إلى أن الحقول الموجودة ضمن الشرائح المتكررة يجب التعامل معها بشكل مختلف (ولهذا وضعنا نجمة). يُرجى الرجوع إلى القسم المحدد أدناه.
يمكن أن تكون حقول DINO الخاصة:
- created_at. تاريخ إنشاء النموذج. حدِّده فقط إذا كنت تريد أن يكون لنماذجك تاريخ إنشاء مختلف عن تاريخ الاستيراد؛
- user_data_ref_id. معرّف المستخدم الذي سيُربط بالنموذج. يُطبَّق فقط عندما يستورد مسؤول؛ وبالنسبة للمستخدمين الآخرين تُتجاهل القيمة وتُعيَّن النماذج للمستخدم الذي يستوردها؛
- area_id. معرّف مقياس AREA الذي سيُربط بالنموذج؛
- [area_name]
- case_id. معرّف مقياس CASE الذي سيُربط بالنموذج؛
- [case_name]
- project_id. معرّف مقياس PROJECT الذي سيُربط بالنموذج؛
- [project_name]
- [project_code]
- location_id. معرّف مقياس LOCATION الذي سيُربط بالنموذج؛
- [location_name]
- organization_id. معرّف مقياس ORGANISATION الذي سيُربط بالنموذج؛
- [organization_name]
- form_status_name. اسم أحد حالات form schema. تحصل الصفوف التي تفتقده على الحالة الأولى للـ schema. إذا لم تطابق أي قيمة اسم حالة موجود، لا يُستورد الملف (حالة form غير صالحة)؛
-
dinoinvalid. يضع علامة على النموذج بأنه غير صالح. استخدم
trueأو1أوyesأوyأوx؛ وأي قيمة أخرى أو خلية فارغة تبقي النموذج صالحاً. -
كل صف سيقابل نموذجاً جديداً مختلفاً. لذا، إذا أنشأنا ملفاً برأس واحد + ولنقل 5 صفوف من البيانات، وإذا نجح الرفع، سننشئ 5 نماذج جديدة في DINO.
- ليس من الضروري أن يكون لديك عمود لكل حقل في النموذج؛ وليس من الضروري ملء جميع صفوف عمود معين، ولكن إذا كان حقل ما فارغاً في جميع الصفوف، يمكن حذفه،
- يجب تنسيق حقول التاريخ بالشكل YYYY-MM-DD كنص (كن حذراً).
- يجب أن تحتوي حقول الاختيار الواحد على أحد الخيارات المقبولة كما هو محدد في “choices” (انظر منشئ النموذج أو ملف XLSForm).
- يجب تنسيق حقول الاختيار من متعدد وفق النمط التالي: [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 إنشاءه أو العثور عليه، وتعرض النتيجة السبب؛ وتُستورد الصفوف الأخرى.