COLLAPSE
S’applique à :
Colonne calculéeTable calculéeMesure
Calcul de visuel
Récupère un contexte à un niveau plus élevé 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 plus élevé.
Syntaxe
Les syntaxes qui effectuent la navigation et le calcul.
COLLAPSE ( <expression>, <axis>[, N] )
COLLAPSE ( <expression>, <column>[, <column>] ... )
Les syntaxes qui effectuent uniquement la navigation.
COLLAPSE ( <axis>[, N] )
COLLAPSE ( <column>[, <column>] ... )
Paramètres
| Terme | Définition |
|---|---|
| expression | L’expression à évaluer dans le nouveau contexte. |
| axis | Une référence d’axe. |
| N° | Une colonne de la grille de données. |
| N | (Facultatif) Le nombre de niveaux à réduire. En cas d’omission, la valeur par défaut est 1. |
Valeur retournée
Pour les versions qui effectuent 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.
Notes
- Cette fonction peut être utilisée seulement dans les calculs visuels.
- Les versions à navigation seule de la fonction peuvent être utilisées au sein 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’il est rencontré.
- Lorsque N est spécifié, la fonction navigue dans la hiérarchie des niveaux N de façon ascendante à partir du niveau actuel ou du niveau supérieur, selon la première éventualité.
- Lorsque plusieurs colonnes sont spécifiées, la fonction navigue dans la hiérarchie de façon ascendante jusqu’à ce qu’elle atteigne le premier niveau auquel aucune colonne spécifiée n’est présente.
- La navigation commence par la cellule active dans la matrice de données, en montant dans la hiérarchie. Si une colonne spécifiée se trouve dans un niveau inférieur à la cellule actuelle, elle est ignorée.
Exemple
Dans 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 DAX suivants récupère la valeur de [SalesAmount] au niveau du parent, au niveau du grand-parent et au niveau de l’année ou de l’individu, respectivement.
ParentValue = COLLAPSE([SalesAmount], ROWS)
GrandParentValue = COLLAPSE([SalesAmount], ROWS, 2)
QuarterOrSelfValue = COLLAPSE([SalesAmount], [Month])
La capture d’écran ci-dessous présente la matrice avec les trois calculs visuels.
