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:

• If the existing filter is applied to the defined source range, the existing filter is not cleared (both filters are applied).
• If the existing filter is applied outside of the defined source range:
  • 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:

• If a column is defined in Column name, only the filter from the specified column is cleared. The defined source range must match the range filtered by the column.
• If Column name is empty:
  • 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 saber como usar essa atividade, consulte Tutorial: filtragem de 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.
• Configure Filter - Click this button to configure the filter for the values in the column. You can use a basic filter to enter one or more values to filter on, or an advanced filter to specify conditions using comparison operators in a similar way to how you configure a Custom AutoFilter in Excel.
• Clear any existing filter - Select this option if you want to clear existing filters instead of creating a new one. Clearing filters does not remove filter configurations from inside the activity, if any were defined.

Painel de Propriedades

Comum

• DisplayName - The name displayed for the activity in the Designer panel.

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.