Criar regras do Ativador de Dados
Depois de trazer dados para um reflexo ou atribuir dados a objetos, você pode criar regras para agir sobre seus dados. Há três tipos de regras: regras sobre eventos, regras sobre eventos que são adicionados a um objeto e regras sobre as propriedades de um objeto.
Importante
O Data Activator está atualmente em pré-visualização.
Porquê criar regras para eventos?
A criação de regras sobre eventos permite que você obtenha uma ativação para cada evento que entra em um fluxo de eventos. Ao criar esses tipos de regras, você pode acompanhar o estado de algo ao longo do tempo. Por exemplo:
Você recebe um alerta sempre que um novo evento entra em um fluxo de eventos que tem leituras em um único sensor IoT.
Você pode receber um alerta sempre que um novo evento for exibido e o valor de uma coluna nesse evento atender à sua condição definida.
Por que criar regras em eventos que são adicionados a objetos?
A criação de regras em eventos que são adicionados a um objeto é semelhante a regras criadas em eventos. No entanto, você controla eventos para IDs de objeto específicos. Você recebe uma ativação sempre que um novo evento entra no fluxo de eventos que é adicionado ao objeto. E você pode identificar para qual instância ele veio também. Um benefício adicional é que você pode usar propriedades de outros fluxos de eventos que são adicionados a esse mesmo objeto em sua expressividade de regra.
Porquê criar regras sobre propriedades?
A criação de regras em propriedades permite monitorar uma propriedade em objetos ao longo do tempo. Se você quiser monitorar o estado de uma propriedade em um objeto, crie uma regra em uma propriedade.
Por exemplo, você pode monitorar a temperatura em uma embalagem e se ela permanece dentro de um intervalo definido ao longo do tempo.
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 de Dados execute.
Passo 1: Selecione os seus dados
No Gerenciador do Ativador de Dados, selecione a propriedade ou o fluxo de eventos a ser monitorado na regra. Consulte create Properties mais adiante neste artigo 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.
Etapa 2: criar uma nova regra
Para criar uma nova regra, na faixa de opções, selecione Nova regra. Dê-lhe um novo nome selecionando o nome da regra padrão e editando-o. A seção Monitor da regra é preenchida previamente com os dados selecionados na Etapa 1.
Etapa 3: 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:
- quando um valor numérico ultrapassa ou fica abaixo de um limiar (por exemplo, a temperatura é superior a 30),
- quando um valor lógico verdadeiro/falso muda (por exemplo, HasFault torna-se True), ou
- quando um valor de cadeia de caracteres é alterado (por exemplo, Status muda de InCompliance).
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 todas as IDs de objeto que o Ativador de Dados 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 o gatilho foi ativado, para os 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.
Etapa 4: 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.
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 fluxo de trabalho que deseja iniciar, linha de assunto ou informações adicionais.
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 de gatilho 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 de Dados 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 fazemos referência à propriedade Temperatura Regra de temperatura máxima da última hora.
Conteúdos relacionados
Você também pode saber mais sobre o Microsoft Fabric: