98 lines
5.9 KiB
Plaintext
98 lines
5.9 KiB
Plaintext
---
|
|
title: Prezentare generală
|
|
description: Modelați datele pe care aplicația le adaugă într-un spațiu de lucru — obiecte, câmpuri și relații.
|
|
icon: database
|
|
---
|
|
|
|
Stratul de **date** al unei aplicații Twenty reprezintă datele pe care aplicația le *adaugă* într-un spațiu de lucru — noile tipuri de înregistrări pe care le declară, coloanele pe care le adaugă la obiectele existente și modul în care aceste înregistrări se conectează între ele.
|
|
|
|
```text
|
|
┌──────────────────────────────────────────────────┐
|
|
│ Object — a record type, e.g. PostCard │
|
|
│ ├─ Field (name, type, label) │
|
|
│ ├─ Field │
|
|
│ └─ Relation (link to another object) │
|
|
└──────────────────────────────────────────────────┘
|
|
│
|
|
├── lives in your app, OR
|
|
│
|
|
▼
|
|
┌──────────────────────────────────────────────────┐
|
|
│ Standard / other apps' objects │
|
|
│ └─ Field added by your app via defineField │
|
|
└──────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## În această secțiune
|
|
|
|
<CardGroup cols={2}>
|
|
<Card title="Obiecte" icon="table" href="/l/ro/developers/extend/apps/data/objects">
|
|
`defineObject` — declarați noi tipuri de înregistrări cu propriile lor câmpuri.
|
|
</Card>
|
|
<Card title="Extinderea obiectelor" icon="wand-magic-sparkles" href="/l/ro/developers/extend/apps/data/extending-objects">
|
|
`defineField` — adăugați câmpuri la obiecte standard sau la obiectele altor aplicații.
|
|
</Card>
|
|
<Card title="Relații" icon="diagram-project" href="/l/ro/developers/extend/apps/data/relations">
|
|
Conexiuni bidirecționale `MANY_TO_ONE` / `ONE_TO_MANY` între obiecte.
|
|
</Card>
|
|
</CardGroup>
|
|
|
|
## Entități dintr-o privire
|
|
|
|
| Entitate | Scop | Definit cu |
|
|
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
|
|
| **Obiect** | Un nou tip de înregistrare personalizat (de ex. PostCard, Invoice) cu propriile sale câmpuri | `defineObject()` |
|
|
| **Câmp** | O coloană pe un obiect. Câmpurile independente pot extinde obiecte pe care nu le-ați creat (de ex. adăugați `loyaltyTier` la Company) | `defineField()` |
|
|
| **Relație** | O legătură bidirecțională între două obiecte — ambele părți declarate ca câmpuri | `defineField()` cu `FieldType.RELATION` |
|
|
| **Indice** | Un indice de bază de date pentru a accelera o interogare recurentă asupra unuia dintre obiectele tale | `defineIndex()` |
|
|
|
|
SDK-ul detectează acestea prin analiza AST la momentul build-ului, astfel încât organizarea fișierelor ține de tine — convenția este `src/objects/`, `src/fields/` și `src/indexes/`. UUID-urile stabile `universalIdentifier` leagă totul în toate implementările.
|
|
|
|
## Indici (opțional)
|
|
|
|
Aplicațiile pot livra indici împreună cu obiectele lor pentru a menține rapide interogările recurente. Cel mai comun caz este o coloană de status sau o coloană cu cheie străină pe care o citești frecvent.
|
|
|
|
```ts src/indexes/post-card-status.index.ts
|
|
import { defineIndex } from 'twenty-sdk/define';
|
|
|
|
import {
|
|
POST_CARD_UNIVERSAL_IDENTIFIER,
|
|
STATUS_FIELD_UNIVERSAL_IDENTIFIER,
|
|
} from '../objects/post-card.object';
|
|
|
|
export default defineIndex({
|
|
universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff0',
|
|
objectUniversalIdentifier: POST_CARD_UNIVERSAL_IDENTIFIER,
|
|
fields: [
|
|
{
|
|
universalIdentifier: 'b6e9d2a1-5a4c-46ca-9d52-42c8f02d1ff1',
|
|
fieldUniversalIdentifier: STATUS_FIELD_UNIVERSAL_IDENTIFIER,
|
|
},
|
|
],
|
|
});
|
|
```
|
|
|
|
### Indici unici
|
|
|
|
`defineIndex` acceptă `isUnique: true` atât pentru unicitatea pe o singură coloană, cât și pe mai multe coloane. Aceasta este primitiva recomandată — `defineField({ isUnique: true })` este învechită (deprecated) și va fi eliminată într-o versiune viitoare.
|
|
|
|
```ts
|
|
defineIndex({
|
|
universalIdentifier: '…',
|
|
objectUniversalIdentifier: PERSON_UNIVERSAL_IDENTIFIER,
|
|
isUnique: true,
|
|
fields: [{ universalIdentifier: '…', fieldUniversalIdentifier: EMAIL_FIELD_UNIVERSAL_IDENTIFIER }],
|
|
});
|
|
```
|
|
|
|
### Alte constrângeri
|
|
|
|
* Clauzele `WHERE` parțiale rămân sub controlul administratorului — aplicațiile nu le pot declara.
|
|
* Fiecare obiect este limitat la 10 indici personalizați (indicii proprii ai framework-ului nu se pun la socoteală).
|
|
|
|
Ordonează array-ul `fields` în modul în care Postgres ar trebui să îl folosească — coloana din stânga prima, ca într-o agendă telefonică. Indicii nu sunt gratuiți: fiecare scriere în tabel îi actualizează. Adaugă unul doar atunci când ai o interogare care are nevoie de el.
|
|
|
|
<Note>
|
|
Căutați **Application Config** sau **Roles & Permissions**? Acestea descriu aplicația în sine, mai degrabă decât datele pe care le adaugă — se află la [Config](/l/ro/developers/extend/apps/config/overview). Căutați **Connections** (Linear, GitHub, Slack OAuth)? Acestea există pentru a fi apelate *din* funcții de logică și se află la [Logic](/l/ro/developers/extend/apps/logic/connections).
|
|
</Note>
|