Подключение к Power BI из PowerAppsConnect 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.

Что нужно для начала работыWhat you need to get started

Использование подключения Power BI в приложенииUse the Power BI connection in your app

Перечисление оповещений, настроенных в службе Power BIList 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. Чтобы отобразить оповещения текущего пользователя, задайте для свойства Items коллекции следующую формулу: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. Для каждого оповещения вы получите имя и код оповещения, а также идентификатор рабочей области группы, в которой настроено оповещение.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. Для получения дополнительных сведений об оповещении потребуется его идентификатор.You will need the alert ID to get further information about the alert.

Просмотр состояния оповещенияView the status of an alert

Чтобы просмотреть состояние оповещения, вызовите функцию CheckAlertStatus с помощью идентификатора оповещения, полученного на предыдущем шаге.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

Идентификатор оповещения можно передать в виде строкового литерала (например, "1234") или ссылки на раздел коллекции, заполненной с помощью вызова GetAlerts() (например, Gallery1.Selected.alertId).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)

Чтобы продолжить, добавьте метку и задайте для ее свойства Text одну из этих формул: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 BIList 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
valuevalue массив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 — идентификатор оповещения;alertId: the ID of the alert
  • groupId — идентификатор группы, в которой создано оповещение.groupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Проверка состояния оповещения.Check the status of an alert.

Примечание. Запросы к этой конечной точке будут регулироваться в зависимости от каждого оповещения, если вызывать их слишком часто.Note: 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 Идентификатор оповещения, возвращенный GetAlertsThe 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 URL-адрес плитки с оповещениемURL 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.