Compartir a través de

Creación de un objeto visual

  • Artículo

Esta API proporciona una manera de crear un objeto visual en una página de informe.

Cómo crear un objeto visual y enlazarlo a datos

Cree un objeto visual vacío de un tipo específico y, a continuación, enlace el objeto visual a campos de datos. Para obtener una lista de los tipos de objetos visuales, vea tipos de objetos visuales predefinidos.

Nota

Los objetos visuales que no están instalados en el panel de visualización no se pueden agregar a un informe. Esto es cierto tanto para los objetos visuales personalizados que no están instalados como para los objetos visuales predefinidos que se han desinstalado.

  1. Configure el objeto visual que desea crear mediante los parámetros siguientes:

    • Tipo de objeto visual: el tipo de objeto visual que desea crear, como un barChart.
    • Diseño (opcional): el diseño que se va a aplicar al nuevo objeto visual.
    • autoFoco (opcional): elija si la página se desplaza automáticamente al objeto visual recién creado (establecido en "True" de forma predeterminada).

  2. Use el método siguiente para crear el objeto visual:

    createVisual(visualType: string, layout?: models.IVisualLayout, autoFocus?: boolean): Promise<models.ICreateVisualResponse>

El valor devuelto contiene un objeto que representa el objeto visual recién creado. Puede usar el de enlace de datos visuales y propiedades visuales API para editar el objeto visual según sus necesidades.

Por ejemplo:

let createVisualResponse = await page.createVisual('areaChart');
let visual = createVisualResponse.visual;

Ejemplos de código

En los ejemplos de código siguientes se muestra cómo crear objetos visuales con distintos parámetros.

Nota

Para obtener información sobre cómo crear diseños personalizados, vea Diseño visual.

Cree un objeto visual de gráfico de áreas con un diseño personalizado y sin foco.

const customLayout = {
    x: 20,
    y: 35,
    width: 1600,
    height: 1200
}

let createVisualResponse = await page.createVisual('areaChart', customLayout, false /* autoFocus */);

Cree un gráfico de áreas con un diseño predeterminado.

let createVisualResponse = await page.createVisual('areaChart');

Tipos de objetos visuales predefinidos disponibles

  • actionButton

  • areaChart

  • barChart

  • basicShape

  • tarjeta

  • clusteredBarChart

  • clusteredColumnChart

  • columnChart

  • debugVisual

  • Árbol de descomposición

  • donutChart

  • esriVisual

  • filledMap

  • embudo

  • calibre

  • hundredPercentStackedBarChart

  • hundredPercentStackedColumnChart

  • imagen

  • keyDriversVisual

  • kpi

  • lineChart

  • lineClusteredColumnComboChart

  • lineStackedColumnComboChart

  • mapa

  • multiRowCard

  • gráfico circular

  • Tabla dinámica

  • PowerApps

  • pythonVisual

  • qnaVisual

  • ribbonChart

  • gráfico de dispersión

  • scriptVisual

  • shapeMap

  • rebanador

  • stackedAreaChart

  • tableEx

  • cuadro de texto

  • gráfico de rectángulos

  • waterfallChart

Consideraciones y limitaciones

Las API de creación de objetos visuales solo están disponibles después de representar el informe. Escuche en el informe rendered evento y desencadene las API de creación de objetos visuales solo después de llamar a él. Consulte de control de eventos para obtener más información.

Contenido relacionado