Skip to content

The open alternative to Salesforce, designed for AI.

3.7 KB
Raw Blame
---
title: Extinderea obiectelor
description: Adăugați câmpuri la obiectele standard Twenty (Person, Company, …) sau la obiecte din alte aplicații folosind defineField.
---

import { PageBanner } from "/snippets/page-banner.mdx"

## Prezentare generală

Folosiți `defineField()` pentru a adăuga un câmp la un obiect pe care nu îl dețineți — un obiect standard Twenty precum Person sau Company, sau un obiect livrat de o altă aplicație instalată. Spre deosebire de câmpurile inline declarate în interiorul [`defineObject`](/ro/developers/extend/apps/data/objects), câmpurile independente necesită un `objectUniversalIdentifier` pentru a specifica obiectul pe care îl extind.

```ts src/fields/company-loyalty-tier.field.ts
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' },
  ],
});
```

## Puncte cheie

* `objectUniversalIdentifier` identifică obiectul țintă. Pentru obiectele standard Twenty, importați constanta din `twenty-sdk`:

  ```ts
  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
  // …
  ```

* Atunci când definiți câmpuri **inline în `defineObject()`**, **nu** aveți nevoie de `objectUniversalIdentifier` — acesta este moștenit de la obiectul părinte.

* `defineField()` este singura modalitate de a adăuga câmpuri la obiecte pe care nu le-ați creat cu `defineObject()`.

* `SELECT` și `MULTI_SELECT` urmează aceleași [reguli de validare a opțiunilor și de culori](/ro/developers/extend/apps/data/objects#select-options) ca și câmpurile inline. O culoare omisă sau nulă este implicit `gray`; culorile neacceptate sunt respinse.

* Locația fișierului depinde de dumneavoastră. Convenția este `src/fields/\<name>.field.ts`, dar CLI-ul detectează câmpuri oriunde în `src/`.

* `isSearchable: true` poate fi setat pe `defineField()` cu aceleași constrângeri ca și câmpurile inline (obiect țintă căutabil, tip de câmp compatibil cu textul), astfel încât înregistrările obiectului țintă să poată fi găsite prin valorile câmpului dvs. în căutarea în text complet.

* `isAuditLogged: false` poate fi setat pe `defineField()` pentru a păstra modificările câmpului în afara cronologiei înregistrării țintă, ceea ce este important mai ales pentru câmpurile pe care aplicația dvs. le rescrie conform unui program.

* Pentru a adăuga o filă într-un layout standard de pagină (de ex. pagina de detalii pentru Task sau Company), folosește [`definePageLayoutTab`](/ro/developers/extend/apps/layout/page-layouts#definepagelayouttab) cu `STANDARD_PAGE_LAYOUT_UNIVERSAL_IDENTIFIERS` din `twenty-sdk/define`.

## Adăugarea unei relații la un obiect existent

Pentru a adăuga un câmp de tip relație (de ex. pentru a lega obiectul personalizat de un `Person` standard), folosiți `defineField()` cu `FieldType.RELATION`. Modelul este același ca pentru relațiile inline, dar cu `objectUniversalIdentifier` setat explicit. Consultați [Relații](/ro/developers/extend/apps/data/relations) pentru modelul bidirecțional.

<PageBanner illustration="card-page-extending-objects" />