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.
| Exemple | Résultat |
|---|---|
|
Top( Sum(Sales) ) |
Renvoie la valeur de Sales pour la première ligne (celle du haut) d'un segment de colonne dans un tableau. |
Exemple - Les bases de Top
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.
Le script de chargement contient :
-
Jeu de données chargé dans une table de données appelée Example.
-
Champs suivants dans la table de données :
-
Year
-
Sales
-
Script de chargement
Example:
LOAD * INLINE [
Year, Sales
2019, 1000
2020, 1500
2021, 1200
2022, 1800
2023, 1700
];Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :
-
Year
Créez les mesures suivantes :
-
=Sum(Sales), pour trouver les ventes annuelles.
-
=Top(Sum(Sales)), pour trouver la valeur des ventes pour la première année, c'est-à-dire la première ligne (celle du haut) d'une colonne dans un tableau.
-
=Sum(Sales) - Top(Sum(Sales)), pour calculer la variance entre la valeur Sales de la ligne en cours et la valeur de la première ligne (celle du haut) d'une colonne.
-
=Sum(Sales)-Top(Sum(Sales), 3), pour calculer la variance entre la valeur des ventes de la ligne en cours et la valeur de la troisième ligne à partir du haut.
-
=(Sales - Top(Sales)) / Top(Sales), pour renvoyer la variation de Sales sous forme de ratio/pourcentage par rapport à la première ligne. Pour afficher cette valeur sous forme de pourcentage, sous Formatage des nombres, sélectionnez Nombre > Formatage simple > 12,34 %.
Triez le tableau sur la dimension Year dans l'ordre croissant.
| Year | Sum(Sales) | Top(Sum(Sales)) | Sum(Sales) - Top(Sum(Sales)) | Sum(Sales)-Top(Sum(Sales), 3) | (Sales - Top(Sales)) / Top(Sales) |
|---|---|---|---|---|---|
| Totals | 7200 | 1000 | 6200 | 6000 | - |
| 2019 | 1000 | 1000 | 0 | -200 | 0.00% |
| 2020 | 1500 | 1000 | 500 | 300 | 50.00% |
| 2021 | 1200 | 1000 | 200 | 0 | 20.00% |
| 2022 | 1800 | 1000 | 800 | 600 | 80.00% |
| 2023 | 1700 | 1000 | 700 | 500 | 70.00% |
En examinant les résultats, vous pouvez comparer les valeurs de Sales de la période en cours à celles de la période du haut (ou première période).
-
La mesure Sum(Sales) - Top(Sum(Sales)) renvoie la variation des valeurs Sales en comparant la période en cours à la première période.
-
La mesure Sum(Sales)-Top(Sum(Sales), 3) renvoie la somme de Sales pour la ligne en cours moins la troisième période à partir du haut.
-
La mesure =(Sales - Top(Sales)) / Top(Sales) renvoie la variation de Sales par rapport à la première période sous forme de pourcentage.
Procédez comme suit :
Créez un graphique à barres et ajoutez ce champ comme dimension :
-
Year
Créez la mesure suivante :
-
=Sum(Sales)- Top(Sum(Sales)), pour renvoyer la variance des ventes entre la période en cours et la période du haut.
Graphique à barres montrant les résultats de la fonction Top
L'utilisation de la fonction Top dans un graphique à barres fournit une comparaison visuelle de la variance entre les ventes de la période en cours et celles de la période du haut (ou première période).