SAX ADD XML ELEMENT VALUE

SAX ADD XML ELEMENT VALUE ( documento ; dados {; *} )

Parâmetro	Tipo		Descrição
documento	Time	→	Referência do documento aberto
dados	Text, Variable	→	Texto ou variáveis a inserir no documento
*	Operador	→	Se passado: criptografa os caracteres especiais; se omitido: não codifica.

Descrição

O comando SAX ADD XML ELEMENT VALUE adiciona diretamente no documento XML referenciado por documento os dados sem convertê-los. Este comando é equivalente, por exemplo, a inserir um arquivo anexado em um e-mail.

Em dados, pode passar diretamente uma cadeia de caracteres, ou uma variável 4D. O conteúdo da variável se converterá em texto antes de ser incluído no documento XML. Se dados for avaliado como undefined, 4D usa uma string vazia. Se quiser codificar os conteúdos de dados, pode usar o comando BASE64 ENCODE. Neste caso, precisa pasar um BLOB em dados.

Se desejar codificar o conteúdo de dados, deve utilizar o comando BASE64 ENCODE. Neste caso deve passar um BLOB em dados.

Por padrão, o comando codifica os caracteres especiais (< > ” ’...) conteúdos nos parâmetros dados a menos que você tenha desativado este mecanismo para o processo atual utilizando o comando XML SET OPTIONS passando o valor XML Raw data à opção XML String encoding. Por exemplo:

 XML SET OPTIONS($docRef;XML string encoding;XML raw data)

Neste contexto, para forçar a codificação de parâmetros especiais durante a chamada de SAX ADD XML ELEMENT VALUE, deve passar o parâmetro opcional *.

Para que este comando funcione corretamente, deve estar aberto um elemento. Do contrário, se gerará um erro.

Exemplo

Este exemplo insere o arquivo whitepaper.pdf no elemento XML aberto:

 var vBMeuBLOB : Blob
 DOCUMENT TO BLOB("c:\\livrobranco.pdf";vBMeuBLOB)
 SAX ADD XML ELEMENT VALUE($DocRef;vBMeuBLOB)

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.

Ver também

SAX GET XML ELEMENT VALUE
XML SET OPTIONS

Propriedades

Número do comando	855
Thread-seguro	✓
Modificar variáveis	OK