4D v14.3

SAX ADD XML ELEMENT VALUE

Página Inicial

 
4D v14.3
SAX ADD XML ELEMENT VALUE

SAX ADD XML ELEMENT VALUE 


 

SAX ADD XML ELEMENT VALUE ( documento ; dados {; *} ) 
Parâmetro Tipo   Descrição
documento  DocRef in Referência do documento aberto
dados  Texto, Variável in Texto ou variáveis a inserir no documento
Operador in Se passado: criptografa os caracteres especiais; se omitido: não codifica.

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:


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)

Se o comando  tiver sido executado corretamente, a variável sistema Ok assume o valor 1. Se ocorrer um erro, assume o valor 0.

 
PROPRIEDADES 

Produto: 4D
Tema: XML SAX
Número 855

Este comando modifica a variável sistema OK

 
HISTÓRIA 

Modificado: 4D v11 SQL
Modificado: 4D v12

 
VER TAMBÉM 

SAX GET XML ELEMENT VALUE
XML SET OPTIONS

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Parent of : SAX ADD XML ELEMENT VALUE ( 4D v11 SQL Release 6)