Partilhar via

Tutorial: Cria e ativa uma regra do Fabric Activator

O Fabric Activator no Microsoft Fabric permite-lhe agir quando detetar padrões ou condições em fluxos de dados. Se és novo no Fabric Activator, vê O que é Fabric Activator. Neste tutorial, utiliza os dados de exemplo incluídos com o Fabric Activator para completar as seguintes 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, precisa de um espaço de trabalho com capacidade para Fabric. Para saber mais sobre Fabric espaços de trabalho, consulte o artigo Workspaces. Se não tiver Fabric, será solicitado a iniciar uma versão de teste.

Criar um ativador de exemplo

  1. Vai ao portal Fabric.

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

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

  3. Ao Criar, na secção Real-Time Inteligência, selecione Ativador de Dados.

    Captura de ecrã a mostrar a página Criar com o Ativador de Dados selecionado.

  4. No Ativador, selecione Experimentar exemplo.

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

Explorar os dados

Neste passo, explora os dados de eventstream sobre os quais esta amostra é construída.

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. Talvez precise rolar para ver tudo.

Explorar uma regra

Usa uma regra para especificar os valores de eventos que queres monitorizar, as condições que queres detetar e as ações que queres que o Fabric Activator realize.

O painel Explorer exibe objetos, como fluxos de eventos, para esse ativador. Eventos de entrega é um dos objetos criados a partir do eventstream 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 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 secção Eventos por ID do objeto é organizada por ID do pacote. ID do pacote é o identificador que identifica exclusivamente cada pacote. Use este ID único para atribuir os eventos Package aos objetos Pacote.

    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. 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 vêm da coluna de 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. Na seção Condição , você vê a condição da regra para monitorar temperaturas superiores a 20 graus Celsius.

    Captura de ecrã mostrando a secção Condição do painel de Definição.

  6. Desloque-se ainda mais para baixo até Filtro de Propriedade. A 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 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 cumprida:

    1. Enviar notificação por email: Envia um email para ti próprio ou para outros membros da tua organização.

      1. Para selecionar ação, selecione Enviar email.
      2. Para To, introduza endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Por defeito, o seu email está preenchido aqui.
      3. Para o assunto, introduza o assunto da notificação por email.
      4. Para o Título, introduza o título da notificação por email.
      5. Para Notas, introduza notas para a notificação por email.

        Observação

        Ao introduzir o assunto, o título ou as notas, pode consultar as propriedades dos dados escrevendo @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

      6. Para Contexto, selecione os valores da lista suspensa que pretende incluir na notificação do e-mail.

      Captura de ecrã que mostra a secção Ação do painel de Definições com a ação de email selecionada.

    2. Enviar Microsoft Teams notificação: Envia uma notificação Microsoft Teams a indivíduos, a um grupo de chat ou a um canal. Pode personalizar o título e o conteúdo da mensagem.

      1. Para Selecionar ação, selecione Teams -->Mensagem para indivíduos ou Mensagem de grupo no chat, ou Publicação no canal.
      2. Siga um destes passos dependendo da sua escolha:
        • Se você selecionou a opção Mensagem para indivíduos , insira os endereços de e-mail dos destinatários ou use a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de e-mail. Quando a condição é cumprida, é enviada uma mensagem Teams aos indivíduos especificados.
        • Se você selecionou a opção Mensagem de chat de grupo , selecione um bate-papo em grupo na lista suspensa. Quando a condição é atendida, uma mensagem é postada no chat de grupo.
        • Se tiveres selecionado a opção Publicação no canal, seleciona uma equipa e um canal a partir das listas suspensas. Quando a condição é cumprida, uma mensagem é publicada no canal selecionado.
      3. No Campo 'Título', introduza o título da notificação do Teams.
      4. Para Notas, introduza notas para a notificação do Teams.

        Observação

        Ao introduzir o assunto, o título ou as notas, pode consultar as propriedades dos dados escrevendo @ ou selecionando o botão ao lado das caixas de texto. Por exemplo, @BikepointID.

      5. Para contextualizar, selecione os valores da lista suspensa que quer incluir na notificação do Teams.

      Captura de ecrã a mostrar a secçã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 Spark, notebook ou Função de Dados de Utilizador quando a condição for cumprida, siga estes passos:

      1. Para selecionar ação, selecione Executar Pipeline, Executar Fluxo de Dados, Executar o trabalho Spark, Executar o Notebook ou Executar Função de Dados do Utilizador (pré-visualização).

      2. No Selecione Fabric item a executar, selecione o item Fabric (pipeline, fluxo de dados, caderno, trabalho Spark ou função) da 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. Pode passar parâmetros a partir dos dados de alerta digitando @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @BikepointID.

        Captura de ecrã que mostra a secção de Ação do painel de Definição com a ação do pipeline selecionada.

    4. Ações personalizadas: Para configurar o alerta para chamar uma ação personalizada quando a condição for cumprida, siga estes passos:

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

        Captura de ecrã que mostra a secção de Ação no painel de Definição com uma ação de notebook selecionada.

      2. Como mencionado na secção de Ações, crie primeiro a regra e depois complete a configuração personalizada da ação seguindo os passos de Acionar ações personalizadas (fluxos de Power Automate).

      3. Depois de criar a ação personalizada, no painel de Definição, selecione a sua ação personalizada na lista de opções 'Selecionar ação'.

    5. Seleciona Criar para guardar a tua regra de Ativador.

