SAX OPEN XML ELEMENT ARRAYS
SAX OPEN XML ELEMENT ARRAYS ( document ; tag {; attribNamesArray ; attribValuesArray} {; attribNamesArray2 ; attribValuesArray2 ; ... ; attribNamesArrayN ; attribValuesArrayN} )
| Parameter | Type | Description | |
|---|---|---|---|
| document | Time | → | Reference of open document |
| tag | Text | → | Name of element to open |
| attribNamesArray | Text array | → | Array of attribute names |
| attribValuesArray | Text array, Array integer, Date array, Real array, Picture array, Boolean array | → | Array of attribute values |
Description
The SAX OPEN XML ELEMENT ARRAYS command is used to add a new element in the XML document whose reference is passed in document as well as, optionally, attributes and their values in the form of arrays.
Except for the support of arrays (see below), this command is identical to SAX OPEN XML ELEMENT. Please refer to the description of this command for more information about its operation.
SAX OPEN XML ELEMENT ARRAYS accepts arrays of the date, number, Boolean and picture type as attribValuesArray parameter(s). 4D automatically carries out the necessary conversions; you can configure these conversions using the XML SET OPTIONS command.
Optionally, the SAX OPEN XML ELEMENT ARRAYS command can be used to pass pairs of attributes and attribute values in the form of arrays in the attribNamesArray and attribValuesArray parameters.
The arrays must have been created previously and operate in attribute/attribute value pairs. You can pass as many pairs of arrays, and as many items in each pair, as you want.
Example
The following method:
ARRAY STRING(80;tAttrNames;2)
ARRAY STRING(80;tAttrValues;2)
vElement:="Book"
tAttrNames{1}:="Font"
tAttrValues{1}:="Arial"
tAttrNames{2}:="Style"
tAttrValues{2}:="Bold"
SAX OPEN XML ELEMENT ARRAYS($DocRef;vElement;tAttrNames;tAttrValues)
... will write in the document:
<Book Font="Arial" Style="Bold">
See also
SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT
XML SET OPTIONS
Properties
| Command number | 921 |
| Thread safe | ✓ |