Conecte-se ao Power BI por meio do PowerAppsConnect to Power BI from PowerApps

Power BI

Power BI é um pacote de ferramentas de análise de negócios para analisar dados e compartilhar informações.Power BI is a suite of business analytics tools to analyze data and share insights. Monitore seus negócios e obtenha respostas rapidamente com painéis avançados disponíveis em todos os dispositivos.Monitor your business and get answers quickly with rich dashboards available on every device. Em seu aplicativo, você pode verificar o status dos alertas de dados que você configurou no serviço do Power BI.In your app, you can check the status of the data alerts that you have set up in the Power BI service. Para obter mais informações sobre alertas de dados no Power BI, vá para a página de documentação.For more information on data alerts in Power BI, head to the documentation page.

Este tópico mostra como usar a conexão do Power BI em um aplicativo e lista as funções disponíveis.This topic shows you how to use the Power BI connection in an app, and lists the available functions.

O que você precisa para começarWhat you need to get started

Usar a conexão do Power BI em seu aplicativoUse the Power BI connection in your app

Lista os alertas que você configurou no serviço do Power BIList the alerts that you've set up in the Power BI service

  1. No menu Inserir, selecione Galeria e adicione qualquer uma das galerias de texto.On the Insert menu, select Gallery, and add any of the Text galleries.
  2. Para mostrar os alertas do usuário atual, defina a propriedade Items da galeria para a fórmula a seguir:To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

A galeria atualizará a lista de alertas.The gallery will update with the list of alerts. Para cada alerta, você receberá o nome do alerta, o número da ID do alerta e a ID do espaço de trabalho do grupo no qual o alerta foi configurado.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. Você precisará da ID do alerta para obter mais informações sobre ele.You will need the alert ID to get further information about the alert.

Exibir o status de um alertaView the status of an alert

Para exibir o status do alerta, chame a função CheckAlertStatus com a ID do alerta obtida na etapa anterior.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

A ID do alerta pode ser passada como uma cadeia de caracteres literal (por exemplo, "1234") ou como uma referência a uma seção de galeria populada usando a chamada GetAlerts() (por exemplo, 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)

Para continuar, adicione um rótulo e, em seguida, defina sua propriedade Text com uma destas fórmulas: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

O rótulo será atualizado com o status atual do alerta.The label will update with the current status of the alert.

Exibir as funções disponíveisView the available functions

Essa conexão inclui as seguintes funções:This connection includes the following functions:

Nome da FunçãoFunction Name DescriçãoDescription
GetAlertsGetAlerts Lista os alertas que você configurou no serviço do Power BIList the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus Verificar o status de um alerta específicoCheck the status of a particular alert

GetAlertsGetAlerts

Lista os alertas que você configurou no serviço do Power BI.List the alerts that you have set up in the Power BI service.

Propriedades de entradaInput properties

Nenhuma.None.

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
valorvalue matrizarray NãoNo Uma matriz dos alertas de dados que você configurou no serviço do Power BI.An array of the data alerts that you have set up in the Power BI service. Cada elemento da matriz incluirá:Each element in the array will include:
  • alertTitle: o título do alertaalertTitle: the title of the alert
  • alertId: o título do alertaalertId: the ID of the alert
  • groupId: a ID do grupo no qual o alerta foi criadogroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

Verifique o status de um alerta.Check the status of an alert.

Observação: as solicitações para esse ponto de extremidade são limitadas de acordo com o número de alertas se chamadas com muita frequência.Note: requests to this endpoint will be throttled on a per-alert basis if called too frequently.

Propriedades de entradaInput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
alertIdalertId inteirointeger SimYes A ID do alerta, conforme retornada por GetAlertsThe ID of the alert, as returned by GetAlerts

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type ObrigatórioRequired DescriçãoDescription
tileValuetileValue númeronumber NãoNo O valor do bloco quando o alerta foi disparadoThe value of the tile when the alert was triggered
tileUrltileUrl cadeia de caracteresstring NãoNo URL para o bloco com o alertaURL for the tile that has the alert
alertTitlealertTitle cadeia de caracteresstring NãoNo Nome do alertaName of the alert
isAlertTriggeredisAlertTriggered boolianoboolean NãoNo Se o alerta está ou não disparado no momentoWhether the alert is currently triggered
alertThresholdalertThreshold númeronumber NãoNo O limite no qual o alarme é disparadoThe threshold at which the alarm is triggered

Veja todas as conexões disponíveis.See all the available connections.
Saiba como adicionar conexões a seus aplicativos.Learn how to add connections to your apps.