Criar uma regra no Ativador de malha

Depois de trazer dados de streaming para um ativador ou atribuir eventos a objetos, você pode criar regras para agir sobre seus dados. A ativação dessas regras pode ser o envio de uma notificação, como um e-mail ou uma mensagem do Teams. A ativação dessas regras pode acionar um fluxo de trabalho, como iniciar um fluxo do Power Automate.

Pré-requisitos

• Para concluir com êxito esse tutorial, você precisa de um espaço de trabalho com uma capacidade habilitada para Microsoft Fabric.

Abra o Ativador

Comece abrindo o Fabric no navegador.

No painel de navegação, selecione Criar>Ativador. Se não vir Criar, selecione as reticências (...) para apresentar mais opções.

Selecione Tentar amostra para criar um ativador pré-predefinido com eventos e objetos de exemplo.

Definir uma regra, condição e ação

Use Regras para especificar os valores que você deseja monitorar em seus eventos, as condições que deseja detetar e as ações que deseja que o Ativador execute.

Selecione os dados da regra

No Activator Explorer, selecione a propriedade ou o fluxo de eventos a ser monitorado em sua regra. Consulte a seção Criar propriedades para obter informações sobre propriedades.

Depois de selecionar uma propriedade ou fluxo de eventos, você verá uma visualização dos valores para uma amostra das instâncias do objeto.

Criar uma nova regra do Ativador

Para criar uma nova regra, selecione o fluxo que você acabou de adicionar e você verá um painel "Criar regra" no lado direito. A seção Monitor da regra é preenchida previamente com o fluxo de dados selecionado.

Definir a condição a ser detetada

Em seguida, escolha o tipo de condição que deseja detetar. Você pode usar condições que verificam:

• Em cada evento, faça uma ação
• Em cada evento em que um valor é atingido, execute uma ação
• em cada evento agrupado por um campo, execute uma ação (por exemplo, em cada evento PackageId quando Temperature for maior que 30)

Por fim, selecione se deseja que a ação executada envie um e-mail ou uma mensagem do Teams e selecione Criar. As condições e ações selecionadas podem ser modificadas posteriormente.

Os gráficos na guia Definição são atualizados para mostrar uma amostra dos eventos que atendem às condições definidas.

Se você navegar até a guia Análise , há dois gráficos. O primeiro mostra o número total de vezes que a regra foi acionada, para todos os IDs de objeto que o Ativador está rastreando. Use este gráfico para entender o volume de notificações disparadas sobre todas as IDs de objeto. O segundo gráfico mostra o número total de vezes que a regra foi ativada para as cinco IDs de objeto. Use este gráfico para entender melhor se houve IDs de objeto específicos que mais contribuem para todas as ativações que são acionadas.

Definir a ação a ser tomada

Por fim, use a seção Ação para escolher o que fazer quando a condição for detetada.

Aqui estão os tipos de ação suportados:

• Email - Um e-mail é enviado para os destinatários especificados.

• Equipas - Uma mensagem do Teams é enviada para destinatários especificados, chat de grupo ou canal.

• Item Fabric - Executa o pipeline Fabric selecionado, caderno Fabric, Definição de Trabalho Fabric Spark, função Fabric.

• Ação personalizada - Ativa um fluxo Power Automatic.

Diferentes tipos de ação têm parâmetros diferentes. Alguns desses parâmetros são: o endereço de e-mail para o qual você deseja enviar, o canal do Teams ou o bate-papo em grupo, o fluxo de trabalho que deseja iniciar, a linha de assunto ou informações adicionais (contexto). Em Contexto, você pode selecionar as propriedades adicionais a serem incluídas na mensagem de alerta.

Você também pode marcar propriedades inserindo @ para adicionar contexto às ações enviadas. Por exemplo: @bikeId.

Observe que, ao resumir a propriedade no cartão "Monitor", o valor original da propriedade será enviado na ação, em vez do valor resumido.

Você também pode selecionar Editar ação para ver um editor com uma visualização da mensagem enviada pela ação e opções para adicionar mais informações à ação.

Teste a sua regra

Depois de criar uma regra, teste-a selecionando Enviar-me um alerta de teste. Selecionar esse botão localiza um evento passado para o qual a ativação da regra é verdadeira e envia um alerta para que você possa ver a aparência do alerta para esse evento.

• O alerta de teste sempre vai para você, independentemente do campo de destinatário no cartão de ação
• A opção Enviar-me um alerta de teste só será ativada se você tiver pelo menos um evento passado para o qual a condição da regra seja verdadeira.

Iniciar e parar a regra

As regras são criadas em um estado interrompido . Isso significa que eles não estão sendo avaliados como fluxos de dados para o sistema e não tomam nenhuma ação como resultado. Depois de definir a regra, selecione Salvar e comece a torná-la ativa. Se você não estiver pronto para iniciar sua regra, salve-a e volte mais tarde. Quando estiver pronto, selecione Iniciar na barra de ferramentas do Ativador para começar a executar o gatilho e a agir.

Depois de iniciado, você verá Executando na área de título do cartão de regras. Além disso, o ícone no Explorer mostra que a regra está em execução. Quando você inicia a regra, novas ativações começam a ser executadas em relação aos novos dados ingeridos. Sua regra não é ativada em dados que já foram ingeridos. Para parar o alerta, selecione Parar.

Se você fizer alterações na regra (por exemplo, alterar a condição procurada), selecione Atualizar na barra de ferramentas para garantir que a regra em execução use os novos valores.

Quando você exclui uma regra (ou objeto), pode levar até cinco minutos para que qualquer processamento de back-end de dados seja concluído. As regras eliminadas podem continuar a monitorizar os dados e a tomar medidas em conformidade, durante alguns minutos após a sua eliminação.

Criar propriedades

Às vezes, você precisa reutilizar a lógica de regras em várias regras. Crie uma propriedade para definir uma condição ou medida reutilizável e, em seguida, faça referência a essa propriedade a partir de várias regras.

Para criar uma propriedade, selecione o fluxo adicionado ao objeto em que está interessado, selecione Nova Propriedade no friso e, em seguida, selecione a propriedade que pretende utilizar na lógica da regra.

Depois de definir uma propriedade, você pode fazer referência a ela a partir de uma ou mais regras. Aqui, faz-se referência à propriedade TemperaturaDemasiado quente para a medicina.

Limpar recursos

Exclua o fluxo de eventos de exemplo selecionando as reticências (...) à direita do fluxo de eventos eventos de entrega de pacote e selecionando Excluir.

Próximo passo

Conteúdos relacionados

• Visão geral das regras do Ativador
• tutorial do Activator