Elemento Axis (XMLA)
Contém um conjunto de tuplas utilizado para representar um único eixo em um conjunto de dados multidimensional contido por um elemento Axes que utiliza o tipo de dados MDDataSet, retornado pelo método Execute.
Sintaxe
<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 do elemento
Característica |
Descrição |
|---|---|
Tipo de dados e comprimento |
Nenhum |
Valor padrão |
Nenhum |
Cardinalidade |
0-n: elemento opcional que pode ocorrer mais de uma vez. |
Comentários
O conteúdo do elemento Axis varia dependendo do valor da propriedade XMLA AxisFormat utilizada pelo método Execute.
TupleFormat
Quando um aplicativo cliente definir a propriedade AxisFormat como TupleFormat, um eixo é representado como um conjunto de tuplas. Cada elemento Axis contém um elemento Tuples que representa o conjunto de tuplas naquele eixo. Cada tupla é representada usando um elemento Tuple que contém elementos Member de toda hierarquia no eixo.
ClusterFormat
Quando um aplicativo cliente define a propriedade AxisFormat como ClusterFormat, os membros de cada eixo são divididos em clusters. Cada cluster representa um produto cruzado entre conjuntos de membros ordenados a partir de cada hierarquia. Cada elemento Axis consiste em um ou mais elementos CrossProduct. Cada elemento CrossProduct contém um elemento Members para cada hierarquia no eixo.
CustomFormat
Quando um aplicativo cliente definir a propriedade AxisFormat como CustomFormat, o valor é tratado da mesma forma que o valor TupleFormat por uma instância Analysis Services.
Exemplos
Descrição
O exemplo a seguir ilustra a estrutura do elemento Axis quando um cliente especifica o TupleFormat ou o CustomFormat para a propriedade XMLA AxisFormat, fornecida aos seguintes membros do eixo:
Hierarquia Time |
1999 |
1999 |
2000 |
Hierarquia Category |
Real |
Orçamento |
Orçamento |
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>
Descrição
O exemplo a seguir ilustra a estrutura dos elementos Axis quando um cliente especifica o ClusterFormat para a propriedade XMLA AxisFormat, fornecida aos seguintes membros do eixo:
Hierarquia Time |
1999 |
1999 |
2000 |
2001 |
Hierarquia Category |
Real |
Orçamento |
Orçamento |
Orçamento |
Clusters |
Cluster 1 |
Cluster 1 |
Cluster 1 |
Cluster 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>