Fonction RELATEDTABLE (DAX)
Évalue une expression de table dans un contexte modifié par les filtres donnés.
Syntaxe
RELATEDTABLE(<expression>,<filter1>,<filter2>,…)
Paramètres
Terme |
Définition |
|---|---|
expression |
Expression de table à évaluer. |
filter1,filter2,… |
Expression booléenne ou expression de table qui définit un filtre. |
L'expression utilisée comme premier paramètre doit être une table ou une expression qui retourne une table.
Les restrictions suivantes s'appliquent aux expressions booléennes utilisées comme arguments :
L'expression ne peut pas faire référence à une mesure.
L'expression ne peut pas utiliser de fonction CALCULATE imbriquée.
L'expression ne peut pas utiliser de fonctions qui analysent ou retournent une table, notamment les fonctions d'agrégation.
Toutefois, une expression booléenne peut utiliser n'importe quelle fonction qui recherche une valeur unique ou calcule une valeur scalaire.
Valeur de retour
Table de valeurs.
Notes
La fonction RELATEDTETABLE modifie le contexte dans lequel les données sont filtrées et évalue l'expression dans le nouveau contexte que vous spécifiez. Pour chaque colonne utilisée dans un argument de filtre, tout filtre existant sur cette colonne est supprimé et le filtre utilisé dans l'argument de filtre est appliqué à la place.
Cette fonction est un synonyme de la fonction CALCULATETABLE.
Exemple
L'exemple suivant utilise la fonction RELATEDTABLE pour obtenir les ventes sur Internet pour 2002 ; cette valeur est utilisée ultérieurement pour calculer un ratio de ventes par rapport aux ventes de l'année 2002.
Le tableau ci-dessous montre les résultats obtenus en utilisant le code indiqué ici.
Étiquettes de ligne |
Internet SalesAmount_USD |
RelatedTable 2002 Internet Sales |
Internet Sales to 2002 ratio |
|---|---|---|---|
2001 |
$2,627,031.40 |
$5,681,440.58 |
0.46 |
2002 |
$5,681,440.58 |
$5,681,440.58 |
1.00 |
2003 |
$8,705,066.67 |
$5,681,440.58 |
1.53 |
2004 |
$9,041,288.80 |
$5,681,440.58 |
1.59 |
Total général |
$26,054,827.45 |
$5,681,440.58 |
4.59 |
= SUMX( RELATEDTABLE('InternetSales_USD', 'DateTime'[CalendarYear]=2002)
, [SalesAmount_USD])
Voir aussi