Filtro

UiPath.Excel.Activities.Business.FilterX

Cria um filtro em um intervalo, tabela ou planilha com base nos valores em uma única coluna. Também pode ser usada para limpar filtros existentes. Para filtrar por várias colunas em um único intervalo/planilha/tabela, você deve usar várias atividades de filtro direcionadas para o mesmo intervalo de origem. A atividade pode ser usada com um arquivo Excel selecionado para uma atividade Use Excel File pai ou com o Project Notebook.

Quando você usa esta atividade para criar um filtro e já existe um filtro:

• Se o filtro existente for aplicado ao intervalo de origemdefinido, o filtro existente não será limpo (ambos os filtros serão aplicados).

• Se o filtro existente for aplicado fora do intervalo de origemdefinido:

  • Se o intervalo de origem definido for uma planilha ou um intervalo de células, o filtro existente será limpo e o novo filtro será aplicado.
  • Se o intervalo de origem definido for uma tabela, o filtro existente não será limpo.

Quando você usa esta atividade para limpar os filtros existentes:

• Se uma coluna for definida em Nome da coluna, apenas o filtro da coluna especificada será limpo. O intervalo de origem definido deve corresponder ao intervalo filtrado pela coluna.

• Se o nome da coluna estiver vazio:

  • Se o intervalo de origem definido for uma planilha ou um intervalo de células, todos os filtros serão removidos da planilha inteira.
  • Se o intervalo de origem definido for uma tabela, todos os filtros serão limpos apenas dessa tabela.

Para aprender a usar esta atividade, consulte o Tutorial: Filtrando Dados no Excel.

Configurando a atividade

No corpo da atividade

• Intervalo de origem - Clique em Mais no lado direito do campo, selecione o arquivo e, então, selecione um intervalo, tabela ou planilha nomeado a ser filtrado ou selecione Indicar no Excel para abrir o arquivo e selecione um intervalo diretamente a partir do arquivo. Para inserir um intervalo, tabela ou planilha manualmente, selecione Entrada personalizada.

  Ou então, você pode selecionar Abrir no editor avançado e inserir uma expressão do VB.

• Nome da coluna - Clique em Mais no lado direito do campo, selecione Intervalo e, então, selecione o cabeçalho da coluna a filtrar. Ou então, você pode selecionar Texto para inserir o valor no cabeçalho da coluna no Construtor de Texto, ou selecionar Abrir no editor avançado e inserir uma expressão do VB.
• Configurar Filtro - Clique neste botão para configurar o filtro para os valores na coluna. Você pode usar um filtro básico para inserir um ou mais valores para filtrar ou um filtro avançado para especificar condições usando operadores de comparação de maneira semelhante à configuração de um AutoFiltro personalizado no Excel.
• Limpar qualquer filtro existente - Selecione esta opção se quiser limpar os filtros existentes em vez de criar um novo. A limpeza de filtros não remove as configurações de filtro de dentro da atividade, se alguma tiver sido definida.

Painel de Propriedades

Comum

• NomeDeExibição — o nome exibido para a atividade no painel do Designer.

Entrada

• Consulte as opções no corpo da atividade.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Limpar filtros existentes - consulte Limpar filtros existentes no corpo da atividade.