다음을 통해 공유

대시보드 포함

  • 아티클

이 문서에서는 애플리케이션에 대시보드를 포함하는 단계를 설명합니다. Power BI 디자이너대시보드 소개에서 대시보드에 대해 자세히 알아보세요.

팁

Power BI Embedded Analytics PlaygroundAPI 섹션에서 대시보드를 포함하거나 클라이언트 API를 실험해 보세요.

대시보드를 포함하는 방법

앱에 Power BI 콘텐츠를 포함하는 경우 구성 개체를 사용하여 포함할 콘텐츠를 정의하고 콘텐츠의 설정을 지정합니다. 그런 다음 해당 개체를 API에 전달합니다.

대시보드를 포함할 때 IDashboardLoadConfiguration형식의 구성 개체를 사용합니다.

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

이 인터페이스에는 다음 속성이 포함됩니다.

  • accessToken - 포함하는 Power BI 데이터에 대한 액세스를 제공하는 토큰입니다. 액세스 토큰에 대한 자세한 내용은 다양한 포함 솔루션 이해를 참조하세요.

  • embedUrl - 포함하는 대시보드의 URL입니다. 이 URL은 포함된 대시보드를 포함하는 HTML iframe 요소의 원본이 됩니다. 특히 API는 url을 iframesrc 특성에 할당합니다. 대시보드 API 사용하여 이 URL을 가져올 수 있습니다. 두 가지 예는 다음과 같습니다.

  • id - 포함하는 대시보드의 ID입니다. 대시보드 API 사용하여 이 ID를 가져옵니다. 예를 들어:

  • pageView - API가 포함된 대시보드에 사용하는 형식입니다. 가능성은 다음과 같습니다.

    • fitToWidth - 포함된 대시보드의 너비가 대시보드를 포함하는 div 요소의 너비와 일치합니다.
    • oneColumn - 포함된 대시보드가 한 열에 나타납니다.
    • actualSize - API는 포함된 대시보드를 전체 크기로 표시합니다.

  • tokenType - 포함하는 Power BI 데이터에 대한 액세스를 제공하는 토큰의 종류입니다.

    • 사용하여 조직에 포함합니다(사용자가 데이터소유하는).
    • 사용하여 고객(앱이 데이터소유하는)을 포함합니다.

    자세한 내용은 다양한 포함 솔루션 이해를 참조하세요.

  • type - 포함하는 콘텐츠의 종류입니다. 대시보드에 'dashboard' 사용합니다.

본보기

다음 예제에서는 단일 대시보드를 포함하는 방법을 보여줍니다.

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aDashboardId,
    pageView: 'fitToWidth',
    tokenType: aTokenType,
    type: 'dashboard'
};
 
// Get a reference to the HTML element that contains the embedded dashboard.
let dashboardContainer = $('#dashboardContainer')[0];
 
// Embed the dashboard.
let dashboard = powerbi.embed(dashboardContainer, embedConfiguration);

고려 사항 및 제한 사항

  • EM SKU에 대시보드 포함은 지원되지 않습니다.

  • 콘텐츠를 포함하면 앱이 div 요소에 콘텐츠를 표시합니다. 대시보드를 포함할 때 actualSizepageView 값을 사용하는 경우:

    • 대시보드가 div 요소보다 넓은 경우 API는 div 요소의 너비를 포함된 대시보드의 너비로 사용합니다.
    • 대시보드가 div 요소보다 좁은 경우 API는 사용되지 않는 공간을 포함된 배경으로 채웁니다. 기본적으로 해당 배경은 흰색이지만 투명하도록 구성할 수 있습니다. 이 경우 div 요소의 스타일이 사용되지 않는 공간에 표시됩니다.

관련 콘텐츠