Criaste uma regra do Fabric Ativator. A regra é executada contra o fluxo de eventos de entrega de encomendas. 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 que já conheces os eventos e objetos usados para criar uma regra, começa 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 é o Destinatário.

    Captura de ecrã a mostrar a secção Ação do painel Definição com o botão Enviar-me uma ação de teste realçado.

  3. Recebes uma mensagem semelhante à seguinte:

    Captura de ecrã a mostrar a notificação de exemplo do Teams.

  4. Selecione Iniciar. Esta ação ativa a regra. Você recebe uma mensagem do Teams sempre que um pacote de medicamento está muito quente. A regra ativa-se várias vezes por hora.

    Captura de ecrã a mostrar o botão Iniciar realçado.

  5. Mais tarde, podes desligar a regra usando o botão Parar na fita.

    Captura de ecrã a mostrar o botão Parar no friso 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 onde as horas de entrega se tornam superiores a 25.

  1. No painel 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 pacotes e, em seguida, selecione Novo objeto na faixa de opções.

    Captura de ecrã a mostrar o botão Novo objeto no friso.

  3. No painel Construir objeto à direita, siga estas etapas:

    1. Nomeie seu novo objeto como Package2.

    2. Escolha PackageId como o ID exclusivo.

    3. Selecione HoursInTransit e City como propriedades do objeto.

    4. Selecione Criar.

      Captura de tela mostrando o painel de objetos Build.

Criar uma nova regra

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

  1. Selecione a sua nova propriedade HoursInTransit. Na faixa de opções, selecione Nova regra.

    Captura de ecrã a mostrar o botão Nova regra no friso.

  2. No painel de Definições , siga estes passos:

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

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

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

    4. Selecione Guardar.

      Captura de ecrã a mostrar o painel de Definição.

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

    Captura de ecrã a mostrar 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 ecrã a mostrar 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, em seguida, selecione Salvar.

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

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

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

  7. Teste a sua regra selecionando o botão Enviar-me uma ação de teste. Certifique-se de receber um alerta. Se usares email, pode demorar um ou dois minutos a chegar.

    Captura de ecrã que mostra o botão Testar selecionado no friso.

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

    Captura de ecrã que mostra o botão Iniciar no friso selecionado.

    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 Fabric Activator nos seus próprios dados, siga os passos no artigo Get data for Fabric Activator.

Limpar recursos

Quando terminares as regras que criaste como parte do tutorial, pára-as. Se não suspender as regras, continuará a receber as notificações. Também pode incorrer em custos por processamento em segundo plano. Selecione cada regra por vez e selecione o botão Parar na barra de ferramentas.

Conteúdos relacionados

Para saber mais sobre a Microsoft Fabric, veja:

  • Last updated on