Axis-Element (XMLA)

Enthält eine Reihe von Tupeln, die verwendet werden, um eine einzelne Achse in einem mehrdimensionalen Dataset darzustellen, das in einem Axes-Element enthalten ist, das den MDDataSet-Datentyp verwendet, der von der Execute-Methode zurückgegeben wird.

Syntax

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

Elementmerkmale

Merkmal	BESCHREIBUNG
Datentyp und -länge	Keine
Standardwert	Keine
Kardinalität	0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Achsen
Untergeordnete Elemente	CrossProduct oder Tupel

Hinweise

Der Inhalt des Axis-Elements variiert abhängig vom Wert der AxisFormat XMLA-Eigenschaft, die von der Execute-Methode verwendet wird.

TupleFormat

Wenn eine Clientanwendung die AxisFormat-Eigenschaft auf TupleFormat festlegt, wird eine Achse als Menge von Tupeln dargestellt. Jedes Axis-Element enthält ein Tupelelement , das den Satz von Tupeln auf dieser Achse darstellt. Jedes Tupel wird mithilfe eines Tuple-Elements dargestellt, das Member-Elemente aus jeder Hierarchie auf der Achse enthält.

ClusterFormat

Wenn eine Clientanwendung die AxisFormat-Eigenschaft auf ClusterFormat festlegt, werden die Elemente auf jeder Achse in Cluster unterteilt, in denen jeder Cluster ein Kreuzprodukt zwischen sortierten Sätzen von Membern aus jeder Hierarchie darstellt. Jedes Axis-Element besteht aus einem oder mehreren CrossProduct-Elementen . Jedes CrossProduct-Element enthält ein Members-Element für jede Hierarchie auf der Achse.

CustomFormat

Wenn eine Clientanwendung die AxisFormat-Eigenschaft auf CustomFormat festlegt, wird der Wert von einer Analysis Services -Instanz genauso behandelt wie der TupleFormat-Wert .

Beispiele

BESCHREIBUNG

Das folgende Beispiel veranschaulicht die Struktur der Axis-Elemente , wenn ein Client TupleFormat oder CustomFormat für die AxisFormat XMLA-Eigenschaft angibt, wenn die folgenden Elemente für die Achse angegeben werden:

Time-Hierarchie

Category-Hierarchie

1999

Tatsächlich

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>  

BESCHREIBUNG

Das folgende Beispiel veranschaulicht die Struktur der Axis-Elemente , wenn ein Client ClusterFormat für die AxisFormat XMLA-Eigenschaft angibt, wenn die folgenden Elemente für die Achse angegeben werden:

Time-Hierarchie

Category-Hierarchie

Cluster

1999

Tatsächlich

Cluster 1

1999

Budget

Cluster 1

2000

Budget

Cluster 1

2001

Budget

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>