Estendere gli oggetti

​

Panoramica

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' },
  ],
});

​

Punti chiave

• objectUniversalIdentifier identifica l’oggetto di destinazione. Per gli oggetti standard di Twenty, importa la costante da 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
  // …
  
• Quando definisci campi inline dentro defineObject(), non hai bisogno di objectUniversalIdentifier — viene ereditato dall’oggetto padre.
• defineField() è l’unico modo per aggiungere campi a oggetti che non hai creato con defineObject().
• SELECT e MULTI_SELECT seguono le stesse regole di convalida delle opzioni e dei colori dei campi in linea. Un colore omesso o null usa per impostazione predefinita gray; i colori non supportati vengono rifiutati.
• Il percorso del file dipende da te. La convenzione è src/fields/\<name>.field.ts, ma la CLI rileva i campi ovunque in src/.
• È possibile impostare isSearchable: true su defineField() con gli stessi vincoli dei campi inline (oggetto di destinazione ricercabile, tipo di campo compatibile con il testo), in modo che i record dell’oggetto di destinazione siano individuabili tramite i valori del campo nella ricerca full-text.
• È possibile impostare isAuditLogged: false su defineField() per escludere le modifiche del campo dalla cronologia del record di destinazione, il che è particolarmente importante per i campi che l’app riscrive secondo una pianificazione.
• Per aggiungere una scheda a un layout di pagina standard (ad es. la pagina di dettaglio di Task o Company), utilizza definePageLayoutTab con STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS da twenty-sdk/define.

​

Aggiungere una relazione a un oggetto esistente