Condividi tramite


Creare un oggetto visivo

Questa API consente di creare un nuovo oggetto visivo in una pagina del report.

Come creare un oggetto visivo e associarlo ai dati

Creare un oggetto visivo vuoto di un tipo specifico e quindi associare l'oggetto visivo ai campi dati. Per un elenco dei tipi di oggetto visivo, vedere tipi di oggetti visivi predefiniti.

Nota

Gli oggetti visivi non installati nel riquadro di visualizzazione non possono essere aggiunti a un report. Questo vale sia per gli oggetti visivi personalizzati non installati che per gli oggetti visivi predefiniti che sono stati disinstallati.

  1. Configurare l'oggetto visivo da creare usando i parametri seguenti:

    • tipo di oggetto visivo: tipo di oggetto visivo da creare, ad esempio un barChart.
    • Layout (facoltativo): layout da applicare al nuovo oggetto visivo.
    • autoFocus (facoltativo): scegliere se la pagina scorre automaticamente fino all'oggetto visivo appena creato (impostato su "True" per impostazione predefinita).
  2. Usare il metodo seguente per creare l'oggetto visivo:

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

Il valore restituito contiene un oggetto che rappresenta l'oggetto visivo appena creato. È possibile usare il data binding visivo e proprietà visive API per modificare l'oggetto visivo in base alle esigenze.

Per esempio:

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

Esempi di codice

Negli esempi di codice seguenti viene illustrato come creare oggetti visivi con parametri diversi.

Nota

Per informazioni sulla creazione di layout personalizzati, vedere Layout visivo.

Creare un oggetto visivo grafico ad area con un layout personalizzato e senza stato attivo.

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

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

Creare un grafico ad area con un layout predefinito.

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

Tipi di oggetti visivi predefiniti disponibili

  • actionButton

  • areaChart

  • barChart

  • basicShape

  • scheda

  • clusteredBarChart

  • clusteredColumnChart

  • columnChart

  • debugVisual

  • Albero di scomposizione

  • donutChart

  • esriVisual

  • filledMap

  • imbuto

  • misuratore

  • hundredPercentStackedBarChart

  • hundredPercentStackedColumnChart

  • immagine

  • keyDriversVisual

  • kpi

  • lineChart

  • lineClusteredColumnComboChart

  • lineStackedColumnComboChart

  • mappa

  • multiRowCard

  • pieChart

  • Tabella pivot

  • PowerApps

  • pythonVisual

  • qnaVisual

  • grafico a barre multifunzione

  • grafico a dispersione

  • scriptVisual

  • shapeMap

  • affettatrice

  • stackedAreaChart

  • tableEx

  • casella di testo

  • mappa ad albero

  • grafico a cascata

Considerazioni e limitazioni

Le API di creazione visiva sono disponibili solo dopo il rendering del report. Ascoltare il report rendered evento e attivare le API di creazione visiva solo dopo la chiamata. Per altre informazioni, vedere gestione degli eventi.