Selecionar Registro do Grid

Objeto serve para selecionar o registro do grid - ERP Totvs Datasul

Visão Geral

O objeto Selecionar Registro do Grid é utilizado para selecionar uma linha específica em um grid exibido no TOTVS Datasul Interactive.

Esse objeto permite que o robô identifique um grid na interface do Datasul e selecione um registro específico com base na posição da linha, possibilitando a execução de ações posteriores sobre esse registro.

A seleção de registros é utilizada em automações que precisam interagir com dados listados em grids, como abrir detalhes de um item, executar ações sobre um registro ou navegar dentro de programas do Datasul.

---

Funcionamento

O objeto executa a seleção de um registro específico dentro de um grid presente em uma janela do Datasul.

Fluxo de execução:

1. O robô identifica a janela do Windows que contém o grid, definida no campo Selecionar Janela Windows com o Grid.

2. O grid é localizado utilizando o Xpath do Grid informado na configuração.

3. O robô identifica a linha que deve ser selecionada com base no valor definido no campo Contador de Linhas.

4. Caso a opção Desselecionar linha selecionada previamente esteja habilitada, o robô remove qualquer seleção anterior antes de selecionar a nova linha.

5. O registro correspondente à linha informada é selecionado no grid.

Quando usar

• Quando for necessário selecionar um registro específico em um grid do Datasul.

• Em automações que precisam abrir ou manipular registros listados em tabelas do sistema.

• Quando o robô precisa navegar entre registros exibidos em consultas ou relatórios do Datasul.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Pode ser alterado para facilitar a identificação.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô. Utilizado para referência em outras etapas do fluxo.
Selecionar Janela Windows com o Grid	Janela do Windows que contém o grid onde o registro será selecionado.
Xpath do Grid	Xpath utilizado para localizar o grid de dados na interface do Datasul.
Selecionar Range	Opção para selecionar um intervalo de registros no grid.
Desselecionar linha selecionada previamente	Quando habilitado, remove a seleção de qualquer linha previamente selecionada antes de selecionar a nova linha.
Contador de Linhas	Define a linha do grid que será selecionada. A contagem inicia a partir do primeiro registro exibido no grid.

---

Exemplos

Exemplo simples

Um robô executa uma consulta no Datasul e precisa selecionar o primeiro registro exibido no grid.

Configuração:

• Janela: DATASUL Interactive

• Xpath do Grid: Xpath do grid identificado na tela

• Contador de Linhas: 0

• Desselecionar linha previamente selecionada: habilitado

Fluxo:

1. O robô executa uma consulta no Datasul.

2. Os resultados são exibidos em um grid.

3. O objeto Selecionar Registro do Grid é executado.

4. O primeiro registro do grid é selecionado.

Exemplo aplicado

Automação de processamento de registros no Datasul.

Fluxo do robô:

1. Executar uma consulta que retorna uma lista de registros.

2. Utilizar o objeto Selecionar Registro do Grid para selecionar uma linha do grid.

3. Executar outras ações sobre o registro selecionado.

4. Repetir o processo para outros registros, se necessário.

---

Retornos

---

Erros comuns e como evitar

Xpath do grid incorreto

Se o Xpath não localizar corretamente o grid, o robô não conseguirá selecionar o registro.

Como evitar:

• Validar o Xpath utilizando ferramentas de inspeção da interface.

Janela incorreta

Se a janela configurada não corresponder à janela real onde o grid está presente, o objeto não conseguirá localizar os elementos necessários.

Como evitar:

• Confirmar o nome da janela correta antes de configurar o objeto.

Linha inexistente no grid

Se o valor definido no Contador de Linhas for maior que o número de registros exibidos, a seleção não será realizada.

Como evitar:

• Garantir que o grid possua registros suficientes antes de executar o objeto.

---

Boas práticas

• Validar sempre o Xpath do grid antes de utilizar o objeto em produção.

• Garantir que o grid esteja carregado completamente antes da seleção do registro.

• Utilizar a opção Desselecionar linha selecionada previamente para evitar múltiplas seleções inesperadas.

• Utilizar corretamente o contador de linhas para evitar erros de seleção.