Alterar Valor do Elemento

Objeto utilizado para alterar o valor de um elemento XML

Salvar XMLEste Objeto depende de outros Objetos, como: Importar XML, Selecionar Elemento

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

Visão Geral

O objeto Alterar Valor do Elemento é utilizado para alterar o valor de um elemento dentro de um XML já carregado no robô.

Esse objeto atua diretamente na estrutura do XML previamente importado, permitindo localizar um elemento específico e substituir seu conteúdo por um novo valor.

Normalmente ele é utilizado após os objetos:

• Importar XML (para carregar o arquivo)

• Selecionar Elemento (opcional, para facilitar a navegação dentro da estrutura)

Após a alteração do valor, é comum utilizar o objeto Salvar XML para persistir as mudanças no arquivo.

---

Funcionamento

O objeto funciona realizando os seguintes passos:

1. Recebe um XML previamente carregado no robô.

2. Identifica o elemento XML informado na configuração.

3. Caso existam múltiplos elementos com o mesmo nome, o índice permite selecionar qual ocorrência será alterada.

4. Substitui o conteúdo atual do elemento pelo novo valor informado.

5. O XML permanece alterado em memória até que seja salvo utilizando o objeto apropriado.

Quando usar

• Quando for necessário atualizar valores específicos dentro de um XML.

• Para modificar dados antes de exportar ou salvar um XML atualizado.

• Em processos de automação que exigem edição dinâmica de arquivos XML.

Quando não usar

Não há restrições documentadas oficialmente para o uso deste objeto.

---

Configuração

CAMPO	DESCRITIVO
Título	Define o nome do objeto dentro do fluxo do robô.
Selecionar objeto do tipo XML	Seleciona o objeto XML que será utilizado na operação. Esse XML normalmente é gerado pelo objeto Importar XML.
Adicionar Elemento	Permite adicionar um ou mais elementos XML que serão utilizados para localizar o elemento desejado na estrutura do arquivo.
Elemento	Define o elemento XML que será procurado. Caso o elemento possua atributos, eles devem ser informados separados por espaço. Exemplo: root id=2.
Índice	Define qual ocorrência do elemento será alterada quando existirem múltiplos elementos com o mesmo nome. O índice inicia em 0.
Novo valor para	Campo onde é definido o novo valor que será atribuído ao elemento XML. Permite utilizar variáveis do robô no formato {nomeVariavel}.

---

Estrutura de Bloco

A estrutura de bloco permite definir qual elemento XML será localizado para alteração.

Cada bloco possui:

• Elemento — nome da tag XML a ser encontrada.

• Índice — posição do elemento na lista de resultados encontrados.

Caso existam múltiplos elementos com o mesmo nome, o índice determina qual deles será alterado.

Exemplo:

<root>
   <valor>1</valor>
   <valor>2</valor>
</root>

• Índice 0 altera o primeiro <valor>

• Índice 1 altera o segundo <valor>

---

Exemplos

Exemplo simples

Fluxo básico de alteração de valor em um XML:

1. Utilizar o objeto Importar XML para carregar o arquivo.

2. Configurar o objeto Alterar Valor do Elemento:

   • Selecionar o XML importado

   • Informar o elemento desejado

   • Definir o novo valor

3. Utilizar o objeto Salvar XML para salvar a alteração.

Exemplo aplicado

Cenário: alterar o valor da tag <cUF> em um XML de nota fiscal.

Fluxo do robô:

1. Importar o XML da nota fiscal.

2. No objeto Alterar Valor do Elemento:

   • Elemento: cUF

   • Índice: 0

   • Novo valor: 35

3. Salvar o XML com o objeto Salvar XML.

O XML resultante conterá o novo valor definido para a tag.

---

Retornos

Não há retorno de valor documentado para este objeto.

A alteração ocorre diretamente na estrutura do XML carregado no robô.

---

Erros comuns e como evitar

Elemento não encontrado

Ocorre quando o nome da tag informado não existe no XML.

Como evitar:

• Verificar se o nome do elemento corresponde exatamente à tag presente no XML.

Índice incorreto

Quando o índice informado não corresponde a nenhum elemento existente.

Como evitar:

• Confirmar a quantidade de elementos iguais presentes no XML.

XML não selecionado

O objeto exige um XML previamente carregado.

Como evitar:

• Utilizar o objeto Importar XML antes da execução.

---

Boas práticas

• Sempre importar o XML antes de realizar alterações.

• Utilizar Selecionar Elemento quando a estrutura do XML for complexa.

• Após alterações, utilizar Salvar XML para persistir as mudanças.

• Utilizar variáveis do robô no campo Novo valor quando os dados forem dinâmicos.