Filtrar Tabela de Dados

UiPath.Core.Activities.FilterDataTable

Permite filtrar uma variável DataTable especificando condições na janela Assistente de Filtro. A atividade pode manter ou excluir linhas e colunas de acordo com as condições lógicas especificadas no assistente. O corpo da atividade contém um botão do Assistente de Filtro para você poder acessar o assistente e personalizar suas configurações a qualquer momento.

Importante: devido a alterações internas, esta atividade não está mais visível na lista de favoritos ao atualizar para a versão 20.4 ou mais recente, caso tenha sido adicionada à lista de favoritos com uma versão 19.4 ou mais antiga do UiPath.System.Activities.

Compatibilidade do projeto

Windows - Legado | Plataforma cruzada

Configuração multiplataforma

Propriedades

• TabelaDeDados — a variável DataTable que você deseja filtrar. Este campo é compatível apenas com variáveis DataTable.
• Condições de filtro - As condições usadas para filtrar a tabela de dados.

Opções avançadas

• Ação — especifica se a tabela deve ser filtrada mantendo ou removendo as linhas de destino.
• Tabela de dados filtrados - A tabela de dados filtrados resultante.

• Primeira linha — a primeira linha da tabela de dados que corresponde aos filtros configurados.

  
  

  

  
  

Windows - Legada, Configuração do Windows

Propriedades

Comum

• DisplayName - O nome de exibição da atividade. Este campo suporta apenas strings ou variáveis String .

Entrada

• TabelaDeDados — a variável DataTable que você deseja filtrar. Este campo é compatível apenas com variáveis DataTable.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• FilterRowsMode - especifica se deve filtrar a tabela mantendo ou removendo as linhas de destino. Selecione uma das duas opções no menu suspenso: Manter ou Remover. O valor padrão é Manter.
• SelecionarModoDeColunas — especifica se a tabela deve ser filtrada mantendo ou removendo as colunas de destino. Selecionar uma das duas opções do menu suspenso: Manter ou Remover. O valor padrão é Manter.

Saída

• TabelaDeDados — a variável filtrada DataTable resultante. Usar a mesma variável que aquela presente no campo Entrada substitui a variável inicial, enquanto adicionar uma nova variável não afeta a variável inicial. Este campo é compatível apenas com variáveis DataTable.
  Observação:

  • Se você copiar e colar uma atividade Filter Data Table personalizada dentro do painel Designer, ela não reterá sua configuração.
  • Intervalos do Excel não são compatíveis como entrada para esta atividade.

Assistente de Filtro

Este assistente ajuda a construir as opções de filtro para uma variável DataTable. Ele pode ser aberto usando o botão do Assistente de Filtro no corpo da atividade no painel Designer. Você pode selecionar a DataTable que você deseja modificar, bem como aquela em que você deseja salvar as alterações, usando os seguintes campos:

• Tabela de dados de entrada — a variável DataTable que você deseja filtrar. Este campo é compatível apenas com variáveis DataTable.
• Tabela de dados de saída — a variável DataTable de saída. Se a mesma variável presente no campo Entrada for usada, ela será substituída com as alterações. Fornecer uma variável diferente não modifica a variável Entrada.

Você também pode escolher filtrar por Linha ou por Coluna, dependendo da guia que você selecionar. Existem duas abas, como mostrado a seguir:

Descrições dos campos na aba Filtrar Linhas

A aba Filtrar Linhas permite filtrar uma DataTable por Linhas. Para fazer isso, você tem as seguintes opções:

1. Manter ou remover linhas correspondentes — especifica se as linhas devem ser filtradas mantendo ou removendo-as. Isso pode ser feito escolhendo entre os botões Manter ou Remover Selecionar Manter mantém apenas as linhas que atendem à condição especificada, enquanto selecionar Remover remove as linhas que atendem à condição especificada.
2. E/Ou — especifica as conjunturas lógicas a serem usadas entre condições. Este botão é exibido apenas se você tem mais de uma condição. Por padrão, quando você adiciona uma nova condição, o botão é exibido como E. Clique no botão para alterar seu valor para Ou.
3. Coluna — o nome ou índice da coluna que deve atender à condição.
4. Operação — a condição lógica que deve ser atendida entre a Coluna e o Valor.
5. Valor — o valor a ser verificado com a Operação e a Coluna.
6. Adicionar/Remover condição — clicar no botão + adiciona outra sentença para a condição, enquanto clicar no botão x remove uma sentença.
   Observação: ao fornecer uma variável na caixa de texto Coluna, você pode usar uma variável Int32 para especificar o índice da coluna, ou uma variável String para especificar o nome da coluna.

Saída

A guia Colunas de Saída permite filtrar uma DataTable por Colunas. Para fazer isso, você tem as seguintes opções:

1. Modo de seleção de colunas — especifica se as colunas devem ser filtradas, mantendo ou removendo-as. Isso pode ser feito escolhendo entre os botões Manter ou Remover Selecionar Manter mantém apenas as colunas que são especificadas abaixo, enquanto selecionar Remover exclui as linhas que são especificadas abaixo da DataTable de entrada.
2. Coluna — as colunas que você quer manter ou remover da DataTable.
   Observação: ao fornecer uma variável na caixa de texto Coluna, você pode usar uma variável Int32 para especificar o índice da coluna, ou uma variável String para especificar o nome da coluna.
3. Adicionar/Remover colunas — clicar no botão + adiciona outra coluna, enquanto pressionar o botão x remove a coluna.
   Observação: a ordem em que você adiciona as colunas no Assistente é a ordem das colunas na tabela de saída.

Exemplo de uso da atividade Filter Data Table

Aqui você pode ver como a atividade Filter Data Table é usada em um exemplo que incorpora várias atividades.