Requêtes et agrégations sur les tables

Découvrez comment interroger vos tables Tulip et créer des agrégations accessibles au sein des applications Tulip

Dans cet article, vous apprendrez…

Les capacités des requêtes sur les tables et des agrégations
Comment créer des requêtes et des agrégations
Comment utiliser les requêtes et les agrégations dans les applications

Présentation

Les requêtes sur les tables et les agrégations vous permettent d’interagir avec les tables de manière dynamique, en filtrant et en synthétisant vos données pour les utiliser dans les applications.

Dans cet article, nous nous appuierons sur le tableau « 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 encore été expédiés :

Les agrégations s’ajoutent à une requête et sont créées au niveau de la table, tout comme les requêtes. Cliquez sur « Agrégations » pour créer une nouvelle agrégation.

L’exemple suivant calcule la somme du champ « Quantité du produit » de la table :

Requêtes

Une requête vous permet de filtrer et de trier les données d'une table. Les requêtes peuvent utiliser soit des valeurs statiques, soit des valeurs dynamiques basées sur les entrées de l'application.

Filtres

Filtrez les enregistrements en comparant une ou plusieurs colonnes à une valeur statique ou à une entrée de l'application.

Exemples d’options de comparaison :

égal à / différent de
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 égal à / est avant ou égal à

La « Valeur statique » sera définie de manière statique lors de la création de la requête, tandis que l’« Entrée de l’application » sera configurée dans l’application elle-même. L’« Entrée de l’application » peut être configurée comme :

Variable
Valeur statique
Informations de l’application
Enregistrement de 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 « Trier ». Exemples :

De A à Z / De Z à A
De 0 à 9 / De 9 à 0

Limites

Nombre maximal d'enregistrements renvoyés par une requête.

Par défaut : 1 000
Maximum : 1 000

:::(Avertissement) (Comportement en cas d'atteinte de la limite)

Si le nombre d'records s de votre table correspondant aux filtres de la requête (ou, de manière générale, si vous ne configurez aucun filtre) dépasse la limite, seules les s dont le nombre ne dépasse pas la limite seront incluses dans le résultat de la requête.

Si la requête inclut un tri, les premiers en records s selon ce tri seront inclus.
:::

Test

Après avoir configuré la requête en définissant les options Filtre, Tri et Limite, vous pouvez tester la requête directement dans le tableau en cliquant sur Tester. Cela simulera le résultat que la requête renverrait dans une application.

Utilisation des requêtes dans les applications

Pour ajouter une requête à une application, commencez par ajouter le tableau à l’application en cliquant sur l’onglet « Enregistrements », puis sur « + Ajouter un tableau ». Cliquez ensuite sur « Requête ».

Dans la fenêtre modale qui s'affiche, attribuez un nom à la requête et, le cas échéant, configurez le champ de saisie de l'application associé au filtre. Dans cet exemple, consultez 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 correspondant à 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é » égal à « Non » sont renvoyés**:**

Agrégations

Les agrégations sont des valeurs de synthèse appliquées aux requêtes ; elles permettent de calculer l’une des valeurs suivantes pour une colonne donnée :

Moyenne*: renvoie la moyenne des nombres ou des entiers

Nombre* Renvoie le nombre d’enregistrements ; aucun champ n’est requis

Max*: renvoie la valeur maximale des nombres ou des entiers

Min*: renvoie la valeur minimale des nombres ou des entiers

Mode*: renvoie la valeur la plus fréquente. Remarque : si deux valeurs ont la même fréquence, c'est toujours la plus petite qui est renvoyée.

Sum* Renvoie la somme des nombres ou des entiers

Valeurs uniques* Renvoie un tableau contenant les valeurs uniques de la requête donnée, quel que soit le type de données

Limites

Les agrégations peuvent prendre en compte un maximum de 1 000 enregistrements.

Les agrégations sont effectuées sur les enregistrements renvoyés par la requête configurée. La limite définie pour la requête parente d’une agrégation s’applique également à l’agrégation (1 000 enregistrements).

Une agrégation peut afficher des résultats inattendus si la table contient plus d’enregistrements que la limite pour les filtres donnés et que l’utilisateur n’est pas au courant de la limite de la requête.

Si vous devez agréger plus de 1 000 enregistrements pour une utilisation dans une application, utilisez le point de terminaison runAggregation de l’API Tulip, qui prend en charge jusqu’à 100 000 enregistrements, via une fonction de connecteur.

Si vous avez uniquement besoin de visualiser une agrégation de plus de 1 000 enregistrements, créez une analyse « Single Value » avec Analytics, qui permet d’agréger l’ensemble des enregistrements d’une table.

Utiliser les agrégations dans les 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, puis attribuez -lui un nom.

Dans cet exemple, l’agrégation « Quantité totale de produits commandés » est appliquée à la requête qui ne renvoie que les enregistrements n’ayant pas encore é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 ». Sélectionnez ensuite 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 sur la requête renvoyant les enregistrements devant être expédiés. Cela renvoie un total de 17 :

Utiliser les agrégations dans la logique de l’application

Les agrégations vous permettent de construire la logique d’une application autour de la valeur d’une agrégation. Voici un exemple ci-dessous :

Veuillez noter que les analyses Tulip « Single Number » ne sont actuellement pas accessibles depuis une application et ne peuvent pas être directement exploitées dans la logique de l’application. En exécutant une agrégation à partir d’une requête, vous pourrez cibler cette valeur et ainsi construire une logique d’application autour de celle-ci.