توسيع الكائنات

​

نظرة عامة

import { defineField, FieldType } from 'twenty-sdk/define';

export default defineField({
  universalIdentifier: 'f2a1b3c4-d5e6-7890-abcd-ef1234567890',
  objectUniversalIdentifier: '701aecb9-eb1c-4d84-9d94-b954b231b64b', // Company object
  name: 'loyaltyTier',
  type: FieldType.SELECT,
  label: 'Loyalty Tier',
  icon: 'IconStar',
  options: [
    { value: 'BRONZE', label: 'Bronze', position: 0, color: 'orange' },
    { value: 'SILVER', label: 'Silver', position: 1, color: 'gray' },
    { value: 'GOLD', label: 'Gold', position: 2, color: 'yellow' },
  ],
});

​

النقاط الرئيسية

• objectUniversalIdentifier يحدّد الكائن الهدف. بالنسبة لكائنات Twenty القياسية، استورد الثابت من twenty-sdk:
  import { STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS } from 'twenty-sdk/define';
  
  // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.company.universalIdentifier
  // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.person.universalIdentifier
  // STANDARD_OBJECT_UNIVERSAL_IDENTIFIERS.opportunity.universalIdentifier
  // …
  
• عند تعريف الحقول بشكل مضمّن داخل defineObject()، لا تحتاج إلى objectUniversalIdentifier — إذ يُورَّث من الكائن الأب.
• defineField() هي الطريقة الوحيدة لإضافة حقول إلى كائنات لم تُنشئها باستخدام defineObject().
• يتبع SELECT وMULTI_SELECT قواعد التحقق من الخيارات والألوان نفسها المتبعة في الحقول المضمنة. يكون اللون المحذوف أو الفارغ افتراضيًا gray؛ وتُرفض الألوان غير المدعومة.
• موقع الملف متروك لك. المتعارف عليه هو src/fields/\<name>.field.ts، لكن واجهة CLI تكتشف الحقول في أي مكان داخل src/.
• يمكن تعيين isSearchable: true على defineField() مع القيود نفسها المطبقة على الحقول المضمنة (كائن هدف قابل للبحث، ونوع حقل متوافق مع النص)، بحيث تصبح سجلات كائن الهدف قابلة للعثور عليها من خلال قيم حقلك في البحث بالنص الكامل.
• يمكن ضبط isAuditLogged: false على defineField() لإبقاء تغييرات الحقل خارج المخطط الزمني لسجل الهدف، وهو أمر مهم للغاية للحقول التي يعيد تطبيقك كتابتها وفق جدول زمني.
• لإضافة علامة تبويب إلى تخطيط صفحة قياسي (مثل صفحة تفاصيل Task أو Company)، استخدم definePageLayoutTab مع STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS من twenty-sdk/define.

​

إضافة علاقة إلى كائن موجود