Ler Coluna
Realiza a leitura de uma coluna da tabela de dados
Visão Geral
O objeto Ler Coluna é utilizado para obter o valor de uma coluna específica em uma linha de uma Tabela de Dados durante a execução de um robô.
Esse objeto permite acessar informações armazenadas em uma DataTable, possibilitando que o robô utilize os valores de determinadas colunas para realizar validações, decisões ou operações em etapas posteriores do fluxo.
O valor lido é armazenado em uma variável de saída, que poderá ser utilizada em outros objetos da automação.
Funcionamento
O objeto Ler Coluna permite acessar o valor de uma coluna específica em uma linha de uma Tabela de Dados.
Fluxo de funcionamento:
O robô executa uma etapa anterior que cria ou carrega uma Tabela de Dados.
O robô percorre ou seleciona uma linha da tabela (DataRow).
O objeto Ler Coluna recebe essa linha através do campo Selecionar linha (DataRow).
O campo Nome da Coluna define qual coluna será lida.
O valor encontrado é armazenado na variável de saída configurada.
Após a execução, o valor da coluna pode ser utilizado em outras etapas da automação.
Quando usar
Quando for necessário acessar valores específicos de uma Tabela de Dados.
Quando o robô precisar ler dados de uma coluna durante o processamento de registros.
Quando processos automatizados exigirem extração de informações de tabelas de dados.
Quando não usar
Não utilizar quando não houver uma Tabela de Dados previamente criada ou carregada, ou quando não existir uma linha selecionada (DataRow) para leitura.
Configuração
Título
Nome do objeto dentro do fluxo do robô.
Nome da variável de saída
Variável que armazenará o valor da coluna lida.
Selecionar linha (DataRow)
Define a linha da tabela que será utilizada para leitura do valor.
Nome da Coluna
Nome da coluna da qual o valor será obtido.
Exemplos
Exemplo simples
Fluxo básico para ler um valor de uma tabela:
Inserir um objeto que carregue dados em uma Tabela de Dados.
Percorrer os registros da tabela utilizando um objeto de iteração.
Inserir o objeto Ler Coluna dentro do fluxo.
Selecionar a linha atual (DataRow).
Informar o Nome da Coluna.
Executar o robô.
Após a execução, o valor da coluna será armazenado na variável de saída.
Exemplo aplicado
Cenário: um robô precisa verificar o status de registros carregados de um arquivo.
Fluxo:
O objeto Carregar Arquivo importa dados para uma Tabela de Dados.
O robô percorre cada linha da tabela.
O objeto Ler Coluna lê o valor da coluna Status.
O robô utiliza esse valor para decidir qual ação executar.
Retornos
Erros comuns e como evitar
Linha (DataRow) não selecionada
Ocorre quando nenhuma linha da tabela é definida no campo Selecionar linha (DataRow).
Como evitar:
Garantir que uma linha válida da tabela esteja selecionada.
Nome da coluna incorreto
Se o nome informado não corresponder a uma coluna existente na tabela, o valor não poderá ser lido.
Como evitar:
Confirmar que o nome da coluna corresponde exatamente ao nome definido na tabela.
Boas práticas
Garantir que a Tabela de Dados esteja corretamente estruturada antes de realizar a leitura.
Utilizar nomes claros para as colunas da tabela.
Utilizar variáveis de saída com nomes descritivos para facilitar a manutenção da automação.
Utilizar a leitura de colunas dentro de loops ou processos que percorrem registros da tabela.
Last updated
Was this helpful?