理解图表：底层数据和图表表示

项目
03/04/2017

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

图表通过将文字值映射在两个轴上来以直观的方式显示数据：水平 (x) 和垂直 (y)。在 Microsoft Dynamics 365 中，x 轴称为“类别”轴，而 y 轴则称为“系列”轴。类别轴即可以显示数字值也可以显示非数字值，而系列轴则仅能显示数字值。

Microsoft Dynamics 365 中的图表可以进一步分为以下类别：

单系列图表：通过将一系列 (y) 值映射到一个类别 (x) 值的方式来显示数据的图表。
多系列图表：通过将多个系列值映射到单一类别值的方式来显示数据的图表。多系列图表包括堆积柱形图（用于跨类别垂直显示每个系列占总体的比例）和 100% 堆积柱形图（用于跨类别比较每个系列占总体的百分比）。您可以将不同的兼容图表类型（例如列和行、栏和行等）合并到多系列图表中。

备注

可以通过 Web 应用程序或修改此处所述的 XML 字符串创建多类别图表。

使用 SDK 在 Microsoft Dynamics 365 中制作图表时，您需要考虑以下两个重要方面：

图表的基本数据：使用数据说明 XML 字符串指定。
表示形式（外观）：使用展示说明 XML 字符串指定。

备注

Microsoft Chart Controls 允许您创建各种类型的图表，例如柱形图、条形图、面积图、折线图、饼图、漏斗图、气泡图和雷达图。Microsoft Dynamics 365 中的图表设计器仅允许您创建某些类型的图表。但是，使用 SDK，您可以创建 Microsoft Chart Controls 支持的大多数图表类型。

使用数据说明 XML 字符串指定图表数据

数据说明 XML 字符串定义要显示在图表上的数据。 XML 字符串的内容会针对可视化效果数据说明架构接受验证。有关架构的详细信息，请参阅Visualization data description schema。

可以在使用 SavedQueryVisualization.DataDescription 或 UserQueryVisualization.DataDescription 属性（分别用于组织负责的图表或用户负责的图表）创建图表时指定数据说明 XML 字符串。

数据说明 XML 字符串包含以下两个元素：<FetchCollection> 和 <CategoryCollection>。

<FetchCollection> 元素

<FetchCollection> 元素使用 FetchXML 检索图表的数据。 FetchXML 查询为要显示在图表中的数据指定有关实体属性、聚合函数和 group by 子句的信息。所有 FetchXML 聚合函数支持图表。有关 FetchXML 聚合函数的详细信息，请参阅使用 FetchXML 聚合。

通过 FetchXML 查询可以筛选数据。另外，还可以通过视图对图表应用筛选器。因此，如果已在 <FetchCollection> 元素的 FetchXML 查询中指定了一个筛选条件，此外还通过视图应用了另一个筛选器，则图表会显示应用了所有筛选器之后返回的数据。有关如何使用 FetchXML 查询筛选数据的详细信息，请参阅使用 FetchXML 构建查询。

备注

尽管数据说明 XML 字符串会针对可视化效果数据说明架构接受验证，但是 <FetchCollection> 元素中的 FetchXML 查询却不这样验证。 FetchXML 查询针对 FetchXML 架构接受验证。有关详细信息，请参阅FetchXML schema。

如果图表是比较图表，则 <FetchCollection> 元素将包含两个分组依据 子句。

<CategoryCollection> 元素

<CategoryCollection> 元素包含有关图表中类别（水平）和系列（垂直）轴的信息。

每个 <Category> 子元素都具有一个名为 <MeasureCollection> 的子元素，该子元素映射至展示说明 XML 中的 <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 字符串的架构定义。但是，在 Microsoft Chart Controls 中，XML 是 Chart 类的序列化。详细信息：图表控件

对组织负责或用户负责的图表分别使用 SavedQueryVisualization.PresentationDescription 或 UserQueryVisualization.PresentationDescription 属性来创建图表时，可以指定展示说明 XML 字符串。

示例

下面是一个示例展示说明 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 构建查询
 FetchXML schema
Visualization data description schema
示例图表
 Chart 类 (Microsoft Chart Controls)

Microsoft Dynamics 365