كيفية استيراد البيانات في أودو
دليل شامل لاستيراد السجلات في أودو باستخدام معالج الاستيراد المدمج — يشمل تنسيقات CSV وExcel وتعيين الحقول ومعالجة الأخطاء وأفضل الممارسات لمجموعات البيانات الكبيرة.
يتيح معالج الاستيراد في أودو إنشاء أو تحديث السجلات بشكل مجمّع من ملف CSV أو Excel — دون كتابة أكواد أو تشغيل SQL. وهو الأداة القياسية لترحيل البيانات الأولية (العملاء والمنتجات والأرصدة الافتتاحية) وللتحديثات المجمّعة الجارية (قوائم الأسعار وجرد المخزون وسجلات الموظفين).
يغطي هذا الدليل كل خطوة في عملية الاستيراد: إعداد ملفك، وتنزيل قالب الحقل، وتعيين الأعمدة، والتعامل مع الحقول العلائقية (many2one)، وحل أخطاء التحقق، وإدارة الاستيرادات الكبيرة. يحدد قسم ملاحظات الإصدار في النهاية ما تغيّر في أودو 16–19 وما يجب التحقق منه عند إصدار إصدار جديد.
فتح معالج الاستيراد
يتوفر معالج الاستيراد على جميع نماذج أودو القياسية التي تدعم الإنشاء المجمّع: جهات الاتصال (res.partner) والمنتجات (product.template / product.product) وأوامر المبيعات (sale.order) وقيود دفتر اليومية (account.move) والموظفون (hr.employee) وغيرها. النماذج المُعلَّمة للقراءة فقط أو نماذج النظام لا تعرض خيار الاستيراد.
إعداد ملف الاستيراد
أسرع طريقة للحصول على رؤوس الأعمدة الصحيحة هي تنزيل قالب حقل أودو مباشرةً من معالج الاستيراد — يُنشئ ملف CSV مع كل اسم حقل متاح بالتنسيق التقني الصحيح. لا تحاول تخمين أسماء الأعمدة يدويًا لعملية استيراد كبيرة.
- افتح معالج الاستيراد للنموذج المستهدف.
- انقر على "تنزيل ملف نموذجي" (أودو 19) أو "قالب استيراد العملاء" / الاسم المعادل لنموذجك. يُنزّل هذا ملف CSV بجميع أسماء الحقول كرؤوس أعمدة.
- افتح ملف CSV في Excel أو LibreOffice Calc. احذف الأعمدة التي لا تحتاجها — كلما قلّت الأعمدة، قلّت أخطاء التعيين.
- أدخل صفوف بياناتك. تأكد من أن الصف الأول يحتوي على رؤوس الأعمدة بالضبط كما تم تنزيلها — لا تعيد تسميتها إلا إذا كنت تنوي إعادة التعيين يدويًا.
- احفظ كـ CSV (ترميز UTF-8) أو احتفظ بـ XLSX — كلاهما مقبول من معالج الاستيراد في أودو 18/19.
| القاعدة | التفاصيل | الخطأ الشائع |
|---|---|---|
| الترميز | مطلوب UTF-8 لملفات CSV. يتعامل Excel XLSX مع الترميز داخليًا. | حفظ CSV من Excel على Windows بترميز ANSI يُفسد الأحرف العربية والفرنسية والخاصة. |
| تنسيق التاريخ | ISO 8601: YYYY-MM-DD (مثلاً 2026-06-18). يقبل أودو أيضًا DD/MM/YYYY إذا تم تهيئته، لكن ISO أكثر أمانًا. | استخدام MM/DD/YYYY يسبب تبديل اليوم/الشهر للتواريخ من 1 إلى 12. |
| الحقول المنطقية | استخدم 1 أو True للمحدد؛ 0 أو False لغير المحدد. | استخدام Yes/No أو نعم/لا يسبب فشل التحقق. |
| حقول many2one (العلائقية) | استخدم اسم السجل أو المعرف الخارجي — ليس معرف قاعدة البيانات الصحيح. | لصق معرف قاعدة البيانات الرقمي (مثلاً 42) بدلًا من اسم العرض يسبب أخطاء "لم يُعثر على السجل". |
| حقول many2many | افصل القيم المتعددة بفاصلة داخل الخلية: "Tag A,Tag B,Tag C". | استخدام الفاصلة المنقوطة كفاصل يفشل؛ خلايا منفصلة لكل قيمة تفشل. |
| الحقول الرقمية | استخدم نقطة كفاصل للأعشار: 1234.56. لا تستخدم فاصلات الآلاف. | 1,234.56 تُقرأ كسلسلة نصية "1" تليها خطأ على "234.56". |
تشغيل عملية الاستيراد — خطوة بخطوة
- من شاشة معالج الاستيراد، انقر على رفع ملف وحدد ملف CSV أو XLSX.
- يقرأ أودو الصف الأول كرؤوس أعمدة ويحاول تعيينها تلقائيًا إلى حقول النموذج. راجع لوحة التعيين — الأعمدة المعيّنة بشكل صحيح تعرض اسم حقل أودو؛ الأعمدة غير المعيّنة تعرض تحذيرًا باللون الأصفر.
- لأي عمود غير معيَّن، انقر على القائمة المنسدلة بجانبه وحدد حقل أودو الصحيح. إذا قمت بتنزيل قالب الحقل في الخطوة 2 من القسم السابق، يجب أن تُعيَّن جميع الأعمدة تلقائيًا.
- انقر على اختبار الاستيراد. يتحقق أودو من جميع الصفوف دون الكتابة إلى قاعدة البيانات ويعرض أخطاء على مستوى الصف مع العمود والسبب.
- صحّح جميع الأخطاء في ملفك المصدر وأعد رفعه، أو صحّحها مباشرةً في المحرر المدمج في المعالج إذا كانت قليلة فقط.
- عندما يُظهر اختبار الاستيراد صفر أخطاء، انقر على استيراد. يُنشئ أودو (أو يُحدّث) جميع السجلات في معاملة قاعدة بيانات واحدة — إذا فشل أي صف، يتراجع الاستيراد بالكامل.
استيراد حقول many2one (العلائقية)
تربط حقول many2one سجلًا بسجل مرتبط واحد — مثلاً، `country_id` لجهة الاتصال يرتبط بسجل `res.country`. يقبل معالج الاستيراد ثلاث طرق بحث لحقول many2one:
| الطريقة | صياغة رأس العمود | مثال على القيمة | متى تستخدمها |
|---|---|---|---|
| البحث بالاسم | اسم الحقل (عادي — مثلاً "Country") | المملكة العربية السعودية | الأسهل. يعمل عندما يكون اسم العرض فريدًا. يفشل إذا كان لسجلين نفس الاسم. |
| البحث بالمعرف الخارجي | field_name/id (مثلاً "Country/External ID") | base.sa | الأكثر موثوقية للبيانات القياسية في أودو. المعرفات الخارجية مستقرة عبر النسخ. استخدمها للدول والمناطق وفئات المنتجات. |
| البحث بمعرف قاعدة البيانات | field_name/.id (مثلاً "Country/.id") | 187 | تجنّبها في عمليات الترحيل — معرفات قاعدة البيانات تختلف بين نسخ أودو. استخدمها فقط لعمليات التصدير المُعاد استيرادها في نفس قاعدة البيانات. |
أخطاء الاستيراد الشائعة وكيفية إصلاحها
| رسالة الخطأ | السبب الجذري | الحل |
|---|---|---|
| "لم يُعثر على سجل مطابق لـ [value] في الحقل [field]" | تعذّر على بحث many2one إيجاد سجل بهذا الاسم أو المعرف الخارجي | تحقق من الإملاء وحالة الأحرف. صدّر النموذج المرتبط للحصول على قيم الاسم أو المعرف الخارجي الدقيقة للاستخدام. |
| "تنسيق تاريخ غير صالح" أو "تعذّر تحويل القيمة إلى تاريخ" | خلية التاريخ ليست بتنسيق YYYY-MM-DD، أو مخزنة كرقم (شائع في Excel) | نسّق عمود التاريخ كـ Text في Excel قبل ملئه، ثم استخدم YYYY-MM-DD. أو استخدم صيغة TEXT(): =TEXT(A2,"YYYY-MM-DD"). |
| "الحقل [field] مطلوب لكن لم يُقدَّم" | عمود حقل إلزامي مفقود من الملف، أو قيمة الخلية فارغة | تحقق من الحقول المطلوبة للنموذج (مُعلَّمة بنجمة حمراء في عرض نموذج أودو). أضف العمود وتأكد من أن كل صف يحتوي على قيمة. |
| "تم العثور على تكرارات" أو الاستيراد يُنشئ سجلات مكررة | لا يوجد عمود معرف خارجي — لا يستطيع أودو مطابقة الصفوف الواردة بالسجلات الموجودة ويُنشئ سجلات جديدة | صدّر السجلات الموجودة للحصول على معرفاتها الخارجية، ثم أضف عمود `id` إلى ملف الاستيراد. سيُحدّث أودو بدلًا من الإنشاء. |
| معالج الاستيراد رمادي اللون أو زر الاستيراد غير مرئي | المستخدم الحالي لا يملك صلاحية الكتابة على النموذج، أو النموذج يستلزم وضع المطور | تحقق من حقوق وصول المستخدم (الإعدادات ← المستخدمون والشركات ← المستخدمون ← حقوق الوصول). بعض النماذج التقنية تستلزم وضع المطور. |
أفضل الممارسات لعمليات الاستيراد الكبيرة
- قسّم الملفات الكبيرة إلى دفعات من 2,000–5,000 صف. عمليات الاستيراد الفردية الكبيرة جدًا (50,000+ صف) قد تنتهي مهلتها أو تستهلك ذاكرة مفرطة على نسخ Odoo.sh أو السحابة المشتركة.
- قم دائمًا بتشغيل اختبار الاستيراد قبل النقر على استيراد. الاستيراد الفاشل يتراجع بالكامل — الاختبار أولًا يوفر الوقت.
- استورد البيانات المرجعية (الدول وفئات المنتجات ووحدات القياس) قبل بيانات المعاملات (أوامر المبيعات والفواتير). يُحلّ أودو عمليات بحث many2one وقت الاستيراد — السجلات المرجعية المفقودة تسبب فشل الصفوف.
- جدوّل عمليات الاستيراد الكبيرة خلال ساعات الذروة المنخفضة (الليالي/عطل نهاية الأسبوع) على أنظمة الإنتاج — القفل على قاعدة البيانات أثناء الاستيراد يمكن أن يبطئ عمليات المستخدمين المتزامنة.
- لعمليات الترحيل الأولية التي تتجاوز 100,000 سجل، استخدم وحدة `base_import` في أودو عبر RPC أو وحدة `odoo-import-export` من المجتمع — كلتاهما تتجاوز حد الصف في المعالج وتدعم الالتزامات المقسّمة.
ملاحظات الإصدار ودليل المراجعة السريعة
| إصدار أودو | موقع معالج الاستيراد | تنسيقات الملفات | تغيير بارز |
|---|---|---|---|
| أودو 16 | قائمة الإجراءات (⚙) ← استيراد السجلات في عروض القائمة | CSV، XLSX | تحديث واجهة المستخدم؛ أضيف محرر الأخطاء المدمج للتصحيحات الصغيرة دون إعادة الرفع |
| أودو 17 | قائمة الإجراءات (⚙) ← استيراد السجلات | CSV، XLSX | لا تغييرات وظيفية على معالج الاستيراد |
| أودو 18 | قائمة الإجراءات (⚙) ← استيراد السجلات | CSV، XLSX | لا تغييرات وظيفية. تأكيد تسمية "تنزيل ملف نموذجي". |
| أودو 19 | قائمة الإجراءات (⚙) ← استيراد السجلات | CSV، XLSX | لا تغييرات وظيفية. موثق يونيو 2026. |
هل تقوم بترحيل البيانات إلى أودو من نظام آخر؟
تتولى iWesabe مشاريع ترحيل البيانات الكاملة — من Tally وQuickBooks وSAP أو جداول البيانات القديمة — بما يشمل تنظيف البيانات وتعيينها والتحقق منها عند الإطلاق.
الأسئلة الشائعة
ما تنسيقات الملفات التي يدعمها استيراد أودو؟
كيف أُحدّث السجلات الموجودة عبر معالج الاستيراد في أودو؟
ما الحد الأقصى لعدد الصفوف التي يمكنني استيرادها مرة واحدة في أودو؟
كيف أستورد منتجًا بمتغيرات متعددة في أودو؟
لماذا يُفيد الاستيراد بـ "لم يُعثر على سجل مطابق" لحقل موجود في أودو؟
هل يمكنني استيراد البيانات في أودو دون وضع المطور؟
iWesabe Editorial Team
رؤى عملية حول Odoo ERP وامتثال ZATCA والعمليات الرقمية للشركات السعودية — بقلم فرق الاستشارات والمالية والهندسة في iWesabe.
مقالات ذات صلة
الهجرة من Tally أو QuickBooks إلى أودو ERP في المملكة العربية السعودية
كيف تستبدل الشركات السعودية الصغيرة والمتوسّطة المحاسبة المستقلّة بحزمة أودو الكاملة — ربط شجرة الحسابات، واستمرارية ضريبة القيمة المضافة/ZATCA، والتحقّق بالتشغيل المتوازي، وتحوّل لا يكسر إقرار مارس.
تنسيق الورق المخصص في تقارير QWeb لأودو
كيفية إنشاء وتهيئة وربط تنسيقات الورق المخصصة بتقارير QWeb لأودو — يشمل إعداد واجهة المستخدم، وتجاوز XML، والتحكم في الهوامش، وضبط حجم الرأس والتذييل.
ما هو نظام أودو ERP؟ الدليل الشامل لأودو (المعروف سابقاً بـ OpenERP) للشركات السعودية
من TinyERP إلى OpenERP إلى أودو 19 — كيف تطوّر النظام ولماذا يستخدمه أكثر من 12 مليون مستخدم حول العالم