创建图表可视化项
发布日期: 2017年1月
适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
若要使用 Microsoft Dynamics 365 SDK 创建可视化项,您必须创建 SavedQueryVisualization 或 UserQueryVisualization 实体的记录,以便分别创建组织负责或用户负责的图表。 本主题显示如何创建图表可视化项和 Web 资源可视化项。
本主题内容
在创建可视化项之前
创建图表可视化项
创建 Web 资源可视化项
在创建可视化项之前
在创建可视化项之前,请确保您知道以下事项:
可视化类型:如果希望可视化项可以在整个组织中使用,并且不希望在更详细级别管理访问级别,可以创建组织负责的可视化项。 但是,如果您担心可视化项的访问权限和安全性,请考虑创建用户负责的可视化项,其中您对可以访问可视化项的人员拥有更多控制。
备注
组织负责的可视化项只能由具有系统管理员或系统定制员角色的用户创建。
关联的实体:将可视化项附加到实体。详细信息: 可视化项支持的实体。 可以使用 SavedQueryVisualization.PrimaryEntityTypeCode 或 UserQueryVisualization.PrimaryEntityTypeCode 属性将图表附加到支持的实体。
创建图表可视化项
图表需要您以数据说明和展示说明 XML 字符串的形式指定图表的基本数据以及图表的外观。详细信息: 理解图表:底层数据和图表表示 和 示例图表。
有关如何创建组织负责的图表的完整示例,请参阅示例:创建、检索、更新和删除图表。
创建多序列图表
多序列图表将多序列(垂直)轴值映射到单个类别(水平)轴值。 与单序列图表的唯一差异是,这些图表具有在 XML 字符串中指定的多个 <measurecollection> 和相应的 <series> 元素。 每个 <measurecollection> 元素都包含一个名为 <measure> 的子元素,其为同一类别(水平)值定义序列(垂直)轴值。详细信息: 理解图表:底层数据和图表表示。
有关示例多序列图表和相应的数据说明和展示说明 XML 字符串,请参阅 多系列图。
创建 Web 资源可视化项
包含 Web 资源的可视化项无需您指定数据说明和展示说明 XML 字符串。 以下示例演示了如何使用 SDK 创建包含 Web 资源的组织负责的可视化项。
SavedQueryVisualization newWebResourceVisualization = new SavedQueryVisualization()
{
Name = "Sample Dashboard Visualization",
Description = "Sample organization-owned visualization",
PrimaryEntityTypeCode = Account.EntityLogicalName,
WebResourceId = new EntityReference(WebResource.EntityLogicalName, _webResourceId))
};
_orgOwnedVisualizationId = _serviceProxy.Create(newWebResourceVisualization);
如果想使用 Microsoft Dynamics 365 Web 应用程序创建 Web 资源可视化项,则必须采用以下格式创建 XML 文件,然后使用功能区中的“导入图表”来导入可视化项。
<visualization>
<name>Visualization_Name</name>
<description>Description</description>
<webresourcename>Name_Of_An_Existing_Web_Resource</webresourcename>
<primaryentitytypecode>Entity_Logical_Name</primaryentitytypecode>
<isdefault>Value: true or false</isdefault>
</visualization>
例如,若要创建一个显示名为“new_TestWebResource”的现有 Web 资源的“示例可视化项”,且该可视化项应附加到“account”实体,则 XML 应该如下所示。
<visualization>
<name>Sample Visualization</name>
<description>Sample Web Resource Visualization.</description>
<webresourcename>new_TestWebResource</webresourcename>
<primaryentitytypecode>account</primaryentitytypecode>
<isdefault>false</isdefault>
</visualization>
另请参阅
使用可视化项(图表)查看数据
理解图表:底层数据和图表表示
可视化项(图表)上的操作
示例图表
自定义可视化和仪表板
示例:创建、检索、更新和删除图表
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权