Élément Axis (XMLA)
Contient un ensemble de tuples utilisé pour représenter un axe unique dans un dataset multidimensionnel que contient un élément Axes utilisant le type de données MDDataSet, retourné par la méthode Execute.
Syntaxe
<Axes>
...
<Axis> <!-- when AxisFormat XMLA property is set to ClusterFormat -->
<CrossProduct>...</CrossProduct>
</Axis>
<Axis> <!-- when AxisFormat XMLA property is set to TupleFormat or CustomFormat -->
<Tuples>...</Tuples>
</Axis>
...
</Axes>
Caractéristiques de l'élément
Caractéristique |
Description |
---|---|
Type de données et longueur |
Aucun |
Valeur par défaut |
Aucune |
Cardinalité |
0-n : élément facultatif susceptible d'apparaître plusieurs fois. |
Relations entre les éléments
Relation |
Élément |
---|---|
Éléments parents |
|
Éléments enfants |
Notes
Le contenu de l'élément Axis varie selon la valeur de la propriété XMLA AxisFormat utilisée par la méthode Execute.
TupleFormat
Lorsqu'une application cliente définit la propriété AxisFormat avec la valeur TupleFormat, un axe est représenté comme un ensemble de tuples. Chaque élément Axis contient un élément Tuples qui représente l'ensemble de tuples sur cet axe. Chaque tuple est représenté en utilisant un élément Tuple qui contient des éléments Member de chaque hiérarchie sur l'axe.
ClusterFormat
Lorsqu'une application cliente définit la propriété AxisFormat avec la valeur ClusterFormat, les membres situés sur chaque axe sont divisés en clusters, chaque cluster représentant un produit croisé entre des jeux de membres ordonnés issus de chaque hiérarchie. Chaque élément Axis consiste en un ou plusieurs éléments CrossProduct. Chaque élément CrossProduct contient un élément Members pour chaque hiérarchie sur l'axe.
CustomFormat
Lorsqu'une application cliente définit la propriété AxisFormat avec la valeur CustomFormat, une instance d'Analysis Services traite cette valeur de la même façon que TupleFormat.
Exemples
Description
L'exemple suivant illustre la structure des éléments Axis lorsqu'un client spécifie TupleFormat ou CustomFormat comme valeur de la propriété XMLA AxisFormat si l'axe comporte les membres suivants :
Hiérarchie Time |
1999 |
1999 |
2000 |
Hiérarchie Category |
Réel |
Budget |
Budget |
Code
<Axes>
<Axis name="Axis0">
<Tuples>
<Tuple>
<Member Hierarchy="Time">
<UName>[Time].[1999]</UName>
...
</Member>
<Member Hierarchy="Category">
<UName>[Scenario].[Actual]</UName>
...
</Member>
</Tuple>
<Tuple>
<Member Hierarchy="Time">
<UName>[Time].[1999]</UName>
...
</Member>
<Member Hierarchy="Category">
<UName>[Scenario].[Budget]</UName>
...
</Member>
</Tuple>
<Tuple>
<Member Hierarchy="Time">
<UName>[Time].[2000]</UName>
...
</Member>
<Member Hierarchy="Category">
<UName>[Scenario].[Budget]</UName>
...
</Member>
</Tuple>
</Tuples>
</Axis>
...
</Axes>
Description
L'exemple suivant illustre la structure des éléments Axis lorsqu'un client spécifie ClusterFormat comme valeur de la propriété XMLA AxisFormat si l'axe comporte les membres suivants :
Hiérarchie Time |
1999 |
1999 |
2000 |
2001 |
Hiérarchie Category |
Réel |
Budget |
Budget |
Budget |
Clusters |
Cluster 1 |
Cluster 1 |
Cluster 1 |
Cluster 2 |
Code
<Axes>
<Axis name="Axis0">
<CrossProduct Size = "4">
<Members Hierarchy="Time">
<Member>
<UName>[Time].[1999]</UName>
...
</Member>
<Member>
<UName>[Time].[2000]</UName>
...
</Member>
</Members>
<Members Hierarchy="Category">
<Member>
<UName>[Scenario].[Actual]</UName>
...
</Member>
<Member>
<UName>[Scenario].[Budget]</UName>
...
</Member>
</Members>
</CrossProduct>
<CrossProduct Size = "1">
<Members Hierarchy="Time">
<Member>
<UName>[Time].[2001]</UName>
...
</Member>
</Members>
<Members Hierarchy="Category">
<Member>
<UName>[Scenario].[Budget]</UName>
...
</Member>
</Members>
</CrossProduct>
</Axis>
...
</Axes>