---
title: استيراد/تصدير البيانات
info: "تعرف على كيفية استيراد وتصدير البيانات."
image: /images/user-guide/import-export-data/cloud.png
sectionInfo: اكتشف Twenty، برنامج CRM مفتوح المصدر.
---

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

<Frame>
  <img src="/images/user-guide/import-export-data/cloud.png" alt="Header" />
</Frame>

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

- يمكنك استيراد البيانات لأي جسم باستخدام ملف .csv، .xlsx، أو .xls.
- كل ملف تقوم برفعه يجب أن يحتوي على **نوع واحد فقط من الأجسام** (مثلًا، سجلات الأشخاص فقط).
- يمكنك استخدام الاستيراد لإنشاء **أو تحديث السجلات**.

### قم بتنزيل ملف نموذجي لمطابقة التنسيق المتوقع

1. اذهب إلى عرض مع الجسم الذي توشك على استيراده.
2. انقر على أيقونة `⋮` في أعلى اليمين ثم اختر `استيراد السجلات`.
3. انقر على `تحميل الملف النموذجي`.

### جهز ملف csv الخاص بك

أدناه بعض العناصر للتحقق منها قبل رفع ملفك.

- قم بتحديد عدد السجلات عند **10,000 لكل ملف**.
- **أزل التكرارات** من ملفك.
  - التفرد في `الأشخاص` يُحدد في الأصل باستخدام `id` و`البريد الإلكتروني`. لديك القدرة أيضًا على تعريف الحقول المخصصة من `الأشخاص` كفريدة عند تكوين نموذج بياناتك.
  - التفرد في `الشركات` يُحدد في الأصل باستخدام `id` و`النطاق`. لديك القدرة أيضًا على تعريف الحقول المخصصة من `الشركات` كفريدة عند تكوين نموذج بياناتك.
  - بالنسبة لأي جسم آخر، بما في ذلك الأجسام المخصصة، لديك القدرة على تعريف بعض الحقول كفريدة. تأكد من عدم تضمين التكرارات عند تجهيز ملفاتك.
- نوصي باستخدام الصيغة `https://domain.com` عند رفع نطاقاتك، حيث أن هذه هي المستخدمة من قبل موصلنا مع صندوق بريدك وتطبيق التقويم.
- يمكنك **استيراد العلاقات بين الأجسام** بتقديم أحد الحقول الفريدة للسجل المرتبط.
  - مثال: تريد إرفاق شخص بشركة. أضف عمود في الملف يحتوي على جميع سجلات `الأشخاص` ويحتوي على `id` للشركة -- أو نطاقها. ستكون قادرًا على تعيين هذا الحقل أثناء التحميل.
    <Warning>

**ملحوظة هامة:**

- العلاقات بين الأجسام في Twenty هي "واحد إلى متعدد". هذا يعني أن كل سجل للجسم A يمكن إرفاقه بعدة سجلات للجسم B. ولكن كل سجل للجسم B يمكن أن ينتمي إلى سجل واحد فقط من الجسم A.
  _مثال، يمكن للشركة أن ترتبط بعدة أشخاص. ويمكن أن ينتمي الشخص الواحد إلى شركة واحدة فقط._

- لتحميل العلاقات عبر وظيفة الاستيراد، تحتاج إلى تقديم `id` (أو أي حقل فريد آخر) للجسم الملحق في الملف الذي يحتوي على السجلات على "جانب متعدد" من العلاقة.  
  _على سبيل المثال، تقدم `id` أو `النطاق` للشركة عند رفع سجلات الأشخاص. أنت لا تزود `id` الأشخاص (أو `البريد الإلكتروني`) عند تحميل الملف مع الشركات._
  </Warning>

### ارفع ملفك

1. اذهب إلى عرض مع الجسم الذي توشك على استيراده.
2. انقر على أيقونة `⋮` في أعلى اليمين ثم اختر `استيراد السجلات`.
3. انقر على `اختر الملف`.
4. Validate the mapping of the fields.

- ليس عليك استيرادها جميعها، يمكنك اختيار خيار "لا تعيين".
- للعلاقات، يُوصى بتعيين أحد الحقول الفريدة فقط.
- قد تحتاج أيضًا إلى تعيين قيم الحقول من نوع التحديد والمننوع التحديد المتعدد.

5. انقر على `الخطوات التالية` و`راجع الصفوف مع الأخطاء`. الخلايا التي بها مشكلة مميزة. **يمكنك إما إزالة الصف أو تحديث الخلية مباشرة من هناك**.
6. بمجرد الانتهاء، انقر على `تأكيد`

<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}}/>

### أسئلة شائعة حول الاستيراد

<details><ملخص>أرى مشاكل التكرارات عند رفع ملفي، ماذا يمكنني أن أفعل؟</ملخص>

يرجى الرجوع إلى قسم **جهز ملف csv الخاص بك** أعلاه في هذه المقالة، حيث يحتوي على إرشادات حول ما سيتم اعتباره تكراراً.

</details>

<details><ملخص>هل يمكنني استيراد العلاقات بين الأجسام؟</ملخص>

نعم، يرجى الرجوع إلى قسم **جهز ملف csv الخاص بك** أعلاه في هذه المقالة، حيث يحتوي على قسم يتعلق باستيراد العلاقات.

</details>

<details><ملخص>هل يمكنني تحديث السجلات الحالية باستخدام وظيفة الاستيراد؟</ملخص>

نعم يمكنك تحديث السجلات الحالية باستخدام وظيفة الاستيراد. تأكد من تقديم `id` (أو أي حقل فريد آخر) عند إعادة رفع سجلاتك.

</details>

<details><ملخص>هل يمكنني نقل `id` من أدواتي الأخرى؟</ملخص>

نعم. تحتاج إلى إنشاء حقل تحدده كفريد في نموذج البيانات الخاص بك الذي سيحتوي على `id` من أدواتك الأخرى. يرجى ملاحظة أن الاسم `id` محمي حيث يستخدم لـ id الخاص بـ Twenty.  
إذا كنت تريد إنشاء العلاقات بين الأجسام باستخدام هذا الحقل، ارجع إلى قسم **جهز ملف csv الخاص بك** أعلاه في هذه المقالة. يحتوي على قسم يتعلق باستيراد العلاقات.

</details>

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

يمكنك تنزيل البيانات من معظم الأجسام وحتى 20,000 سجل لكل تصدير.
لتصدير البيانات من جسم:

1. قم بزيارة مؤشر الجسم.
2. اختر العرض لتصدير البيانات. قم بتكوين الأعمدة التي تريد تنزيلها عن طريق إخفاء أو إضافة أعمدة وابحث عن السجلات التي تحتاجها عن طريق تصفية عرضك.
3. قم بالوصول إلى اللوحة الجانبية من خلال أيقونة `⋮` في أعلى اليمين.
4. انقر على `تصدير العرض`.
5. حدد موقع الحفظ لبيانات CSV. يرجى ملاحظة أن التصدير قد يستغرق وقتًا عندما يكون عدد السجلات كبيرًا.

<VimeoEmbed videoId="926226303" title="Video demonstration" />

