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

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().
• موقع الملف متروك لك. المتعارف عليه هو src/fields/\<name>.field.ts، لكن حزمة SDK تكتشف الحقول في أي مكان داخل src/.
• يمكن أيضًا تعيين writability على مستوى الحقل: يقتصر السماح بالكتابة في حالة MetadataWritability.APPLICATION على دوال منطق تطبيقك نفسها، بينما يُخصَّص MetadataWritability.SYSTEM للبيانات المُدارة بواسطة المنصة. لا يمكن أن يكون مستوى قابلية الكتابة للحقل إلا أكثر تقييدًا من مستوى الكائن الذي ينتمي إليه، ولا تتأثر عمليات القراءة بذلك. راجع Objects للاطّلاع على الدلالات الكاملة.
• لإضافة علامة تبويب إلى تخطيط صفحة قياسي (مثل صفحة تفاصيل Task أو Company)، استخدم definePageLayoutTab مع STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS من twenty-sdk/define.

​

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