Compartilhar via


Usar a atividade Filtro para filtrar itens de uma matriz

Você pode usar uma atividade de filtro em um pipeline para aplicar uma expressão de filtro para uma matriz de entrada.

Pré-requisitos

Para começar, você deve concluir os seguintes pré-requisitos:

Adicionar uma atividade de filtro a um pipeline usando a UI

Para usar uma atividade de filtro em um pipeline, conclua as seguintes etapas:

Criando a atividade

  1. Crie uma nova pipeline em seu espaço de trabalho.

  2. Selecione a guia Variáveis na área de configurações do pipeline e selecione + Novo para adicionar uma nova variável de pipeline do tipo Array.

    Captura de tela mostrando a criação de uma nova variável de pipeline de tipo Array chamada AnimalsArray com alguns nomes de animais como seus valores.

  3. Procure por Filtrar no painel Atividades do pipeline e selecione-a para adicioná-la à tela do pipeline. Talvez seja necessário expandir a lista completa de atividades selecionando o botão + à extrema direita da barra de ferramentas.

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade Pesquisa realçadas.

  4. Selecione a nova atividade Filtro na tela se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia Configurações gerais da atividade Filtro.

Veja as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Configurações de filtro

  1. Selecione a guia Configurações, na qual você pode fornecer uma lista de matrizes de Itens e uma Condição a ser aplicada a cada item. Ambas as configurações dão suporte a conteúdo dinâmico.

    Captura de tela mostrando a guia Configurações da atividade de pesquisa destacando a guia e onde escolher uma nova conexão.

  2. Este exemplo simples filtra a matriz para cachorro, mas um uso do mundo real pode ser tão complexo quanto necessário, usando qualquer uma das funções e valores disponíveis no construtor de expressões dinâmicas. Selecione Adicionar conteúdo dinâmico para os Itens e, em seguida, selecione a guia Variáveis no Construtor de expressões de pipeline e escolha o AnimalsArray criado anteriormente. Em seguida, selecione OK.

    Captura de tela mostrando o Construtor de expressões do pipeline com o AnimalsArray criado anteriormente selecionado.

  3. Selecione Adicionar conteúdo dinâmico novamente, desta vez para a configuração Condição. A expressão item() retorna o valor do item atual à medida que a atividade Filter itera por meio da lista fornecida de itens de matriz. Usando a função equals(), podemos compará-la com o item para retornar true ou false para cada item. Somente os itens que retornam true serão incluídos na matriz de saída da atividade Filter, que pode ser usada em qualquer outra atividade.

    Captura de tela mostrando o valor de configuração de condição a ser selecionado para um animal específico.

Salvar e executar ou agendar o pipeline

Depois de adicionar outras atividades necessárias usando a matriz de saída da atividade Filtrar, alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode exibir o histórico de execuções aqui ou definir outras configurações.

Captura de tela mostrando a guia Página Inicial no editor de pipeline com o nome da guia e os botões Salvar, Executar e Agendar realçados.