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:

  • Revise um item de exemplo do Ativador
  • 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.

Crie um Ativador de exemplo

  1. Na página inicial do Fabric, no painel de navegação à esquerda, selecione a reticência (...) e depois selecione Criar.

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

  2. Na página Criar, em Inteligência em Tempo Real, selecione Activator.

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

  3. Na página Ativador , selecione Experimentar amostra.

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

Explorar os dados

Neste passo, explora os dados do fluxo de eventos sobre os quais a amostra é construída.

O novo item Ativador tem uma secção de Explorador . 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 eventos de pacote a objetos de 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, veja o painel de Definição para ver como funciona a regra.

    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. Desça até Ação. Escolha uma das seguintes ações a tomar quando 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 e-mail.
      2. Para To, insira os endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. O seu endereço de email é preenchido aqui por defeito.
      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 referir-se a propriedades dos dados escrevendo @ ou selecionando o botão junto às caixas de texto. Por exemplo, @PackageId.

      6. Para contextualizar, selecione os valores da lista suspensa que pretende incluir na notificação por email.

      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 Mensagem do Teams>para indivíduos, Mensagem de Grupo no chat ou Publicação no Canal.
      2. Siga um destes passos dependendo da sua escolha:
        • Se selecionou Mensagem para indivíduos, insira os endereços de email dos destinatários ou utilize a lista suspensa para selecionar uma propriedade cujo valor seja um endereço de email. Quando a condição é cumprida, o Fabric Activator envia uma mensagem Teams aos indivíduos especificados.
        • Se selecionaste mensagem no chat de grupo, seleciona um chat de grupo na lista suspensa. Quando a condição é cumprida, o Fabric Activator publica uma mensagem no grupo de chat.
        • Se selecionou publicação no canal, selecione uma equipa e um canal nas listas pendentes. Quando a condição é cumprida, o Fabric Activator publica uma mensagem 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 referir-se a propriedades dos dados escrevendo @ ou selecionando o botão junto às caixas de texto. Por exemplo, @PackageId.

      5. Para Context, selecione os valores da lista pendente que pretende 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 iniciar um pipeline do Fabric, um Dataflow, uma tarefa do Spark, um notebook, uma Função, uma tarefa de cópia ou publicar um evento empresarial (pré-visualização) quando a condição for satisfeita, siga estes passos:

      1. Para Selecionar ação, selecione Executar pipeline, Executar fluxo de dados, Executar tarefa Spark, Executar Notebook, Executar função, Executar tarefa de cópia ou Publicar evento empresarial (pré-visualização).

      2. Em Selecione o item do Fabric a executar, selecione o item do Fabric (pipeline, fluxo de dados, bloco de notas, tarefa do Spark, função, tarefa de cópia ou publicar evento de negócio (pré-visualização)) na lista.

      3. Selecione Adicionar parâmetro e depois 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 escrevendo @ ou selecionando o botão ao lado da caixa de texto. Por exemplo, @PackageId. Os jobs de cópia não aceitam parâmetros, por isso este passo não se aplica a eles.

        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. Primeiro, crie a regra. Depois, conclua a configuração de ações personalizadas seguindo os passos em Acionar ações personalizadas (fluxos do Power Automate).

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

  8. Depois de configurares a ação selecionada, 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 contenham medicamentos e verifica se a temperatura é superior a 20 graus Celsius. Quando a temperatura ultrapassa os 20 graus Celsius, a regra envia uma mensagem no Teams.

Este exemplo de item Ativador inclui outras regras. Explora-os ao teu próprio ritmo para perceberes 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 cria um objeto teu. Nesta secção, apagas o objeto Package e recrias-no com as propriedades que vais usar na secção seguinte para criar uma regra.

  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 regra

Crie uma regra que o alerte quando o tempo médio de trânsito ultrapassar 25 horas.

  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 Condition, defina a condição para ser acionada quando HoursInTransit for superior a 25.

    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óximo passo, tenta configurar 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