> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# التحويل من نظام ذاتي الاستضافة إلى السحابة

> دليل خطوة بخطوة لترحيل مثيل Twenty ذاتي الاستضافة الخاص بك إلى Twenty Cloud.

## نظرة عامة

يرشدك هذا الدليل خلال ترحيل بياناتك من مثيل Twenty ذاتي الاستضافة إلى Twenty Cloud. تتضمن العملية إعداد مساحة العمل السحابية الخاصة بك، وتصدير بياناتك، ثم إعادة استيرادها.

<Note>يجب إعادة إنشاء العروض، وسير العمل، والأدوار يدويًا بعد الترحيل. خطط وقتًا لهذا العمل الخاص بالإعداد.</Note>

## الخطوة 1: إنشاء مساحة العمل السحابية الخاصة بك

1. انتقل إلى [app.twenty.com](https://app.twenty.com) وأنشئ مساحة عمل جديدة
2. أكمل معالج الإعداد الأولي
3. دوّن عنوان URL لمساحة العمل الجديدة لديك

## الخطوة 2: إعادة إنشاء نموذج البيانات الخاص بك

قبل استيراد البيانات، أعد إنشاء الكائنات والحقول المخصّصة لديك:

1. انتقل إلى **الإعدادات → نموذج البيانات** في مثيلك السحابي
2. أنشئ كائنات مخصّصة تتطابق مع إعدادك ذاتي الاستضافة
3. أضف حقولًا مخصّصة إلى الكائنات القياسية والمخصّصة
4. قم بضبط إعدادات الحقول (فريد، مطلوب، إلخ.)

<Note>التقط لقطات شاشة لنموذج البيانات ذاتي الاستضافة لديك كمرجع، أو اترك المثيلين مفتوحين جنبًا إلى جنب.</Note>

## الخطوة 3: دعوة جميع المستخدمين

<Warning>
  **هام: قم بدعوة المستخدمين قبل استيراد البيانات.**

  يجب على المستخدمين قبول دعواتهم قبل أن تستورد أي سجلات تُشير إليهم (مثل حقول مالك الحساب). إذا لم يكن المستخدمون موجودين بعد، فلن يمكن تعيين تلك العلاقات.
</Warning>

1. انتقل إلى **الإعدادات → الأعضاء** في مثيلك السحابي
2. ادعُ جميع أعضاء الفريق الذين كانت لديهم حسابات على المثيل ذاتي الاستضافة
3. **انتظر أن يقبل الجميع** دعواتهم
4. تحقق من ظهور جميع المستخدمين في قائمة الأعضاء لديك

## الخطوة 4: تصدير البيانات من المثيل ذاتي الاستضافة

صدِّر كل كائن من مثيلك ذاتي الاستضافة:

1. انتقل إلى كل كائن (الشركات، الأشخاص، الفرص، إلخ.)
2. قم بإعداد العرض ليُظهر **جميع الأعمدة** التي تريد ترحيلها
3. انقر **⋮ → Export view**
4. احفظ كل ملف CSV باسم واضح (مثلًا، `companies-export.csv`)

**صدِّر بالترتيب التالي** (للرجوع إليه عند الاستيراد):

1. الشركات
2. الأشخاص
3. الفرص
4. الكائنات المخصّصة (وفقًا لتبعياتها)
5. المهام، الملاحظات

## الخطوة 5: تحديث مراجع أعضاء مساحة العمل

تحتوي ملفات CSV المُصدَّرة على معرّفات المستخدمين من مثيلك ذاتي الاستضافة. هذه المعرّفات لن تتطابق مع مثيلك السحابي، لذا تحتاج إلى استبدالها بعناوين البريد الإلكتروني.

**لكل ملف CSV يحتوي على مراجع للمستخدمين (المالك، المسند إليه، إلخ.):**

1. افتح ملف CSV في تطبيق جداول بيانات
2. أضِف عمودًا جديدًا بجوار كل عمود لمعرّف المستخدم (مثلًا، `accountOwnerEmail` بجوار `accountOwnerId`)
3. املأ **عنوان البريد الإلكتروني** لكل مستخدم
4. يمكنك حذف عمود المعرّف القديم أو تركه (سيتم تخطيه أثناء الاستيراد)

**مثال:**

قبل:

```csv theme={null}
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
```

بعد:

```csv theme={null}
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
```

<Note>استخدم عناوين البريد الإلكتروني نفسها التي استخدمها المستخدمون لقبول دعوتهم إلى مساحة العمل السحابية.</Note>

## الخطوة 6: التخطيط لترتيب الاستيراد

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

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

اطّلع على [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) لمعرفة تفاصيل الحفاظ على العلاقات.

## الخطوة 7: الاستيراد إلى السحابة

لكل ملف CSV، بالتسلسل:

1. انتقل إلى الكائن في مثيلك السحابي
2. انقر **⋮ → Import records**
3. ارفع ملف CSV
4. طابق الأعمدة مع الحقول:
   * طابِق أعمدة بريد المستخدم الإلكتروني مع حقول العلاقات المناسبة
   * طابق الأعمدة الأخرى كالمعتاد
5. راجِع وأصلِح أي أخطاء
6. أكِّد عملية الاستيراد
7. تحقّق من عدد قليل من السجلات قبل المتابعة إلى الملف التالي

## الخطوة 8: إعادة إنشاء الإعدادات

بعد استيراد البيانات، أعد إنشاء ما يلي يدويًا:

### العروض

* أعد إنشاء العروض المحفوظة مع عوامل التصفية والترتيب وتكوينات الأعمدة
* قم بإعداد أي عروض كانبان أو تقويم

### سير العمل

* أعد إنشاء الأتمتة في **الإعدادات → سير العمل**
* اختبر كل سير عمل قبل الاعتماد عليه

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

* قم بتكوين الأدوار في **الإعدادات → الأعضاء → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة

### التكاملات

* أعد توصيل مزامنة البريد الإلكتروني والتقويم لكل مستخدم
* أعد تكوين أي تكاملات API بمفاتيح API جديدة

## قائمة التحقق بعد التحويل

<Check>تم استيراد جميع البيانات بنجاح</Check>
<Check>العلاقات بين الكائنات تعمل بشكل صحيح</Check>
<Check>تعيينات المستخدمين (المالك، المسند إليه) تمت مطابقتها بشكل صحيح</Check>
<Check>تمت إعادة إنشاء العروض</Check>
<Check>تمت إعادة إنشاء سير العمل واختبارها</Check>
<Check>تم تكوين الأدوار والصلاحيات</Check>
<Check>تمت إعادة توصيل مزامنة البريد الإلكتروني/التقويم</Check>
<Check>تم تحديث تكاملات API بمفاتيح جديدة</Check>

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

<AccordionGroup>
  <Accordion title="هل يمكنني ترحيل سير العمل تلقائيًا؟">
    ليس في الوقت الحالي. يجب إعادة إنشاء سير العمل يدويًا في مثيلك السحابي.
  </Accordion>

  <Accordion title="ماذا عن مرفقات الملفات والصور؟">
    مرفقات الملفات غير متضمنة في صادرات CSV. ستحتاج إلى إعادة رفع أي مرفقات يدويًا، أو ترحيلها عبر API، أو التواصل مع فريقنا للحصول على المساعدة في عمليات الترحيل الكبيرة.
  </Accordion>

  <Accordion title="هل يمكنني إبقاء المثيلين يعملان أثناء الترحيل؟">
    نعم، نوصي بإبقاء مثيلك ذاتي الاستضافة قيد التشغيل حتى تتحقق من اكتمال الترحيل إلى السحابة. فقط احرص على عدم إنشاء بيانات جديدة في كلا المكانين.
  </Accordion>

  <Accordion title="ماذا لو لم يقبل مستخدم دعوته بعد؟">
    السجلات التي تُشير إلى ذلك المستخدم ستفشل في الاستيراد أو ستكون العلاقة فارغة. تأكّد من أن جميع المستخدمين يقبلون الدعوات قبل استيراد البيانات.
  </Accordion>
</AccordionGroup>

## هل تحتاج إلى مساعدة؟

بالنسبة لعمليات الترحيل المعقّدة أو مجموعات البيانات الكبيرة، تواصل معنا عبر [contact@twenty.com](mailto:contact@twenty.com) أو اطّلع على [خدمات التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services).