팁
사용자 고유의 보고서 또는 샘플 보고서를 사용하여 실시간으로 API를 실험하려면 Power BI 임베디드 분석 실습
Power BI 클라이언트 API는 JavaScript 또는 TypeScript를 사용하여 포함된 Power BI 콘텐츠를 프로그래밍 방식으로 제어할 수 있는 클라이언트 쪽 라이브러리입니다.
클라이언트 API를 사용하여 Power BI 항목(예: 보고서 및 대시보드)과 애플리케이션 코드 간에 통신합니다. 이렇게 하면 디자인에 따라 최종 사용자 환경을 유연하게 빌드할 수 있습니다.
클라이언트 라이브러리는 어떻게 작동하나요?
클라이언트 API는 보고서 또는 대시보드와 같은 포함된 Power BI 항목과 통신합니다. iframe은 호스팅 앱과 Power BI 항목 간에 분리를 만들어 데이터가 보호되도록 합니다.
Power BI와 관련된 Power BI JavaScript API를 보여 주는 
클라이언트 애플리케이션 - 전체 스크린샷은 클라이언트 애플리케이션의 예입니다.
포함된 보고서 - 현재 애플리케이션에 표시된 포함된 보고서입니다.
iFrame 경계 - 포함된 보고서는 iFrame 내에서 호스트됩니다. 다이어그램은 경계를 간략하게 설명합니다.
클라이언트 API - 클라이언트 API를 사용하여 웹 애플리케이션과 포함된 구성 요소 간에 통신합니다. 예를 들어
report.setPage(…)호출할 때 보고서의 활성 페이지가 변경됩니다. 페이지가 변경된 후 pageChanged 이벤트가 보고서에서 내보내지고 이벤트 처리기에 코드를 추가할 수 있습니다. 자세한 내용은 페이지 탐색참조하세요.
이 설명서 집합에는 무엇이 포함됩니까?
이 설명서 집합에는 다음 구성 요소에 대한 API가 나열됩니다.
powerbi-client
- powerbi-report-authoring 제외한 모든 Power BI 클라이언트 API를 포함하는 기본 Power BI 클라이언트 라이브러리입니다. 이 라이브러리는 포함할 수 있는 다양한 Power BI 항목에 대한 클래스를 정의합니다. powerbi-client 라이브러리를 사용하면 포함할 콘텐츠를 제어할 수 있습니다.powerbi-models - Power BI 클라이언트 API에 대한 개체 모델을 포함합니다. 각 모델에는 TypeScript 인터페이스, JSON 스키마 정의 및 지정된 개체가 유효한 모델인지 확인하는 유효성 검사 함수가 있습니다.
powerbi-report-authoring
- 클라이언트 라이브러리의 확장입니다. 이러한 API는 시각적 개체를 만들고 보고서를 로드한 후 작성하는 데 도움이 됩니다. powerbi-report-authoring 라이브러리를 사용하면 포함된 보고서를 프로그래밍 방식으로 편집할 수 있습니다.
설명서 집합에는 코드 예제와 함께 API를 사용하는 방법을 설명하는 문서도 포함되어 있습니다. 문서는 다음 섹션으로 나뉩니다.
개요 - Power BI 임베디드 분석에 대한 추가 정보입니다.
플레이그라운드는 소개합니다. Power BI 임베디드 분석 플레이그라운드를 사용하여 앱에서 임베디드 분석을 빠르게 사용하는 방법을 알아봅니다.
포함 시작 - 보고서 및 대시보드와 같은 각 Power BI 항목을 포함하는 방법을 알아봅니다.
기본 개념 - 모든 개발자가 잘 알고 있어야 하는 몇 가지 개념에 대해 알아봅니다.
보고서 포함 - 보고서에만 적용되는 추가 포함 개념입니다.
보고서 작업 - 포함된 보고서를 조정하여 고객에게 더 나은 사용자 환경을 제공합니다.
조직 대한 보고서 포함 - 조직 솔루션에포함할 때 더 나은 포함된 보고서를 만듭니다. 보고서 작성 - 보고서를 로드한 후 시각화를 만들고 개인 설정할 수 있도록 하는 powerbi-report-authoring API 전용 문서입니다.
리소스 항목에는 Power BI 개발자에게 유용한 리소스가 포함되어 있습니다.
메모
Power BI 임베디드 분석 플레이그라운드실험하는 동안 이러한 문서를 검토하는 것이 좋습니다.