Partilhar via

Tutorial: Criar e ativar uma regra do Ativador

  • Artigo

Neste tutorial, você usa dados de exemplo incluídos no Ativador de malha. Use os dados de exemplo para concluir estas tarefas:

  • Revisar um ativador de exemplo
  • Explorar os dados
  • Explorar uma regra
  • Iniciar a regra
  • Criar um objeto
  • Criar uma regra

Pré-requisitos

Antes de começar, você precisa de um espaço de trabalho com capacidade de malha. Você pode saber mais sobre espaços de trabalho de malha no artigo Espaços de trabalho. Se você não tiver o Fabric, será solicitado que inicie uma avaliação.

Criar um ativador de exemplo

Comece abrindo o Fabric no navegador.

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

    Captura de ecrã a mostrar o painel de navegação esquerdo com Criar selecionado.

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

    Captura de tela mostrando a opção para adicionar dados ou usar os dados de exemplo.

Explorar os dados

Nesta etapa, exploramos os dados do fluxo de eventos nos quais esse exemplo foi criado.

O novo ativador tem uma seção Explorer . Role para baixo e selecione o fluxo de eventos de entrega de pacotes.

Captura de tela do Ativador com o fluxo de eventos de entrega de pacote selecionado.

Esses eventos mostram o status em tempo real dos pacotes que estão em processo de entrega.

Observe os eventos recebidos e passe o mouse sobre os dados do evento na tabela ao vivo. Cada ponto de dados contém informações sobre o evento. Você pode ter que rolar para ver tudo.

Explorar uma regra

Use uma regra para especificar os valores de evento que você deseja monitorar, as condições que deseja detetar e as ações que deseja que o Ativador execute.

O painel Explorer exibe objetos, como fluxos de eventos, para esse ativador. de eventos de entrega é um dos objetos criados a partir dos eventos de entrega de pacotes eventstream.

  1. No painel Explorer, selecione o objeto chamado Eventos de entrega. Você pode criar regras sobre objetos que usam dados do fluxo de eventos de entrega de pacote. Por exemplo, uma regra que verifica a temperatura dos pacotes.

    Captura de ecrã a mostrar a tabela Eventos de entrega e a coluna de temperatura.

  2. Observe que a seção Eventos por ID do objeto é organizada pela ID do pacote. ID do pacote é o ID da coluna que identifica exclusivamente cada pacote. Usamos essa ID exclusiva para atribuir os eventos Package aos objetos Package.

    Captura de tela mostrando a coluna ID exclusiva na tela Eventos por ID do objeto.

  3. Selecione a regra Temperatura chamada Demasiado quente para o medicamento. Percorra o painel Definição para ver como a regra funciona.

  4. Na seção Monitor, selecione Temperatura. Os valores de temperatura vêm da coluna Temperatura na tabela Eventos de entrega. Você pode ver a coluna Temperatura em uma captura de tela anterior.

    Captura de ecrã a mostrar a secção Monitor do painel Definição.

  5. Role para baixo até Condição. A nossa regra é a monitorização de temperaturas que se tornarem maiores do que20 graus Celsius.

  6. Desloque-se ainda mais para baixo até Filtro de Propriedade. A nossa regra aplica-se apenas a embalagens que contenham medicamentos. Na tabela Eventos de Entrega, a regra analisa a coluna denominada Conteúdo de cuidados especiais. Na coluna Cuidados especiais, algumas das embalagens têm um valor de Medicina.

    Captura de ecrã mostrando a seção Filtro de Propriedade do painel Definição.

  7. Por fim, role para baixo até Ação. Nossa regra envia uma mensagem do Teams se a condição for atendida.

Criámos uma regra Activator. A regra está sendo executada no fluxo de eventos de eventos de entrega de pacotes. A regra procura embalagens que tenham medicamentos e verifica se a temperatura agora é superior a 20 graus Celsius. Quando a temperatura se torna superior a 20 graus Celsius, é enviada uma mensagem do Teams.

Veja as outras regras para saber como funcionam.

Iniciar a regra

Agora você está familiarizado com os eventos e objetos usados para criar uma regra. O próximo passo é iniciar a regra.

  1. Selecione Demasiado quente para o medicamento.

  2. Opcionalmente, envie uma mensagem de teste selecionando Enviar-me uma ação de teste. Primeiro, verifique se você é o destinatário. Certifique-se de que recebe a mensagem e que tem o aspeto esperado.

  3. Selecione Iniciar. Isso faz com que a regra se torne ativa. Você recebe uma mensagem do Teams sempre que um pacote de medicamento está muito quente. A regra deve ser acionada várias vezes a cada hora.

  4. Mais tarde, você pode desativar a regra usando o botão Parar .

Criar um objeto

Agora é hora de criar um objeto próprio. Nesta seção, exclua o objeto Package . Em seguida, recrie-o para acompanhar o status dos pacotes em trânsito onde as horas de entrega se tornam superiores a 25.

  1. Selecione e exclua o objeto Package .
  2. Selecione o Fluxo de eventos de entrega de pacotes.
  3. Na faixa de opções, selecione Novo objeto.
  4. Nomeie seu novo objeto Package2 e escolha Package ID como o ID exclusivo.
  5. Adicione HoursInTransit e City como propriedades do objeto.
  6. Selecione Criar.

Criar uma nova regra

Crie uma regra que o alerte se o tempo de trânsito na entrega exceder um limite.

  1. Selecione sua nova propriedade HoursInTransit . Na faixa de opções, selecione Nova regra. No cabeçalho, selecione o ícone de lápis para editar o nome da regra. Nomeie-o Tempo médio de trânsito acima do alvo. Seu objeto Package2 tem esta aparência.

    Visualização do explorador do tempo médio de trânsito para o tutorial do ativador.

  2. Selecione Editar detalhes para abrir o painel de Definição.

  3. No painel Definição, selecione HoursInTransit. Em seguida, selecione Adicionar resumo>média. Defina uma agregação Tamanho da janela de cinco minutos e um tamanho de Etapa de cinco minutos. O gráfico Monitor é atualizado para refletir o resumo e o gráfico Monitor de regras tem esta aparência.

    Gráfico de tempo médio de trânsito para tutorial do ativador.

  4. Na etapa Condição, detete quando o tempo médio de trânsito se torna maior que 25. Defina a regra para alertá-lo sempre que a condição for atendida. Depois de concluir esta etapa, o gráfico de condição é atualizado e a regra tem esta aparência.

    Captura de tela mostrando o gráfico de deteção de regra de tempo médio de trânsito para o tutorial do ativador.

  5. Especifique uma ação para sua regra. Você pode optar por enviar uma mensagem ou um e-mail do Teams. Personalize sua ação de acordo com como você gostaria que ela aparecesse.

  6. Teste a sua regra selecionando o botão Enviar-me uma ação de teste. Certifique-se de receber um alerta. Se estiver usando e-mail, pode levar um ou dois minutos para chegar.

  7. Inicie a regra selecionando Salvar e iniciar.

Você criou seu primeiro objeto e regra. Como próximas etapas, você pode tentar configurar algumas outras regras no objeto Package2 . Quando estiver pronto para tentar usar o Activator em seus próprios dados, siga as etapas no artigo Obter dados para o Ativador .

Clean up resources (Limpar recursos)

Depois de terminar com as regras que você criou como parte do tutorial, certifique-se de pará-las. Se não suspender as regras, continuará a receber as notificações. Você também pode incorrer em cobranças pelo processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na faixa de opções.

Conteúdos relacionados

Você também pode saber mais sobre o Microsoft Fabric: