Ler Atributos do Elemento

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

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

Visão Geral

O objeto Ler Atributos do Elemento XML é utilizado para percorrer elementos de um XML e acessar os atributos associados a cada elemento.

Esse objeto funciona como uma estrutura de repetição, permitindo iterar sobre os elementos presentes em um objeto XML e ler os atributos disponíveis em cada item.

Durante a execução do robô, os atributos identificados podem ser utilizados dentro do fluxo da automação para processamento, validação ou armazenamento de dados presentes no XML.

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

• Notas fiscais eletrônicas

• Documentos de integração entre sistemas

• Arquivos XML com múltiplos elementos ou registros

---

Funcionamento

O objeto executa uma estrutura de repetição baseada nos elementos de um objeto XML, permitindo acessar os atributos de cada elemento.

O fluxo de funcionamento ocorre da seguinte forma:

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

2. Define a variável de repetição, que será utilizada para percorrer os elementos do XML.

3. Configura o contador de linhas, que controla o processo de iteração.

4. Durante a execução do robô, o sistema percorre os elementos do XML e disponibiliza os atributos associados a cada elemento.

Essa abordagem permite tratar dinamicamente arquivos XML que possuem listas de elementos ou estruturas repetitivas.

Quando usar

• Quando for necessário percorrer elementos de um XML e acessar seus atributos.

• Quando o XML possui múltiplos registros ou elementos repetidos.

• Em automações que processam listas de dados dentro de arquivos XML.

Quando não usar

• Quando o XML possui apenas um único elemento sem repetição.

• Quando não é necessário acessar atributos de elementos XML.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Permite identificar a etapa da automação.
Nome Identificador da Variável de Repetição	Variável utilizada para percorrer os elementos do XML durante o processo de repetição.
Selecionar objeto do tipo XML	Define o objeto XML que será utilizado como base para leitura dos atributos.
Contador de Linhas	Variável utilizada para controlar a contagem de elementos percorridos durante a repetição.
Valor inicial do contador	Define o valor inicial utilizado no contador de linhas.
Incremento do contador	Define o valor que será incrementado no contador a cada iteração da repetição.

Observação:

• O objeto funciona como estrutura de repetição baseada na quantidade de elementos presentes no XML.

---

Estrutura de Bloco

Este objeto cria uma estrutura de bloco de repetição, onde as ações internas são executadas para cada elemento do XML.

Dentro desse bloco é possível adicionar outros objetos para processar os atributos lidos durante cada iteração.

---

Exemplos

Exemplo simples

Percorrer elementos de um XML e acessar seus atributos.

Fluxo:

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

2. Adicionar o objeto Ler Atributos do Elemento XML.

3. Selecionar o objeto XML.

4. Definir a variável de repetição.

5. Executar o robô para percorrer os elementos do XML.

Exemplo aplicado

Processamento de itens de uma nota fiscal em XML.

Fluxo possível:

1. Receber o arquivo XML da nota fiscal.

2. Utilizar um objeto para localizar os elementos de itens da nota.

3. Utilizar Ler Atributos do Elemento XML para percorrer cada item.

4. Durante cada iteração:

   • Ler atributos do item

   • Processar os dados

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

---

Retornos

Durante cada iteração da repetição, os atributos do elemento XML atual ficam disponíveis para utilização dentro do fluxo do robô através da variável de repetição configurada.

---

Erros comuns e como evitar

Erro	Como evitar
Objeto XML não selecionado	Garantir que um objeto XML válido esteja definido no campo Selecionar objeto do tipo XML
Variável de repetição incorreta	Verificar se o Nome Identificador da Variável de Repetição foi configurado corretamente
Contador configurado incorretamente	Garantir que o valor inicial e incremento do contador estejam definidos corretamente

---

Boas práticas

• Utilize nomes claros para a variável de repetição.

• Configure corretamente o contador de linhas para controlar a iteração.

• Utilize o bloco de repetição para processar cada elemento do XML de forma organizada.

• Combine este objeto com outros objetos de manipulação de XML para extrair e tratar os dados.