|
|
|
|
|
|
|
|
|
|
|
version 11 (Modified)
SAX ADD XML ELEMENT VALUE (document; data; *)
| Parameter | Type | Description | |
| document | DocRef |  | Reference of open document |
| data | Text | Variable | | Text or variable to insert in the document |
| * | * | | If passed: encoding of special characters |
| If omitted: no encoding |
Description
In the XML document referenced by document, the SAX ADD XML ELEMENT VALUE command adds data directly without converting them. This command is equivalent, for instance, to inserting an attachment in the body of an e-mail.
In data, you can either pass a character string directly, or a 4D variable. The variable contents will be converted into text before being included in the XML document.
If you want to encode the contents of data, you must use the ENCODE command. In this case, of course, you must passs a BLOB in data.
By default, the command does not encode special characters (< > " '...) contained in the data parameter. To force the encoding of these parameters, simply pass the optional * parameter.
In order for this command to operate correctly, an element must be open. Otherwise, an error will be generated.
Example
This example inserts the whitepaper.pdf file into the open XML element:
C_BLOB(vBMyBLOB)
DOCUMENT TO BLOB ("c:\\whitepaper.pdf";vBMyBLOB)
SAX ADD XML ELEMENT VALUE($DocRef;vBMyBLOB)
See Also
System Variables or Sets
If the command has been executed correctly, the system variable OK is set to 1; otherwise, it is set to 0 and an error is generated.
|
|
|
|
|
|
|
|
|
|
|