Varrer Dados Tabela
Pesquisa todos os dados de uma tabela de dados.
Visão Geral
O objeto Varrer Dados Tabela é utilizado para percorrer os registros de uma Tabela de Dados durante a execução de um robô.
Esse objeto permite iterar por cada linha de uma DataTable, possibilitando que o robô processe individualmente os registros armazenados na tabela. Durante a execução, cada linha pode ser acessada por meio de uma variável de iteração, permitindo manipulação ou leitura dos dados.
Essa funcionalidade é frequentemente utilizada em automações que precisam processar listas de registros, como dados importados de arquivos, resultados de consultas ou informações geradas ao longo da execução.
Funcionamento
O objeto Varrer Dados Tabela executa uma iteração sobre os registros de uma Tabela de Dados.
Fluxo de funcionamento:
O robô executa uma etapa anterior que cria ou carrega uma Tabela de Dados.
O objeto Varrer Dados Tabela seleciona a tabela através do campo Selecionar tabela.
O campo Nome da variável de iteração define a variável que representará cada linha da tabela durante o processamento.
O objeto utiliza um contador para controlar a progressão da iteração.
Para cada registro da tabela, o robô executa as ações definidas dentro do bloco de execução.
Durante a execução, cada linha da tabela pode ser acessada e manipulada utilizando a variável de iteração configurada.
Quando usar
Quando for necessário percorrer todos os registros de uma Tabela de Dados.
Quando o robô precisar processar dados linha por linha.
Quando processos automatizados exigirem tratamento sequencial de registros.
Quando não usar
Não utilizar quando não houver uma Tabela de Dados previamente criada ou carregada, ou quando não for necessário processar os registros individualmente.
Configuração
Título
Nome do objeto dentro do fluxo do robô.
Nome da variável de iteração
Variável utilizada para representar cada linha da tabela durante a iteração.
Selecionar tabela
Define a Tabela de Dados que será percorrida pelo robô.
Nome identificador do contador
Nome da variável utilizada para controlar o contador da iteração.
Valor inicial do contador
Define o valor inicial do contador utilizado na iteração.
Incremento do contador
Define o valor de incremento aplicado ao contador a cada iteração.
Estrutura de Bloco
O objeto Varrer Dados Tabela executa um bloco de ações para cada registro da tabela.
Durante cada iteração:
A variável de iteração representa a linha atual da tabela.
O contador indica a posição atual da iteração.
As ações configuradas dentro do bloco são executadas para cada registro.
Isso permite que o robô processe os dados da tabela de forma estruturada.
Exemplos
Exemplo simples
Fluxo básico para percorrer os registros de uma tabela:
Inserir um objeto que carregue dados em uma Tabela de Dados.
Inserir o objeto Varrer Dados Tabela.
Selecionar a tabela no campo Selecionar tabela.
Definir a variável de iteração.
Inserir ações dentro do bloco para processar cada registro.
Executar o robô.
Após a execução, o robô percorrerá todos os registros da tabela.
Exemplo aplicado
Cenário: um robô precisa processar uma lista de clientes carregada de um arquivo.
Fluxo:
O objeto Carregar Arquivo importa os dados para uma Tabela de Dados.
O objeto Varrer Dados Tabela percorre cada linha da tabela.
Para cada registro, o robô lê os dados do cliente utilizando objetos como Ler Coluna.
O robô executa operações no sistema com base nas informações da tabela.
Retornos
Erros comuns e como evitar
Tabela não selecionada
Ocorre quando nenhuma tabela é definida no campo Selecionar tabela.
Como evitar:
Garantir que uma Tabela de Dados válida esteja selecionada.
Tabela inexistente no fluxo
Se a tabela não tiver sido criada ou carregada anteriormente, a iteração não poderá ser realizada.
Como evitar:
Utilizar objetos como Criar Tabela ou Carregar Arquivo antes da execução.
Variável de iteração não configurada
Sem a variável de iteração, o robô não poderá acessar os registros da tabela.
Como evitar:
Definir corretamente a variável de iteração antes da execução.
Boas práticas
Utilizar o objeto após importar ou gerar dados em uma Tabela de Dados.
Utilizar objetos como Ler Coluna dentro da iteração para acessar os valores da tabela.
Manter nomes claros para variáveis de iteração e contadores.
Evitar operações pesadas dentro do loop para manter o desempenho da automação.
Last updated
Was this helpful?