Scopri come eseguire query sulle tue tabelle Tulip e creare aggregazioni accessibili all’interno delle app Tulip
In questo articolo imparerai...
- Le funzionalità delle query sulle tabelle e delle aggregazioni
- Come creare query e aggregazioni
- Come utilizzare le query e le aggregazioni nelle app
Panoramica
Le query sulle tabelle e le aggregazioni consentono di interagire con le tabelle in modo dinamico, filtrando e riepilogando i dati per utilizzarli nelle app.
Per questo articolo faremo riferimento alla seguente tabella degli ordini, che contiene 10 righe:
In alto a destra sono visibili i pulsanti "Query" e "Aggregazioni". Fare clic su "Query" per aggiungere una nuova query.
L'esempio seguente utilizza un filtro per restituire solo i record che non sono stati spediti:
Le aggregazioni vengono aggiunte a una query e, come le query, vengono create a livello di tabella. Fare clic su "Aggregazioni " per creare una nuova aggregazione.
L’esempio seguente calcola la somma del campo della tabella “Quantità prodotto”:
Query
Una query consente di filtrare e ordinare i dati in una tabella. Le query possono utilizzare valori statici o valori dinamici basati sugli input dell’app.
Filtri
Filtra i record confrontando una colonna specifica, o più colonne, con un " Valore statico " o un " Input dell’app".
Esempi di opzioni di confronto includono:
- uguale / diverso da
- è nullo / non è nullo
- contiene / non contiene
- inizia con / non inizia con
- finisce con / non finisce con
- è presente in
- è maggiore o uguale a / è minore o uguale a
- è successivo o uguale a / è precedente o uguale a
Il valore statico verrà impostato in modo statico durante la creazione della query, mentre l’input dell’app verrà configurato nell’app stessa. L’input dell’app può essere configurato come:
- Variabile
- Valore statico
- Informazioni sull’app
- Record della tabella Tulip
Ora è possibile utilizzare i campi " Creato il " e " Aggiornato il " nelle query sulle tabelle.
Ordinamento
È possibile personalizzare la visualizzazione dei record configurando l'opzione "Ordina". Ecco alcuni esempi:
- Da A a Z / Da Z ad A
- Da 0 a 9 / Da 9 a 0
Limiti
Il numero massimo di record restituiti da una query.
- Impostazione predefinita: 1.000
- Massimo: 1.000
:::(Avviso) (Comportamento al raggiungimento del limite)
Se nella tabella sono presenti più records che soddisfano i filtri della query (o in generale se non si configurano filtri) rispetto al limite, nel risultato della query ne vengono inclusi solo tanti quanti specificati dal limite.
Se la query include un ordinamento, verranno inclusi i primi records in base a tale ordinamento.
:::
Prova
Dopo aver configurato la query impostando le opzioni Filtro, Ordina e Limite, è possibile testare la query direttamente sulla tabella facendo clic su Prova. In questo modo verrà simulato il risultato che la query restituirebbe in un'app.
Utilizzo delle query nelle app
Per aggiungere una query a un'app, aggiungere innanzitutto la tabella all'app facendo clic sulla scheda Record, quindi su +Aggiungi tabella. Successivamente, fare clic su Query.
Nella finestra modale che appare, assegnare un nome alla query e, se necessario, configurare l’input dell’app associato al filtro. In questo esempio, si veda la query Prodotti non spediti:
Ora che la query è configurata nell’app, incorporare una tabella interattiva e selezionare la query come origine dati.
La tabella incorporata visualizzerà i risultati della query. In questo esempio, vengono restituiti 3 record che soddisfano il filtro, ovvero "Spedito" uguale a "No":
Aggregazioni
Le aggregazioni sono valori di riepilogo applicati alle query e possono calcolare uno dei seguenti valori per una colonna specifica:
Media* Restituisce la media di numeri o interi
Conteggio* Restituisce il conteggio dei record; non è richiesto alcun campo
Max* Restituisce il massimo tra numeri o interi
Min* Restituisce il minimo tra numeri o interi
Modale* Restituisce il valore più frequente* Nota: se due valori hanno la stessa frequenza, verrà sempre restituito il valore più basso.
Sum* Restituisce la somma di numeri o interi
Valori unici* Restituisce un array dei singoli valori unici della query specificata, di qualsiasi tipo di dati
Limiti
Le aggregazioni possono prendere in considerazione un massimo di 1.000 record.
Le aggregazioni vengono eseguite sui record restituiti dalla query configurata. Il limite impostato per la query principale di un'aggregazione si applica anche all'aggregazione stessa (1.000 record).
Un'aggregazione potrebbe mostrare risultati inaspettati se la tabella contiene più record per i filtri specificati rispetto al limite e l'utente non è a conoscenza del limite della query.
Se è necessario aggregare più di 1.000 record per l’utilizzo in un’app, utilizzare l’endpoint runAggregation dell’API Tulip, che supporta fino a 100.000 record, tramite una funzione di connettore.
Se è necessario solo visualizzare un'aggregazione di oltre 1.000 record, creare un'analisi a valore singolo con Analytics, che consente di aggregare tutti i record di una tabella.
Utilizzo delle aggregazioni nelle app
Analogamente a come si aggiunge una query a un’app, aggiungi un’aggregazione facendo clic su +Aggiungi aggregazione e assegna un nome all’aggregazione.
In questo esempio, l’aggregazione “Quantità totale di prodotti ordinati ” viene eseguita sulla query che restituisce solo i record che non sono stati spediti. Per questo motivo, il nome dell’aggregazione è “Quantità di prodotti da spedire”:
Per incorporare l’aggregazione in un’app, trascinare una variabile nell’app e selezionare la fonte dati “Tulip Table Aggregation”. Successivamente, selezionare il nome dell’aggregazione configurato al momento dell’aggiunta dell’aggregazione all’app.
In questo esempio, l’aggregazione “Somma della quantità di prodotti ” è stata eseguita sulla query che restituisce i record che devono essere spediti. Il risultato è un totale di 17:
Utilizzo delle aggregazioni nella logica dell’app
Grazie alle aggregazioni, è possibile costruire la logica dell’app attorno al valore di un’aggregazione. Ecco un esempio qui sotto:
Si noti che le analisi Tulip a numero singolo non sono attualmente accessibili dall’interno di un’app e non possono essere sfruttate direttamente con la logica dell’app. Eseguendo un’aggregazione su una query, sarà possibile utilizzare questo valore come base e quindi costruire la logica dell’app attorno ad esso.
{{snippet.Hai trovato quello che cercavi?}}