تعيين الحقول

​

كيف يعمل تعيين الحقول

​

التعيين التلقائي

• أسماء رؤوس الأعمدة (مطابقات دقيقة أو متشابهة)
• اكتشاف نوع البيانات (تواريخ، أرقام، عناوين بريد إلكتروني)
• أنماط الحقول الشائعة

​

خيارات التعيين اليدوي

• تعيين إلى حقل: اختر الحقل المطابق في Twenty من قائمة منسدلة
• عدم التعيين: تخطَّ العمود بالكامل (لن يتم استيراد البيانات)

​

توافق أنواع الحقول

​

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

​

حقول العنوان

• Address / Address 1: سطر عنوان الشارع 1
• Address / Address 2: سطر عنوان الشارع 2
• Address / City: اسم المدينة
• Address / State: الولاية أو المقاطعة
• Address / Country: اسم الدولة
• Address / Post Code: الرمز البريدي/ZIP

​

حقول المصفوفة

[\"value1\",\"value2\"]

​

حقول القيم المنطقية

​

حقول العملة

• Amount / Amount: القيمة الرقمية (مثال: 1234.56)
• Amount / Currency: رمز العملة (مثال: USD، EUR)

​

حقول التاريخ

• YYYY-MM-DD (موصى به)
• MM/DD/YYYY
• DD/MM/YYYY
• تنسيق ISO 8601

​

حقول النطاق

• يُوصى باستخدام التنسيق https://domain.com لتجنب إنشاء التكرارات، إذ إن هذا هو التنسيق المستخدم للشركات التي يتم إنشاؤها عبر مزامنة صندوق البريد والتقويم
• يمكن ملء حقلي Domain Label وDomain URL: وأفضل ممارسة هي وضع domain.com في التسمية وhttps://domain.com في عنوان URL
• يجب أن تكون النطاقات فريدة داخل كائن الشركات
• يجب أن تكون النطاقات فريدة داخل الملف المُراد استيراده

​

حقول البريد الإلكتروني

• يجب أن تكون بتنسيق بريد إلكتروني صحيح
• يجب أن تكون عناوين البريد الإلكتروني فريدة داخل كائن الأشخاص
• يجب أن تكون عناوين البريد الإلكتروني فريدة داخل الملف المُراد استيراده
• للبريد الإلكتروني الإضافي: استخدم Emails / Primary Email للبريد الرئيسي، وEmails / Additional Emails بهذا التنسيق:

[\"[email protected]\",\"[email protected]\"]

​

حقول المعرّف

• تعيين معرّف محدد: اختر UUID للسجلات التي سيتم إنشاؤها
• تحديث السجلات الحالية: طابِق السجلات الحالية لتحديثها بدلاً من إنشاء تكرارات. في هذه الحالة، يُنصح بعدم تعيين الحقول الفريدة الأخرى: فاقتصار التعيين على حقل فريد واحد يضمن عملية استيراد أكثر سلاسة.

​

حقول JSON

{"key":"value","key2":"value2"}

​

حقول الروابط

• املأ عمودي التسمية والرابط معًا: Links / Link URL وLinks / Link Label
• استخدم تنسيق الرابط الكامل: https://example.com
• للروابط الثانوية، استخدم عمود Links / Secondary Links بهذا التنسيق:

[{\"url\":\"https://twenty.com\",\"label\":\"Twenty\"}]

​

حقول التحديد المتعدد

[\"VALUE1\",\"VALUE2\"]

​

حقول الأرقام

• أرقام فقط
• تُكتب الكسور العشرية بنقطة: 1234.56
• من دون فواصل آلاف

​

حقول الهاتف

• Phones / Primary Phone Number: رقم الهاتف (مثال: 4159095555)
• Phones / Primary Phone Country Code: رمز الدولة (مثال: US)
• Phones / Primary Phone Calling Code: رمز الاتصال (مثال: +1)

​

حقول التقييم

​

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

​

حقول الاختيار

VALUE1

​

الحقول النصية

• لا يلزم تنسيق خاص
• تُزال المسافات في البداية والنهاية

​

العثور على أسماء واجهة برمجة التطبيقات

​

كيفية العثور على أسماء واجهة برمجة التطبيقات

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