Power BI

O Power BI é um conjunto de ferramentas de análise de negócio para analisar os dados e partilhar informações. Monitorize a sua empresa e obtenha respostas rapidamente com dashboards avançados disponíveis em todos os dispositivos. Na sua aplicação, pode verificar o estado dos alertas de dados que configurou no serviço Power BI. Para mais informações sobre alertas de dados no Power BI, siga para a página de documentação.

Este tópico mostra-lhe como utilizar a ligação do Power BI numa aplicação e apresenta as funções disponíveis.

O que precisa para começar

Utilize a ligação do Power BI na sua aplicação

Liste os alertas que configurou no serviço Power BI

  1. No menu Inserir, selecione Galeria e adicione qualquer uma das Galerias de texto.
  2. Para mostrar os alertas do utilizador atual, defina a propriedade Itens da galeria com a seguinte fórmula:

    PowerBI.GetAlerts()

A galeria será atualizada com a lista de alertas. 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. Irá precisar do ID do alerta para obter mais informações sobre o alerta.

Ver o estado de um alerta

Para ver o estado do alerta, chame a função CheckAlertStatus com o ID do alerta obtido a partir do passo acima.

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)

Para continuar, adicione uma caixa de texto e, em seguida, defina a propriedade Texto com uma das seguintes 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

A caixa de texto será atualizada com o atual estado do alerta.

Ver as funções disponíveis

Esta ligação inclui as seguintes funções:

Nome da Função Descrição
GetAlerts Liste os alertas que configurou no serviço Power BI
CheckAlertStatus Verifique o estado de um alerta específico

GetAlerts

Liste os alertas que configurou no serviço Power BI.

Propriedades de entrada

Nenhum.

Propriedades de saída

Nome da Propriedade Tipo de Dados Necessário Descrição
valor matriz Não Uma matriz dos alertas de dados que configurou no serviço Power BI. Cada elemento da matriz irá incluir:
  • alertTitle: o título do alerta
  • alertId: o ID do alerta
  • groupId: o ID do grupo em que o alerta foi criado

CheckAlertStatus

Verifique o estado de um alerta.

Nota: os pedidos para este ponto final serão limitados numa base por alerta se forem chamados com muita frequência.

Propriedades de entrada

Nome da Propriedade Tipo de Dados Necessário Descrição
alertId número inteiro Sim O ID do alerta, conforme devolvido por GetAlerts

Propriedades de saída

Nome da Propriedade Tipo de Dados Necessário Descrição
tileValue número Não O valor do mosaico quando o alerta foi acionado
tileUrl cadeia Não URL para o mosaico que tem o alerta
alertTitle cadeia Não Nome do alerta
isAlertTriggered booleano Não Se o alerta é acionado atualmente
alertThreshold número Não O limiar em que é acionado o alarme

Ligações úteis

Veja todas as ligações disponíveis.
Saiba como adicionar ligações às suas aplicações.