---
title: تصدير بياناتك
description: دليل كامل خطوة بخطوة لتصدير البيانات من Twenty.
---

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

## نظرة عامة

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

**حالات الاستخدام:**

* **نسخ احتياطية منتظمة** — احتفظ بنسخ من بياناتك
* **تقارير خارجية** — حلّل البيانات في Excel وGoogle Sheets أو أدوات ذكاء الأعمال (BI)
* **الترحيل** — انقل البيانات إلى نظام آخر
* **تحديثات دفعيّة** — صدّر، ثم حرّر وأعد الاستيراد لتحديث السجلات

## ما تحتاج إلى معرفته

### حدود التصدير

* **حد أقصى 20,000 سجل** لكل عملية تصدير
* يتم تصدير **الأعمدة المرئية** فقط
* يتم تصدير **السجلات المصفّاة** فقط (استنادًا إلى العرض الحالي لديك)

<Note>بالنسبة لعمليات التصدير الأكبر (أكثر من 20,000 سجل)، استخدم عوامل التصفية للتصدير على دفعات أو استخدم [واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/capabilities/apis).</Note>

### الصلاحيات

تحتاج إلى صلاحية **"تصدير CSV"** لتصدير البيانات. تواصل مع مشرف مساحة العمل إذا لم يكن هذا الخيار متاحًا لديك.

## الخطوة 1: الانتقال إلى الكائن

اذهب إلى الكائن الذي تريد تصديره:

* **الأشخاص** — لجهات الاتصال
* **الشركات** — للمؤسسات
* **الفرص** — للصفقات
* **كائنات مخصصة** — أي كائن قمت بإنشائه

## الخطوة 2: تهيئة العرض الخاص بك

**مهم:** يتضمن التصدير فقط ما هو مرئي في عرضك الحالي.

### إضافة/إزالة الأعمدة

1. انقر **الخيارات → الحقول** (أو **+** في نهاية الأعمدة)
2. حدّد الحقول التي تريد تصديرها
3. ألغ تحديد الحقول التي لا تحتاجها

### تصفية السجلات (اختياري)

إذا كنت تحتاج فقط إلى مجموعة فرعية من البيانات:

1. انقر على **تصفية**
2. أضف شروط التصفية (مثال: "تاريخ الإنشاء > 1 يناير 2024")
3. سيتم تصدير السجلات المطابقة فقط

### فرز السجلات (اختياري)

1. انقر على عنوان عمود للفرز
2. سيتبع التصدير ترتيب الفرز الذي اخترته

<Note>**أنشئ عرضًا مخصصًا للتصدير.** احفظ عرضًا مُهيّأً خصيصًا لعمليات التصدير حتى لا تحتاج إلى إعادة التهيئة في كل مرة.</Note>

## الخطوة 3: تصدير البيانات

1. انقر على أيقونة **⋮** في أعلى يمين الجدول
2. حدد **تصدير العرض**
3. اختر مكان حفظ ملف CSV
4. انتظر حتى يكتمل التنزيل

## ما الذي يتم تصديره

| متضمن                                   | غير متضمن                    |
| --------------------------------------- | ---------------------------- |
| جميع الأعمدة المرئية                    | الأعمدة المخفية              |
| السجلات المطابقة لعوامل التصفية الحالية | السجلات المُستبعدة بالتصفية  |
| قيم الحقول المخصصة                      | الحقول غير الموجودة في العرض |
| معرّفات السجلات                         | مرفقات الملفات               |
| معرّفات العلاقات                        | الصور                        |

### حقول العلاقات

يتم تصدير معرّفات العلاقات فقط على جانب "المتعدد" من العلاقة:

* **تصدير الأشخاص** يتضمن عمود `companyId` (علاقة الأشخاص → الشركة)
* **تصدير الشركات** لا يتضمن `peopleIds` (الشركات هي جانب "الواحد")

هذا يعني أنه يمكنك استخدام تصدير الأشخاص لإعادة الاستيراد والحفاظ على رابط الشركة، لكن ستحتاج إلى إعادة استيراد الأشخاص بعد الشركات لإعادة إنشاء العلاقات.

## التصدير لأغراض محددة

### للنسخ الاحتياطي

1. أنشئ عرضًا تكون فيه **جميع الحقول** مرئية
2. أزل جميع عوامل التصفية لتضمين كل السجلات
3. صدّر كل نوع من الكائنات على حدة
4. احفظ ملفات التصدير في موقع آمن
5. عيّن تذكيرًا متكررًا (أسبوعي/شهري)

### للتقارير الخارجية

1. ضمّن فقط الحقول التي تحتاجها للتحليل
2. طبّق عوامل تصفية للتركيز على البيانات ذات الصلة
3. فكّر في الفرز حسب الحقل الذي ستقوم بتحليله

