Partilhar via


Usar a atividade Filtrar para filtrar itens de uma matriz

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

Pré-requisitos

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

Adicionar uma atividade de Filtro a um pipeline com a interface do usuário

Para utilizar uma atividade de Filtro numa pipeline, siga os seguintes passos:

Criação da atividade

  1. Crie um novo pipeline em seu espaço de trabalho.

  2. Selecione o separador Variáveis na área de definições do pipeline e depois selecione + Novo para adicionar uma nova variável de pipeline do tipo Matriz.

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

  3. Pesquise Filtro no painel de Atividades do pipeline e selecione-o para o adicionar à lona do pipeline. Talvez seja necessário expandir a lista completa de atividades selecionando o botão + na extremidade direita da barra de ferramentas.

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

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

    Captura de ecrã a mostrar o separador Definições gerais da atividade Filtro.

Consulte a orientação sobre as definições geraisdo para configurar o separador definições geral.

Configurações de filtro

  1. Selecione a guia Configurações, onde pode fornecer uma lista de array de Itens e uma Condição a ser aplicada a cada item. Ambas as configurações suportam conteúdo dinâmico.

    Captura de ecrã a mostrar o separador Definições de atividade de pesquisa a realçar o separador e onde escolher uma nova ligação.

  2. Este exemplo simples filtra a matriz para "cão", mas um uso em contexto real pode ser tão complexo como 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 do Pipelinee escolha o AnimalsArray criado anteriormente. Em seguida, selecione OK.

    Captura de ecrã mostrando o construtor de expressões do Pipeline com o AnimalsArray anteriormente criado selecionado.

  3. Selecione Adicionar conteúdo dinâmico novamente, desta vez para a configuração da Condição . A expressão item() retorna o valor do item atual à medida que a atividade Filter itera através 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 Filtro, que pode ser usada em qualquer outra atividade.

    Captura de tela mostrando o valor da configuração de condição para selecionar para um animal específico.

Guarde e execute ou agende o pipeline

Depois de adicionar quaisquer atividades adicionais necessárias usando a matriz de saída da atividade Filtro, alterne para a guia Home na parte superior do editor de pipeline e selecione o botão Salvar para salvar seu pipeline. Selecione Executar para realizar a execução direta ou Agendar para programá-la. Você também pode visualizar o histórico de execução aqui ou definir outras configurações.

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