Ugrás a fő tartalomhoz
Ö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 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 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:

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. A belső mezők nem szerepelnek az API-válaszokban, és a biztonsági szabályokban sem hivatkozhat rájuk.

Sémamezők

string
Az entitás szöveges azonosítója.
string
kötelező
Értéke kötelezően "object".
string
Felhasználóbarát megjelenítendő név.
string
Annak leírása, mit képvisel az entitás.
object
kötelező
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:

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.
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 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.
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:

Entitások telepítése

Az entitásséma definiálása után telepítse a Base44-re az entities push paranccsal. Az entitások akkor is automatikusan telepítődnek, amikor a teljes projekt telepítéséhez a deploy parancsot futtatja. A telepítés után az SDK entities moduljával 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: Különleges beépített entitás a felhasználói hitelesítéshez
  • Biztonság: Sorszintű biztonsági szabályok konfigurálása az entitásokhoz
  • Projektstruktúra: Hogyan illeszkednek az entitássémák a projektbe
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.