Compartilhar via

Tutorial: Criar e ativar uma regra do Fabric Activator

Ativador do Fabric no Microsoft Fabric permite que você execute ações quando detecta padrões ou condições em fluxos de dados. Se você não estiver familiarizado com Fabric Activator, consulte O que é Fabric Activator. Neste tutorial, você usará os dados de exemplo incluídos com 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 de um workspace com capacidade do Fabric. Para saber mais sobre Fabric workspaces, consulte o artigo Workspaces. Se você não tiver Fabric, será solicitado que você inicie uma avaliação.

Criar um ativador de exemplo

  1. Vá para o portal 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. Em Criar, na seção Real-Time Intelligence, selecione Ativador de Dados.

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

  4. No Activator, selecione Experimentar exemplo.

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

Explorar os dados

Nesta etapa, você explorará os dados de fluxo de eventos 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.

Observe os eventos de entrada e passe o mouse sobre os dados do evento na tabela em tempo real. 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 Fabric Activator execute.

O painel Explorer exibe objetos, como fluxos de eventos, para este 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 objetos que usam dados do stream de eventos 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. Use esse ID exclusivo para atribuir os eventos do pacote a objetos Package.

    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. A 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. Send Microsoft Teams notification: Envia uma notificação de Microsoft Teams para indivíduos, um chat em grupo ou um canal. 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, uma mensagem do Teams é enviada aos 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 lançar um pipeline do Fabric, Dataflow, trabalho do Spark, notebook ou Função de Dados do Usuário quando a condição for atendida, siga estas etapas:

      1. Para selecionar a ação, selecione Executar Pipeline, Executar Fluxo de Dados, Executar Trabalho do Spark, Executar Notebook ou Executar Função de Dados do Usuário (versão prévia).

      2. Em Selecionar item do Fabric para execução, selecione o item do Fabric (pipeline, fluxo de dados, notebook, trabalho do Spark ou função) na lista.

      3. Selecione Add parameter 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 das ações personalizadas Trigger (fluxos de 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.

Você criou uma regra Fabric Activator. A regra é executada no fluxo de 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 que você está familiarizado com os eventos e objetos usados para criar uma regra, inicie a regra.

  1. Selecione Muito quente para a medicina.

  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ê recebe uma mensagem semelhante à seguinte:

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

  4. Selecione Iniciar. Essa ação ativa a regra. Você recebe uma mensagem do Teams sempre que um pacote de medicamentos estiver muito quente. A regra é acionada 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ê 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 você usar 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 você estiver pronto para tentar usar Fabric Activator em seus próprios dados, siga as etapas no artigo Get data for Fabric Activator.

Limpar os recursos

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

Conteúdo relacionado

Para saber mais sobre Microsoft Fabric, confira:

  • Last updated on