4D Doc Center : DOM SET XML ELEMENT VALUE

4D v14.3

DOM SET XML ELEMENT VALUE


DOM SET XML ELEMENT VALUE ( refElemento {; xRota}; valorElemento {; *} )

Parâmetro	Tipo	Descrição
refElemento	cadeia	Referência de elemento XML
xRota	Texto	Rota do xRota do elemento XML
valorElemento	cadeia, Variável	Novo valor do elemento
*	Operador	Se passado: estabelece o valor em CDATA

Descrição

O comando DOM SET XML ELEMENT VALUE lhe permite modificar o valor do elemento definido por refElement.

Se passar o parâmetro opcional xRota, você escolhe utilizar a notação XPath para indicar o elemento a ser modificado (para maior informação sobre esta notação, consulte o parágrafo “Uso da notação XPath” na seção Visão Geral dos comandos XML DOM). Neste caso, deve passar a referência de um elemento XML raiz em refElemento e a rota XPath do elemento a modificar em xRota.

Em valorElemento, passe uma cadeia ou uma variável (ou um campo) que contenha o novo valor do elemento especificado:

Se passar uma cadeia, o valor se utilizará tal como na estrutura XML.
Se passar uma variável ou um campo, 4D processará o valor, dependendo do tipo de valorElemento.
Todos os tipos de dados podem ser utilizados, com exceção dos arrays, imagens e ponteiros.

Quando for passado o parâmetro opcional asterisco (*), indica que o valor do elemento deve ser definido na forma de CDATA. A forma especial CDATA permite escrever texto sem formato (ver exemplo 2).

Nota: Se o elemento designado por refElemento for de tipo BLOB, DOM SET XML ELEMENT VALUE o codifica automaticamente em banco64. Entretanto, o comando DOM GET XML ELEMENT VALUE realiza automaticamente a operação inversa.

Exemplo 1

Na fonte XML abaixo:

<Book>
   <Title>O melhor vendedor</Title>
</Book>

Se for executado o código abaixo, com vRefElem conterá a referência do elemento “Título”:

DOM SET XML ELEMENT VALUE(vRefElem;"O Perdedor")

Obtemos:

<Book>
   <Title>O Perdedor</Title>
</Book>

Exemplo 2

Na fonte XML abaixo:

<Maths>
   <Postulate>1+2=3</Postulate>
</Maths>

Queremos escrever o texto “12<18” no elemento <Postulate>. Esta cadeia não pode ser escrita em XML porque o caractere “<” não é aceito. Este caractere deve ser transformado então em “<” ou deve ser utilizado a forma CDATA. Se vElemRef indica o nodo XML <Postulate>:

  ` Forma normal

 DOM SET XML ELEMENT VALUE(vElemRef;"12<18")

Obtemos:

<Maths>
   <Postulate>12 < 18</Postulate>
</Maths>

  ` CDATA form

 DOM SET XML ELEMENT VALUE(vElemRef;"12<18";*)

Obtemos:

<Maths>
   <Postulate><![CDATA[12 < 18]]></Postulate>
</Maths>

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0 e um erro é gerado (por exemplo, se a referência do elemento for inválida)