Selecionar Elemento

Objeto utilizado para selecionar um elemento XML. Com este Objeto é possível utilizar à variável criada para os demais Objetos de XML.

Este Objeto depende do Objeto Importar XML

Visão Geral

O objeto Selecionar Elemento XML é utilizado para localizar e selecionar um elemento específico dentro da estrutura de um objeto XML.

Esse objeto permite navegar pela árvore de elementos do XML e selecionar uma tag específica para utilização em outras etapas do fluxo do robô.

A seleção do elemento ocorre a partir de um objeto XML previamente carregado ou criado, permitindo que o robô acesse partes específicas da estrutura do documento.

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

• Notas fiscais eletrônicas

• Documentos de integração entre sistemas

• Processamento de dados estruturados em XML

---

Funcionamento

O objeto executa a seleção de um elemento dentro da estrutura de um XML.

O fluxo de funcionamento ocorre da seguinte forma:

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

2. Utiliza a opção Adicionar Elemento para navegar pela estrutura do XML até localizar o elemento desejado.

3. Informa o nome da tag (Elemento) que será selecionada.

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

5. Durante a execução do robô, o sistema identifica o elemento configurado e o disponibiliza para uso em outras etapas da automação.

Quando usar

• Quando for necessário selecionar um elemento específico dentro de um XML.

• Quando o XML possui estrutura hierárquica e múltiplos elementos.

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

Quando não usar

• Quando o objetivo for capturar diretamente o valor de uma tag, sem necessidade de selecionar o elemento.

• Quando não houver necessidade de navegar pela estrutura 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 elemento selecionado dentro do fluxo do robô.
Selecionar objeto do tipo XML	Define o objeto XML que será utilizado como base para localizar o elemento.
Adicionar Elemento	Permite navegar pela estrutura do XML até localizar o elemento desejado.
Elemento	Nome da tag que será selecionada dentro do XML.
Índice	Define qual ocorrência do elemento será utilizada quando houver 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

Selecionar um elemento específico em um XML.

Fluxo:

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

2. Adicionar o objeto Selecionar Elemento XML.

3. Selecionar o objeto XML.

4. Informar o Elemento que será localizado.

5. Executar o robô para selecionar o elemento.

Exemplo aplicado

Processamento de dados de uma nota fiscal em XML.

Fluxo possível:

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

2. Utilizar Selecionar Elemento XML para localizar um grupo de dados dentro do documento.

3. Utilizar o elemento selecionado em outros objetos de leitura ou manipulação XML.

---

Retornos

O objeto retorna o elemento XML selecionado na estrutura do documento.

Esse retorno 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 à estrutura do XML
Índice incorreto	Confirmar se o índice corresponde à posição correta do elemento dentro do XML

---

Boas práticas

• Analise previamente a estrutura do XML antes de selecionar elementos.

• Utilize nomes claros no Nome Identificador do Objeto.

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

• Utilize esse objeto para navegar pela estrutura do XML antes de executar operações de leitura ou manipulação.