> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entitássémák

> Egyéni adatszerkezetek definiálása JSON Schemával, validálási szabályokkal és mezőtípusokkal

Ön a fejlesztői dokumentációt nézi

Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól. Az alkalmazásadatok alkalmazásszerkesztőben történő kezeléséről az [Alkalmazásadatok kezelése](https://docs.base44.com/hu/Building-your-app/Managing-your-app-data.md) oldalon olvashat.

Az entitásokat JSON Schema definiálja, amely leírja az adatszerkezetet és a validálási szabályokat.

## Alapvető sémaszerkezet

Az entitássémák JSON-fájlokban vannak definiálva a projekt entities könyvtárában. Ez alapértelmezés szerint a `base44/entities/` könyvtár, de az útvonalat a [projektkonfigurációban](https://docs.base44.com/hu/developers/backend/overview/project-structure.md#config-jsonc) módosíthatja. A fájlnév határozza meg az entitás nevét. A `Task.json` például egy `Task` entitást hoz létre.

Íme egy entitásséma-sablon:

```json theme={null}
{
  "name": "my_entity",
  "type": "object",
  "title": "My Entity",
  "description": "Description of what this entity represents",
  "properties": {
    "<field_name>": {
      "type": "<field_type>",
      "<option>": "<value>"
    }
  },
  "required": ["<field_name>"]
}
```

## Beépített mezők

Minden entitásrekord automatikusan tartalmazza a következő mezőket. Ne definiáljon ilyen nevű mezőket a sémában.

| Mező | Típus | Leírás |
| - | - | - |
| `id` | string | A rekord egyedi azonosítója |
| `created_date` | datetime | A rekord létrehozásának időpontja |
| `updated_date` | datetime | A rekord utolsó frissítésének időpontja |
| `created_by` | string | A rekordot létrehozó felhasználó e-mail-címe |
| `created_by_id` | string | A rekordot létrehozó felhasználó azonosítója |
| `is_deleted` (belső) | boolean | Logikai törlés jelzője |
| `deleted_date` (belső) | datetime | A rekord törlésének időpontja |
| `is_sample` (belső) | boolean | Azt jelzi, hogy a rekord mintaadat-e |
| `entity_name` (belső) | string | Az entitástípus neve |
| `app_id` (belső) | string | Alkalmazásazonosító |
| `environment` (belső) | string | `prod` vagy `dev` |

A belső mezők nem szerepelnek az API-válaszokban, és a [biztonsági szabályokban](https://docs.base44.com/hu/developers/backend/resources/entities/security.md#condition-syntax) sem hivatkozhat rájuk.

## Sémamezők

**name** `string`

Az entitás szöveges azonosítója.

**type** `string` *required*

Értéke kötelezően `"object"`.

**title** `string`

Felhasználóbarát megjelenítendő név.

**description** `string`

Annak leírása, mit képvisel az entitás.

**properties** `object` *required*

A meződefiníciókat tartalmazó objektum. Minden mezőnek van `type` értéke és opcionális
validálási szabályai.

## Mezőtípusok

Az entitások különféle mezőtípusokat támogatnak a tárolható adatok fajtáinak meghatározásához: `string`, `integer`, `number`, `boolean`, `array` és `object`.
A `properties` minden mezőjének kötelező `type` értéke van. A típus alapján validálási beállításokat adhat hozzá.

### Szöveges mezők

A szöveges mezők a következő beállításokat támogatják:

* **`minLength`** / **`maxLength`**: A karakterek minimális és maximális számának szabályozása.
* **`pattern`**: Reguláris kifejezés egyéni validáláshoz.
* **`format`**: Előre definiált formátumok. Támogatott értékek:
  * `"date"`
  * `"date-time"`
  * `"time"`
  * `"email"`
  * `"uri"`
  * `"hostname"`
  * `"ipv4"`
  * `"ipv6"`
  * `"uuid"`
* **`enum`**: Korlátozás meghatározott megengedett értékekre. Tömbként adja meg: `["value1", "value2", "value3"]`.
* **`default`**: Alapértelmezett érték, ha nincs megadva.

### Egész szám mezők

Az egész szám mezők a következő beállításokat támogatják:

* **`minimum`** / **`maximum`**: Alsó és felső határ megadása (a határértékek megengedettek).
* **`default`**: Alapértelmezett érték, ha nincs megadva.

### Szám mezők

A szám mezők a következő beállításokat támogatják:

* **`minimum`** / **`maximum`**: Alsó és felső határ megadása (a határértékek megengedettek).
* **`default`**: Alapértelmezett érték, ha nincs megadva.

### Logikai mezők

A logikai mezők a következő beállításokat támogatják:

* **`default`**: Alapértelmezett érték, ha nincs megadva.

### Tömb mezők

A tömb mezők a következő beállításokat támogatják:

* **`items`**: A tömbelemek típusának vagy sémájának megadása.
* **`default`**: Alapértelmezett tömbérték, ha nincs megadva.

### Objektum mezők

Az objektum mezők a következő beállításokat támogatják:

* **`properties`**: Az objektumon belüli mezők megadása.
* **`required`**: A kötelező tulajdonságnevek listája.

## Kötelező mezők

Adja meg, mely mezőket kötelező megadni:

```json theme={null}
{
  "required": ["title", "email"]
}
```

## Egyediség

A Base44-entitások nem támogatják az egyediségi megkötéseket. A sémaformátumba nem tartozó tulajdonságokat, például a `unique_fields` mezőt a rendszer a sémával együtt tárolja, de figyelmen kívül hagyja.

> [!NOTE]
>
> Az ismétlődő rekordok elkerülése érdekében új rekord létrehozása előtt ellenőrizze egy backend-függvényben, hogy létezik-e már ilyen rekord. Egy ilyen ellenőrzés szűkíti az ismétlődés lehetőségét, de nem zárja ki. Ha biztosítani szeretné, hogy csak egy felhasználó járjon sikerrel, használja a [párhuzamos frissítések](#concurrent-updates) részben leírt lefoglalási mintát.

## Párhuzamos frissítések

A Base44 nem zárolja a rekordokat, és nem futtat több rekordra kiterjedő tranzakciókat. Ha 2 felhasználó vagy folyamat egyszerre módosítja ugyanazokat az adatokat, minden írás önállóan érvényesül. Ez a szakasz leírja, mely frissítések atomiak, hogyan foglalhat le biztonságosan egy rekordot, és mire számíthat a több rekordot író hívásoknál.

### Rekord biztonságos lefoglalása

Ha biztosítani szeretné, hogy egy meglévő rekordot, például egy feladatot vagy egy foglalási időpontot csak egy felhasználó foglalhasson le, hívja meg az `updateMany()` metódust az adott rekord `id` értékével és azokkal a feltételekkel, amelyeknek még teljesülniük kell. A frissítés csak akkor érvényesül, ha a feltételek az írás pillanatában még teljesülnek. Így ha 2 felhasználó egyszerre próbálkozik, csak az egyikük jár sikerrel. A válasz `updated` értékéből láthatja, hogy az Öné sikerült-e.

```javascript theme={null}
const result = await base44.entities.Task.updateMany(
  { id: taskId, status: "open" },
  { $set: { status: "claimed", claimed_by: user.email } }
);

if (result.updated === 1) {
  // This user claimed the task.
} else {
  // Someone else claimed it first, or it was no longer open.
}
```

> [!WARNING]
>
> A feltételeket a rendszer csak akkor ellenőrzi újra az írás pillanatában, ha a lekérdezés egyszerű értékként egyetlen rekord `id` értékét adja meg. Minden más lekérdezés, beleértve a `$in` vagy `$or` operátorban megadott több azonosítót is, előbb megkeresi az egyező rekordokat, majd frissíti őket. Így egy közben megváltozott rekord is frissülhet.

### Több rekord írása

A `bulkCreate()`, a `bulkUpdate()`, az `updateMany()`, a `deleteMany()` és az `upsert()` nem tranzakció. Minden rekord önállóan íródik, így ha egy hívás félúton meghiúsul, a már megírt rekordok megmaradnak. Úgy tervezze meg ezeket a hívásokat, hogy biztonságosan újrafuttathatók legyenek, például szűrje ki a már frissített rekordokat.

Az azonos kulccsal egyszerre futó `upsert()` hívások ismétlődő rekordokat hozhatnak létre.

## Teljes példa

Íme egy teljes entitásséma:

```json theme={null}
{
  "name": "Task",
  "type": "object",
  "title": "Task",
  "description": "A task item with priority, due date, and completion status",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "priority": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "default": "medium"
    },
    "completed": {
      "type": "boolean",
      "default": false
    },
    "due_date": {
      "type": "string",
      "format": "date"
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    },
    "internal_notes": {
      "type": "string",
      "rls": {
        "read": {"user_condition": {"role": "admin"}},
        "write": {"user_condition": {"role": "admin"}}
      }
    }
  },
  "required": ["title"],
  "rls": {
    "create": true,
    "read": {"created_by": "{{user.email}}"},
    "update": {"created_by": "{{user.email}}"},
    "delete": {"created_by": "{{user.email}}"}
  }
}
```

## Entitások telepítése

Az entitásséma definiálása után telepítse a Base44-re az [`entities push`](https://docs.base44.com/developers/references/cli/commands/entities-push) paranccsal. Az entitások akkor is automatikusan telepítődnek, amikor a teljes projekt telepítéséhez a [`deploy`](https://docs.base44.com/developers/references/cli/commands/deploy) parancsot futtatja.

A telepítés után az [SDK `entities` moduljával](https://docs.base44.com/developers/references/sdk/docs/type-aliases/entities) dolgozhat az entitásokkal. A sémában szereplő entitásnévnek pontosan meg kell egyeznie azzal, ahogyan az SDK-ban hivatkozik rá, a kis- és nagybetűkkel együtt. Ha például a sémában `"name": "Task"` szerepel, így kell elérnie: `base44.entities.Task.list()`.

A telepített entitássémákat az irányítópult **Data** részében tekintheti meg.

## Lásd még

* [Felhasználói séma](https://docs.base44.com/hu/developers/backend/resources/entities/user-schema.md): Különleges beépített entitás a felhasználói hitelesítéshez
* [Biztonság](https://docs.base44.com/hu/developers/backend/resources/entities/security.md): Sorszintű biztonsági szabályok konfigurálása az entitásokhoz
* [Projektstruktúra](https://docs.base44.com/hu/developers/backend/overview/project-structure.md): Hogyan illeszkednek az entitássémák a projektbe

> [!NOTE]
>
> Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az [angol nyelvű változatot](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.