Aracılığıyla paylaş

Sayfaları ve görselleri alma

  • Makale

Bir raporu yükledikten sonra, bu örneklerde değişiklik yapmak için doğrudan kullanılabilecek sayfaların veya görsellerin listesini oluşturabilirsiniz. Belirli bir sayfada hangi görsellerin kullanıldığını görmek için bir liste de oluşturabilirsiniz.

Sayfa listesi alma

Sayfası sınıfı, değişiklik raporu sayfasının özelliklerini ve yöntemlerini içerir. Örneğin, rapora kaydedilen sayfa boyutunu tanımlamak için defaultSize özelliğini veya rapordaki tüm sayfa düzeyi filtrelerini almak için getFilters() yöntemini kullanabilirsiniz. Daha fazla bilgi için bkz. Page sınıfı.

Rapordaki sayfaların listesini almak için getPages kullanın. Döndürülen sayfaların sırası rapordakiyle aynı sıradadır.

let pages = await report.getPages();

Görsellerin listesini alma

VisualDescriptor sınıfı, belirli bir sayfadaki görseli değiştirmek için özellikler ve yöntemler içerir. Örneğin, görselin konumunu, boyutunu ve görünürlüğünü tanımlamak için layout özelliğini kullanabilirsiniz. Daha fazla bilgi için bkz. VisualDescriptor sınıfı .

page örneğinde getVisuals zaman uyumsuz yöntemini kullanın.

let pages = await page.getVisuals();

Kod örnekleri

Sayfa koleksiyonunu alma

Aşağıdaki kod örneğinde, rapordaki bir sayfa koleksiyonunun nasıl alınıp alınıp her nesnenin sayfa adını ve görünen adını gösteren bir örnek çıktı gösterilmektedir.

let pages = await report.getPages();
let log = "Report pages:";
pages.forEach(function (page) {
    log += "\n" + page.name + " - " + page.displayName;
});

console.log(log);

Report pages:
ReportSectioneb8c865100f8508cc533 - Tiles
ReportSection600dd9293d71ade01765 - Market Share
ReportSectiona271643cba2213c935be - YTD Category
ReportSection1c45b5dc6513ae89b4e3 - Sentiment
ReportSection2ff5a27ac612830bbd93 - Tooltip
ReportSection6da8317ad6cbcae5b3bb - Empty Page

Görsellerin listesini alma

Bu kod örneği, ilk sayfa için görsellerin listesinin nasıl alınacaklarını gösterir.

let pages = await report.getPages();

// Retrieve the first page.
let firstPage = pages[0];
let visuals = await firstPage.getVisuals();
console.log(visuals);

Sayfa koleksiyonunu ve ilk sayfanın görsellerini alma

Bu örnek, etkin sayfa için sayfa koleksiyonunu ve görselleri (çeşitli özelliklere sahip) alır.

let activePage = await report.getActivePage();

let visuals = await activePage.getVisuals();
console.log(
    visuals.map(function (visual) {
        return {
            name: visual.name,
            type: visual.type,
            title: visual.title,
            layout: visual.layout
        };
    }));

Dikkat edilmesi gerekenler ve sınırlamalar

getPages veya getVisuals işlevlerini kullanabilmek için raporun yüklenmesi gerekir.

İlgili içerik