グラフの理解: 基盤となるデータとグラフ表現

グラフには、水平 (x) と垂直 (y) の 2 つの軸にテキスト値をマップすることでデータが視覚的に表示されます。 x 軸は カテゴリ 軸と呼ばれ、y 軸は series 軸と呼ばれます。 カテゴリ軸には数値と数値以外を表示できますが、系列軸には数値のみ表示されます。

モデル駆動形アプリのグラフは、さらに次のように分類できます。

• 単一系列グラフ: 単一の系列 (y) 値が単一のカテゴリ (x) 値にマップされたデータを表示するグラフ。

• 複数系列グラフ: 複数の系列値が単一のカテゴリ値にマップされたデータを表示するグラフ。 複数系列グラフには、積み上げ縦棒グラフ (全カテゴリ合計に対する各系列の貢献度を垂直方向に表示) と 100% 積み上げ縦棒グラフ (全カテゴリ合計に対する各系列の貢献率を比較) があります。 たとえば、縦棒グラフと横棒グラフ、棒グラフと折れ線グラフなど、複数系列グラフの、互換性のある別の種類のグラフと結合できます。

モデル駆動形アプリで SDK を使用してグラフを作成する際には、次の 2 つの要点を考慮する必要があります。

• グラフの基になるデータ: データ記述 XML 文字列を使用して指定します。

• データ表現 (外観): プレゼンテーション記述 XML 文字列を使用してデータ プレゼンテーションを指定します。

データ記述 XML 文字列を使用してグラフ データを指定する

データ記述 XML 文字列は、グラフに表示されるデータを定義します。 XML 文字列のコンテンツは、ビジュアル化データ記述スキーマに照らして検証されます。 スキーマの詳細については、「ビジュアル化データ記述スキーマ」を参照してください。

グラフを作成する際に、組織所有のグラフまたはユーザー所有のグラフでそれぞれ SavedQueryVisualization.DataDescription または UserQueryVisualization.DataDescription を使用してデータ記述 XML 文字列を指定できます。

データ記述 XML 文字列には、<FetchCollection> および <CategoryCollection> という 2 つの要素が含まれます。

<FetchCollection> 要素

<FetchCollection> 要素は FetchXML を使用してグラフのデータを取得します。 FetchXML クエリは、グラフに表示されるデータのテーブル列、集計関数、およびグループ化句に関する情報を指定します。 すべての FetchXML 集計関数がグラフでサポートされています。 集計関数の詳細については、「FetchXmlを使用してデータを集計する」を参照してください FetchXML 。 ...

FetchXML クエリを使用すると、データをフィルタリングできます。 また、フィルターはビュー経由でもグラフに適用されます。 したがって、 FetchXML 要素のクエリでフィルター条件がすでに指定されていて、さらにビューを通じてフィルターが適用されている場合、チャートにはすべてのフィルターを適用した後に返されるデータが表示されます。 <FetchCollection> クエリを使用してデータをフィルター処理する方法の詳細については、「FetchXmlを使用してデータをクエリする」を参照してください。 FetchXML ...

グラフが比較グラフの場合、<FetchCollection> 要素には* 句による 2 つのグループが含まれます。

<CategoryCollection> 要素

<CategoryCollection> 要素には、グラフのカテゴリ (水平) 軸と系列 (垂直) 軸に関する情報が含まれます。

• 各 <Category> サブ要素には、プレゼンテーション記述 XML 内の <MeasureCollection> 要素にマップされる <Series> という子要素があります。 単一系列グラフには単一の <MeasureCollection> 子要素があり、複数系列グラフには複数の <MeasureCollection> 子要素があります。それぞれ、プレゼンテーション記述 XML の <Series> 要素にマップされます。

• 各 <MeasureCollection> 子要素には、カテゴリ (水平) 軸の各値に対応する系列 (垂直) 軸値に対応する <Measure> という要素があります。

例

データ記述 XML 文字列の例を次に示します。

<datadefinition>  
  <fetchcollection>  
    <fetch mapping="logical" count="10">  
      <entity name="opportunity">  
        <attribute name="estimatedvalue" />  
        <order attribute="estimatedvalue" descending="true" />  
      </entity>  
    </fetch>  
  </fetchcollection>  
  <categorycollection>  
    <category>  
      <measurecollection>  
        <measure alias="estimatedvalue" />  
      </measurecollection>  
    </category>  
  </categorycollection></datadefinition>  

データ記述 XML 文字列のその他の例については、「サンプル グラフ」を参照してください。

プレゼンテーション記述 XML 文字列を使用してデータ プレゼンテーションを指定する

プレゼンテーション記述 XML 文字列には、グラフ タイトル、グラフの色、グラフの種類 (横棒、縦棒、折れ線など) など、グラフの外観に関する情報が含まれます。 この XML 文字列に対するスキーマ定義はありません。 ただし XML はシリアル化された Microsoft Chart Controls における Chart class です。 詳細: グラフ コントロール

グラフを作成する際に、組織所有のグラフまたはユーザー所有のグラフでそれぞれ SavedQueryVisualization.PresentationDescription や UserQueryVisualization.PresentationDescription を使用してプレゼンテーション記述 XML 文字列を指定できます。

