e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
210 lines
11 KiB
Plaintext
210 lines
11 KiB
Plaintext
---
|
|
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/api).</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/api)
|
|
|
|
## نصائح وأفضل الممارسات
|
|
|
|
### إنشاء عروض للتصدير
|
|
|
|
احفظ عروضًا مُهيّأة خصيصًا لعمليات التصدير:
|
|
|
|
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/api) — أنشئ عمليات سير عمل تصدير مخصصة
|