---
title: Data Migration
description: استيراد وتصدير بيانات CRM عبر ملفات CSV أو عبر API.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

## طرق الاستيراد

تدعم Twenty طريقتين رئيستين لاستيراد البيانات:

| طريقة                 | الأفضل لـ                           | حد الحجم           |
| --------------------- | ----------------------------------- | ------------------ |
| **استيراد CSV**       | عمليات ترحيل قياسية، تحديثات منتظمة | 10,000 سجل لكل ملف |
| **الاستيراد عبر API** | عمليات ترحيل واسعة النطاق، أتمتة    | غير محدود          |

<Note>بالنسبة لمجموعات البيانات الكبيرة جداً (مئات الآلاف من السجلات)، استخدم API. يمكن لشركائنا في [التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services) المساعدة في تشغيل هذه النصوص البرمجية عند الحاجة.</Note>

## أساسيات استيراد CSV

يمكنك استيراد البيانات لأي جسم باستخدام ملفات CSV أو XLSX أو XLS. يجب أن يحتوي كل ملف على **نوع واحد فقط من الأجسام** (مثلًا، سجلات الأشخاص فقط).

<Note>**يجب أن تكون الحقول موجودة قبل الاستيراد.** يؤدي رفع ملف CSV إلى إنشاء سجلات لكنه لا ينشئ حقولاً. إذا كنت تحتاج إلى حقول مخصّصة، فأنشئها أولاً ضمن **الإعدادات → نموذج البيانات**.</Note>

### الخطوات

1. انتقل إلى الجسم الذي تريد استيراد البيانات إليه
2. انقر أيقونة **⋮** في أعلى اليمين (هذه هي قائمة الأوامر) ثم انقر **استيراد السجلات**
3. قم بتنزيل ملف القالب للتأكد من أن بياناتك بالتنسيق المتوقع
4. ارفع ملف CSV المُنسَّق الخاص بك
5. طابِق أعمدتك مع حقول Twenty
6. راجِع الأخطاء (المظلَّلة باللون الأصفر) وأصلحها من خلال التحرير مباشرةً في واجهة المستخدم
7. أكد الاستيراد

### استيراد العلاقات بين الأجسام

يمكنك استيراد العلاقات بين الأجسام باستخدام ميزة استيراد CSV. تحتاج إلى الإشارة إلى الجسم المرتبط باستخدام حقل فريد من هذا الجسم: `id`، و`email` للأشخاص وأعضاء مساحة العمل، و`domain` للشركات، وأي حقل آخر مُعيَّن كفريد في نموذج البيانات لأي جسم آخر.

<Note>**تُحتسب السجلات المحذوفة ضمن التفرّد.** السجلات المحذوفة حذفاً ناعماً (المرئية ضمن قائمة الأوامر → عرض السجلات المحذوفة) تُدرج ضمن عمليات التحقق من التفرّد. إذا قمتَ باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم استعادة السجل المحذوف.</Note>

<Warning>
**ترتيب الاستيراد مهم!**

عند استيراد أجسام مترابطة، ارفع الملفات بهذا الترتيب:
1. **الشركات** أولاً (جانب "الواحد" من العلاقات)
2. **الأفراد** ثانياً (مرتبطون بالشركات عبر companyId)
3. **الفرص** ثالثاً (مرتبطة بالشركات/الأفراد)
4. **الأجسام المخصّصة** ذات العلاقات أخيراً

لماذا؟ يجب أن يكون جانب "الواحد" من علاقة واحد إلى متعدد موجودًا قبل أن تتمكن من الإشارة إليه. على سبيل المثال، يجب أن يكون سجل الشركة موجودًا قبل أن تستورد شخصًا يحمل معرّف تلك الشركة.
</Warning>

يرجى الرجوع إلى [هذه المقالة](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) للاطلاع على دليل خطوة بخطوة حول كيفية المتابعة.

## تصدير البيانات

صدّر بيانات مساحة العمل للنسخ الاحتياطي أو إعداد التقارير أو الترحيل.

### الخطوات

1. انتقل إلى الجسم الذي تريد تصديره
2. قم بتهيئة العرض بالأعمدة التي تحتاجها
3. انقر **⋮** → **تصدير العرض**
4. احفظ ملف CSV

<Note>**يتم تصدير الأعمدة المرئية فقط.** سيحتوي ملف CSV فقط على الأعمدة المعروضة في عرضك الحالي. أضِف الأعمدة أو أخفها قبل التصدير للتحكم في البيانات المُدرجة.</Note>

<Note>**حدود التصدير**: حتى 20,000 سجل لكل عملية تصدير.</Note>

## الصلاحيات

يتطلّب استيراد وتصدير البيانات أذونات محددة:

* **الاستيراد**: يتطلب إذن "Import CSV"
* **التصدير**: يتطلب إذن "Export CSV"

تواصل مع مسؤول مساحة العمل لديك إذا لم تكن تملك هذه الأذونات.

## الخطوات التالية

* [حضّر ملفات CSV الخاصة بك](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [استيراد العلاقات بين الأجسام](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [الاستيراد عبر API لمجموعات البيانات الكبيرة](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)
