Importar XML

Visão Geral

O objeto Importar XML é utilizado para carregar um arquivo XML existente para dentro do fluxo do robô, permitindo que seu conteúdo seja manipulado posteriormente por outros objetos de XML.

Após a importação, o XML fica disponível por meio do Nome Identificador do Objeto, podendo ser referenciado em ações como leitura, busca ou alteração de elementos.

---

Funcionamento

O objeto realiza a leitura de um arquivo XML a partir do caminho informado no campo Arquivo e o disponibiliza internamente no fluxo do robô.

Durante a execução:

1. O robô acessa o caminho informado em Arquivo.

2. O conteúdo do XML é carregado.

3. O XML passa a ser identificado pelo valor definido em Nome Identificador do Objeto.

4. Outros objetos de XML podem utilizar esse identificador para manipulação do conteúdo.

O objeto não executa alterações no XML por si só, ele apenas realiza a importação para uso posterior.

Quando usar

• Quando for necessário manipular um XML já existente.

• Quando outros objetos de XML dependerem de um XML previamente carregado.

• Quando o arquivo XML estiver salvo em diretório local ou acessível ao robô.

Quando não usar

• Quando não houver necessidade de manipulação de XML no fluxo.

• Quando o XML ainda não existir (nesse caso deve-se utilizar outro objeto apropriado para criação, se aplicável na documentação oficial).

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido para o objeto no fluxo do robô. Campo obrigatório.
Nome Identificador do Objeto	Identificador único que representa o XML dentro do fluxo. Será utilizado por outros objetos de XML para referência. Campo obrigatório.
Arquivo	Caminho completo do arquivo XML que será importado. Deve apontar para um arquivo existente. Campo obrigatório.

---

Exemplos

Exemplo simples

Configuração básica para importar um XML:

• Título: Importar XML

• Nome Identificador do Objeto: xmlImport

• Arquivo: C:\Temp\exemplo.xml

Após essa configuração, o XML poderá ser utilizado por outros objetos através do identificador xmlImport.

Exemplo aplicado

Cenário: leitura de dados de um XML de clientes.

1. Importar o arquivo clientes.xml utilizando o identificador xmlClientes.

2. Utilizar objetos de XML para localizar elementos como /clientes/cliente.

3. Extrair ou manipular informações conforme necessidade do fluxo.

---

Retornos

---

Erros comuns e como evitar

• Arquivo não encontrado Verifique se o caminho informado no campo Arquivo está correto e se o arquivo existe.

• Nome Identificador duplicado Utilize nomes únicos para evitar conflitos dentro do fluxo.

• Caminho inválido ou sem permissão Certifique-se de que o robô possui permissão de acesso ao diretório informado.

---

Boas práticas

• Utilize nomes identificadores descritivos (ex: xmlNotasFiscais, xmlClientes).

• Garanta que o arquivo exista antes da execução do robô.

• Mantenha o XML organizado para facilitar a manipulação posterior.

• Utilize caminhos absolutos para evitar ambiguidades.

---

Robô Exemplo

3KB

robo-exemplo-importar-xml.roboteasy

Open