Criar alertas do Activator para um Painel em Tempo Real

Você pode criar alertas do Fabric Activator em várias fontes de dados diferentes no Microsoft Fabric. Este artigo explica como criar alertas do Activator para um Painel em Tempo Real. Para obter mais informações, confira O que é o Activator?

Alerta quando as condições são atendidas em um Painel em Tempo Real

Use o Activator para disparar notificações quando as condições forem atendidas nos dados em um Painel em Tempo Real. Por exemplo, se você tiver um Painel em Tempo Real que exibe a disponibilidade de bicicletas de aluguel em vários locais, poderá disparar um alerta se houver poucas bicicletas disponíveis em qualquer local. Envie essas notificações de alerta para si mesmo ou para outras pessoas na sua organização, usando email ou Microsoft Teams.

Pré-requisitos

• Um espaço de trabalho com uma capacidade habilitada para o Microsoft Fabric
• Um painel em tempo real com pelo menos um bloco exibindo dados

Criar uma regra do Activator usando Definir alerta

Abra um painel de Real-Time e faça um dos seguintes procedimentos:

1. Na barra de menus:

   1. Defina alertas selecionando o botão Definir alerta .

   2. Na janela pop-up, escolha o bloco que você deseja monitorar e selecione Selecionar para abrir o painel lateral.

2. No bloco:

   1. Escolha um bloco no Painel em Tempo Real para o Activator monitorar.

   2. Selecione Definir Alerta na barra de ferramentas do bloco ou no menu Mais (...) no canto superior direito do bloco.

      

Definir as condições de alerta do Activator

Seção Detalhes

No painel Definir alerta , forneça um nome para sua regra.

Seção de Monitoramento

Selecione com que frequência você deseja que o Activator execute a consulta. O padrão é a cada 5 minutos.

Seção Condição

Defina suas condições de regra da seguinte maneira:

• Se a visualização não tiver dimensões, você poderá selecionar a condiçãoEm cada evento quando para monitorar as alterações no fluxo de dados escolhendo um campo específico a ser monitorado.
• Se a visualização incluir dimensões, você poderá selecionar a condição Em cada evento agrupado por para monitorar as alterações no fluxo de dados selecionando um campo para agrupamento, que divide os dados em grupos distintos

1. Na lista suspensa Quando , selecione o valor a ser avaliado.
2. No menu suspenso Condição, selecione a condição a ser atendida. Para obter mais informações, consulte Condições.
3. No menu suspenso Ocorrência, defina o número de vezes que a condição deve ser atendida para disparar o alerta.

Seção Ação

Na seção Ação , selecione uma das seguintes ações a serem executadas quando o alerta for disparado:

• Enviar email:

  1. Para selecionar a ação, escolha Enviar email.
  2. Para To, insira o endereço de email do destinatário ou use a lista suspensa para selecionar uma lista de usuários da sua organização. Por padrão, seu endereço de email é preenchido lá.
  3. Para Assunto, insira o assunto da notificação por email.
  4. Para o Título, insira a manchete da notificação por email.
  5. Para Anotações, insira qualquer informação adicional que você deseja incluir na notificação por email.

     Observação

     Ao inserir o assunto, o título ou as anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

  6. Para Contexto, selecione os valores na lista suspensa que você deseja incluir na notificação por email.

  

• Enviar notificação do Microsoft Teams:

  1. Para selecionar a ação, selecione Teams -->Mensagem para individuais ou Mensagem de chat em grupo ou Postagem de Canal.
  2. Siga uma destas etapas dependendo da seleção:
     • Se você selecionou a opção Mensagem para indivíduos, insira os endereços de email dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Quando a condição é atendida, um email é enviado para indivíduos especificados.
     • Se você selecionou a opção Mensagem de chat em grupo, selecione um chat em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat do grupo.
     • Se você selecionou a opção de postagem do Canal , selecione uma equipe e um canal nas listas suspensas. Quando a condição é atendida, uma mensagem é postada no canal selecionado.
  3. Para Título, insira o título da notificação do Teams.
  4. Para anotações, insira anotações para a notificação do Teams.

     Observação

     Ao inserir assunto, título ou anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

  5. Para Contexto, selecione os valores na lista suspensa que você deseja incluir na notificação do Teams.

  