Web クライアントの例

Web クライアントのプレゼンテーション記述 XML 文字列の例を次に示します。

<Chart Palette="BrightPastel">  
  <Series>  
    <Series _Template_="All" Color="153, 204, 255" BorderColor="164, 164, 164" BorderDashStyle="Solid" BorderWidth="1" ShadowColor="128, 128, 128, 128" ShadowOffset="1" IsValueShownAsLabel="true" Font="{0}, 6.75pt" BackGradientStyle="TopBottom" BackSecondaryColor="0, 102, 153" LabelForeColor="100, 100, 100" ChartType="Column">  
      <SmartLabelStyle Enabled="True" />  
      <Points />  
    </Series>  
  </Series>  
  <ChartAreas>  
    <ChartArea _Template_="All" BackColor="White" BorderColor="26, 59, 105" BorderWidth="0" BorderDashStyle="Solid">      <AxisY LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">  
        <MajorTickMark LineColor="Gray" />  
        <MajorGrid Enabled="false" />  
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />  
      </AxisY>  
      <AxisX LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">        <MajorTickMark LineColor="Gray" />        <MajorGrid Enabled="false" />  
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />  
      </AxisX>  
    </ChartArea>  
  </ChartAreas>  
  <Titles>  
    <Title _Template_="All" Font="{0}, 9pt, style=Bold, GdiCharSet=0" ForeColor="100, 100, 100"></Title>  
  </Titles>  
  <BorderSkin PageColor="Control" BackColor="CornflowerBlue" BackSecondaryColor="CornflowerBlue" />  
</Chart>  

プレゼンテーション記述 XML 文字列のその他の例については、「サンプル グラフ」を参照してください。

統一インターフェイスでサポートされているメソッドとプロパティ

次のセクションでは、統一インターフェイスでサポートされているメソッドとプロパティを示します。

AxisX

シリーズの X 軸タイプを取得または設定します。

プロパティ

例

 <AxisX Enabled="True" LineColor="165, 172, 181" Title="Test XAxis Title" TitleForeColor="91,151,213" IsReversed="true">
    <MajorTickMark LineColor="165, 172, 181" Enabled="true" />
    <MajorGrid LineColor="green" Enabled="true"/>
    <LabelStyle ForeColor="red" Format="#,0,.##K" Enabled="true" />
 </AxisX>

AxisY

シリーズの Y 軸タイプを取得または設定します。

プロパティ

例

<AxisY Enabled="True" LineColor="165, 172, 181" Title="Test YAxis Title" TitleForeColor="91,151,213" Interval="1" Minimum="0" Maximum="5">
  <MajorTickMark LineColor="165, 172, 181" Enabled="true" />
  <MajorGrid LineColor="green" Enabled="true"/>
  <LabelStyle ForeColor="red" Enabled="true" />
</AxisY>
<AxisY2 Enabled="True" LineColor="165, 172, 181" Title="Test YAxis2 Title" TitleForeColor="91,151,213" Interval="10" Minimum="0" Maximum="100">
  <MajorTickMark LineColor="165, 172, 181" Enabled="true" />
  <MajorGrid LineColor="green" Enabled="true"/>
  <LabelStyle ForeColor="red" Enabled="true" />
</AxisY2>

グラフ​​

グラフのルート クラス。

プロパティ

例

<Chart Palette="None" PaletteCustomColors="91, 151, 213; #4169E1, red, 127,97,142,206">

ChartArea

グラフ画像のグラフ領域を表します。

プロパティ

例

<ChartArea BackColor="orange" BackSecondaryColor="purple" BackGradientStyle="LeftRight" >
  <Area3DStyle Enable3D="true" />
</ChartArea>

凡例

チャート画像の凡例を表します。

プロパティ

例

<Legends>
  <Legend Enabled="True"/>
</Legends>

系列

データ ポイントと系列を格納します。

プロパティ

例

<Series>
  <Series ChartType="Column" Color="91, 151, 213" LegendText="Est Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59">
  </Series>
  <Series ChartType="Column" Color="237, 125, 49" LegendText="Actual Revenue" IsVisibleInLegend="True" BorderColor="red" BorderWidth="1" IsValueShownAsLabel="True" LabelFormat="$#,0,.##K" LabelForeColor="59, 59, 59" YAxisType="Secondary">
  </Series>
</Series>

統一インターフェイスでサポートされるカラー形式

統一インターフェイスは、ウェブ クライアントと互換性のあるグラフ プレゼンテーション xml で次の色形式をサポートしています。

• RGB 少数形式: 97,142,206
• RGB HEX 形式: #4169E1
• ARGB 少数形式: 127,90,138,57
• ブラウザが認識する名前のついた色: 赤、透明

統一インターフェイスのグラフでサポートされる数値形式

関連項目

ビジュアル化 (グラフ)
ビジュアル化に対するアクション (グラフ)
グラフの作成
FetchXML を使用してデータのクエリを実行する
ビジュアル化データ記述スキーマ
サンプル グラフ
Chart クラス (Microsoft Chart Controls)