Struttura base dello schema
Gli schemi delle entità sono definiti in file JSON nella directory delle entità del tuo progetto. Per impostazione predefinita, èbase44/entities/, ma puoi personalizzare il percorso nella configurazione del progetto. Il nome del file determina il nome dell’entità. Ad esempio, Task.json crea un’entità Task.
Ecco un modello di schema di entità:
Campi integrati
Ogni record di entità include automaticamente i seguenti campi. Non definire campi con questi nomi nel tuo schema.
I campi interni non sono restituiti nelle risposte API e non puoi usarli nelle regole di sicurezza.
Campi dello schema
Oggetto contenente le definizioni dei campi. Ogni campo ha un
type e regole
di validazione opzionali.Tipi di campo
Le entità supportano vari tipi di campo per definire diversi tipi di dati che puoi memorizzare:string, integer, number, boolean, array e object.
Ogni campo dentro properties richiede un type. In base al tipo, puoi aggiungere opzioni di validazione.
Campi stringa
I campi stringa supportano queste opzioni:minLength/maxLength: controllano il numero minimo e massimo di caratteri.pattern: espressione regolare per la validazione personalizzata.format: formati predefiniti. Valori supportati:"date""date-time""time""email""uri""hostname""ipv4""ipv6""uuid"
enum: limita a valori specifici consentiti. Definisci come array:["value1", "value2", "value3"].default: valore predefinito se non ne viene fornito uno.
Campi interi
I campi interi supportano queste opzioni:minimum/maximum: impostano limiti inferiore/superiore inclusivi.default: valore predefinito se non ne viene fornito uno.
Campi numerici
I campi numerici supportano queste opzioni:minimum/maximum: impostano limiti inferiore/superiore inclusivi.default: valore predefinito se non ne viene fornito uno.
Campi booleani
I campi booleani supportano queste opzioni:default: valore predefinito se non ne viene fornito uno.
Campi array
I campi array supportano queste opzioni:items: definisce il tipo/schema per gli elementi dell’array.default: valore array predefinito se non ne viene fornito uno.
Campi oggetto
I campi oggetto supportano queste opzioni:properties: definisce i campi all’interno dell’oggetto.required: elenco dei nomi delle proprietà obbligatorie.
Campi obbligatori
Specifica quali campi devono essere forniti:Unicità
Le entità di Base44 non supportano vincoli di unicità. Una proprietà che non fa parte del formato dello schema, comeunique_fields, viene memorizzata con il tuo schema e ignorata.
Per evitare record duplicati, verifica l’esistenza di un record in una funzione backend prima di crearne uno nuovo. Un controllo di questo tipo riduce la finestra per i duplicati ma non la elimina. Per assicurarti che un solo utente riesca, usa il pattern di claim descritto in aggiornamenti concorrenti.
Aggiornamenti concorrenti
Base44 non blocca i record e non esegue transazioni su più record. Quando 2 utenti o processi modificano gli stessi dati nello stesso momento, ogni scrittura viene applicata separatamente. Questa sezione spiega quali aggiornamenti sono atomici, come rivendicare un record in modo sicuro e cosa aspettarti dalle chiamate che scrivono più record.Rivendicare un record in modo sicuro
Per assicurarti che un solo utente possa rivendicare un record esistente, come un’attività o uno slot di prenotazione, chiamaupdateMany() con l’id di quel singolo record e le condizioni che devono essere ancora vere. L’aggiornamento viene applicato solo se quelle condizioni corrispondono ancora al momento della scrittura. Così, quando 2 utenti ci provano nello stesso momento, solo uno dei due riesce. Controlla updated nella risposta per vedere se il tuo è riuscito.
Scrivere più record
bulkCreate(), bulkUpdate(), updateMany(), deleteMany() e upsert() non sono transazioni. Ogni record viene scritto separatamente, quindi se una chiamata fallisce a metà, i record già scritti restano scritti. Progetta queste chiamate in modo che sia sicuro eseguirle di nuovo, per esempio filtrando i record già aggiornati.
Chiamate upsert() concorrenti con la stessa chiave possono creare record duplicati.
Esempio completo
Ecco uno schema di entità completo:Distribuzione delle entità
Dopo aver definito lo schema dell’entità, distribuiscilo a Base44 usandoentities push. Le entità vengono anche distribuite automaticamente quando esegui il comando deploy per distribuire l’intero progetto.
Una volta distribuita, puoi interagire con le tue entità usando il modulo entities dell’SDK. Il nome dell’entità nel tuo schema deve corrispondere esattamente a come vi accedi nell’SDK, incluse le maiuscole. Ad esempio, se il tuo schema ha "name": "Task", devi accedervi come base44.entities.Task.list().
Gli schemi delle entità distribuite possono essere visualizzati nella dashboard nella sezione Data.
Vedi anche
- Schema utente: entità integrata speciale per l’autenticazione degli utenti
- Sicurezza: configura regole di sicurezza a livello di riga per le entità
- Struttura del progetto: come gli schemi delle entità si inseriscono nel tuo progetto
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.