Skip to main content
Usa defineField() per aggiungere un campo a un oggetto che non possiedi — un oggetto standard di Twenty come Person o Company, oppure un oggetto fornito da un’altra app installata. A differenza dei campi inline dichiarati all’interno di defineObject, i campi autonomi richiedono un objectUniversalIdentifier per specificare quale oggetto estendono.
src/fields/company-loyalty-tier.field.ts

​
Punti chiave

  • objectUniversalIdentifier identifica l’oggetto di destinazione. Per gli oggetti standard di Twenty, importa la costante da twenty-sdk:
  • 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().
  • Il percorso del file dipende da te. La convenzione è src/fields/\<name>.field.ts, ma l’SDK rileva i campi ovunque in src/.
  • La writability può anche essere impostata per singolo campo: MetadataWritability.APPLICATION limita le scritture alle sole funzioni di logica della tua app, mentre MetadataWritability.SYSTEM è riservata ai dati gestiti dalla piattaforma. La writability di un campo può essere solo più restrittiva rispetto al livello del relativo oggetto e le letture non sono influenzate. Consulta Objects per i dettagli completi sulla semantica.
  • 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

Per aggiungere un campo di relazione (ad esempio collegare il tuo oggetto personalizzato a un Person standard), usa defineField() con FieldType.RELATION. Lo schema è lo stesso delle relazioni inline, ma con objectUniversalIdentifier impostato esplicitamente. Vedi Relazioni per lo schema bidirezionale.