Cria uma regra no Fabric Activator

Quando trazes dados em streaming para um ativador ou atribuis eventos a objetos, podes criar regras para agir sobre os teus 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 também desencadear um fluxo de trabalho, como iniciar um fluxo do Power Automate.

As regras ativadoras também podem ativar ações baseadas em eventos Fabric e Azure Blob Storage recebidos através do Eventstream, permitindo orquestração orientada por eventos. Por exemplo, podes iniciar jobs Spark ou Dataflows quando ficheiros caem num contentor de blobs. Para mais informações sobre como ligar fontes de eventos, consulte Adicionar um destino de ativador Fabric a um fluxo de eventos.

Pré-requisitos

• Um espaço de trabalho com capacidade compatível com Microsoft Fabric.

Abra o Ativador

Começa por abrir o Fabric no teu 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é-preenchido 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. Para informações sobre propriedades, consulte a secção Criar propriedades .

Depois de selecionar uma propriedade ou eventstream, vê uma pré-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 stream que acabou de adicionar. Vês um painel de regras de criação 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, realiza uma ação.
• Em cada evento em que um valor é cumprido, realiza uma ação.
• Em cada evento agrupado por um campo, execute uma ação (por exemplo, em cada evento PackageId quando a Temperatura é superior a 30)

Por fim, selecione se quer que a ação lhe envie um email ou uma mensagem no Teams, e selecione Criar. Podes modificar as condições e ações mais tarde.

Os gráficos no separador Definição atualizam-se para mostrar uma amostra dos eventos que cumprem as condições que definiste.

Se fores ao separador de Análises , vês dois gráficos. O primeiro gráfico mostra o número total de vezes que a regra foi disparada, para todos os IDs de objetos que o Activator está a rastrear. 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. Utilize este gráfico para compreender melhor se determinados IDs de objetos contribuem mais para todas as ativações que ocorrem.

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 - Envie um email aos destinatários especificados.

• Teams - Envie uma mensagem Teams para destinatários especificados, chat de grupo ou canal.

• Fabric item - Executar o pipeline Fabric selecionado, caderno Fabric, Definição de Job Spark Fabric, Dataflow Fabric ou Função de Dados do Utilizador Fabric. Use estas ações para implementar pipelines baseados em eventos. Para mais informações, veja Trigger Fabric items.

• Ação personalizada - Ativar um fluxo Power Automate.

Diferentes tipos de ação têm parâmetros diferentes. Alguns desses parâmetros incluem o endereço de email para onde quer enviar, o canal do Teams ou o grupo de chat, o fluxo de trabalho que quer iniciar, o assunto ou informações adicionais (contexto). Para contextualizar, pode selecionar as propriedades adicionais a incluir na mensagem de alerta.

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

Quando resumir a propriedade no cartão Monitor, a ação envia o valor original da propriedade em vez do valor resumido.

Selecione Editar ação para ver um editor com uma pré-visualização da mensagem enviada pela ação e opções para adicionar mais informação à 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 vai sempre para si, independentemente do campo do destinatário no cartão 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.

Ativar e desativar a regra

As regras são criadas em um estado interrompido . Este estado significa que o sistema não está a avaliar a regra à medida que os dados entram no sistema, e a regra não toma qualquer ação como resultado. Depois de definires a regra, seleciona Guardar e começa a ativar a regra. 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. A tua regra não entra em ação para dados que já foram ingeridos. Para parar o alerta, selecione Parar.

Se fizer alterações à regra (por exemplo, alterar a condição que ela procura), selecione Atualizar na barra de ferramentas para garantir que a regra em execução usa 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 agir em conformidade durante alguns minutos depois de as apagar.

Criar propriedades

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

Para criar uma propriedade, selecione o fluxo que adicionou ao objeto que lhe interessa, selecione Nova Propriedade na fita e depois selecione a propriedade que gostaria de usar na lógica de regras.

Depois de definir uma propriedade, pode referenciá-la em uma ou mais regras. Neste exemplo, refere-se à propriedade TemperaturaDemasiado quente para medicação.

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