Bagikan melalui


Membuat visual

API ini menyediakan cara untuk membuat visual baru di halaman laporan.

Cara membuat visual dan mengikatnya ke data

Buat visual kosong dari jenis tertentu, lalu ikat visual ke bidang data. Untuk daftar jenis visual, lihat jenis visual out-of-the-box.

Nota

Visual yang tidak diinstal di panel visualisasi tidak dapat ditambahkan ke laporan. Ini berlaku untuk visual kustom yang tidak diinstal dan visual di luar kotak yang telah dihapus instalasinya.

  1. Konfigurasikan visual yang ingin Anda buat dengan menggunakan parameter berikut:

    • Jenis visual: Jenis visual yang ingin Anda buat, seperti barChart.
    • tata letak (opsional ): Tata letak yang akan diterapkan ke visual baru.
    • autoFocus (opsional): Pilih apakah halaman secara otomatis menggulir ke visual yang baru dibuat (diatur ke 'True' secara default).
  2. Gunakan metode berikut untuk membuat visual Anda:

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

Nilai yang dikembalikan berisi objek yang mewakili visual yang baru dibuat. Anda dapat menggunakan pengikatan data visual dan properti visual API untuk mengedit visual sesuai dengan kebutuhan Anda.

Misalnya:

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

Contoh kode

Contoh kode berikut menunjukkan cara membuat visual dengan parameter yang berbeda.

Nota

Untuk informasi tentang membuat tata letak kustom, lihat tata letak visual .

Buat visual bagan area dengan tata letak kustom dan tanpa fokus.

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

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

Buat bagan area dengan tata letak default.

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

Jenis visual out-of-the-box yang tersedia

  • actionButton

  • areaChart

  • barChart

  • basicShape

  • kartu

  • clusteredBarChart

  • clusteredColumnChart

  • columnChart

  • debugVisual

  • Pohon Dekomposisi

  • donutChart

  • esriVisual

  • filledMap

  • corong

  • Gauge

  • hundredPercentStackedBarChart

  • hundredPercentStackedColumnChart

  • citra

  • keyDriversVisual

  • kpi

  • lineChart

  • lineClusteredColumnComboChart

  • lineStackedColumnComboChart

  • peta

  • multiRowCard

  • pieChart

  • pivotTable

  • PowerApps

  • pythonVisual

  • qnaVisual

  • bagan pita

  • scatterChart

  • scriptVisual

  • shapeMap

  • Slicer

  • stackedAreaChart

  • tableEx

  • kotak teks

  • peta pohon

  • waterfallChart

Pertimbangan dan batasan

API pembuatan visual hanya tersedia setelah laporan dirender. Dengarkan peristiwa rendered laporan dan picu API penulisan visual hanya setelah dipanggil. Lihat Penanganan peristiwa untuk informasi selengkapnya.