보고서 시각적 개체 포함
팁
Power BI Embedded Analytics Playground의 API 탐색 섹션에서 보고서 시각적 개체를 포함하거나 클라이언트 API를 실험해 보세요.
이 문서에서는 애플리케이션에 시각적 개체를 포함하는 단계를 설명합니다. Power BI의 시각적 개체에 대해 자세히 알아봅니다.
시각적 개체를 포함하는 방법
앱에 Power BI 콘텐츠를 포함하는 경우 구성 개체를 사용하여 포함할 콘텐츠를 정의하고 콘텐츠 설정을 지정합니다. 그런 다음 해당 개체를 API에 전달합니다.
시각적 개체를 포함할 때 형식 IVisualLoadConfiguration의 구성 개체를 사용합니다.
interface IVisualLoadConfiguration {
accessToken?: string;
embedUrl?: string;
id?: string;
pageName: string;
tokenType?: models.TokenType;
type: string;
visualName: string;
}
이 인터페이스에는 다음 속성이 포함됩니다.
accessToken- 포함하는 Power BI 데이터에 대한 액세스를 제공하는 토큰입니다. 액세스 토큰에 대한 자세한 내용은 다양한 포함 솔루션 이해를 참조하세요.embedUrl- 포함할 시각적 개체가 포함된 보고서의 URL입니다. 이 URL은 포함된 시각적 개체를 포함하는 HTMLiframe요소의 원본이 됩니다. 특히 API는 의 특성에 URL을srciframe할당합니다. 보고서 API를 사용하여 이 URL을 가져올 수 있습니다. 다음과 같은 두 가지 예가 있습니다.id- 포함하는 시각적 개체가 포함된 Power BI 보고서의 ID입니다.pageName- 포함할 시각적 개체가 포함된 페이지의 이름입니다. Report getPages 메서드를 사용하여 보고서의 페이지를 가져올 수 있습니다.tokenType- 포함하는 Power BI 데이터에 대한 액세스를 제공하는 토큰의 종류입니다.- organization(사용자가 데이터를 소유)에 포함하는 경우 를 사용합니다
models.TokenType.Aad. - 고객에 대해 포함하는 경우 를 사용합니다
models.TokenType.Embed(앱이 데이터를 소유).
자세한 내용은 다양한 포함 솔루션 이해를 참조하세요 .
- organization(사용자가 데이터를 소유)에 포함하는 경우 를 사용합니다
type- 포함할 콘텐츠의 종류입니다. 시각적 개체에 를 사용합니다'visual'.visualName- 포함할 시각적 개체의 이름입니다. Page getVisuals 메서드를 사용하여 페이지에서 시각적 개체를 가져올 수 있습니다.
예제
다음 예제에서는 단일 시각적 개체를 포함하는 방법을 보여줍니다.
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
embedUrl: anEmbedUrl,
id: aReportId,
pageName: aPageName,
tokenType: aTokenType,
type: 'visual',
visualName: aVisualName
};
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);
필터
기본적으로 updateFilters API는 단일 보고서 시각적 개체를 포함할 때 시각적 수준 필터를 적용합니다.
보고서 수준에서 적용되기 때문에 포함 구성 개체에 적용된 필터와 충돌이 발생할 수 있습니다.
이 문제를 해결하려면 API를 사용하여 필터 수준을 설정할 수 있습니다.
await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);
보고서 필터 제어에서 필터에 대해 자세히 알아봅니다.