Udostępnij za pośrednictwem


Pobieranie stron i wizualizacji

Po załadowaniu raportu można wprowadzić listę stron lub wizualizacji, które mogą być bezpośrednio używane do wprowadzania zmian w tych wystąpieniach. Możesz również utworzyć listę, aby zobaczyć, jakie wizualizacje są używane na określonej stronie.

Jak uzyskać listę stron

Klasa Page zawiera właściwości i metody zmiany strony raportu. Na przykład można użyć właściwości defaultSize do zdefiniowania rozmiaru strony zgodnie z zapisem w raporcie lub metody getFilters() w celu pobrania wszystkich filtrów na poziomie strony w raporcie. Aby uzyskać więcej informacji, zobacz Page class.

Użyj getPages, aby pobrać listę stron w raporcie. Zwracana kolejność stron jest taka sama jak w raporcie.

let pages = await report.getPages();

Jak uzyskać listę wizualizacji

Klasa VisualDescriptor zawiera właściwości i metody zmiany wizualizacji na określonej stronie. Na przykład możesz użyć właściwości layout, aby zdefiniować położenie, rozmiar i widoczność wizualizacji. Aby uzyskać więcej informacji, zobacz VisualDescriptor class ( Klasa VisualDescriptor).

Użyj metody asynchronicznej getVisuals w wystąpieniu page.

let pages = await page.getVisuals();

Przykłady kodu

Pobieranie kolekcji stron

Poniższy przykład kodu przedstawia sposób pobierania kolekcji stron w raporcie z przykładowymi danymi wyjściowymi pokazującymi nazwę strony i nazwę wyświetlaną każdego obiektu.

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

Pobieranie listy wizualizacji

W tym przykładzie kodu pokazano, jak uzyskać listę wizualizacji dla pierwszej strony.

let pages = await report.getPages();

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

Pobieranie kolekcji stron i wizualizacji pierwszej strony

Ten przykład pobiera kolekcję stron i wizualizacje (z kilkoma właściwościami) dla aktywnej strony.

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

Zagadnienia i ograniczenia

Aby można było używać funkcji getPages lub getVisuals, należy załadować raport.