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 abase44/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
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 aunique_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 azupdateMany() 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.
Több rekord írása
AbulkCreate(), 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 azentities 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.