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

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

Dynamics 365 for Customer Engagement のグラフは、さらに次のように分類できます。

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

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

注

複数カテゴリ グラフは、Web アプリケーションで、またはここで説明するように XML 文字列を変更することで作成できます。

SDK を使用して Dynamics 365 for Customer Engagement でグラフを作成する際には、次の 2 つの重要な側面を考慮する必要があります。

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

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

注

Microsoft Chart Controls を用いると、縦棒グラフ、横棒グラフ、面積グラフ、折れ線グラフ、円グラフ、じょうごグラフ、バブル チャート、レーダー チャートなど様々な種類のグラフを作成できます。 Dynamics 365 for Customer Engagement のグラフ デザイナーでは、特定の種類のグラフのみを作成できます。 ただし SDK を用いることにより Microsoft Chart Controls でサポートされているほとんどの種類のグラフを作成できます。

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

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

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

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

<FetchCollection> 要素

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

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

注

データ記述 XML 文字列はビジュアル化データ記述スキーマに照らして検証されますが、<FetchCollection> 要素内の FetchXML クエリはこのスキーマに照らして検証されません。 FetchXML クエリは、FetchXML スキーマに照らして検証されます。 詳細については、Fetch XML Schema を参照してください。

グラフが比較グラフの場合、 <FetchCollection> 要素には 2 つの group by 句が含まれます。

<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 です。 詳細: グラフ コントロール

プレゼンテーションの説明 XML 文字列は、組織所有のグラフまたはユーザー所有のグラフの SavedQueryVisualization.PresentationDescription 属性または UserQueryVisualization.PresentationDescription 属性を使用して、グラフの作成中に指定できます。

例

次に、プレゼンテーションの説明 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 文字列のその他の例については、「サンプル グラフ」を参照してください。

こちらも参照ください

ビジュアル化 (グラフ)
ビジュアライゼーション (チャート) のアクション
グラフの作成
FetchXML を使用したクエリの構築
XML スキーマの取得
ビジュアル化データ記述スキーマ
サンプル グラフ
Chart クラス (Microsoft Chart Controls)