Compartilhar via

Tutorial: Criar e ativar uma regra do Fabric Activator

O Fabric Activator no Microsoft Fabric permite que você execute ações quando padrões ou condições são detectados em fluxos de dados. Se você está começando a usar o Fabric Activator, consulte O que é o Fabric Activator. Neste tutorial, você usará os dados de exemplo incluídos com o Fabric Activator para concluir as seguintes 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

  1. Navegue até o portal do Fabric.

  2. No painel de navegação esquerdo, selecione as reticências (...) e, em seguida, selecione Criar.

    Captura de tela mostrando o painel de navegação esquerdo com Criar selecionado.

  3. Na página Criar, na seção Inteligência em Tempo Real, selecione Ativador de Dados.

    Captura de tela mostrando a página Criar com o Ativador de Dados selecionado.

  4. Na página Ativador , selecione Experimentar 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.

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.

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 de evento que você deseja monitorar, as condições que você deseja detectar e as ações que você deseja que o Fabric Activator execute.

O painel Explorer exibe objetos, como Eventstreams, para esse ativador. Eventos de entrega são um dos objetos criados a partir do eventstream de eventos de entrega de pacotes.

  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. No painel mais à direita, consulte o painel Definição para ver como a regra funciona.

    Captura de tela mostrando a regra de exemplo.

  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. Na seção Condição , você verá a condição de regra para monitorar temperaturas acima de 20 graus Celsius.

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

  6. Role mais para baixo até Filtro de propriedade. Nossa regra se aplica apenas a pacotes que contêm medicamentos. Na tabela Eventos de entrega, a regra examina a coluna denominada Conteúdo de cuidados especiais. Na coluna Conteúdos de cuidados especiais, alguns dos pacotes têm um valor de Medicamento.

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

  7. Por fim, role para baixo até Ação. Escolha uma das seguintes ações se a condição for atendida:

    1. Enviar notificação por email: Envia um email para si mesmo ou para outras pessoas em sua organização.

      1. Para selecionar a ação, selecione Enviar email.
      2. Para To, insira endereços de email de receptores ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Por padrão, seu email é preenchido aqui.
      3. Para Assunto, insira o assunto da notificação por email.
      4. Para o Título, insira a manchete da notificação por email.
      5. Para Anotações, insira anotações para a notificação por email.

        Observação

        Ao inserir o assunto, o título ou as anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

      6. Para Contexto, selecione os valores da lista suspensa que você deseja incluir na notificação por email.

      Captura de tela mostrando a seção Ação do painel Definição com a ação de email selecionada.

    2. Enviar notificação do Microsoft Teams: Envia uma mensagem do Microsoft Teams para si mesmo. Você pode personalizar o título e o conteúdo da mensagem.

      1. Para selecionar a ação, selecione Teams -->Mensagem para indivíduos ou Mensagem de chat de grupo ou postagem de canal.
      2. Siga uma destas etapas dependendo da seleção:
        • Se você selecionou a opção Mensagem para indivíduos, insira os endereços de email dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor é um endereço de email. Quando a condição é atendida, um email é enviado para indivíduos especificados.
        • Se você selecionou a opção Mensagem de chat em grupo, selecione um chat em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat do grupo.
        • Se você selecionou a opção de postagem do Canal , selecione uma equipe e um canal nas listas suspensas. Quando a condição é atendida, uma mensagem é postada no canal selecionado.
      3. Para Título, insira o título da notificação do Teams.
      4. Para anotações, insira anotações para a notificação do Teams.

        Observação

        Ao inserir o assunto, o título ou as anotações, você pode consultar as propriedades nos dados digitando @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

      5. Para Contexto, selecione os valores da lista suspensa que você deseja incluir na notificação do Teams.

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

    3. Executar atividades do Fabric: Para configurar o alerta para iniciar um pipeline do Fabric, um trabalho do Spark ou um notebook quando a condição for atendida, siga estas etapas:

      1. Para selecionar a ação, selecione Executar Pipeline, Executar trabalho do Spark, Executar Notebook ou Executar Função (versão prévia).

      2. No Selecionar o item Malha para executar, selecione o item Malha (pipeline, notebook, tarefa do Spark ou função) na lista.

      3. Selecione Adicionar parâmetro e especifique o nome do parâmetro para o item Fabric e um valor para ele. Você pode adicionar mais de um parâmetro. Você pode passar parâmetros dos dados de alerta digitando @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikepointID.

        Captura de tela mostrando a seção Ação do painel Definição com a ação de pipeline selecionada.

    4. Ações personalizadas: Para configurar o alerta para chamar uma ação personalizada quando a condição for atendida, siga estas etapas:

      1. Para selecionar a ação, selecione Criar ação personalizada.

        Captura de tela mostrando a seção Ação do painel de Definição com a ação do notebook selecionada.

      2. Conforme mencionado na seção Ação, crie a regra primeiro e conclua a configuração da ação personalizada seguindo as etapas de Disparar ações personalizadas (fluxos do Power Automate).

      3. Depois de criar a ação personalizada, no painel Definição, selecione sua ação personalizada na lista suspensa Selecionar ação.

    5. Selecione Criar para salvar a regra do Ativador.

