نظرة عامة
يأخذك هذا الدليل خلال استيراد العلاقات بين الكائنات—على سبيل المثال، ربط الأشخاص بالشركات، أو الفرص بالأشخاص.ما الذي يمكن استيراده: العلاقات من واحد إلى متعدد التي تشير إلى نوع كائن واحد فقط. العلاقات التي تشير إلى أنواع كائنات متعددة (مثل ملاحظات مرتبطة بالأشخاص والشركات معًا) غير مدعومة للاستيراد بعد.
فهم العلاقات
ما هي علاقة “واحد إلى متعدد”؟
في علاقة واحد إلى متعدد:- شركة واحدة لديها العديد من الأشخاص (الموظفين)
- شركة واحدة لديها العديد من الفرص
- شخص واحد لديه العديد من المهام
العلاقات الشائعة في Twenty
الخطوة 1: تحديد جانبي “الواحد” و”المتعدد”
قبل الاستيراد، حدّد أي الكائنات هو الأصل وأيها التابع. اسأل نفسك: “هل لدى كائن واحد من [Object A] العديد من [Object B]؟”- شركة واحدة → العديد من الأشخاص ✓ (الشركة هي الأصل)
- شخص واحد → العديد من الشركات ✗ (هذا خطأ — الشخص ينتمي إلى شركة واحدة)
الخطوة 2: استيراد سجلات الأصل أولًا
يجب أن يكون الأصل (جانب “الواحد”) موجودًا في Twenty قبل أن تتمكّن من الإشارة إليه. ترتيب الاستيراد:- الشركات أولًا (من دون تبعيات)
- الأشخاص ثانيًا (مرتبطون بالشركات)
- الفرص ثالثًا (مرتبطة بالشركات و/أو الأشخاص)
- المهام/الملاحظات (مرتبطة بأي مما سبق)
الخطوة 3: تدوين المعرّف الفريد للأصل
تحتاج إلى الإشارة إلى سجل الأصل باستخدام مُعرّف فريد. الخيارات المتاحة:موصى به: استخدم
domain للشركات وemail للأشخاص. هذه مقروءة للبشر وسهلة التحقّق منها في جدول البيانات الخاص بك.العثور على المعرّف
إذا كنت تحتاج إلىid:
- صدّر سجلات الأصل من Twenty
- يتضمن التصدير عمود
id - استخدم هذه المعرّفات في ملف سجلات التابع
الخطوة 4: التحقّق من وجود حقل العلاقة
قبل الاستيراد، تأكّد من وجود حقل العلاقة بين كائناتك. للتحقّق أو الإنشاء:- اذهب إلى الإعدادات → نموذج البيانات
- اختر كائن التابع الخاص بك (مثلًا، الأشخاص)
- ابحث عن حقل علاقة يشير إلى الأصل (مثلًا، الشركة)
- إذا لم يكن موجودًا، فقم بإنشائه:
- انقر + إضافة حقل
- اختر نوع العلاقة
- اختر كائن الأصل
الخطوة 5: جهّز ملف CSV الخاص بك
أضِف عمودًا إلى ملف CSV للتابع يشير إلى الأصل باستخدام مُعرّفه الفريد.مثال: ربط الأشخاص بالشركات
ملف CSV الخاص بالأشخاص لديك:companyDomain إلى نطاق الشركة.
متطلبات التنسيق
قواعد مهمة
- تطابق تام مطلوب — يجب أن تتطابق القيمة تمامًا مع سجل الأصل
- قم بتعيين مُعرّف فريد واحد فقط — لا تُدرج كلًّا من
companyIdوcompanyDomain - حسّاس لحالة الأحرف —
Acme.com≠acme.com
الخطوة 6: ارفع الملف وعيّن العلاقة
- انتقل إلى كائن التابع (مثلًا، الأشخاص)
- انقر ⋮ → Import records
- ارفع ملف CSV الخاص بك
- في خطوة تعيين الحقول:
- اعثر على عمود العلاقة الخاص بك (مثلًا،
companyDomain) - طابقه مع حقل علاقة Company
- اعثر على عمود العلاقة الخاص بك (مثلًا،
- أكمل التعيينات المتبقية
- راجع الأخطاء وأكّد
الخطوة 7: التحقّق من الاستيراد
بعد الاستيراد:- افتح عددًا قليلًا من سجلات التابع (مثلًا، الأشخاص)
- تحقّق من أن حقل العلاقة يعرض الأصل الصحيح (مثلًا، الشركة)
- افتح سجل الأصل وتفقّد قسم السجلات المرتبطة
أخطاء شائعة يجب تجنّبها
الربط بأعضاء مساحة العمل
عند الربط بأعضاء مساحة العمل (فريقك):- استخدم عنوان بريدهم الإلكتروني، وليس اسمهم
- مثال:
owner@yourcompany.com، وليس “John Smith”
الأسئلة الشائعة
ماذا لو لم يكن لدى سجل الأصل نطاق أو بريد إلكتروني؟
ماذا لو لم يكن لدى سجل الأصل نطاق أو بريد إلكتروني؟
لديك خياران:
- استخدم
idالخاص بـ Twenty (صدّر سجلات الأصل للحصول على معرّفاتها) - أنشئ حقلًا فريدًا مخصصًا في نموذج البيانات لتخزين معرّف خارجي من نظامك السابق
هل يمكنني تحديث العلاقات على السجلات الموجودة؟
هل يمكنني تحديث العلاقات على السجلات الموجودة؟
نعم! ضمّن المُعرّف الفريد لسجل التابع (مثلًا،
email للأشخاص) وقيمة العلاقة الجديدة. سيقوم الاستيراد بتحديث العلاقة.هل يمكنني استيراد علاقات عديدة-إلى-عدة؟
هل يمكنني استيراد علاقات عديدة-إلى-عدة؟
العلاقات عديدة-إلى-عدة غير مدعومة للاستيراد بعد. هذا مُخطّط للنصف الأول من عام 2026.
هل يمكنني الربط بأنواع كائنات متعددة (مثل ربط الملاحظات بالأشخاص والشركات معًا)؟
هل يمكنني الربط بأنواع كائنات متعددة (مثل ربط الملاحظات بالأشخاص والشركات معًا)؟
العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة للاستيراد/التصدير بعد. هذا على خارطة الطريق لدينا.
ماذا يحدث إذا كان سجل الأصل غير موجود؟
ماذا يحدث إذا كان سجل الأصل غير موجود؟
سيعرض الاستيراد خطأً لذلك الصف. يمكنك إما:
- استورد سجل الأصل أولًا، ثم أعد الاستيراد
- أصلِح قيمة المرجع
- أزل الصف من الاستيراد
لماذا لا يتم ربط العلاقة بشكل صحيح؟
لماذا لا يتم ربط العلاقة بشكل صحيح؟
أسباب شائعة:
- تنسيق غير صحيح (استخدم
https://domain.comللنطاقات) - عدم تطابق حالة الأحرف (تحقّق من التهجئة الدقيقة)
- الأصل غير موجود (استورد الأصول أولًا)
- تعيين عدة مُعرّفات (استخدم واحدًا فقط)