다음을 통해 공유


Power Apps의 Power BI 타일 컨트롤

앱 내에서 Power BI 타일을 보여 주는 컨트롤입니다.

Power BI가 없나요? 등록합니다.

Description

앱 내에 Power BI 타일 을 표시하여 기존 데이터 분석 및 보고를 활용합니다. 옵션 패널의 데이터 탭에서 작업 영역, 대시보드 및 타일 속성을 설정하여 표시할 타일을 지정합니다.

비고

  • GCC High 및 DoD 환경에서는 Power BI 타일 컨트롤을 사용할 수 없습니다.
  • Power BI 타일 컨트롤은 중국에서 사용할 수 없습니다.
  • Power BI 타일을 포함할 때 라이선스 요구 사항은 라이선싱을 참조하세요.

공유 및 보안

Power BI 콘텐츠가 포함된 앱을 공유하는 경우 앱 자체뿐만 아니라 타일이 제공되는 대시보드 도 공유해야 합니다. 그렇지 않으면 앱을 여는 사용자에 대해서도 Power BI 콘텐츠가 표시되지 않습니다. Power BI 콘텐츠가 포함된 앱은 해당 콘텐츠에 대한 사용 권한을 준수합니다.

Performance

앱 내에서 동시에 3개 이상의 Power BI 타일을 로드하지 않는 것이 좋습니다. LoadPowerBIContent 속성을 설정하여 타일 로드 및 언로드를 제어할 수 있습니다.

포함 옵션

포함은 Power BI API 버전 간에 다릅니다. 새 Power BI API 인증 체계로 인해 모바일 또는 다른 포함된 시나리오(Teams 또는 SharePoint) 내에서 타일에 액세스할 수 없을 수 있습니다.

AllowNewAPI 속성을 사용하여 API 버전의 사용을 제어할 수 있습니다. 자세한 내용은 키 속성을 참조하세요.

AllowNewAPI 속성 값 행동
진실 Power BI에서 Embed URL 을 가져와 서 TileUrl 값으로 만들어 대시보드, 보고서 또는 타일을 포함할 수 있습니다.
거짓 URL을 포함하고 TileUrl 값으로 만들거나 제공 그래픽 인터페이스를 사용하여 대시보드 타일을 포함할 수 있습니다.

비고

Power BI URL(예: IFrame)을 포함하는 것은 Power BI URL 요청 인증이 모바일 플레이어에 의해 처리되지 않으므로 Power Apps 모바일에서 지원되지 않습니다.

Filtering

필터링은 Power BI API 버전 간에 다릅니다. 컨트롤을 구성하는 방법에 따라 아래의 적절한 섹션을 참조하세요.

새 API를 사용하여 Power BI 서비스를 호출하는 경우

AllowNewAPI 속성이 "True"로 설정된 경우 새 API를 사용하여 Power BI 서비스를 호출합니다. 자세한 내용은 URL에서 쿼리 문자열 매개 변수를 사용하여 보고서 필터링을 참조하세요.

원래 API를 사용하여 Power BI 서비스를 호출하는 경우

AllowNewAPI 속성이 "False"로 설정된 경우 원래 API를 사용하여 Power BI 서비스를 호출합니다. 이 경우 앱에서 단일 매개 변수를 전달하여 Power BI 타일에 표시되는 결과를 필터링할 수 있습니다. 그러나 문자열 값과 equals 연산자만 지원되며 테이블 이름 또는 열 이름에 공백이 포함된 경우 필터가 작동하지 않을 수 있습니다.

단일 필터 값을 전달하려면 다음 구문을 따르는 TileURL 속성 값을 수정합니다.

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

이 값에 다음 구문을 추가합니다.

&$filter=<TableName>/<ColumnName> eq '<Value>'

예를 들어 목록 상자의 값을 사용합니다.

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