• Executar atividades do Fabric: para configurar o alerta para iniciar um pipeline do Fabric, um trabalho do Spark ou um notebook quando a condição for atendida, siga estas etapas:

  1. Para selecionar a ação, selecione Executar Pipeline, Executar trabalho do Spark, Executar Notebook ou Executar Função (versão prévia).
  2. Na seleção do item Fabric a ser executado, selecione o item Fabric (pipeline, notebook, trabalho do Spark ou função) na lista.
  3. Selecione Adicionar um parâmetro e especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. Você pode passar parâmetros dos dados de alerta digitando @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikepointID.
  • Ações personalizadas: para configurar o alerta para chamar uma ação personalizada quando a condição for atendida, siga estas etapas:

    1. Para selecionar a ação, selecione Criar ação personalizada.

       

    2. Conforme mencionado na seção Ação, crie a regra primeiro e conclua a configuração da ação personalizada seguindo as etapas de Disparar ações personalizadas (fluxos do Power Automate).

    3. Depois de criar a ação personalizada, no painel Definição da regra, selecione a ação personalizada criada na lista suspensa Ação .

Seção Salvar localização

Defina o local para salvar essa regra do Activator e selecione Criar.

Modificar sua regra no Activator

Quando a regra estiver pronta, você receberá uma notificação com um link para a regra. Selecione o link para editar sua regra no Activator. Editar a regra será útil se você quiser fazer um dos seguintes refinamentos:

• Adicionar outros destinatários ao seu alerta.
• Defina uma condição de alerta mais complexa do que a possível no painel Definir alerta.

Para obter informações sobre como editar regras no Activator, confira Criar ativadores no modo de design.

Limitações para definir alertas

Ao criar alertas, tenha em mente que os alertas só podem ser criados em tipos específicos de visuais. Não há suporte para os seguintes visuais para a criação de alertas:

• Tables
• Mapas
• Gráficos de funil
• Anomalies
• Gráficos de dispersão
• Reduções de Preço
• Mapas de calor
• Gráficos de tempo (conforme descrito na próxima seção)

Limitações em gráficos com um eixo de tempo

Se você tiver um gráfico com um eixo de tempo no Power BI ou em um Painel em Tempo Real, o Activator lerá o valor da medida exatamente uma vez para cada ponto no eixo de tempo. Se o valor medido de determinado ponto de tempo for alterado após ser lido pelo Activator, o Activator ignorará o valor alterado.

Exemplo de limitação

O exemplo de código a seguir ilustra essa limitação. Neste exemplo, um gráfico mostra o número de bicicletas vendidas. O Activator lê o gráfico pela primeira vez na manhã de 3 de janeiro. Neste momento, o gráfico mostra 10 bicicletas vendidas:

Mais tarde, no dia 3 de janeiro, mais bicicletas são vendidas. O gráfico é atualizado para refletir essa alteração e o número de bicicletas vendidas agora é 15:

O Activator ignora o valor alterado, pois ele já leu um valor de 10 no início do dia.

Como contornar essa limitação

A razão mais comum pela qual um valor de medida pode mudar ao longo do tempo é que o ponto mais recente no eixo do tempo está sujeito a alterações. No exemplo, o número de vendas aumenta ao longo do dia. O número de itens vendidos nos dias anteriores nunca muda, pois essas datas estão no passado. Para evitar essa limitação:

1. Exclua a data/hora atual do gráfico, de modo que esse valor não faça parte da amostra enquanto ainda estiver sujeito a alterações.

   • Adicione um filtro de tempo relativo ao gráfico para excluir a data ou hora atual do gráfico. O Activator vê o valor somente quando é o final para o período que está sendo medido e não está mais sujeito a alterações.

   • Adicione um filtro de tempo em que o intervalo de tempo termina em 'um compartimento antes' da hora atual. Portanto, o último compartimento amostrado pelo Activator já está "fechado" e não será alterado.

     TableForReflex
     | where YourTimeColumn between (ago(5h)..bin(now(), 1h))
     | summarize count() by bin(YourTimeColumn, 1h)
     | render timechart
     

2. Use um visual de cartão ou KPI para acompanhar o valor da data atual, pois a limitação descrita aqui só se aplica a gráficos com um eixo de tempo. Por exemplo, crie um visual KPI que exibe as "vendas até agora de hoje". O Activator lê e dispara para as alterações nesse valor ao longo do dia.

Conteúdo relacionado

• Criar regras do Activator no modo de design
• Condições de detecção no Activator
• Tutorial do Activator usando dados de exemplo
• O que é o Microsoft Fabric?