Lookup Data Table

UiPath.Core.Activities.LookupDataTable

Description

Essa atividade emula o comportamento da fórmula VLOOKUP do Excel. Ele permite pesquisar um valor fornecido em uma DataTable especificada e retorna o ÍndiceDeLinha no qual ele foi encontrado. Se o valor fornecido não for localizado, então o ÍndiceDeLinha retornado será -1. Esta atividade também pode ajudar a retornar o valor encontrado na célula que possui as coordenadas de linha especificadas na propriedade ÍndiceDeLinha e as coordenadas de coluna especificadas na categoria de propriedade Coluna de Destino .

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Encontrar Este Valor — O valor que você deseja pesquisar na TabelaDeDados. Suporta apenas valores de String.
• Nesta tabela de dados — a TabelaDeDados em que a pesquisa é executada.
• No nome da coluna — o nome da coluna que você deseja pesquisar na TabelaDeDados definida acima. Você pode alternar entre o uso de um Nome da coluna ou Número da coluna no menu "+" ao lado do campo de entrada.
• Retornar valor do nome da coluna — retorna o valor da célula localizada nas coordenadas entre esse valor e a propriedade ÍndiceDeLinha. Se a coluna de destino não estiver definida, o valor da célula será nulo. Você pode alternar entre usando Retornar valor do nome da coluna ou Retornar valor do número da coluna no menu "+" ao lado do campo de entrada.

No painel Propriedades

Saída

• Found Cell Value - The value found in the cell that has the Row coordinates specified in the RowIndex property and the column coordinates specified in the Target Column property category. The output type matches the source data type and is resolved dynamically during runtime based on the source DataTable. To avoid issues with type conversion, please make sure the variable assigned to this property matches the expected variable type of the source DataTable.
• Número da linha encontrada - O número da linha da célula encontrada.

Windows, Windows - configuração herdada

Painel de Propriedades

Comum

• DisplayName - O nome de exibição da atividade.

Entrada

• TabelaDeDados — a variável DataTable em que você deseja executar a pesquisa. Este campo é compatível apenas com variáveis DataTable.
• LookupValue — o valor pelo qual você deseja pesquisar na variável DataTable especificada. Este campo é compatível apenas com strings e variáveis String.

Pesquisar Coluna

• Coluna — a variável que contém a coluna pela qual você deseja pesquisar. Este campo é compatível apenas com variáveis DataColumn. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.
• ÍndiceDeColuna — o índice da coluna pela qual você deseja pesquisar. Este campo é compatível apenas com variáveis Int32. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.
• NomeDaColuna — o nome da coluna pela qual você deseja pesquisar. Este campo é compatível apenas com strings e variáveis String. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.

Diversos

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

Saída

• ValorDaCélula — opcional. O valor encontrado na célula que tem as coordenadas de Linha especificadas na propriedade RowIndex e as coordenadas de coluna especificadas na categoria de propriedade Coluna de Destino. O tipo de saída corresponde ao tipo de dados de origem e é resolvido dinamicamente durante o runtime com base na TabelaDeDados de origem. Para evitar problemas com conversão de tipo, certifique-se de que a variável atribuída a esta propriedade corresponda ao tipo de variável esperado da TabelaDeDados de origem.
• ÍndiceDeLinha — o índice da linha da célula localizada, armazenado em uma variável Int32. Se o valor fornecido não for localizado, o índice de linha será -1. Este campo é compatível apenas com variáveis Int32.

Coluna de Destino

• Coluna — especificar uma variável DataColumn aqui retorna o valor da célula localizada nas coordenadas entre esta coluna e o valor da propriedade ÍndiceDeLinha. Este campo é compatível apenas com variáveis DataColumn. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.
• ÍndiceDeLinha — especificar um índice de coluna aqui retorna o valor da célula localizada nas coordenadas entre esta coluna e o valor da propriedade ÍndiceDeLinha. Este campo é compatível apenas com variáveis Int32. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.
• NomeDaColuna — especificar um nome de coluna aqui retorna o valor da célula localizada nas coordenadas entre esta coluna e o valor da propriedade ÍndiceDeLinha. Este campo é compatível apenas com strings e variáveis String. Definir uma variável nesta propriedade de campo desabilita as outras duas propriedades.