Aracılığıyla paylaş


Görsel oluşturma

Bu API, rapor sayfasında yeni bir görsel oluşturmanın bir yolunu sağlar.

Görsel oluşturma ve verilere bağlama

Belirli bir türde boş bir görsel oluşturun ve ardından görseli veri alanlarına bağlayın. Görsel türlerinin listesi için bkz.kullanıma hazır görsel türleri.

Not

Görselleştirme bölmesinde yüklü olmayan görseller rapora eklenemez. Bu, hem yüklenmemiş özel görseller hem de kaldırılmış kullanıma hazır görseller için geçerlidir.

  1. Oluşturmak istediğiniz görseli aşağıdaki parametreleri kullanarak yapılandırın:

    • Görsel türü: oluşturmak istediğiniz görselin türü, örneğin barChart.
    • Düzeni (isteğe bağlı): Yeni görsele uygulanacak düzen.
    • autoFocus (isteğe bağlı): Sayfanın otomatik olarak yeni oluşturulan görsele kaydırılıp kaydırılmayacağını seçin (varsayılan olarak 'True' olarak ayarlanır).
  2. Görselinizi oluşturmak için aşağıdaki yöntemi kullanın:

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

Döndürülen değer, yeni oluşturulan görseli temsil eden bir nesne içerir. görseli gereksinimlerinize göre düzenlemek için görsel veri bağlama ve görsel özelliklerini API'leri kullanabilirsiniz.

Mesela:

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

Kod örnekleri

Aşağıdaki kod örneklerinde farklı parametrelere sahip görsellerin nasıl oluşturulacağı gösterilmektedir.

Not

Özel düzenler oluşturma hakkında bilgi için bkz. Görsel düzen.

Özel düzende ve odaksız bir alan grafiği görseli oluşturun.

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

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

Varsayılan düzende bir alan grafiği oluşturun.

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

Kullanıma hazır görsel türleri

  • actionButton

  • areaChart

  • barChart

  • basicShape

  • kart

  • clusteredBarChart

  • clusteredColumnChart

  • columnChart

  • debugVisual

  • Ayrıştırma Ağacı

  • donutChart

  • esriVisual

  • filledMap

  • huni

  • Ölçer

  • hundredPercentStackedBarChart

  • hundredPercentStackedColumnChart

  • resim

  • keyDriversVisual

  • kpi

  • lineChart

  • lineClusteredColumnComboChart

  • lineStackedColumnComboChart

  • harita

  • multiRowCard

  • pieChart

  • pivotTable

  • PowerApps

  • pythonVisual

  • qnaVisual

  • ribbonChart

  • dağılım Çizelgesi

  • scriptVisual

  • shapeMap

  • Dilimleyici

  • stackedAreaChart

  • tableEx

  • metin kutusu

  • ağaç haritası

  • waterfallChart

Dikkat edilmesi gerekenler ve sınırlamalar

Görsel oluşturma API'leri yalnızca rapor işlendikten sonra kullanılabilir. Rapor rendered olayını dinleyin ve görsel yazma API'lerini yalnızca çağrıldıktan sonra tetikler. Daha fazla bilgi için bkz. olay işleme .