4D Doc Center : SAX ADD XML ELEMENT VALUE

4D v14.3

SAX ADD XML ELEMENT VALUE


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

Parâmetro	Tipo	Descrição
documento	DocRef	Referência do documento aberto
dados	Texto, Variável	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 desejar codificar o conteúdo de dados, deve utilizar o comando 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:

 C_BLOB(vBMeuBLOB)

 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.