Compartilhar via


Conectar-se ao Power BI a partir do Power Apps

Power BI.

O Power BI é um conjunto de ferramentas de análise de negócios com base na nuvem para analisar dados e compartilhar insights. Monitore seus negócios e obtenha respostas rapidamente com painéis avançados disponíveis em todos os dispositivos. Em seu aplicativo, você pode verificar o status dos alertas de dados que configurou no serviço do Power BI. Para obter mais informações sobre alertas de dados no Power BI, vá para a página de documentação.

Este tópico mostra como usar a conexão do Power BI em um aplicativo e lista as funções disponíveis.

Observação

A conexão do Power BI não é delegável.

Pré-requisitos

Usar a conexão do Power BI em seu aplicativo

Lista os alertas que você configurou no serviço do Power BI

  1. No menu Inserir, selecione Galeria e adicione qualquer uma das Galerias de texto.

  2. Para mostrar os alertas do usuário atual, defina a propriedade Items da galeria como a fórmula a seguir:

    PowerBI.GetAlerts()

A galeria atualizará a lista de alertas. 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. Você precisará da ID do alerta para obter mais informações sobre ele.

Exibir o status de um alerta

Para exibir o status do alerta, chame a função CheckAlertStatus com a ID do alerta obtida na etapa anterior.

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 da galeria preenchida usando a chamada GetAlerts() (por exemplo, Gallery1.Selected.alertId)

Para continuar, adicione um rótulo e, em seguida, defina sua propriedade Text como uma destas fórmulas:

  • 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.

Exibir as funções disponíveis

Essa conexão inclui as seguintes funções:

Nome da Função Descrição
GetAlerts Lista os alertas que você configurou no serviço do Power BI
CheckAlertStatus Verifica o status de um alerta específico

GetAlerts

Lista os alertas que você configurou no serviço do Power BI.

Propriedades de entrada

Nenhum.

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatória Descrição
valor matriz Não Uma matriz dos alertas de dados que você configurou no serviço do Power BI. Cada elemento da matriz incluirá:
  • alertTitle: o título do alerta;
  • alertId: a ID do alerta;
  • groupId: a ID do grupo no qual o alerta foi criado.

CheckAlertStatus

Verifique o status de um alerta.

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.

Propriedades de entrada

Nome da Propriedade Tipo de Dados Obrigatória Descrição
alertId inteiro Sim A ID do alerta, conforme retornada por GetAlerts

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatória Descrição
tileValue número Não O valor do bloco quando o alerta foi disparado
tileUrl cadeia de caracteres Não URL para o bloco com o alerta
alertTitle cadeia de caracteres Não Nome do alerta
isAlertTriggered booliano Não Se o alerta está ou não disparado no momento
alertThreshold número Não O limite no qual o alarme é disparado

Veja todas as conexões disponíveis.
Saiba como adicionar conexões a seus aplicativos.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).