CurrentMember (MDX)

Article
05/23/2023

Retourne le membre actuel dans une hiérarchie spécifique au cours d'une itération.

Syntaxe

  
Hierarchy_Expression.CurrentMember

Arguments

Hierarchy_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne une hiérarchie.

Remarques

Au cours d'une itération effectuée dans un jeu de membres de hiérarchie, le membre manipulé à chaque étape de l'itération est le membre actuel. La fonction CurrentMember retourne ce membre.

Important

Lorsqu'une dimension contient uniquement une hiérarchie visible unique, cette hiérarchie peut être désignée soit par le nom de dimension, soit par le nom de la hiérarchie, puisque le nom de dimension est résolu à son unique hiérarchie visible. Par exemple, Measures.CurrentMember est une expression MDX valide parce qu'elle est résolue à la seule hiérarchie de la dimension de mesures.

Exemples

La requête suivante montre comment Currentmember peut être utilisé pour rechercher le membre actuel à partir de hiérarchies sur l’axe Colonnes, Lignes et segments :

WITH
  MEMBER MEASURES.CURRENTDATE AS [Date].[Calendar].CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTPRODUCT AS [Product].[Product Categories].CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTMEASURE AS MEASURES.CURRENTMEMBER.NAME
  MEMBER MEASURES.CURRENTCUSTOMER AS [Customer].[Customer Geography].CURRENTMEMBER.NAME
SELECT
 [Product].[Product Categories].[Category].MEMBERS *
 {MEASURES.CURRENTDATE,
    MEASURES.CURRENTPRODUCT,
    MEASURES.CURRENTMEASURE,
    MEASURES.CURRENTCUSTOMER} ON 0, 
 [Date].[Calendar].MEMBERS ON 1  
FROM [Adventure Works]
WHERE ([Customer].[Customer Geography].[Country].&[Australia])

Le membre actuel change sur une hiérarchie utilisée sur un axe dans une requête. Par conséquent, le membre actuel sur d’autres hiérarchies de la même dimension qui ne sont pas utilisées sur un axe peut également changer ; ce comportement est appelé « existe automatiquement » et vous trouverez plus de détails dans Concepts clés dans MDX (Analysis Services). Par exemple, la requête suivante illustre comment le membre actuel sur la hiérarchie Année civile de la dimension Date change avec le membre actuel sur la hiérarchie Calendrier, lorsque celle-ci est affichée sur l'axe des lignes :

WITH
  MEMBER MEASURES.CURRENTYEAR AS [Date].[Calendar Year].CURRENTMEMBER.NAME
SELECT
 {MEASURES.CURRENTYEAR} ON 0,
 [Date].[Calendar].MEMBERS ON 1  
FROM [Adventure Works]

CurrentMember est très important pour rendre les calculs conscients du contexte de la requête dans laquelle ils sont utilisés. L’exemple suivant retourne la quantité de commande de chaque produit et le pourcentage de quantités de commandes par catégorie et modèle, à partir du cube Adventure Works . La fonction CurrentMember identifie le produit dont la quantité de commande doit être utilisée pendant le calcul.

WITH   
   MEMBER [Measures].[Order Percent by Category] AS  
   CoalesceEmpty  
(   
      ([Product].[Product Categories].CurrentMember,  
        Measures.[Order Quantity]) /   
          (  
           Ancestor  
           ( [Product].[Product Categories].CurrentMember,   
             [Product].[Product Categories].[Category]  
           ), Measures.[Order Quantity]  
       ), 0  
   ), FORMAT_STRING='Percent'  
SELECT   
   {Measures.[Order Quantity],  
      [Measures].[Order Percent by Category]} ON COLUMNS,  
{[Product].[Product].Members} ON ROWS  
FROM [Adventure Works]  
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}

Voir aussi

Guide de référence des fonctions MDX (MDX)