페이지를 매긴 보고서 포함

아티클
09/22/2023

팁

페이지를 매긴 보고서를 포함하거나 Power BI Embedded 분석 플레이그라운드의 API 탐색 섹션에서 클라이언트 API를 실험해 보세요.

이 문서에서는 애플리케이션에 페이지를 매긴 보고서를 포함하는 단계를 설명합니다. 페이지를 매긴 보고서에 대한 자세한 내용은 Power BI Premium 페이지를 매긴 보고서란?에서 알아봅니다.

페이지를 매긴 보고서를 포함하는 방법

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

페이지를 매긴 보고서를 포함할 때 형식 IPaginatedReportLoadConfiguration의 구성 개체를 사용합니다.

export interface IPaginatedReportLoadConfiguration {
    accessToken: string;
    id: string;
    embedUrl?: string;
    settings?: IPaginatedReportSettings;
    tokenType?: TokenType;
    type?: string;
    parameterValues?: IPaginatedReportParameter[];
}

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

accessToken - 포함하는 Power BI 데이터에 대한 액세스 권한을 제공하는 토큰입니다. 액세스 토큰에 대한 자세한 내용은 다양한 포함 솔루션 이해를 참조하세요.
embedUrl - 포함하는 보고서의 URL입니다. 이 URL은 포함된 보고서를 포함하는 HTML iframe 요소의 원본이 됩니다. 특히 API는 iframe의 특성에 src URL을 할당합니다. 보고서 API를 사용하여 이 URL을 가져올 수 있습니다. 다음과 같은 두 가지 예가 있습니다.
- 보고서 - 그룹 내 보고서 가져오기
- 보고서 - 그룹에서 보고서 가져오기
아래에 설명된 속성을 사용하여 보고서 매개 변수를 parameterValues 보고서에 전달하는 것이 좋습니다. 그러나 포함 URL의 끝에 쿼리 문자열을 추가하여 매개 변수를 보고서에 전달할 수도 있습니다. 페이지를 매긴 보고서에서 URL 매개 변수를 전달하는 방법에 대해 자세히 알아보세요. URL에 매개 변수를 전달하는 예제를 참조하세요.
id - 포함하는 Power BI 보고서의 ID입니다.
hostname - 기본값 hostname 은 app.powerbi.com. 소버린 클라우드를 사용하는 경우 여기에 URL을 제공합니다. 에 대한 embedURL값을 제공한 경우 는 hostname 무시됩니다.
settings - IPaginatedReportSettings 형식의 구성 개체입니다. 이 개체는 보고서의 매개 변수 패널 모양에 대한 정보를 지정합니다. 매개 변수 패널은 확장하거나 숨길 수 있는 작업 표시줄 아래의 막대입니다.
- 작업 표시줄에서 매개 변수 단추를 클릭하여 매개 변수 패널을 표시하거나 숨길 수 있습니다. 이 단추는 기본적으로 사용할 수 있습니다. 그러나 패널의 enabled 속성을 false로 구성하면 매개 변수 단추를 사용할 수 없습니다.
- 기본적으로 API는 매개 변수 패널을 축소합니다. 패널의 expanded 속성을 true로 설정하면 API는 이 패널이 확장된 보고서를 로드합니다.
- 이 코드는 속성을 구성하는 한 가지 방법을 보여줍니다.settings
```
settings: {
    commands: {
        parameterPanel: {
            enabled: true,
            expanded: true
        }
    }
}
```
tokenType - 포함하는 Power BI 데이터에 대한 액세스를 제공하는 토큰의 종류입니다.
- organization(사용자 소유 데이터)에 포함하는 경우 를 사용합니다models.TokenType.Aad.
- 고객(앱 소유 데이터)을 포함하는 경우 를 사용합니다 models.TokenType.Embed .
자세한 내용은 다양한 포함 솔루션 이해를 참조하세요 .
parameterValues – 형식 IPaginatedReportParameter의 구성 개체입니다. 이 속성을 사용하여 보고서 매개 변수를 설정합니다. 이 메서드는 JavaScript SDK를 사용하며 보고서 매개 변수를 전달하는 기본 방법입니다. 예를 들면 다음과 같습니다.
```
parameterValues: [
      {name: "State", value: "WA"},
      {name: "City", value: "Seattle"},
      {name: "City", value: "Bellevue"},
      {name: "City", value: "Redmond"}
]
```
이 메서드는 rdl 매개 변수(URL 접rdl:두사 포함)가 아닌 보고서 매개 변수(URL 접두rp:사를 가진 매개 변수)를 전달하는 데만 사용할 수 있습니다.

예제

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

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    uniqueId: aReportId,
    tokenType: aTokenType,
    type: 'report',
    datasetBindings: [{
      sourceDatasetId: "originalDatasetId",
      targetDatasetId: "notOriginalDatasetId"
    }]
};
 
// 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);

다중 리소스 포함 토큰에 바인딩에 사용되는 모든 DatasetId를 포함해야 합니다.

고려 사항 및 제한 사항

동적 바인딩을 사용하려면 페이지를 매긴 보고서에 데이터 세트 동적 바인딩을 참조하세요.
페이지를 매긴 보고서에는 부트스트랩된 메서드가 지원되지 않습니다.
페이지를 매긴 보고서를 포함할 때 다중 값 매개 변수는 지원되지 않습니다.
속성은 parameterValues 보고서 매개 변수에만 사용할 수 있습니다. rdl 매개 변수에는 사용할 수 없습니다.
페이지를 매긴 보고서를 실시간 데이터 세트(푸시 데이터 세트)로 포함하는 것은 지원되지 않습니다.

페이지를 매긴 보고서 포함

페이지를 매긴 보고서를 포함하는 방법

예제

고려 사항 및 제한 사항

다음 단계

추가 리소스