Ler Elementos

Objeto utilizado para criar um laço de repetição sobre um elemento do XML possibilitando a leitura de todos elementos filhos.

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

*O Objeto Selecionar Elemento não é obrigatório.

Visão Geral

O objeto Ler Elementos XML é utilizado para percorrer e acessar elementos dentro da estrutura de um arquivo XML.

Esse objeto permite localizar elementos específicos através do nome da tag e atributos associados, criando uma lista de elementos encontrados que pode ser percorrida durante a execução do robô.

O objeto também cria uma estrutura de repetição, permitindo que cada elemento encontrado seja processado individualmente dentro do fluxo da automação.

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

• Notas fiscais eletrônicas

• Arquivos de integração entre sistemas

• Documentos estruturados em XML

---

Funcionamento

O objeto executa a leitura de elementos presentes em um objeto XML, utilizando critérios definidos na configuração.

O fluxo de funcionamento ocorre da seguinte forma:

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

2. Define o nome da tag que será utilizada para localizar os elementos.

3. Opcionalmente informa um atributo e valor de atributo para refinar a busca.

4. O sistema localiza os elementos correspondentes dentro da estrutura do XML.

5. Os elementos encontrados são armazenados em uma lista de elementos.

6. O objeto cria uma estrutura de repetição, permitindo percorrer cada elemento encontrado durante a execução do robô.

A opção Montar árvore de elementos permite estruturar os resultados considerando a hierarquia dos elementos dentro do XML.

Quando usar

• Quando for necessário percorrer elementos específicos dentro de um XML.

• Quando o XML possui listas de elementos repetidos.

• Em automações que precisam processar múltiplos registros dentro de um XML.

Quando não usar

• Quando o XML possui apenas um único elemento que não exige repetição.

• Quando não há necessidade de percorrer múltiplos elementos do documento.

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Define a versão do componente utilizada pelo objeto.
Título	Nome do objeto dentro do fluxo do robô. Permite identificar a etapa da automação.
Selecionar objeto do tipo XML	Define o objeto XML que será utilizado como base para leitura dos elementos.
Montar árvore de elementos	Quando habilitado, organiza os elementos encontrados respeitando a hierarquia da estrutura XML.
Nome da Tag	Nome da tag que será utilizada para localizar os elementos dentro do XML.
Nome do Atributo	Nome do atributo que será utilizado como critério adicional de busca.
Valor do Atributo	Valor correspondente ao atributo informado para refinar a busca.
Nome Identificador da Variável de Repetição	Variável utilizada para percorrer os elementos encontrados durante a repetição.
Lista de Elementos	Variável que armazenará a lista de elementos encontrados no XML.
Contador de Linhas	Variável utilizada para controlar o processo de repetição.
Valor inicial do contador	Define o valor inicial do contador utilizado na repetição.
Incremento do contador	Define o valor que será incrementado no contador a cada iteração.

Observação:

• O objeto cria automaticamente uma estrutura de repetição baseada na lista de elementos encontrados no XML.

---

Estrutura de Bloco

Este objeto cria um bloco de repetição, onde cada iteração corresponde a um elemento encontrado no XML.

Dentro desse bloco é possível adicionar outros objetos para processar cada elemento identificado no XML.

---

Exemplos

Exemplo simples

Percorrer elementos de um XML.

Fluxo:

1. Carregar um arquivo XML no robô.

2. Adicionar o objeto Ler Elementos XML.

3. Selecionar o objeto XML.

4. Informar o Nome da Tag que será localizada.

5. Executar o robô para percorrer os elementos encontrados.

Exemplo aplicado

Processamento de itens de uma nota fiscal em XML.

Fluxo possível:

1. Receber o XML da nota fiscal.

2. Utilizar Ler Elementos XML para localizar os elementos de itens da nota.

3. O objeto cria uma lista de elementos encontrados.

4. Durante cada iteração:

   • Ler informações do item

   • Processar os dados

   • Registrar informações em banco de dados ou sistema externo.

---

Retornos

O objeto retorna uma lista de elementos encontrados no XML.

Essa lista é armazenada na variável definida no campo Lista de Elementos, e cada elemento pode ser processado dentro do bloco de repetição criado pelo objeto.

---

Erros comuns e como evitar

Erro	Como evitar
Objeto XML não selecionado	Garantir que um objeto XML válido esteja configurado
Tag não encontrada	Verificar se o Nome da Tag corresponde à estrutura real do XML
Atributo configurado incorretamente	Confirmar se o Nome do Atributo e Valor do Atributo estão corretos
Repetição não executada	Verificar se a lista de elementos foi corretamente gerada

---

Boas práticas

• Utilize o Nome da Tag correto conforme a estrutura do XML.

• Utilize filtros por atributo e valor de atributo quando necessário.

• Defina nomes claros para variáveis de repetição e listas de elementos.

• Utilize o bloco de repetição para organizar o processamento de cada elemento.