Partager via


É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

Axes

Éléments enfants

CrossProduct ou Tuples

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>

Voir aussi

Concepts