SAX ADD XML ELEMENT VALUE
SAX ADD XML ELEMENT VALUE ( documento ; dados {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| documento | refDoc | 🡒 | 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 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.