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