페이지 및 시각적 개체 가져오기
보고서를 로드한 후 해당 인스턴스를 변경하는 데 직접 사용할 수 있는 페이지 또는 시각적 개체 목록을 만들 수 있습니다. 목록을 만들어 특정 페이지에서 사용되는 시각적 개체를 확인할 수도 있습니다.
페이지 목록을 가져오는 방법
Page 클래스에는 변경 보고서 페이지에 대한 속성과 메서드가 포함됩니다. 예를 들어 defaultSize 속성을 사용하여 보고서에 저장된 페이지 크기를 정의하거나 getFilters() 메서드를 사용하여 보고서의 모든 페이지 수준 필터를 가져올 수 있습니다. 자세한 내용은 Page 클래스참조하세요.
getPages 사용하여 보고서의 페이지 목록을 검색합니다. 반환되는 페이지의 순서는 보고서와 동일한 순서입니다.
let pages = await report.getPages();
시각적 개체 목록을 가져오는 방법
VisualDescriptor 클래스에는 특정 페이지에서 시각적 개체를 변경하는 속성과 메서드가 포함되어 있습니다. 예를 들어 layout 속성을 사용하여 시각적 개체의 위치, 크기 및 표시 유형을 정의할 수 있습니다. 자세한 내용은 VisualDescriptor 클래스를 참조하세요.
page 인스턴스에서 getVisuals 비동기 메서드를 사용합니다.
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
};
}));
고려 사항 및 제한 사항
getPages 또는 getVisuals 함수를 사용하려면 보고서를 로드해야 합니다.