Manuale · 8

Query

Le query stabiliscono cosa un’app può leggere e modificare. Si trovano nella scheda Query dell’App-Builder e vengono eseguite sul server: il browser invia solo il nome della query e i valori dei suoi parametri – tabella, filtro, campi e valori non gli arrivano mai e non si possono alterare.

Tipi

Tipo Per Campi
Elenca record elenchi per tabelle, elenchi, grafici, selezioni tabella, campi (nessuno = tutti), filtro, ordinamento, massimo per pagina
Un record dettagli, es. in una finestra tabella, record (chiave primaria), campi
Crea record salvare un modulo tabella, valori (colonna → valore)
Modifica record impostare uno stato, modificare tabella, record, valori
Elimina record – tabella, record
Carica un file allegati di un record, ad es. foto o ricevute tabella, record, colonna allegati; il file arriva da un campo File
Esegui workflow logica sul server workflow (vedi Workflow e sorgenti REST)
Endpoint personalizzato endpoint di script esistenti metodo, percorso
Sorgente REST API esterna sorgente, metodo, percorso, corpo

Parametri e segnaposto

Una query accetta solo parametri dichiarati (nome, tipo testo/numero/sì-no/data/qualsiasi, obbligatorio). In filtro, valori, record, percorso e corpo i segnaposto li inseriscono:

  • {{params.<nome>}} – un parametro. Da solo mantiene il suo tipo.
  • {{user.id}}, {{user.email}}, {{user.role}} – l’account con accesso (vuoto nelle app pubbliche).
  • {{now}} (istante) e {{today}} (data).

I segnaposto vengono inseriti nella struttura salvata, mai in un testo di query – un valore può diventare solo un valore. Nei percorsi delle sorgenti REST vengono codificati per l’URL. Valore di filtro vuoto = nessuna condizione: se il segnaposto di una condizione è vuoto, la condizione viene tolta – un campo di ricerca vuoto mostra tutto. Dai segnaposto crea i parametri dai segnaposto usati.

Gli elementi di dati indicano i valori dei parametri nelle loro proprietà, le azioni nel passo Esegui query (con Modulo i valori di un modulo diventano parametri con lo stesso nome). In fondo alla scheda ogni query si può provare con valori di esempio (le query di scrittura modificano davvero i dati).

Diritti

  • App con accesso: ogni query raggiunge esattamente la sua tabella al suo livello (lettura o scrittura) – e mai più di quanto l’account possa già: per i viewer valgono in più i loro permessi di tabella.
  • Gli utenti app non hanno permessi di tabella; valgono solo le query delle loro app.
  • Le app pubbliche girano con un’identità di app anonima: esattamente le query dell’app, uguali per tutti i visitatori – anche quelli con accesso.
  • I campi calcolati fanno parte della tabella: lookup, rollup, formule, collegamenti, record figli e valori visualizzati delle chiavi esterne arrivano con la tabella della query (o le tabelle di un workflow), anche quando attingono ad altre tabelle – in fields e where si usano con il loro nome API. Gli utenti app e le app pubbliche li vedono come è costruita la tabella; per i viewer i campi di tabelle che non possono leggere restano nascosti.
  • Hook, webhook e campi calcolati funzionano come con l’API REST. Il runtime consente 600 chiamate al minuto per IP.