Pegar Valor do Campo

Objeto que permite pegar o valor de um campo específico nos objetos encontrados na janela SAP

Visão Geral

O objeto Pegar Valor do Campo é utilizado para capturar o valor de um elemento da interface do SAP durante a execução de um robô.

Esse objeto permite que a automação leia informações exibidas em campos da interface do SAP, como valores de entrada, resultados de consultas ou dados apresentados em formulários. A identificação do elemento é realizada por meio de XPath, permitindo que o robô localize o componente e capture seu conteúdo.

O valor capturado pode ser utilizado em etapas posteriores da automação para validações, armazenamento ou processamento de dados.

---

Funcionamento

O objeto Pegar Valor do Campo captura o conteúdo exibido em um elemento da interface do SAP.

Fluxo de funcionamento:

1. O robô executa o objeto Pegar Valor do Campo.

2. O campo Selecionar objeto do tipo Automação SAP define o objeto responsável pela automação e conexão com o SAP.

3. O campo Selecionar tipo de elemento define o tipo de componente SAP que será acessado.

4. O campo XPath identifica o elemento dentro da interface do SAP.

5. O campo Tempo máximo de espera (em segundos) define o tempo máximo que o robô aguardará até que o elemento esteja disponível.

6. O sistema localiza o elemento na interface.

7. O valor do campo é capturado e disponibilizado para uso dentro da automação.

Opções adicionais podem definir o comportamento da captura:

• Retornar Conteúdo: retorna o valor contido no campo.

• Tipo do Conteúdo: permite identificar o tipo do conteúdo capturado.

Quando usar

• Quando for necessário capturar valores exibidos em campos do SAP.

• Quando o robô precisar ler informações exibidas na interface do sistema.

• Quando processos automatizados exigirem extração de dados da tela do SAP.

Quando não usar

Não utilizar quando não houver necessidade de capturar informações da interface ou quando os dados já estiverem disponíveis em outras etapas do processo.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô.
Selecionar objeto do tipo Automação SAP	Define o objeto responsável pela automação do SAP.
Selecionar tipo de elemento	Define o tipo de componente SAP que será acessado.
XPath	Caminho utilizado para localizar o elemento na interface do SAP.
Tempo máximo de espera (em segundos)	Define o tempo máximo que o robô aguardará até que o elemento esteja disponível.
Retornar Conteúdo	Define se o valor contido no campo será retornado.
Tipo do Conteúdo	Permite identificar o tipo do conteúdo capturado.

---

Exemplos

Exemplo simples

Fluxo básico para capturar um valor de um campo no SAP:

1. Inserir o objeto Pegar Valor do Campo no fluxo do robô.

2. Selecionar o objeto de Automação SAP configurado.

3. Informar o XPath do campo que será lido.

4. Executar o robô.

Após a execução, o valor exibido no campo será capturado e poderá ser utilizado no fluxo da automação.

Exemplo aplicado

Cenário: um robô precisa capturar o número de um documento exibido em uma tela do SAP.

Fluxo:

1. O robô acessa a transação correspondente.

2. O objeto Pegar Valor do Campo localiza o campo contendo o número do documento.

3. O robô captura o valor exibido.

4. O valor capturado é utilizado em etapas posteriores da automação, como registro em arquivo ou validação de dados.

---

Retornos

---

Erros comuns e como evitar

XPath incorreto

Se o XPath informado não corresponder ao elemento da interface, o robô não conseguirá localizar o campo.

Como evitar:

• Validar o XPath antes da execução.

Elemento não disponível

Se o campo ainda não estiver carregado na tela, o robô poderá falhar ao tentar capturar o valor.

Como evitar:

• Configurar um tempo de espera adequado.

Objeto de Automação SAP não configurado

Sem o objeto de automação SAP, a interação com a interface não será possível.

Como evitar:

• Garantir que o objeto de automação SAP esteja corretamente configurado.

---

Boas práticas

• Validar previamente o XPath utilizado para identificar o campo.

• Garantir que a tela do SAP esteja completamente carregada antes da captura do valor.

• Utilizar nomes claros no campo Título para facilitar a manutenção do fluxo.

• Utilizar o valor capturado para validações e controle do fluxo da automação.