매개 변수는 타일이 시작되는 보고서의 데이터 세트에서 값을 필터링합니다. 그러나 필터링 기능에는 다음과 같은 제한 사항이 있습니다.

  • 필터를 하나만 적용할 수 있습니다.
  • 연산자 eq 만 지원됩니다.
  • 필드 형식은 문자열이어야 합니다.
  • 필터링은 고정된 시각화 타일에서만 사용할 수 있습니다. 고정된 보고서에는 지원되지 않습니다.
  • R 및 Python 스크립트 시각적 개체는 필터링할 수 없습니다.

Power BI 보고서에서 계산 필드를 사용하여 다른 값 형식을 문자열로 변환하거나 여러 필드를 하나로 결합할 수 있습니다.

키 속성

AllowNewAPI - Power BI 서비스를 호출할 때 새 API를 사용할지 여부입니다. 값을 True 로 설정하면 새 Power BI API를 사용할 수 있습니다(모바일 및 일부 포함된 시나리오에서는 지원되지 않지만 고급 필터링을 허용). False 는 원래 API를 사용합니다. 기본값은 false입니다.

대시보드 – 타일의 원본인 Power BI 대시보드입니다.

LoadPowerBIContentTrue로 설정하면 Power BI 콘텐츠가 로드되고 표시됩니다. False로 설정하면 Power BI 콘텐츠가 언로드되어 메모리가 해제되고 성능이 최적화됩니다.

PowerBIInteractions - True로 설정하면 Power BI 콘텐츠와 상호 작용할 수 있지만 Power Apps OnSelect 이벤트는 트리거되지 않습니다. False로 설정하면 타일과 상호 작용할 수 없지만 타일을 선택하면 Power Apps OnSelect 이벤트가 트리거됩니다.

타일 – 표시할 Power BI 타일의 이름입니다.

작업 영역 – 타일의 원본인 Power BI 작업 영역입니다.

추가 속성

BorderColor – 컨트롤 테두리의 색입니다.

BorderStyle – 컨트롤의 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.

BorderThickness – 컨트롤 테두리의 두께입니다.

DisplayMode – 컨트롤에서 사용자 입력(편집)을 허용하는지 여부, 데이터만 표시(보기) 또는 사용 안 함(사용 안 함)입니다.

높이 – 컨트롤의 위쪽 가장자리와 아래쪽 가장자리 사이의 거리입니다.

OnSelect – 사용자가 컨트롤을 선택할 때 수행할 작업입니다. 기본적으로 타일과 연결된 Power BI 보고서가 열립니다.

TileUrl – Power BI 서비스에서 타일을 요청하는 URL입니다. URL에 쿼리 문자열 필터링을 추가하려면 위의 필터링 섹션을 참조하세요.

표시 – 컨트롤이 표시되는지 숨겨지는지 여부입니다.

너비 – 컨트롤의 왼쪽 가장자리와 오른쪽 가장자리 사이의 거리입니다.

X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너의 왼쪽 가장자리 사이의 거리입니다(부모 컨테이너가 없는 경우 화면).

Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너의 위쪽 가장자리 사이의 거리입니다(부모 컨테이너가 없는 경우 화면).

Example

  1. 삽입 탭에서 차트 메뉴를 연 다음 Power BI 타일 컨트롤을 추가합니다.

    컨트롤을 추가하고 구성하는 방법을 모르시나요?

  2. 옵션 패널의 데이터 탭에서 작업 영역 설정에 대한 내 작업 영역을 선택합니다.

  3. 대시보드 목록에서 대시보드를 선택한 다음 타일 목록에서 타일을 선택합니다.

    이 컨트롤은 Power BI 타일을 렌더링합니다.

내게 필요한 옵션 지침

Power BI 타일은 Power BI 콘텐츠에 대한 컨테이너일 뿐입니다. 이러한 Power BI 접근성 팁을 사용하여 접근성 있는 콘텐츠를 만드는 방법을 알아봅니다.

Power BI 콘텐츠에 제목이 없는 경우 레이블 컨트롤을 사용하여 제목을 추가하여 화면 읽기 프로그램을 지원하는 것이 좋습니다. Power BI 타일 바로 앞에 레이블을 배치할 수 있습니다.