Ottenere pagine e oggetti visivi

  • Articolo

Dopo il caricamento di un report, è possibile creare un elenco di pagine o oggetti visivi che possono essere usati direttamente per apportare modifiche a tali istanze. È anche possibile creare un elenco per visualizzare gli oggetti visivi usati in una pagina specifica.

Come ottenere un elenco di pagine

La classe page include proprietà e metodi per una pagina del report delle modifiche. Ad esempio, è possibile utilizzare la proprietà defaultSize per definire le dimensioni della pagina salvate nel report o il metodo getFilters() per ottenere tutti i filtri a livello di pagina nel report. Per altre informazioni, vedere classe Page.

Utilizzare getPages per recuperare un elenco delle pagine nel report. L'ordine delle pagine restituite è nello stesso ordine del report.

let pages = await report.getPages();

Come ottenere un elenco di oggetti visivi

La classe visualDescriptor include proprietà e metodi per modificare un oggetto visivo in una pagina specifica. Ad esempio, è possibile usare la proprietà layout per definire la posizione, le dimensioni e la visibilità dell'oggetto visivo. Per altre informazioni, vedere visualDescriptor classe.

Usare il metodo asincrono getVisuals nell'istanza di page.

let pages = await page.getVisuals();

Esempi di codice

Recuperare la raccolta di pagine

Nell'esempio di codice seguente viene illustrato come recuperare una raccolta di pagine nel report, con un output di esempio che mostra il nome della pagina e il nome visualizzato di ogni oggetto.

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

Ottenere un elenco di oggetti visivi

Questo esempio di codice mostra come ottenere un elenco di oggetti visivi per la prima pagina.

let pages = await report.getPages();

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

Ottenere la raccolta di pagine e gli oggetti visivi della prima pagina

In questo esempio vengono recuperati l'insieme di pagine e gli oggetti visivi (con diverse proprietà) per la pagina attiva.

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

Considerazioni e limitazioni

Il report deve essere caricato per usare le funzioni di getPages o di getVisuals.

Contenuto correlato