Compartilhar via


Usar a atividade Filtrar 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 Filtrar a um pipeline com interface do usuário

Para usar uma atividade Filter em um pipeline, siga estas etapas:

Criando a atividade

  1. Crie um pipeline no seu workspace.

  2. Selecione a guia Variáveis nas configurações do pipeline e, em seguida, selecione + Novo, para adicionar um novo pipeline do tipo Matriz.

    Screenshot showing the creation of a new Array type pipeline variable called AnimalsArray with some animal names as its values.

  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 + na extrema direita da barra de ferramentas.

    Screenshot of the Fabric UI with the Activities pane and Lookup activity highlighted.

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

    Screenshot showing the General settings tab of the Filter activity.

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

    Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

  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. Depois, selecione OK.

    Screenshot showing the Pipeline expression builder with the previously created AnimalsArray selected.

  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 Filtrar itera pela 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 Filtrar, que pode ser usada em qualquer outra atividade.

    Screenshot showing the Condition setting value to select for a specific animal.

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.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.