Query e aggregazioni della tabella Tulipano

Scopo

Imparare a interrogare le tabelle di Tulip e a costruire aggregazioni accessibili all'interno delle applicazioni Tulip.

In questo articolo imparerete...

• Le funzionalità delle query sulle tabelle
• Come costruire query e aggregazioni
• Come utilizzare le query e le aggregazioni nelle applicazioni

Panoramica delle query e delle aggregazioni di tabelle

Con le query e le aggregazioni di tabelle è possibile interrogare e filtrare dinamicamente le tabelle di Tulip all'interno delle applicazioni.

In questo articolo faremo riferimento alla seguente tabella di ordini, che ha 10 righe:

In alto a destra si trovano i pulsanti Query e Aggregations. 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 si aggiungono a una query e sono costruite a livello di tabella come le query. Fare clic su Aggregazioni per creare una nuova aggregazione.

L'esempio che segue evoca il campo della tabella Quantità di prodotti:

Opzioni di query

Filtro

Filtrare i record confrontando una colonna specifica, o più colonne, con un valore statico o un input dell'applicazione.

Esempi di opzioni di confronto sono:

• uguale / non uguale
• è nullo / non è nullo
• contiene / non contiene
• inizia con / non inizia con
• finisce con / non finisce con
• è in
• è maggiore o uguale a / è minore o uguale a
• è dopo o a / è prima o a

Ilvalore statico viene impostato staticamente durante la creazione della query, mentre l'input dell'applicazione viene configurato nell'applicazione stessa. L'input dell 'applicazione può essere configurato come una:

• Variabile
• Valore statico
• Informazioni sull'applicazione
• Record della tabella Tulip

È ora possibile utilizzare i campi Created At e Updated At nelle query della tabella.

Ordinamento

È possibile personalizzare la visualizzazione dei record configurando l'opzione Ordinamento. Gli esempi includono:

• Da A a Z / Da Z a A
• Da 0 a 9 / Da 9 a 0

Limite

Configurando un limite, è possibile limitare la quantità di record restituiti dalla query.

Il valore massimo del limite è di 1.000 record.

Test

Dopo aver configurato la query impostando le opzioni Filtro, Ordina e Limite, è possibile testare la query direttamente sulla tabella facendo clic su Test. In questo modo si simulerà il risultato della query in un'applicazione.

Aggregazioni

Le aggregazioni sono valori di riepilogo che vengono eseguiti in aggiunta alle query e possono calcolare uno dei seguenti valori per una particolare colonna:

• Media
• Numero
• Massimo
• Min
• Modalità
• Somma
• Valori unici

:::(Info) (Aggregazioni e limiti) Poiché le aggregazioni sono configurate sopra le query di tabella, il limite impostato per la query di tabella madre di un'aggregazione si applica anche all'aggregazione. Ciò significa che le aggregazioni sono in grado di considerare un massimo di 1.000 record:

Utilizzo di query e aggregazioni nelle app

Aggiunta di query alle applicazioni

Per aggiungere una query a un'applicazione, aggiungere prima la tabella all'applicazione facendo clic sulla scheda Record e su +Aggiungi tabella. Quindi, fare clic su Query.

Nella finestra di dialogo che appare, assegnare alla query un nome e, se applicabile, configurare l'input dell'app associato al filtro. In questo esempio, si veda la query Prodotti non spediti:

Ora che la query è configurata nell'applicazione, incorporare una tabella interattiva e selezionare la fonte di dati come query.

La tabella incorporata mostrerà i risultati della query. In questo esempio, sono stati restituiti 3 record che soddisfano il filtro**'Spedito' uguale a 'No'**:

Aggiunta di aggregazioni alle applicazioni

Analogamente a come si aggiunge una query a un'applicazione, è possibile aggiungere un'aggregazione facendo clic su +Aggregazione e assegnando un nome all'aggregazione.

In questo esempio, l'aggregazione Qtà totale 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'applicazione, inserire una variabile nell'applicazione e scegliere Datasource - Tulip Table Aggregation. Quindi, selezionare il nome dell'aggregazione configurato al momento dell'aggiunta dell'aggregazione all'app.

In questo esempio, l'aggregazione Somma di quantità di prodotti è stata eseguita in aggiunta alla query che restituisce i record che devono essere spediti. Il risultato è un totale di 17:

Uso delle aggregazioni nella logica dell'applicazione

Con le aggregazioni, è possibile costruire la logica dell'applicazione intorno al valore di un'aggregazione. Si veda un esempio qui sotto:

Si noti che i dati di Tulip Analytics a numero singolo non sono attualmente accessibili dall'interno di un'applicazione e non possono essere sfruttati direttamente con la logica dell'applicazione. Eseguendo un'aggregazione da una query, si potrà puntare a questo valore e quindi costruire una logica per l'applicazione.