La fonction Below() évalue une expression au niveau de la ligne située en dessous de la ligne active dans un segment de colonne d'une table. La ligne pour laquelle elle est calculée dépend de la valeur de décalage offset (si présente), le paramètre par défaut étant la ligne située directement en dessous. Pour les autres graphiques que les tables, l'évaluation de la fonction Below() porte sur la ligne située en dessous de la colonne active dans l'équivalent du tableau simple du graphique.
Below([TOTAL] expr [ , offset [,count ]])
double
| Argument | Description |
|---|---|
| expr | Expression ou champ contenant les données à mesurer. |
| offset |
Si vous spécifiez un décalage offsetn supérieur à 1, l'évaluation de l'expression est déplacée de n lignes en dessous de la ligne active. Si vous spécifiez un décalage égal à 0, l'expression est évaluée sur la ligne active. Si vous spécifiez un décalage négatif, la fonction Below aboutit au même résultat que la fonction Above avec le décalage positif correspondant. |
| count |
Si vous spécifiez un troisième paramètre count supérieur à 1, la fonction renvoie une plage de valeurs count, une pour chacune des lignes de table count situées en dessous de la cellule de départ. De cette façon, la fonction peut être utilisée comme argument pour l'une des fonctions de plage spéciales. Fonctions de plage |
| TOTAL |
Si la table est unidimensionnelle ou si le qualificateur TOTAL est utilisé comme argument, le segment de colonne actif est toujours égal à la colonne entière. |
Pour la dernière ligne d'un segment de colonne, la fonction renvoie une valeur NULL, puisqu'il n'y a pas de ligne en dessous.
-
Les appels récursifs renvoient la valeur NULL.
-
Le tri sur les valeurs des ordonnées dans les graphiques ou le tri par colonnes d'expressions dans les tableaux n'est pas autorisé lors de l'utilisation de cette fonction de graphique dans l'une des expressions du graphique. Ces options de tri sont donc automatiquement désactivées. Lorsque vous utilisez cette fonction de graphique dans une visualisation ou un tableau, le tri de la visualisation revient à l'entrée triée via cette fonction.
Dans la capture d'écran de l'exemple 1, la visualisation de la table présentée est créée à partir de la dimension Customer et des mesures Sum(Sales) et Below(Sum(Sales)).
La colonne Below(Sum(Sales)) renvoie NULL pour la ligne Customer contenant Divadip, puisqu'il n'y a aucune ligne en dessous. Le résultat de la ligne Canutility affiche la valeur de Sum(Sales) pour Divadip tandis que le résultat relatif à Betacab indique la valeur de Sum(Sales) pour Canutility et ainsi de suite.
La table présente également des mesures plus complexes, affichées dans les colonnes étiquetées : Sum(Sales)+Below(Sum(Sales)), Below +Offset 3 et Higher?. Ces expressions fonctionnent comme décrit dans les paragraphes suivants.
Pour la colonne intitulée Sum(Sales)+Below(Sum(Sales)), la ligne relative à Astrida affiche le résultat de l'addition des valeurs Sum(Sales) des lignes Betacab + Astrida (539+587). Le résultat de la ligne Betacab affiche le résultat de l'addition des valeurs Sum(Sales) de Canutility + Betacab (539+683).
La mesure intitulée Below +Offset 3, créée à l'aide de l'expression Sum(Sales)+Below(Sum(Sales), 3), comporte l'argument offset, défini sur 3, et a pour effet de prendre la valeur de la ligne située trois lignes en dessous de la ligne active. Elle ajoute la valeur Sum(Sales) de la ligne Customer active à la valeur de la ligne Customer située trois lignes en dessous. Les valeurs renvoyées pour les trois dernières lignes Customer sont nulles.
La mesure étiquetée Higher? est créée à partir de l'expression :IF(Sum(Sales)>Below(Sum(Sales)), 'Higher'). Elle compare les valeurs de la ligne active dans la mesure Sum(Sales) à celles de la ligne située en dessous. Si la ligne active comporte une valeur plus élevée, le texte Higher est généré.
Pour les graphiques comportant plus d'une dimension, les résultats d'expressions contenant les fonctions Above, Below, Top et Bottom dépendent de l'ordre dans lequel les dimensions de colonne sont triées par Qlik Sense. Qlik Sense évalue les fonctions d'après les segments de colonne résultant de la dernière dimension qui a été triée. L'ordre de tri des colonnes est déterminé dans le panneau des propriétés, sous l'option Tri. Il ne correspond pas nécessairement à l'ordre d'affichage des colonnes dans une table.Pour plus de détails, reportez-vous à l'exemple : 2 dans la fonction Above.
|
|
Résultat | ||
|---|---|---|---|
|
La fonction Below peut s'utiliser comme donnée d'entrée dans les fonctions de plage. Par exemple : RangeAvg (Below(Sum(Sales),1,3)). |
Dans les arguments de la fonction Below(), offset est défini sur 1 et count est défini sur 3. La fonction recherche les résultats de l'expressionSum(Sales) dans les trois lignes situées immédiatement en dessous de la ligne active dans le segment de colonne (lorsqu'il y a une ligne). Ces trois valeurs sont utilisées comme données d'entrée dans la fonction RangeAvg(), qui calcule la moyenne des valeurs de la plage de nombres fournie. Une table comprenant la dimension Customer donne les résultats suivants pour l'expression RangeAvg(). |
||
|
Données utilisées dans les exemples :