Crear una visualización (gráfico)

Artigo
03/22/2023

Para crear una visualización mediante programación, debe crear un registro para la Entidad SavedQueryVisualization o la Entidad UserQueryVisualization para crear un gráfico propiedad de la organización o propiedad del usuario respectivamente. Este tema muestra cómo crear una visualización del gráfico y una visualización del recurso web.

Antes de crear una visualización

Antes de crear una visualización, asegúrese de saber lo siguiente:

Tipo de visualización: si desea que las visualizaciones estén disponibles en la organización y no se desea administrar los niveles de acceso en un nivel más detallado, puede crear una visualización propiedad de la organización. Sin embargo, si le preocupan los privilegios de acceso y la seguridad de la visualización, considere la posibilidad de crear una visualización propiedad del usuario en la que tenga más control sobre quién puede obtener acceso a ella.

Nota

Las visualizaciones que pertenecen a la organización solo las pueden crear los usuarios que tengan el rol de administrador del sistema o personalizador del sistema.
Entidad asociada: las visualizaciones se asocian a entidades. Más información: Entidades compatibles con visualizaciones. Puede vincular un gráfico a una entidad admitida usando el atributo SavedQueryVisualization.PrimaryEntityTypeCode o UserQueryVisualization.PrimaryEntityTypeCode.

Creación de una visualización de gráfico

Los gráficos requieren que se especifiquen sus datos subyacentes y el aspecto que tendrán los gráficos mediante cadenas XML de descripción de datos y descripción de presentación. Más información: Especificar datos de gráficos y Gráficos de ejemplo.

Para obtener un ejemplo completo sobre cómo crear un gráfico de propiedad de la organización, vea Ejemplo: Crear, recuperar, actualizar y eliminar (CRUD) un gráfico .

Creación de un gráfico de varias series

Los gráficos de varias series asignan valores de eje (vertical) de varias series a un solo valor de eje (horizontal) de categorías. Solo se diferencia de los gráficos de una sola serie en que estos gráficos tienen varios elementos <measurecollection> y <series> correspondientes especificados en las cadenas XML. Cada elemento <measurecollection> contiene un elemento secundario <measure> que define un valor de eje (vertical) de series para el mismo valor (horizontal) de categorías. Más información: Descripción de los gráficos: representación de datos y gráficos subyacentes.

Para obtener un gráfico de varias series de ejemplo y las correspondientes cadenas XML de descripción de datos y de presentación, consulte Gráfico de varias series.

Creación de una visualización de recurso web

Las visualizaciones que contienen recursos web no requieren especificar las cadenas XML de descripción de datos y de presentación. El siguiente ejemplo muestra cómo crear una visualización propiedad de una organización que contiene un recurso web mediante el SDK.

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

Si desea crear una visualización del recurso web mediante la aplicación web Dynamics 365 for Customer Engagement, debe crear un archivo XML en el siguiente formato y después usar Importar gráfico en la cinta de opciones para importar la visualización.

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

Por ejemplo, para crear una Visualización de ejemplo que muestra un recurso web existente llamado new_TestWebResource, la visualización debe estar asociada a la entidad cuenta, el código XML debería tener este aspecto.

<visualization>  
  <name>Sample Visualization</name>  
  <description>Sample Web Resource Visualization.</description>  
  <webresourcename>new_TestWebResource</webresourcename>  
  <primaryentitytypecode>account</primaryentitytypecode>  
  <isdefault>false</isdefault>  
</visualization>

Vea también

Gráficos
Especificar datos del gráfico
Acciones en el gráfico
Gráficos de muestra
Análisis y visualización de datos
Ejemplo: Crear, recuperar, actualizar y eliminar (CRUD) un gráfico

Compartir por