Compartilhar via

Tutorial: criar e ativar uma regra do Activator

  • Artigo

Neste tutorial, você usará os dados de exemplo incluídos no Fabric Activator. Você usa os dados de exemplo para concluir estas tarefas:

  • Examinar 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 ter um workspace com uma capacidade do Fabric. Saiba mais sobre os workspaces do Fabric no artigo Workspaces. Se você não tiver o Fabric, será solicitado que você inicie uma avaliação.

Criar um ativador de exemplo do Activator

Comece abrindo um workspace que tenha uma capacidade do Fabric.

  1. Na home page do Fabric, selecione um workspace com uma capacidade do Fabric e selecione Criar>Activator.

    Captura de tela mostrando o painel de navegação à esquerda com a opção Criar selecionada.

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

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

Explorar os dados

Nesta etapa, exploraremos os dados de Eventstream nos quais este exemplo foi criado.

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

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

Examine os eventos de entrada e passe o mouse sobre os dados do evento na tabela ao vivo. Cada ponto de dados contém informações sobre o evento. Talvez seja necessário rolar para ver tudo.

Explorar uma regra

Use uma regra para especificar os valores que você deseja monitorar, as condições que você deseja detectar e as ações que você deseja que o Activator execute.

O painel Explorer exibe objetos, como Eventstreams, para esse ativador. A opção Eventos de entrega é um dos objetos.

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

    Captura de tela mostrando a tabela de eventos de entrega e a coluna de temperatura.

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

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

  3. Selecione a regra Temperatura chamada Muito quente para medicamentos. Role pelo painel Definição para ver como a regra funciona.

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

    Captura de tela mostrando a seção Monitor do painel Definição.

  5. Role para baixo até Condição. Nossa regra é monitorar temperaturas que ficarem acima de 50.

  6. Role mais para baixo até Escopo. Nossa regra se aplica apenas a pacotes que contêm medicamentos. Na tabela de Eventos de entrega, a regra examina a coluna chamada de Tratamento especial. Na coluna Tratamento especial, alguns dos pacotes têm um valor de Medicamentos.

    Captura de tela mostrando a seção Escopo do painel Definição.

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

Criamos uma regra do Activator. A regra está em execução no Eventstream dos Eventos de entrega de pacotes. A regra procura pacotes que tenham medicamentos e verifica se a temperatura ficou acima de 50 graus. Quando a temperatura fica acima da 50 graus, uma mensagem do Teams é enviada.

Olhe para as outras regras para saber como elas funcionam.

Iniciar a regra

Agora você está familiarizado com os eventos e objetos usados para criar uma regra. A próxima etapa é iniciar a regra.

  1. Selecione Muito quente para medicamentos.

  2. Como alternativa, envie uma mensagem de teste selecionando Teste. Primeiro, verifique se você é o Destinatário. Verifique se você recebeu a mensagem e se ela está do jeito que você espera.

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

  4. Mais tarde, você poderá 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 no transporte, em que as horas na entrega ficarem acima de 100.

  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 o novo objeto Package2 e escolha a ID do Pacote como a ID exclusiva.
  5. Adicione HoursInTransit e City como propriedades do objeto.
  6. Selecione Criar.

Criar uma nova regra

Crie uma regra que alerte você se o tempo de transporte na entrega exceder um limite.

  1. Selecione a 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 como Tempo médio de transporte acima do destino. O objeto Package2 é assim.

Modo de exibição do gerenciador de tempo médio de transporte para o tutorial do ativador.

  1. No painel Definição, selecione HoursInTransit. Em seguida, selecione Mostrar opções>Adicionar resumo>Média. Defina um Tamanho de janela de agregação de 1 hora e um Tamanho de etapa de 1 hora. O gráfico Monitor é atualizado para refletir o resumo e a regra é assim.

    Gráfico do tempo médio de transporte para o tutorial do ativador.

  2. Na etapa Condição, detecte quando o tempo médio de transporte ficar acima de 25. Defina a regra para alertar você sempre que a condição for atendida. Depois de concluir esta etapa, o gráfico de condições será atualizado e a regra será assim.

    Captura de tela mostrando o gráfico de detecção de regra do tempo médio de transporte para o tutorial do ativador.

  3. Especifique uma ação para a regra. Você pode enviar uma mensagem ou email do Teams. Personalize a ação de acordo com a forma como deseja que ela seja exibida.

  4. Teste a regra selecionando o botão Testar a ação. Verifique se você recebeu um alerta. Se estiver usando o email, pode levar um ou dois minutos para chegar.

  5. Inicie a regra selecionando Salvar e iniciar.

Você criou o 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 nos seus pró dados, siga as etapas do artigo Obter dados para o Activator.

Limpar os recursos

Depois de concluir as regras criadas como parte do tutorial, pare-as. Se você não parar as regras, continuará recebendo as notificações da regra. Você também pode incorrer em encargos devido ao processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na faixa de opções.

Captura de tela que mostra o botão Parar regra para o tutorial do ativador.

Conteúdo relacionado

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