Élément Axis (XMLA)

Contient un jeu de tuples utilisé pour représenter un axe unique dans un jeu de données multidimensionnel contenu dans un élément axes qui utilise 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	None
Valeur par défaut	None
Cardinalité	0-n : élément facultatif pouvant apparaître plusieurs fois.

Relations d’éléments

Relation	Élément
Éléments parents	Axes
Éléments enfants	CrossProduct ou tuples

Remarques

Le contenu de l’élément Axis varie en fonction de la valeur de la propriété XMLA AxisFormat utilisée par la méthode Execute .

TupleFormat

Quand 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 le jeu de tuples sur cet axe. Chaque tuple est représenté à l’aide d’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 sur ClusterFormat, les membres sur chaque axe sont divisés en clusters dans lesquels chaque cluster représente un produit croisé entre des ensembles ordonnés de membres de chaque hiérarchie. Chaque élément Axis se compose d’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 sur CustomFormat, la valeur est traitée de la même façon que la valeur TupleFormat par une instance Analysis Services.

Exemples

Description

L’exemple suivant illustre la structure des éléments Axis lorsqu’un client spécifie TupleFormat ou CustomFormat pour la propriété XMLA AxisFormat , en fonction des membres suivants de l’axe :

Hiérarchie Time

Hiérarchie Category

1999

Réel

1999

Budget

2000

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 pour la propriété XMLA AxisFormat , en fonction des membres suivants de l’axe :

Hiérarchie Time

Hiérarchie Category

Clusters

1999

Réel

Clusters 1

1999

Budget

Clusters 1

2000

Budget

Clusters 1

2001

Budget

Clusters 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>