COLLAPSE
s’applique à :
colonne calculéetable calculéemesure
calcul visuel
Récupère un contexte à un niveau supérieur par rapport au contexte actuel. Si une expression est fournie, retourne sa valeur dans le nouveau contexte, ce qui permet la navigation dans les hiérarchies et le calcul à un niveau supérieur.
Syntaxe
Syntaxes qui effectuent à la fois la navigation et le calcul.
COLLAPSE ( <expression>, <axis>[, N] )
COLLAPSE ( <expression>, <column>[, <column>] ... )
Syntaxes qui effectuent uniquement la navigation.
COLLAPSE ( <axis>[, N] )
COLLAPSE ( <column>[, <column>] ... )
Paramètres
| Terme | Définition |
|---|---|
expression |
Expression à évaluer dans le nouveau contexte. |
axis |
Référence d’axe. |
column |
Colonne de la grille de données. |
N |
(Facultatif) Nombre de niveaux à réduire. Si elle est omise, la valeur par défaut est 1. |
Valeur de retour
Pour les versions qui effectuent à la fois la navigation et le calcul, la fonction retourne la valeur de l’expression dans le nouveau contexte après avoir navigué vers un nouveau niveau. Pour les versions qui effectuent uniquement la navigation, la fonction modifie le contexte d’évaluation en accédant à un nouveau niveau.
Remarques
- Cette fonction ne peut être utilisée que dans les calculs visuels.
- Les versions de navigation uniquement de la fonction peuvent être utilisées à l’intérieur de la fonction CALCULATE.
- Les niveaux de la hiérarchie sont déterminés par toutes les colonnes de chaque axe référencé par la référence d’axe.
- Lorsque des colonnes sont spécifiées, les axes sont déterminés en incluant l’axe de chaque colonne la première fois qu’elle est rencontrée.
- Lorsque N est spécifié, la fonction navigue vers le haut des niveaux N de la hiérarchie à partir du niveau actuel ou du niveau le plus élevé, selon ce qui se produit en premier.
- Lorsque plusieurs colonnes sont spécifiées, la fonction navigue vers le haut de la hiérarchie jusqu’à ce qu’elle atteigne le premier niveau auquel aucune des colonnes spécifiées n’est présente.
- La navigation commence à la cellule active dans la matrice de données, croissant vers le haut de la hiérarchie. Si une colonne spécifiée est à un niveau inférieur à la cellule actuelle, elle est ignorée.
Exemple
Compte tenu d’un tableau qui résume les ventes totales d’une hiérarchie avec des niveaux pour le total, l’année, le trimestre et le mois, les calculs suivants DAX récupèrent respectivement la valeur de [SalesAmount] au niveau parent, le niveau grand-parent et l’année ou l’auto- niveau.
ParentValue = COLLAPSE([SalesAmount], ROWS)
GrandParentValue = COLLAPSE([SalesAmount], ROWS, 2)
QuarterOrSelfValue = COLLAPSE([SalesAmount], [Month])
La capture d’écran ci-dessous montre la matrice avec les trois calculs visuels.
de calcul visuel