VisualTotals (MDX)

Article
12/15/2008

Mis à jour : 17 juillet 2006

Retourne un jeu généré en totalisant de manière dynamique les membres enfants d'un jeu spécifié, et avec l'aide éventuelle d'un modèle pour le nom du membre parent dans l'ensemble de résultats.

Syntaxe

VisualTotals(Set_Expression[,Pattern])

Arguments

Set_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.

Pattern
Expression de chaîne valide du membre parent du jeu contenant un astérisque (*) en tant que caractère de substitution utilisé pour le nom du parent.

Notes

L'expression de jeu définie peut spécifier un jeu qui contient des membres à n'importe quel niveau au sein d'une seule dimension. Il s'agit généralement de membres pour lesquels une relation ancêtre-descendant existe. La fonction VisualTotals totalise les valeurs des membres enfants dans le jeu spécifié et ignore les membres enfants qui n'apparaissent pas dans le jeu lors du calcul des totaux. Les totaux sont effectués de manière visible pour les jeux classés dans l'ordre hiérarchique. Si l'ordre des membres dans les jeux ne respecte pas la hiérarchie, les résultats obtenus ne sont pas des valeurs visibles. Par exemple, la fonction VisualTotals (USA, WA, CA, Seattle) ne retourne pas WA sous la forme Seattle, mais plutôt les valeurs de WA, CA et Seattle, puis totalise ces valeurs en tant que valeur visible pour la valeur USA, comptabilisant ainsi les ventes pour Seattle deux fois.

Remarque :
Si vous appliquez la fonction VisualTotals à des membres de dimension qui ne sont pas associés à une mesure ou qui se situent sous la granularité du groupe de mesures, les valeurs sont remplacées par des valeurs NULL.

L'argument Pattern (facultatif) spécifie le format de l'étiquette des totaux. Pattern exige un astérisque (*) en tant que caractère de substitution du membre parent et le reste du texte de la chaîne apparaît dans le résultat concaténé avec le nom du parent. Pour afficher un astérisque littéral, utilisez deux astérisques (**).

Exemples

L'exemple ci-dessous retourne la valeur visible du troisième trimestre de l'année civile 2001 sur la base de l'unique descendant spécifié, soit le mois de juillet.

SELECT VisualTotals
   ({[Date].[Calendar].[Calendar Quarter].&[2001]&[3]
      ,[Date].[Calendar].[Month].&[2001]&[7]}) ON 0
FROM [Adventure Works]

L'exemple suivant retourne le membre [All] de la hiérarchie d'attribut Category dans la dimension Product avec deux de ses quatre enfants. Le total retourné pour le membre [All] de la mesure Internet Sales Amount (volume de vente Internet) correspond au total des membres Accessories (accessoires) et Clothing (vêtements) uniquement. L'argument Pattern est également utilisé pour préciser l'étiquette de la colonne [All Products].

SELECT
   VisualTotals
   ({[Product].[Category].[All Products]
      ,[Product].[Category].[Accessories]
      ,[Product].[Category].[Clothing]}
      , '* - Visual Total'
   ) ON Columns
, [Measures].[Internet Sales Amount] ON Rows
FROM [Adventure Works]

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Contenu modifié : Mise à jour de la syntaxe et des arguments à des fins d'éclaircissement. Ajout d'exemples mis à jour.

Partager via