Adiciona um elemento filho a um elemento em um objeto XML.

Figura 1 - Bloco Adiciona elemento XML

Compatibilidade

• Bloco cliente: cronapi.xml.addXMLElement()

Retorno

Retorna o valor booleano true se o elemento for adicionado com sucesso; caso contrário, retorna false.

Parâmetros

Elemento pai

Objeto contendo o elemento XML pai. Utilize o retorno do bloco Obtém elemento raiz.

• Posição: 1
• Inglês: Parent element
• Tipo: Objeto / Object
• Exemplo: retorno do bloco Obtém elemento raiz

Elemento para adicionar

Objeto contendo o elemento XML a ser adicionado. Utilize o retorno do bloco Cria elemento XML.

• Posição: 1
• Inglês: Element to add
• Tipo: Objeto / Object
• Exemplo: retorno do bloco Cria elemento XML

Exemplo

Na função abaixo, o bloco Adiciona elemento XML adicionará um novo elemento XML, com o conteúdo especificado, ao elemento pai definido na variável "xml". Em seguida, o elemento XML resultante será impresso no console do navegador, após a impressão do retorno de valor "true" do bloco.

Figura 2 - Exemplo de uso do bloco Adiciona elemento XML

Na imagem a seguir, podemos visualizar o resultado de execução da função da Figura 2.

Figura 2.1 - Resultado de execução da função da Figura 2