الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يأخذك هذا الدليل خلال استيراد العلاقات بين الكائنات—على سبيل المثال، ربط الأشخاص بالشركات، أو الفرص بالأشخاص.
ما الذي يمكن استيراده: العلاقات من واحد إلى متعدد التي تشير إلى نوع كائن واحد فقط. العلاقات التي تشير إلى أنواع كائنات متعددة (مثل ملاحظات مرتبطة بالأشخاص والشركات معًا) غير مدعومة للاستيراد بعد.

​
فهم العلاقات

​
ما هي علاقة “واحد إلى متعدد”؟

في علاقة واحد إلى متعدد:
  • شركة واحدة لديها العديد من الأشخاص (الموظفين)
  • شركة واحدة لديها العديد من الفرص
  • شخص واحد لديه العديد من المهام
جانب “الواحد” هو الأصل. جانب “المتعدد” هو التابع.

​
العلاقات الشائعة في Twenty

علاقةجانب “الواحد” (الأصل)جانب “المتعدد” (التابع)
الشركات → الأشخاصالشركةالأشخاص
الشركات → الفرصالشركةالفرص
الأشخاص → المهامشخصالمهام
الأشخاص → الملاحظاتشخصالملاحظات

​
الخطوة 1: تحديد جانبي “الواحد” و”المتعدد”

قبل الاستيراد، حدّد أي الكائنات هو الأصل وأيها التابع. اسأل نفسك: “هل لدى كائن واحد من [Object A] العديد من [Object B]؟”
  • شركة واحدة → العديد من الأشخاص ✓ (الشركة هي الأصل)
  • شخص واحد → العديد من الشركات ✗ (هذا خطأ — الشخص ينتمي إلى شركة واحدة)

​
الخطوة 2: استيراد سجلات الأصل أولًا

يجب أن يكون الأصل (جانب “الواحد”) موجودًا في Twenty قبل أن تتمكّن من الإشارة إليه. ترتيب الاستيراد:
  1. الشركات أولًا (من دون تبعيات)
  2. الأشخاص ثانيًا (مرتبطون بالشركات)
  3. الفرص ثالثًا (مرتبطة بالشركات و/أو الأشخاص)
  4. المهام/الملاحظات (مرتبطة بأي مما سبق)
إذا كان سجل الأصل غير موجود، فسيفشل الاستيراد.تحقّق دائمًا من استيراد الشركات قبل استيراد الأشخاص الذين لديهم مراجع للشركات.

​
الخطوة 3: تدوين المعرّف الفريد للأصل

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

​
العثور على المعرّف

إذا كنت تحتاج إلى id:
  1. صدّر سجلات الأصل من Twenty
  2. يتضمن التصدير عمود id
  3. استخدم هذه المعرّفات في ملف سجلات التابع

​
الخطوة 4: التحقّق من وجود حقل العلاقة

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

​
الخطوة 5: جهّز ملف CSV الخاص بك

أضِف عمودًا إلى ملف CSV للتابع يشير إلى الأصل باستخدام مُعرّفه الفريد.

​
مثال: ربط الأشخاص بالشركات

ملف CSV الخاص بالأشخاص لديك: 
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
يشير عمود companyDomain إلى نطاق الشركة.

​
متطلبات التنسيق

معرّفالتنسيقمثال
النطاقتنسيق عنوان URLhttps://acme.com
البريد الإلكترونيبريد إلكتروني قياسيjohn@acme.com
المعرفUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
تنسيق النطاق مهم!استخدم https://domain.com (وليس فقط domain.com). هذا يتوافق مع طريقة تخزين Twenty لنطاقات الشركات ويمنع أخطاء المطابقة.

​
قواعد مهمة

  1. تطابق تام مطلوب — يجب أن تتطابق القيمة تمامًا مع سجل الأصل
  2. قم بتعيين مُعرّف فريد واحد فقط — لا تُدرج كلًّا من companyId وcompanyDomain
  3. حسّاس لحالة الأحرف — Acme.com ≠ acme.com

​
الخطوة 6: ارفع الملف وعيّن العلاقة

  1. انتقل إلى كائن التابع (مثلًا، الأشخاص)
  2. انقر ⋮ → Import records
  3. ارفع ملف CSV الخاص بك
  4. في خطوة تعيين الحقول:
    • اعثر على عمود العلاقة الخاص بك (مثلًا، companyDomain)
    • طابقه مع حقل علاقة Company
  5. أكمل التعيينات المتبقية
  6. راجع الأخطاء وأكّد
سيقوم Twenty بربط كل سجل تابع تلقائيًا بالأصل المطابق.

​
الخطوة 7: التحقّق من الاستيراد

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

​
أخطاء شائعة يجب تجنّبها

الخطأالمشكلةالحل
ترتيب استيراد خاطئاستيراد الأشخاص قبل الشركاتاستورد دائمًا الأصول أولًا، ثم التوابع
تنسيق نطاق غير صحيحاستخدام acme.com بدلًا من https://acme.comاستخدم تنسيق عنوان URL الكامل مع https://
حقول فريدة متعددةتعيين كلٍّ من companyId وcompanyDomainقم بتعيين مُعرّف فريد واحد فقط
حقل علاقة مفقودحقل العلاقة غير موجود في نموذج البياناتقم بإنشائه ضمن الإعدادات → نموذج البيانات قبل الاستيراد
سجلات غير موجودةسجل الأصل غير موجود في Twentyاستورد سجلات الأصل أولًا، أو تحقّق من الأخطاء الإملائية
عدم تطابق حالة الأحرفAcme.com في الملف ولكن acme.com في Twentyتأكّد من تطابق حالة الأحرف تمامًا

​
الربط بأعضاء مساحة العمل

عند الربط بأعضاء مساحة العمل (فريقك):
  • استخدم عنوان بريدهم الإلكتروني، وليس اسمهم
  • مثال: owner@yourcompany.com، وليس “John Smith”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

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

لديك خياران:
  1. استخدم id الخاص بـ Twenty (صدّر سجلات الأصل للحصول على معرّفاتها)
  2. أنشئ حقلًا فريدًا مخصصًا في نموذج البيانات لتخزين معرّف خارجي من نظامك السابق
نعم! ضمّن المُعرّف الفريد لسجل التابع (مثلًا، email للأشخاص) وقيمة العلاقة الجديدة. سيقوم الاستيراد بتحديث العلاقة.
العلاقات عديدة-إلى-عدة غير مدعومة للاستيراد بعد. هذا مُخطّط للنصف الأول من عام 2026.
العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة للاستيراد/التصدير بعد. هذا على خارطة الطريق لدينا.
سيعرض الاستيراد خطأً لذلك الصف. يمكنك إما:
  • استورد سجل الأصل أولًا، ثم أعد الاستيراد
  • أصلِح قيمة المرجع
  • أزل الصف من الاستيراد
أسباب شائعة:
  • تنسيق غير صحيح (استخدم https://domain.com للنطاقات)
  • عدم تطابق حالة الأحرف (تحقّق من التهجئة الدقيقة)
  • الأصل غير موجود (استورد الأصول أولًا)
  • تعيين عدة مُعرّفات (استخدم واحدًا فقط)
تذكير: السجلات المحذوفة حذفًا ناعمًا تُحتسب ضمن التفرد.إذا كنت تتلقى أخطاء “not found” ولكن يبدو أن السجل موجود، فتحقّق من قائمة الأوامر → عرض السجلات المحذوفة. قد يكون السجل الأصل قد حُذِف حذفًا منطقيًا.

​
استكشاف الأخطاء وإصلاحها

هل تواجه مشكلات؟ اطّلع على: