Axis-Element (XMLA)

Enthält einen Satz Tupel, die eine einzelne Achse eines in einem Axes-Element enthaltenen mehrdimensionalen Datasets darstellen, das den von der Execute-Methode zurückgegebenen MDDataSet-Datentyp verwendet.

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	Keiner
Kardinalität	0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Achsen
Untergeordnete Elemente	CrossProduct oder Tuples

Hinweise

Der Inhalt des Axis-Elements variiert je nach dem Wert der AxisFormat-XMLA-Eigenschaft, die von der Execute-Methode verwendet wird.

TupleFormat

Wenn eine Clientanwendung die AxisFormat-Eigenschaft auf TupleFormat setzt, wird eine Achse als Menge an Tupels dargestellt. Jedes Axis-Element enthält ein Tuples-Element, das die Tupelmenge 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 setzt, werden die Elemente auf jeder Achse in Cluster unterteilt, wobei jedes Cluster ein Kreuzprodukt aus geordneten Mengen an Elementen 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 setzt, wird der Wert von einer Analysis Service-Instanz ebenso 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 XMLA-Eigenschaft AxisFormat festlegt, wobei die folgenden Elemente für die Achse vorhanden sind:

Time-Hierarchie	1999	1999	2000
Category-Hierarchie	Tatsächlich	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>

Beschreibung

Das folgende Beispiel veranschaulicht die Struktur der Axis-Elemente, wenn ein Client ClusterFormat für die XMLA-Eigenschaft AxisFormat festlegt, wobei die folgenden Elemente für die Achse vorhanden sind:

Time-Hierarchie	1999	1999	2000	2001
Category-Hierarchie	Tatsächlich	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>

Siehe auch

Konzepte

Eigenschaften (XMLA)