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

يُسرّع الاستيراد الجماعي إقلاع منشأتك على وقتي أو تحديث بياناتها عبر تحميل المستخدمين والأقسام والموردين من ملفات منظمة—عادة CSV أو حمولات JSON عبر واجهة الإدارة أو واجهة الاستيراد.

نظرة عامة

يدعم وقتي ثلاثة أنواع رئيسية للاستيراد لتجهيز النظام والصيانة:

نوع الاستيراد	الاستخدام الأساسي
المستخدمون	إدماج الموظفين بكميات كبيرة؛ ربط الأقسام والمديرين؛ وربط الأدوار اختيارياً.
الأقسام	بناء أو تحديث الهيكل التنظيمي؛ تعيين المدراء؛ ربط الأب في مرحلة ثانية عند الحاجة.
الموردون	تحميل أو تحديث سجل الموردين من جداول أو تصدير من نظام آخر.

التحقق في بيئة تجريبية أولاً

شغّل ملفاً صغيراً (5–10 صفوف) على مستأجر غير إنتاجي، راجع أعداد الاستجابة JSON، ثم وسّع النطاق.

استيراد المستخدمين

يقبل استيراد المستخدمين مصفوفة سجلات (JSON) أو صفوف CSV بحقول مكافئة.

السلوك

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

خطوات نموذجية (مسار الإدارة)

1. جهّز ملفاً بالأعمدة المطلوبة (البريد، الاسم، مرجع القسم، إلخ).
2. افتح الإعدادات ← استيراد البيانات ← المستخدمون (أو المسار المكافئ).
3. ارفع CSV أو الصق JSON حسب تكاملكم.
4. راجع أخطاء التحقق قبل التنفيذ إن وفر المعاينة.
5. نفّذ الاستيراد واقرأ ملخص الاستجابة (انظر تنسيق الاستجابة).

البريد المستقر كمرساة

استخدم البريد المؤسسي كمفتاح دمج؛ البريد الشخصي أو الأسماء المستعارة تسبب ازدواجية في الاستيراد التالي.

استيراد الأقسام

يُنشئ استيراد الأقسام الوحدات التنظيمية أو يحدّثها ويربطها هرمياً.

السلوك

الموضوع	طريقة العمل
إنشاء / تحديث	يُطابق الصفوف بـ الرمز و/أو الاسم (حسب القالب)—الموجود يُحدَّث والرمز الجديد يُدرج.
مدير القسم	عيّن مدير القسم بـ بريد المستخدم؛ يُفضّل وجود المستخدم أو استيراده بالترتيب الذي يحدد دليل التشغيل.
القسم الأب	إن كان الأب يجب أن يوجد أولاً، استخدم مرحلتين: (1) استيراد الأقسام دون أب، (2) تمريرة ثانية تضبط الأب برمز الأب.

خطوات

1. صدّر أو أعد قائمة مسطحة بالأقسام: الرمز، الاسم، ورمز الأب اختياري.
2. استورد أقسام الجذر أولاً إن اشترط النظام وجود الأب مسبقاً.
3. نفّذ تمريرة ثانية لربط parent_code (أو ما يعادله) بالوحدات الفرعية.
4. عيّن بريد المدير لكل صف عند الحاجة.
5. تحقق من مخطط المؤسسة تحت الإعدادات ← الأقسام.

رموز أقسام ثابتة

اعتبر رمز القسم ثابتاً بعد الاستخدام؛ تغيير الرمز يكسر التقارير التاريخية والاستيراد المتكرر.

استيراد الموردين

يُصمَّم استيراد الموردين لـ الدمج الجماعي لسجلات الموردين.

السلوك

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

خطوات

1. جهّز صفوف المورد: الاسم القانوني، بريد الاتصال، الهاتف، ضريبة/سجل تجاري إن لزم.
2. افتح استيراد البيانات ← الموردون (أو نقطة API).
3. ارفع الملف ونفّذ.
4. راجع الصفوف المتخطاة ورسائل الخطأ؛ صحّح المصدر وأعد الاستيراد.

تنسيق الاستجابة

تُعيد عمليات الاستيراد JSON بأعداد مجمّعة:

الحقل	المعنى
created	سجلات أُدرجت جديدة.
updated	سجلات وُجدت وعُدّلت.
skipped	صفوف لم تُطبّق (غالباً تكرار أو فشل تحقق—انظر errors).
errors	مصفوفة رسائل لكل صف أو حقل للتصحيح.

مثال توضيحي:

{
  "created": 42,
  "updated": 8,
  "skipped": 3,
  "errors": [
    { "row": 15, "field": "email", "message": "Invalid email format" }
  ]
}

نصائح لإعداد البيانات

الممارسة	السبب
صف واحد لكل كيان	تجنّب الخلايا المدمجة والأسطر المتعددة في CSV.
ترميز UTF-8	يحافظ على الأسماء العربية والرموز الخاصة.
تطبيع البريد	أحرف صغيرة وإزالة المسافات—يقلل إنشاء مستخدم «جديد» بالخطأ.
ترتيب التبعيات	استورد الأقسام (والمستخدمين عند الحاجة) قبل الصفوف التي تشير إليها.
سجل تغييرات	دوّن إصدار الملف والتاريخ للتدقيق ومناقشات التراجع.

وثّق خريطة الأعمدة

احتفظ بجدول داخلي قصير يربط كل عمود CSV بحقول وقتي (إلزامي/اختياري)—تسريع تسليم المسؤول التالي.

مواضيع ذات صلة

• دليل المسؤول
• التكوين