Bagikan melalui

Mendapatkan halaman dan visual

  • Artikel

Setelah memuat laporan, Anda dapat membuat daftar halaman atau visual yang dapat langsung digunakan untuk membuat perubahan pada instans tersebut. Anda juga dapat membuat daftar untuk melihat visual apa yang digunakan pada halaman tertentu.

Cara mendapatkan daftar halaman

Kelas Halaman menyertakan properti dan metode ke halaman laporan perubahan. Misalnya, Anda dapat menggunakan properti defaultSize untuk menentukan ukuran halaman seperti yang disimpan dalam laporan, atau metode getFilters() untuk mendapatkan semua filter tingkat halaman dalam laporan. Untuk informasi selengkapnya, lihatkelas Halaman .

Gunakan getPages untuk mengambil daftar halaman dalam laporan. Urutan halaman yang dikembalikan berada dalam urutan yang sama seperti dalam laporan.

let pages = await report.getPages();

Cara mendapatkan daftar visual

Kelas VisualDescriptor menyertakan properti dan metode untuk mengubah visual di halaman tertentu. Misalnya, Anda dapat menggunakan properti layout untuk menentukan posisi, ukuran, dan visibilitas visual. Untuk informasi selengkapnya, lihat kelas VisualDescriptor.

Gunakan metode asinkron getVisuals pada instans page.

let pages = await page.getVisuals();

Contoh kode

Mengambil kumpulan halaman

Contoh kode berikut menunjukkan cara mengambil kumpulan halaman dalam laporan, dengan contoh output yang memperlihatkan nama halaman dan nama tampilan setiap objek.

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

Mendapatkan daftar visual

Contoh kode ini menunjukkan cara mendapatkan daftar visual untuk halaman pertama.

let pages = await report.getPages();

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

Mendapatkan kumpulan halaman dan visual halaman pertama

Contoh ini mengambil kumpulan halaman dan visual (dengan beberapa properti) untuk halaman aktif.

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
        };
    }));

Pertimbangan dan batasan

Laporan harus dimuat untuk menggunakan fungsi getPages atau getVisuals.

Konten terkait