### للتحديثات الدفعيّة

1. صدّر السجلات التي تريد تحديثها
2. ضمّن المعرّف الفريد (`email`، `domain`، أو `id`)
3. حرّر الملف المُصدَّر
4. أعد الاستيراد لتحديث السجلات
   راجع: [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import)

### للترحيل

إذا كنت تقوم بالتصدير للترحيل إلى نظام آخر:

1. **صدّر كل كائن على حدة** — الأشخاص، الشركات، الفرص، إلخ.
2. **ضمّن حقول المعرّف** — فهي تساعد في الحفاظ على العلاقات
3. **وَثِّق مطابقة الحقول** — دوّن كيفية توافق حقول Twenty مع نظامك المستهدف

## التعامل مع مجموعات بيانات كبيرة (أكثر من 20,000 سجل)

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

### الخيار 1: التصدير على دفعات

1. أضف عامل تصفية (مثال: نطاقات "تاريخ الإنشاء")
2. صدّر الدفعة الأولى
3. غيِّر عامل التصفية
4. صدّر الدفعة التالية
5. ادمج الملفات في تطبيق جداول البيانات لديك

**أمثلة لعوامل التصفية للتجميع على دفعات:**

* حسب النطاق الزمني (يناير، فبراير، مارس...)
* حسب المالك (عضو الفريق أ، عضو الفريق ب...)
* حسب الحالة (نشط، غير نشط...)

### الخيار 2: استخدام واجهة برمجة التطبيقات (API)

لا يوجد حد للسجلات في واجهة برمجة التطبيقات (API):

1. احصل على مفتاح API من **الإعدادات → المطوّرون**
2. استخدم واجهة برمجة تطبيقات GraphQL للاستعلام عن السجلات
3. عالج النتائج في تطبيقك

راجع: [وثائق واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/capabilities/apis)

## نصائح وأفضل الممارسات

### إنشاء عروض للتصدير

احفظ عروضًا مُهيّأة خصيصًا لعمليات التصدير:

1. هيّئ الأعمدة وعوامل التصفية
2. انقر **خيارات العرض** → **حفظ كعرض جديد**
3. سمّه "تصدير - [الغرض]"

### أمّن عمليات التصدير الخاصة بك

قد تحتوي ملفات التصدير على بيانات حساسة:

* احفظها في مواقع آمنة
* احذف عمليات التصدير القديمة عندما لا تعود مطلوبة
* كن حذرًا عند مشاركة ملفات التصدير

### تحقّق قبل التصدير

<Check>الأعمدة الصحيحة مرئية</Check>
<Check>تم ضبط عوامل التصفية بشكل صحيح (أو تمت إزالتها للتصدير الكامل)</Check>
<Check>لديك صلاحية التصدير</Check>

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="لماذا تفتقد عملية التصدير بعض الأعمدة؟">
    يتم تصدير الأعمدة المرئية فقط. أضف الأعمدة التي تحتاجها عبر **الخيارات → الحقول** قبل التصدير.
  </Accordion>

  <Accordion title="لماذا لا تحتوي عملية التصدير على جميع السجلات؟">
    تحقّق من عوامل التصفية لديك. يتضمن التصدير فقط السجلات التي تطابق عوامل التصفية في عرضك الحالي. أزل عوامل التصفية لتصدير جميع السجلات.
  </Accordion>

  <Accordion title="هل يمكنني تصدير أكثر من 20,000 سجل؟">
    ليس في عملية تصدير واحدة. استخدم عوامل التصفية للتصدير على دفعات، أو استخدم واجهة برمجة التطبيقات (API) لمجموعات البيانات الأكبر.
  </Accordion>

  <Accordion title="ما صيغة ملف التصدير؟">
    CSV (قيم مفصولة بفواصل). يفتح في Excel أو Google Sheets أو أي تطبيق لجداول البيانات.
  </Accordion>

  <Accordion title="هل يتم تضمين معرّفات العلاقات؟">
    نعم، ولكن فقط على جانب "المتعدد" من العلاقات. على سبيل المثال، يتضمن تصدير الأشخاص `companyId`، بينما لا يتضمن تصدير الشركات معرّفات الأشخاص.
  </Accordion>

  <Accordion title="هل يمكنني أتمتة عمليات التصدير؟">
    ليس مباشرة عبر واجهة المستخدم. استخدم واجهة برمجة التطبيقات (API) لبناء عمليات سير عمل تصدير مؤتمتة.
  </Accordion>
</AccordionGroup>

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

* [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import) — حرّر وأعد استيراد ملف التصدير الخاص بك
* [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api) — لمجموعات البيانات الكبيرة
* [وثائق واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/capabilities/apis) — أنشئ عمليات سير عمل تصدير مخصصة
