보고서 포함

팁

Power BI Embedded Analytics Playground의 API 탐색 섹션에서 보고서를 포함하거나 클라이언트 API를 실험해 보세요.

이 문서에서는 애플리케이션에 Power BI 보고서를 포함하는 단계를 설명합니다. Power BI의 보고서에서 보고서에 대해 자세히 알아봅니다.

보고서를 포함하는 방법

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

기존 보고서 포함

이미 있는 보고서를 포함하는 경우 IReportLoadConfiguration 형식의 구성 개체를 사용합니다.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

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

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

• datasetBinding - 포함된 보고서에서 사용하는 데이터 스키마를 정의하는 데이터 세트입니다. 데이터 세트에 대한 자세한 내용은 보고서에 동적으로 데이터 세트 바인딩을 참조하세요.

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

  • 보고서 - 그룹 내 보고서 가져오기
  • 보고서 - 그룹에서 보고서 가져오기

• id - 포함하는 Power BI 보고서의 ID입니다.

• permissions - 포함된 보고서에 대해 사용자에게 부여하는 작업입니다. 다음 값을 사용할 수 있습니다.

  • Read - 사용자가 보고서를 볼 수 있습니다.
  • ReadWrite - 사용자가 보고서를 보고 편집하고 저장할 수 있습니다.
  • Copy - 사용자가 다른 이름으로 저장을 사용하여 보고서의 복사본을 저장할 수 있습니다.
  • Create - 사용자가 새 보고서를 만들 수 있습니다.
  • All - 사용자는 보고서 복사본을 만들고, 보고, 편집하고, 저장하고, 저장할 수 있습니다.

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

  • 조직에 대해 포함하는 경우 사용합니다 models.TokenType.Aad (사용자가 데이터를 소유).
  • 고객에 대해 포함하는 경우 사용합니다 models.TokenType.Embed (앱이 데이터를 소유).

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

• type - 포함하는 콘텐츠의 종류입니다. Power BI 보고서에 사용합니다 'report' .

인터페이스에는 IReportLoadConfiguration 다른 속성도 포함됩니다. 이러한 속성에 대한 자세한 내용은 보고서 설정 구성 을 참조하세요.

• bookmark
• contrastMode
• filters
• pageName
• settings
• slicers
• theme
• viewMode

새 보고서 포함

데이터 세트에서 만든 새 보고서를 포함하는 경우 형식 IReportCreateConfiguration의 구성 개체를 사용합니다.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

이 인터페이스의 속성은 다음 예외를 제외하고 인터페이스의 IReportLoadConfiguration 속성과 유사합니다.

• datasetId - 새 보고서에서 사용하는 데이터 스키마를 정의하는 데이터 세트의 ID입니다.

• embedUrl - 새 보고서에서 사용하는 데이터 스키마를 정의하는 데이터 세트의 URL입니다. 이 URL은 포함된 보고서를 포함하는 HTML iframe 요소의 원본이 됩니다. 특히 API는 URL을 .의 특성에 srciframe할당합니다. 데이터 세트 API를 사용하여 이 URL을 가져올 수 있습니다. 다음과 같은 두 가지 예가 있습니다.

  • 데이터 세트 - 그룹 내 데이터 세트 가져오기
  • 데이터 세트 - 그룹 내 데이터 세트 가져오기

보고서 편집 및 만들기에 대한 자세한 내용은 포함된 보고서 만들기, 편집 및 저장을 참조하세요.

예제

다음 예제에서는 보고서를 포함하는 방법을 보여줍니다.

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

다음 단계

보고서 시각적 개체 포함

페이지를 매긴 보고서 포함

보고서 설정 구성

보고서 만들기, 편집 및 저장

성능 향상을 위해 부트스트랩 사용