Obter Valor do Elemento

Objeto utilizado para realizar a busca de elemento e atribuir o valor em uma variável

Este Objeto depende dos Objetos, como: Importar XML e Selecionar Elemento

Visão Geral

O objeto Obter Valor do Elemento é utilizado para capturar o valor de um elemento (tag) específico dentro de um arquivo XML.

Esse objeto permite localizar um elemento na estrutura do XML e retornar o conteúdo textual presente dentro da tag, possibilitando que esse valor seja utilizado em outras etapas do fluxo do robô.

A leitura ocorre a partir de um objeto XML previamente carregado ou criado, permitindo que o robô acesse informações estruturadas presentes no documento.

Esse recurso é frequentemente utilizado em automações que processam arquivos XML estruturados, como:

• Notas fiscais eletrônicas

• Arquivos de integração entre sistemas

• Documentos estruturados em XML

---

Funcionamento

O objeto executa a leitura do conteúdo de um elemento dentro da estrutura de um XML.

O fluxo de funcionamento ocorre da seguinte forma:

1. O usuário seleciona um objeto do tipo XML previamente criado ou carregado no fluxo.

2. Opcionalmente define a estrutura de elementos dentro do XML utilizando a opção Adicionar Elemento.

3. Informa o nome do elemento (tag) que será localizado.

4. Define o índice do elemento, caso existam múltiplas ocorrências da mesma tag.

5. Durante a execução do robô, o sistema localiza o elemento correspondente e retorna o valor contido dentro da tag.

Quando usar

• Quando for necessário capturar o valor contido dentro de uma tag de um XML.

• Quando o XML possui elementos que armazenam informações importantes dentro de suas tags.

• Em automações que processam dados estruturados em XML.

Quando não usar

• Quando o valor desejado estiver em atributos do elemento, e não no conteúdo da tag.

• Quando não existir a necessidade de capturar valores específicos de elementos do XML.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Permite identificar a etapa da automação.
Nome Identificador do Objeto	Identificador utilizado para acessar o valor retornado pelo objeto dentro do fluxo do robô.
Selecionar objeto do tipo XML	Define o objeto XML que será utilizado como base para leitura do elemento.
Adicionar Elemento	Permite definir elementos dentro da estrutura do XML para navegar até o elemento desejado.
Elemento	Nome da tag que será utilizada para localizar o valor dentro do XML.
Índice	Define qual ocorrência do elemento será utilizada quando existirem múltiplas tags com o mesmo nome.

Observação:

• O campo Índice permite selecionar a posição do elemento quando houver mais de uma ocorrência da mesma tag no XML.

---

Exemplos

Exemplo simples

Obter o valor de uma tag em um XML.

Fluxo:

1. Carregar ou criar um objeto XML no robô.

2. Adicionar o objeto Obter Valor do Elemento.

3. Selecionar o objeto XML.

4. Informar o Elemento que será localizado.

5. Executar o robô para capturar o valor da tag.

Exemplo aplicado

Capturar informações de uma nota fiscal em XML.

Fluxo possível:

1. Receber o XML da nota fiscal no robô.

2. Utilizar Obter Valor do Elemento para localizar elementos como:

   • Número da nota

   • Valor total

   • Data de emissão

3. Utilizar os valores capturados para validação ou integração com outros sistemas.

---

Retornos

O objeto retorna o valor contido dentro do elemento XML localizado.

Esse valor pode ser utilizado em outros objetos do fluxo através do Nome Identificador do Objeto configurado.

---

Erros comuns e como evitar

Erro	Como evitar
Objeto XML não selecionado	Garantir que um objeto XML válido esteja configurado
Elemento não encontrado	Verificar se o nome da tag corresponde exatamente ao elemento presente no XML
Índice incorreto	Confirmar se o índice corresponde à posição correta do elemento dentro do XML

---

Boas práticas

• Verifique previamente a estrutura do XML antes de configurar a leitura do elemento.

• Utilize nomes claros para o Nome Identificador do Objeto.

• Utilize corretamente o índice do elemento quando houver múltiplas ocorrências da mesma tag.

• Combine este objeto com outros objetos de manipulação de XML para processar dados de forma estruturada.