Filtro

UiPath.Excel.Activities.Business.FilterX

Description

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

Painel do Designer

• Source range - Select Plus on the right side of the field, select the file, and then select a named range, table, or sheet to filter, or select Indicate in Excel to open the file and select a range directly from the file. To enter a range, table, or sheet manually, select Custom Input. Alternatively, you can select Open in Advanced Editor and enter a VB expression.
• Column name - Select Plus on the right side of the field, select Range, and then select the header of the column to filter on. Alternatively, you can select Text to enter the value in the column header in the Text Builder, or select Open in Advanced Editor and enter a VB expression.
• Configure Filter - Select 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.