Power BI

Power BI é um pacote de ferramentas de análise de negócios para analisar dados e compartilhar informações. 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 você 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.

O que você precisa para começar

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

Para continuar, adicione um rótulo e, em seguida, defina sua propriedade Text com 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 Verificar o status de um alerta específico

GetAlerts

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

Propriedades de entrada

Nenhuma.

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório 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: o título 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ório Descrição
alertId inteiro Sim A ID do alerta, conforme retornada por GetAlerts

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório 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

Links Úteis

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