Obter Valor do Atributo

Objeto utilizado para guardar o valor do atributo de um elemento em uma variável

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

Visão Geral

O objeto Obter Valor do Atributo é utilizado para capturar o valor de um atributo específico dentro de um elemento XML.

Esse objeto permite acessar atributos presentes em elementos da estrutura XML e disponibilizar seu valor para uso dentro do fluxo do robô.

A leitura do atributo ocorre a partir de um objeto XML previamente carregado ou criado, permitindo que o robô utilize o valor capturado em validações, integrações ou outras etapas do processo automatizado.

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 valor de um atributo presente em um elemento XML.

O fluxo de funcionamento ocorre da seguinte forma:

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

2. Opcionalmente define um elemento dentro da estrutura XML.

3. Informa o nome do atributo que será lido.

4. Durante a execução do robô, o sistema localiza o atributo informado e retorna seu valor.

Caso nenhum elemento seja definido na árvore de elementos, o sistema utilizará automaticamente a tag raiz do XML para realizar a leitura do atributo.

Quando usar

• Quando for necessário capturar o valor de um atributo específico em um XML.

• Quando o XML possui atributos associados aos elementos.

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

Quando não usar

• Quando o valor desejado estiver dentro de tags e não em atributos.

• Quando o XML não possuir atributos associados aos elementos.

---

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 para localizar o atributo.
Adicionar Elemento	Permite especificar um elemento dentro da estrutura do XML onde o atributo será buscado.
Nome do Atributo	Nome do atributo que terá seu valor capturado.

Observação:

• Caso nenhum elemento seja definido, a busca será realizada automaticamente na tag raiz do XML.

---

Exemplos

Exemplo simples

Obter o valor de um atributo de um XML.

Fluxo:

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

2. Adicionar o objeto Obter Valor do Atributo.

3. Selecionar o objeto XML.

4. Informar o Nome do Atributo.

5. Executar o robô para capturar o valor do atributo.

Exemplo aplicado

Capturar um identificador presente em um documento XML.

Fluxo possível:

1. Receber um arquivo XML no robô.

2. Utilizar Obter Valor do Atributo para localizar o atributo desejado.

3. Capturar o valor retornado.

4. Utilizar esse valor para validação ou integração com outro sistema.

---

Retornos

O objeto retorna o valor do atributo localizado no elemento XML.

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
Atributo não encontrado	Verificar se o Nome do Atributo corresponde exatamente ao atributo presente no XML
Elemento incorreto	Confirmar se o elemento configurado corresponde à estrutura real do XML

---

Boas práticas

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

• Utilize nomes claros para o Nome Identificador do Objeto.

• Configure corretamente o elemento onde o atributo está localizado para evitar erros de leitura.

• Utilize o retorno do atributo para validações ou processamento de dados no fluxo do robô.