Axis 要素 (XMLA)

[アーティクル]
08/01/2012

Execute メソッドによって返される、MDDataSet データ型を使用する Axes 要素に含まれる多次元データセット内で、単一の軸を表すために使用される組のセットを含みます。

構文

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

要素の特性

特性	説明
データ型と長さ	なし
既定値	なし
基数	0-n : 省略可能な要素で、出現する場合は複数回の出現が可能です

要素のリレーションシップ

リレーションシップ	要素
親要素	Axes
子要素	CrossProduct または Tuples

説明

Axis 要素の内容は、Execute メソッドによって使用される XMLA プロパティ AxisFormat の値に応じて異なります。

TupleFormat

クライアントアプリケーションが AxisFormat プロパティを TupleFormat に設定した場合、軸は複数の組のセットとして表されます。各 Axis 要素には、その軸上の組のセットを表す 1 つの Tuples 要素が含まれます。それぞれの組は Tuple 要素を使用して表され、この要素には軸上の各階層に属する Member 要素が含まれます。

ClusterFormat

クライアントアプリケーションが AxisFormat プロパティを ClusterFormat に設定した場合、それぞれの軸上のメンバーはクラスターに分割され、各クラスターは各階層の順序付けされたメンバーのセットどうしのクロス積を表します。各 Axis 要素は、1 つ以上の CrossProduct 要素から成っています。それぞれの CrossProduct 要素には、軸上の各階層に対する 1 つの Members 要素が含まれます。

CustomFormat

クライアントアプリケーションが AxisFormat プロパティを CustomFormat に設定した場合、値は Analysis Services インスタンスによって TupleFormat 値と同じように扱われます。

使用例

説明

次の例は、クライアントが XMLA プロパティ AxisFormat に TupleFormat または CustomFormat を指定した場合の Axis 要素の構造を示しています。ここで、軸のメンバーは以下のとおりです。

Time 階層	1999	1999	2000
Category 階層	Actual	Budget	Budget

コード

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

説明

次の例は、クライアントが XMLA プロパティ AxisFormat に ClusterFormat を指定した場合の Axis 要素の構造を示しています。ここで、軸のメンバーは以下のとおりです。

Time 階層	1999	1999	2000	2001
Category 階層	Actual	Budget	Budget	Budget
クラスター	Cluster 1	Cluster 1	Cluster 1	Cluster 2

コード

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

次の方法で共有