Criamos uma regra do Fabric 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 agora é maior que 20 graus Celsius. Quando a temperatura se torna maior que 20 graus Celsius, 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. Opcionalmente, envie uma mensagem de teste selecionando Enviar-me uma ação de teste. Primeiro, verifique se você é o Destinatário.

    Captura de tela mostrando a seção Ação do painel Definição com o botão Enviar-me uma ação de teste realçado.

  3. Você deve receber uma mensagem semelhante à seguinte:

    Captura de tela mostrando a notificação do Teams de exemplo.

  4. 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.

    Captura de tela mostrando o botão Iniciar realçado.

  5. Posteriormente, você pode desativar a regra usando o botão Parar na faixa de opções.

    Captura de tela mostrando o botão Parar na barra de ferramentas realçado.

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, em que as horas na entrega se tornam maiores que 25.

  1. No painel Do Explorer , clique com o botão direito do mouse em Pacote e selecione Excluir. Na janela Excluir item , selecione Excluir.

    Captura de tela mostrando o menu Excluir no objeto Package.

  2. Selecione o fluxo de eventos de entrega de pacote e selecione Novo objeto na faixa de opções.

    Captura de tela mostrando o botão Novo Objeto na barra de ferramentas.

  3. No painel Construção à direita, siga estas etapas:

    1. Nomeie seu novo objeto Package2.

    2. Escolha PackageId como a ID exclusiva.

    3. Selecione HoursInTransit e City como propriedades do objeto.

    4. Selecione Criar.

      Captura de tela mostrando o painel Objeto de Construção.

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.

    Captura de tela mostrando o botão Nova regra na faixa de opções.

  2. No painel Definição , siga estas etapas:

    1. Para Monitor, escolha o atributo a ser monitorado e, opcionalmente, adicione filtros.

    2. Para Condição, selecione o tipo de condição e ocorrência.

    3. Para a Ação, selecione uma das opções para enviar uma mensagem no Teams ou email.

    4. Clique em Salvar.

      Captura de tela mostrando o painel Definição.

  3. Você deve ver a regra em HoursInTransit no painel Explorer. Selecione a regra. No painel do meio, selecione o ícone de lápis na parte superior e atualize o nome para Tempo médio de trânsito acima do destino.

    Captura de tela mostrando o ícone de lápis para alterar o nome da regra.

  4. No painel Definição à direita, selecione HoursInTransit. Em seguida, selecione Adicionar resumo>Média.

    Captura de tela mostrando o painel Definição com a agregação Média selecionada.

  5. Defina um tamanho de janela de agregação de cinco minutos e um tamanho de etapa de cinco minutos e selecione Salvar.

    Captura de tela mostrando o painel Definição com a janela e o tamanho da etapa.

  6. O gráfico do Monitor é atualizado para refletir o resumo, e o gráfico do Monitor de regra tem esta aparência.

    Captura de tela do gráfico de tempo de trânsito médio para o tutorial do ativador.

  7. Teste sua regra selecionando o botão Enviar-me uma ação de teste. Verifique se você recebeu um alerta. Se estiver usando o email, pode levar um ou dois minutos para chegar.

    Captura de tela que mostra o botão Testar selecionado na faixa de opções.

  8. Inicie sua regra selecionando Salvar e iniciar no painel Definição ou selecionando Iniciar na faixa de opções.

    Captura de tela que mostra o botão Iniciar na faixa de opções selecionada.

    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 Fabric Activator em seus próprios dados, siga as etapas no artigo Obter dados do Fabric 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.

Conteúdo relacionado

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

  • Last updated on