Requêtes et agrégations de la table Tulip

Objectif

Apprenez à interroger vos tables Tulip et à créer des agrégations accessibles dans Tulip Apps.

Dans cet article, vous apprendrez...

• Les possibilités des requêtes de tables
• Comment construire des requêtes et des agrégations
• Comment utiliser les requêtes et les agrégations dans les applications ?

Vue d'ensemble des requêtes et agrégations de table

Avec les requêtes et les agrégations de tables, vous pouvez interroger et filtrer dynamiquement les tables Tulip dans les applications.

Dans cet article, nous allons nous référer à la table des commandes suivante, qui comporte 10 lignes :

En haut à droite, vous pouvez voir les boutons Requêtes et Agrégations. Cliquez sur Requêtes pour ajouter une nouvelle requête.

L'exemple suivant utilise un filtre pour retourner uniquement les enregistrements qui n'ont pas été expédiés :

Les agrégations sont ajoutées par-dessus une requête, et sont construites au niveau de la table comme les requêtes. Cliquez sur Agrégations pour créer une nouvelle agrégation.

L'exemple suivant va agréger le champ de la table, Quantité de produits:

Options de requête

Filtrer

Filtrez les enregistrements en comparant une colonne spécifique, ou plusieurs colonnes, à une valeur statique ou à une entrée d'application.

Voici quelques exemples d'options de comparaison :

• est égal / n'est pas égal
• est nul / n'est pas nul
• contient / ne contient pas
• commence par / ne commence pas par
• se termine par / ne se termine pas par
• est dans
• est supérieur ou égal à / est inférieur ou égal à
• est après ou à / est avant ou à

Lavaleur statique sera définie statiquement lors de la construction de la requête, mais l'entrée d'application sera configurée dans l'application elle-même. L'App Input peut être configurée pour être un :

• Variable
• Valeur statique
• Informations sur l'application
• Enregistrement de la table Tulip

Vous pouvez désormais utiliser les champs Created At et Updated At dans les requêtes de table.

Trier

Personnalisez l'affichage des enregistrements, en configurant l'option Tri. Exemples :

• A à Z / Z à A
• 0 à 9 / 9 à 0

Limite

Limitez le nombre d'enregistrements renvoyés par la requête en configurant une limite.

Après avoir configuré la requête en définissant les options Filtre, Tri et Limite, la requête peut être testée directement sur le tableau en cliquant sur Test. Cela simulera ce que la requête retournerait dans une application.

Options d'agrégation

Les agrégations sont des valeurs récapitulatives qui sont exécutées en plus des requêtes, et peuvent calculer l'une des valeurs suivantes pour une colonne particulière :

• Moyenne
• Nombre
• Maximum
• Min
• Mode
• Somme
• Valeurs uniques

Utiliser les requêtes et les agrégations dans les applications

Ajouter des requêtes aux applications

Pour ajouter une requête à une application, ajoutez d'abord la table à l'application en cliquant sur l'onglet Enregistrements, puis sur +Ajouter une table. Ensuite, cliquez sur Requête.

Dans la modale qui apparaît, donnez un nom à la requête et, le cas échéant, configurez l'entrée de l'application associée au filtre. Dans cet exemple, il s'agit de la requête Produits non expédiés :

Maintenant que la requête est configurée dans l'application, intégrez une table interactive et sélectionnez la source de données de la requête.

Le tableau incorporé affichera les résultats de la requête. Dans cet exemple, il y a 3 enregistrements retournés qui remplissent le filtre,'Shipped' égale 'No':

Ajout d'agrégations aux applications

De la même manière qu'une requête est ajoutée à une application, ajoutez une agrégation en cliquant sur +Add Aggregation, et attribuez un nom d'agrégation.

Dans cet exemple, l'agrégation Qté totale de produits commandés est exécutée sur la requête qui renvoie uniquement les enregistrements qui n'ont pas été expédiés. Pour cette raison, le nom de l'agrégation est Quantité de produits à expédier :

Pour intégrer l'agrégation dans une application, déposez une Variable dans l'application et choisissez la Source de données - Agrégation de table Tulip. Ensuite, sélectionnez le nom de l'agrégation qui a été configuré lors de l'ajout de l'agrégation à l'application.

Dans cet exemple, l'agrégation Sum of Product Quantity a été exécutée en plus de la requête renvoyant les enregistrements à expédier. Cela donne un total de 17 :

Utilisation des agrégations dans la logique de l'application

Avec les agrégations, vous avez la possibilité de construire une logique applicative autour de la valeur d'une agrégation. Voir un exemple ci-dessous :

Veuillez noter que Single Number Tulip Analytics n'est actuellement pas accessible depuis une application, et ne peut pas être utilisé directement avec la logique applicative. En exécutant une agrégation à partir d'une requête, vous serez en mesure de cibler cette valeur, et donc de construire une logique applicative autour d'elle.