Crear una visualización (gráfico)

Artículo
02/23/2023

Para crear una visualización mediante programación, debe crear un registro para la Tabla SavedQueryVisualization o la Tabla 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.
Tabla asociada: las visualizaciones se asocian a tablas. Más información: Tablas compatibles con visualizaciones. Puede vincular un gráfico a una tabla admitida usando el parámetroSavedQueryVisualization.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, por sus siglas en inglés) 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.

var newWebResourceVisualization = new SavedQueryVisualization()
{
   Name = "Sample Dashboard Visualization",
   Description = "Sample organization-owned visualization",
  PrimaryEntityTypeCode = Account.EntityLogicalName,
   WebResourceId = new EntityReference(WebResource.EntityLogicalName, _webResourceId))

};
_orgOwnedVisualizationId = service.Create(newWebResourceVisualization);

Si desea crear una visualización del recurso web mediante la aplicación web de Microsoft Dataverse, 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 tabla 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>

Consultar también

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

Compartir vía