Elemento Axis (XMLA)

Contiene un conjunto de tuplas utilizado para representar un eje único en un conjunto de datos multidimensional contenido por un elemento Axes que utiliza el tipo de datos MDDataSet devuelto por el método Execute.

Sintaxis

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

Características del elemento

Característica	Descripción
Tipo y longitud de los datos	Ninguno
Valor predeterminado	Ninguno
Cardinalidad	0-n: Elemento opcional que puede tener lugar más de una vez.

Relaciones del elemento

Relación	Elemento
Elementos primarios	Axes
Elementos secundarios	CrossProduct o Tuples

Comentarios

El contenido del elemento Axis varía, dependiendo del valor de la propiedad XMLA AxisFormat usada por el método Execute.

TupleFormat

Cuando una aplicación cliente establece la propiedad AxisFormat en TupleFormat, un eje se representa como un conjunto de tuplas. Cada elemento Axis contiene un elemento Tuples que representa el conjunto de tuplas de ese eje. Cada tupla se representa utilizando un elemento Tuple que contiene elementos Member de cada jerarquía del eje.

ClusterFormat

Cuando una aplicación cliente establece la propiedad AxisFormat en ClusterFormat, los miembros de cada eje se dividen clústeres en los que cada uno representa un producto cruzado entre los conjuntos ordenados de miembros de cada jerarquía. Cada elemento Axis consta de uno o varios elementos CrossProduct. Cada elemento CrossProduct contiene un elemento Members para cada jerarquía del eje.

CustomFormat

Cuando una aplicación cliente establece la propiedad AxisFormat en CustomFormat, el valor se trata igual que el valor TupleFormat por parte de una instancia de Analysis Services.

Ejemplos

Descripción

El ejemplo siguiente muestra la estructura de los elementos Axis cuando un cliente especifica TupleFormat o CustomFormat para la propiedad XMLA AxisFormat, dados los siguientes miembros para el eje:

Jerarquía de Time	1999	1999	2000
Jerarquía de Category	Real	Presupuesto	Presupuesto

Código

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

Descripción

El ejemplo siguiente muestra la estructura de los elementos Axis cuando un cliente especifica ClusterFormat para la propiedad XMLA AxisFormat, dados los siguientes miembros para el eje:

Jerarquía de Time	1999	1999	2000	2001
Jerarquía de Category	Real	Presupuesto	Presupuesto	Presupuesto
Clústers	Clúster 1	Clúster 1	Clúster 1	Clúster 2

Código

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

Vea también

Conceptos

Properties (XMLA)