PowerApps에서 Power BI에 연결Connect to Power BI from PowerApps

Power BI

Power BI는 데이터를 분석하고 정보 활용을 공유하는 비즈니스 분석 도구 제품군입니다.Power BI is a suite of business analytics tools to analyze data and share insights. 비즈니스를 모니터링하고 모든 장치에서 사용할 수 있는 다양한 대시보드에 대해 신속하게 답변 받을 수 있습니다.Monitor your business and get answers quickly with rich dashboards available on every device. 앱에서 Power BI 서비스에서 설정한 데이터 경고의 상태를 확인할 수 있습니다.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Power BI의 데이터 경고에 대한 자세한 내용은 설명서 페이지를 참조하세요.For more information on data alerts in Power BI, head to the documentation page.

이 토픽에서는 앱에서 Power BI 연결을 사용하는 방법과 사용할 수 있는 함수를 나열합니다.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

필수 조건Prerequisites

앱의 Power BI 연결을 사용합니다.Use the Power BI connection in your app

Power BI 서비스에서 설정한 경고를 나열합니다.List the alerts that you've set up in the Power BI service

  1. 삽입 메뉴에서 갤러리를 선택하고 텍스트 갤러리 하나를 추가합니다.On the Insert menu, select Gallery, and add any of the Text galleries.

  2. 현재 사용자의 경고를 표시하려면 갤러리의 항목 속성을 다음 수식에 설정합니다.To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

갤러리가 경고 목록으로 업데이트됩니다.The gallery will update with the list of alerts. 사용자는 각 경고에 대한 경고 이름, 경고 ID 번호, 경고가 구성 된 그룹 작업 영역 ID를 받습니다.For each alert, you will receive the alert name, the ID number of the alert, and the ID of the group workspace in which the alert was configured. 경고 ID는 경고에 대해 자세한 정보를 얻고자 할 때 필요합니다.You will need the alert ID to get further information about the alert.

경고 상태 보기View the status of an alert

경고 상태를 보려면 위의 단계에서 받은 경고 ID로 CheckAlertStatus 함수를 호출합니다.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

경고 ID는 GetAlerts() 호출(예: Gallery1.Selected.alertId)을 사용하여 채워진 갤러리 섹션에 리터럴 문자열(예: "1234") 또는 참조로 전달됩니다.The alert ID can be passed in either as a literal string (e.g. "1234") or as a reference to a gallery section populated using the GetAlerts() call (e.g. Gallery1.Selected.alertId)

계속 진행하려면 레이블을 추가하고 해당 텍스트 속성을 이러한 수식 중 하나로 설정합니다.To proceed, add a label, and then set its Text property to one of these formulas:

  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertTitle
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).currentTileValue
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertThreshold
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).isAlertTriggered

레이블은 경고의 현재 상태로 업데이트됩니다.The label will update with the current status of the alert.

사용할 수 있는 함수 보기View the available functions

이 연결에는 다음 함수가 포함됩니다.This connection includes the following functions:

함수 이름Function Name 설명Description
GetAlertsGetAlerts Power BI 서비스에서 설정한 경고를 나열합니다.List the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus 특정 경고의 상태를 확인합니다.Check the status of a particular alert

GetAlertsGetAlerts

Power BI 서비스에서 설정한 경고를 나열합니다.List the alerts that you have set up in the Power BI service.

입력 속성Input properties

없음None.

출력 속성Output properties

속성 이름Property Name 데이터 형식Data Type 필수Required 설명Description
value 배열array 아니요No Power BI 서비스에서 설정한 데이터 경고의 배열입니다.An array of the data alerts that you have set up in the Power BI service. 배열의 각 요소에는 다음이 포함됩니다.Each element in the array will include:
  • alertTitle: 경고의 제목alertTitle: the title of the alert
  • alertId: 경고의 IDalertId: the ID of the alert
  • groupId: 경고가 만들어진 그룹의 IDgroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

경고 상태를 봅니다.Check the status of an alert.

참고

너무 자주 호출하는 경우 경고 당 기준에 따라 이 엔드포인트에 대한 요청이 정체됩니다.Requests to this endpoint will be throttled on a per-alert basis if called too frequently.

입력 속성Input properties

속성 이름Property Name 데이터 형식Data Type 필수Required 설명Description
alertIdalertId 정수integer Yes GetAlerts가 반환한 경고 IDThe ID of the alert, as returned by GetAlerts

출력 속성Output properties

속성 이름Property Name 데이터 형식Data Type 필수Required 설명Description
tileValuetileValue 숫자number 아니요No 경고가 트리거되는 경우 타일 값The value of the tile when the alert was triggered
tileUrltileUrl 문자열string 아니요No 경고가 있는 타일에 대한 URLURL for the tile that has the alert
alertTitlealertTitle 문자열string 아니요No 경고의 이름Name of the alert
isAlertTriggeredisAlertTriggered 부울boolean 아니요No 경고가 현재 트리거되는지 여부Whether the alert is currently triggered
alertThresholdalertThreshold 숫자number 아니요No 경보가 트리거되는 임계값The threshold at which the alarm is triggered

사용 가능한 연결을 모두 보세요.See all the available connections.
앱에 연결을 추가하는 방법을 알아보세요.Learn how to add connections to your apps.