페이지 및 시각적 개체 가져오기

아티클
09/17/2023

보고서를 로드한 후 해당 인스턴스를 변경하는 데 직접 사용할 수 있는 페이지 또는 시각적 개체 목록을 만들 수 있습니다. 목록을 만들어 특정 페이지에서 사용되는 시각적 개체를 확인할 수도 있습니다.

페이지 목록을 가져오는 방법

Page 클래스에는 변경 보고서 페이지에 대한 속성과 메서드가 포함됩니다. 예를 들어 사용할 수 있습니다는 defaultSize 속성 보고서에 저장 된 페이지 크기를 정의 하거나 getFilters() 보고서의 모든 페이지 수준 필터를 가져올 메서드입니다. 자세한 내용은 Page 클래스를 참조하세요.

를 사용하여 getPages 보고서의 페이지 목록을 검색합니다. 반환되는 페이지의 순서는 보고서와 동일한 순서입니다.

let pages = await report.getPages();

시각적 개체 목록을 가져오는 방법

VisualDescriptor 클래스에는 특정 페이지에서 시각적 개체를 변경하는 속성과 메서드가 포함되어 있습니다. 예를 들어 속성을 사용하여 layout 시각적 개체의 위치, 크기 및 표시 유형을 정의할 수 있습니다. 자세한 내용은 VisualDescriptor 클래스를 참조하세요.

인스턴스에서 getVisuals 비동기 메서드를 page 사용합니다.

let pages = await page.getVisuals();

코드 예제

페이지 컬렉션 검색

다음 코드 예제에서는 각 개체의 페이지 이름 및 표시 이름을 보여 주는 예제 출력과 함께 보고서에서 페이지 컬렉션을 검색하는 방법을 보여 있습니다.

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

시각적 개체 목록 가져오기

이 코드 예제에서는 첫 번째 페이지에 대한 시각적 개체 목록을 가져오는 방법을 보여 줍니다.

let pages = await report.getPages();

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

페이지 컬렉션 및 첫 번째 페이지의 시각적 개체 가져오기

다음은 현재 페이지에 대한 페이지 컬렉션과 시각적 개체(여러 속성 포함)를 검색하는 예제입니다.

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

제한 사항

또는 getVisuals 함수를 사용 getPages 하려면 보고서를 로드해야 합니다.

다음 단계

페이지 탐색

보고서 설정 구성

Share via