Requêtes et agrégations du tableau Tulip

Objectif

Apprenez à interroger vos tables Tulip et à construire des agrégations accessibles dans les applications Tulip.

Dans cet article, vous apprendrez...

• Les capacité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 tableaux

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

Pour cet article, nous nous référerons au tableau de commandes suivant, 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 ne renvoyer que les enregistrements qui n'ont pas été expédiés :

Les agrégations sont ajoutées au-dessus d'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 récapitule le champ de 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 applicative.

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 de manière statique lors de la construction de la requête, mais l'entrée applicative sera configurée dans l'application elle-même. L'entrée de l'application peut être configurée pour être une :

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

Vous pouvez désormais utiliser les champs Créé le et Mis à jour le dans les requêtes de table.

Tri

Personnalisez l'affichage des enregistrements en configurant l'option Tri. Exemples : A à Z / Z à A :

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

Limite

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

La valeur maximale de la limite est de 1 000 enregistrements.

Test

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 renverrait dans une application.

Agrégations

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

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

:::(Info) (Agrégations et limites) Comme les agrégations sont configurées au-dessus des requêtes de table, la limite fixée pour la requête de table parente d'une agrégation s'applique également à l'agrégation. Cela signifie que les agrégations peuvent prendre en compte un maximum de 1 000 enregistrements :: :

Utilisation des requêtes et des 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 et +Ajouter une table. Ensuite, cliquez sur Requête.

Dans la fenêtre modale qui s'affiche, 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, voir la requête Produits non expédiés:

Maintenant que la requête est configurée dans l'application, intégrez un tableau interactif et sélectionnez la source de données pour la requête.

Le tableau intégré affichera les résultats de la requête. Dans cet exemple, trois enregistrements répondant au filtre**"Expédié" égalent "Non"** ont été renvoyés :

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 +Ajouter une agrégation, et attribuez un nom à l'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. C'est pourquoi 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 - Tulip Table Aggregation. 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 Somme de la quantité de produits a été exécutée en plus de la requête renvoyant les enregistrements qui doivent être expédiés. Le résultat est un total de 17 :

Utilisation des agrégations dans la logique applicative

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

Veuillez noter que les analyses Tulip à numéro unique ne sont actuellement pas accessibles à partir d'une application et ne peuvent pas être directement exploitées avec la logique de l'application. 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.