Ligar ao Power BI a partir do PowerAppsConnect to Power BI from PowerApps

Power BI

O Power BI é um conjunto de ferramentas de análise de negócio para analisar os dados e partilhar informações.Power BI is a suite of business analytics tools to analyze data and share insights. Monitorize a sua empresa e obtenha respostas rapidamente com dashboards avançados disponíveis em todos os dispositivos.Monitor your business and get answers quickly with rich dashboards available on every device. Na sua aplicação, pode verificar o estado dos alertas de dados que configurou no serviço 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 mais informações sobre alertas de dados no Power BI, siga 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-lhe como utilizar a ligação do Power BI numa aplicação e apresenta 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 precisa para começarWhat you need to get started

Utilize a ligação do Power BI na sua aplicaçãoUse the Power BI connection in your app

Liste os alertas que configurou no serviço 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 utilizador atual, defina a propriedade Itens da galeria com a seguinte fórmula:To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

A galeria será atualizada com a lista de alertas.The gallery will update with the list of alerts. Para cada alerta, irá receber o nome do alerta, o número de ID do alerta e o ID da área de trabalho do grupo na 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. Irá precisar do ID do alerta para obter mais informações sobre o alerta.You will need the alert ID to get further information about the alert.

Ver o estado de um alertaView the status of an alert

Para ver o estado do alerta, chame a função CheckAlertStatus com o ID do alerta obtido a partir do passo acima.To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

O ID do alerta pode ser passado como uma cadeia literal (por exemplo: "1234") ou como uma referência a uma secção de galeria povoada com 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 uma etiqueta e, em seguida, defina a propriedade Text como uma das seguintes 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

A etiqueta será atualizada com o estado atual do alerta.The label will update with the current status of the alert.

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

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

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

GetAlertsGetAlerts

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

Propriedades de entradaInput properties

Nenhum.None.

Propriedades de saídaOutput properties

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

CheckAlertStatusCheckAlertStatus

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

Nota: os pedidos para este ponto final serão limitados numa base por alerta se forem chamados 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 NecessárioRequired DescriçãoDescription
alertIdalertId número inteirointeger SimYes O ID do alerta, conforme devolvido por GetAlertsThe ID of the alert, as returned by GetAlerts

Propriedades de saídaOutput properties

Nome da PropriedadeProperty Name Tipo de DadosData Type NecessárioRequired DescriçãoDescription
tileValuetileValue númeronumber NãoNo O valor do mosaico quando o alerta foi acionadoThe value of the tile when the alert was triggered
tileUrltileUrl cadeiastring NãoNo URL para o mosaico que tem o alertaURL for the tile that has the alert
alertTitlealertTitle cadeiastring NãoNo Nome do alertaName of the alert
isAlertTriggeredisAlertTriggered booleanoboolean NãoNo Se o alerta é acionado atualmenteWhether the alert is currently triggered
alertThresholdalertThreshold númeronumber NãoNo O limiar em que é acionado o alarmeThe threshold at which the alarm is triggered

Veja todas as ligações disponíveis.See all the available connections.
Saiba como adicionar ligações às suas aplicações.Learn how to add connections to your apps.