La fonction Top() évalue une expression au niveau de la première ligne (du haut) d'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 du haut. Pour les autres graphiques que les tables, l'évaluation de la fonction Top() porte sur la première ligne de la colonne active dans l'équivalent du tableau simple du graphique.
Top([TOTAL] expr [ , offset [,count ]])
double
| Argument | Description |
|---|---|
| expr | Expression ou champ contenant les données à mesurer. |
| offset |
Si vous spécifiez un décalage offset de n, supérieur à 1, l'évaluation de l'expression est déplacée de n lignes en dessous de la ligne supérieure. Si vous spécifiez un décalage négatif, la fonction Top aboutit au même résultat que la fonction Bottom 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 count valeurs, une pour chacune des count dernières lignes du segment de colonne actif. 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. |
-
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.
1
Dans la capture d'écran de la table présentée dans cet exemple, la visualisation de la table est créée à partir de la dimension Customer et des mesures Sum(Sales) et Top(Sum(Sales)).
La colonne Top(Sum(Sales)) renvoie 587 pour toutes les lignes, car il s'agit de la valeur de la ligne supérieure : Astrida.
La table présente également des mesures plus complexes : une mesure créée à partir de Sum(Sales)+Top(Sum(Sales)) et une autre intitulée Top offset 3, créée à l'aide de l'expression Sum(Sales)+Top(Sum(Sales), 3) et comportant l'argument offset défini sur 3. Elle ajoute la valeur Sum(Sales) de la ligne active à la valeur de la troisième ligne en partant de la ligne du haut, autrement dit, la ligne active plus la valeur correspondant à Canutility.
2
Dans les captures d'écran des tables présentées dans cet exemple, d'autres dimensions ont été ajoutées aux visualisations : Month et Product. 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.
|
3 |
Résultat | ||
|---|---|---|---|
|
La fonction Top peut s'utiliser comme donnée d'entrée dans les fonctions de plage. Par exemple : RangeAvg (Top(Sum(Sales),1,3)). |
Dans les arguments de la fonction Top(), offset est défini sur 1 et count est défini sur 3. La fonction recherche les résultats de l'expression Sum(Sales) dans les trois lignes, en commençant par la ligne située en dessous de la ligne inférieure dans le segment de colonne (car offset=1) et les deux lignes situées en dessous (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(). |
||
|