Schemi delle entità

Le entità sono definite usando uno JSON Schema che descrive la struttura dei dati e le regole di validazione.

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

{
  "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>"]
}

Campi integrati

Ogni record di entità include automaticamente i seguenti campi. Non definire campi con questi nomi nel tuo schema.

Campo	Tipo	Descrizione
`id`	string	Identificatore univoco del record
`created_date`	datetime	Quando il record è stato creato
`updated_date`	datetime	Quando il record è stato aggiornato l’ultima volta
`created_by`	string	Email dell’utente che ha creato il record
`created_by_id`	string	ID dell’utente che ha creato il record
`is_deleted` (interno)	boolean	Flag di eliminazione soft
`deleted_date` (interno)	datetime	Quando il record è stato eliminato
`is_sample` (interno)	boolean	Se il record è dato di esempio
`entity_name` (interno)	string	Nome del tipo di entità
`app_id` (interno)	string	ID dell’app
`environment` (interno)	string	`prod` oppure `dev`

I campi interni non sono restituiti nelle risposte API ma possono essere referenziati nelle regole di sicurezza.

Campi dello schema

string

Identificatore stringa per l’entità.

string

obbligatorio

Deve essere "object".

string

Nome visualizzato in modo leggibile.

string

Descrizione di ciò che l’entità rappresenta.

object

obbligatorio

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:

{
  "required": ["title", "email"]
}

Esempio completo

Ecco uno schema di entità completo:

{
  "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}}"}
  }
}

Distribuzione delle entità

Dopo aver definito lo schema dell’entità, distribuiscilo a Base44 usando entities 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.

Panoramica

Guida rapida

Progetto

Strumenti di sviluppo con IA

Risorse

Struttura base dello schema

Campi integrati

Campi dello schema

Tipi di campo

Campi stringa

Campi interi

Campi numerici

Campi booleani

Campi array

Campi oggetto

Campi obbligatori

Esempio completo

Distribuzione delle entità

Vedi anche

​Struttura base dello schema

​Campi integrati

​Campi dello schema

​Tipi di campo

​Campi stringa

​Campi interi

​Campi numerici

​Campi booleani

​Campi array

​Campi oggetto

​Campi obbligatori

​Esempio completo

​Distribuzione delle entità

​Vedi anche

Struttura base dello schema

Campi integrati

Campi dello schema

Tipi di campo

Campi stringa

Campi interi

Campi numerici

Campi booleani

Campi array

Campi oggetto

Campi obbligatori

Esempio completo

Distribuzione delle entità

Vedi anche