4D v16.3

SAX OPEN XML ELEMENT

Home

 
4D v16.3
SAX OPEN XML ELEMENT

SAX OPEN XML ELEMENT 


 

SAX OPEN XML ELEMENT ( document ; tag {; attribName ; attribValue} {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} ) 
Parameter Type   Description
document  DocRef in Reference of open document
tag  String in Name of element to open
attribName  String in Attribute name
attribValue  String in Attribute value

The SAX OPEN XML ELEMENT command adds a new element in the XML document referenced by document as well as, optionally, attributes and their values.

The added element is “open” in the document (the end tag is not added). To close an element created using this command, you must either:

  • Use the SAX CLOSE XML ELEMENT command, or
  • Close the XML document. In this case, 4D will automatically add the necessary XML end tags.

In tag, pass the name of the element to be created. This name may only contain letters, numbers and the characters “.”, “-“,”_” and “:”. If an invalid character is passed in tag, an error will be generated.

Optionally, the command can pass one or more attribute/value pairs (in the form of variables, fields or literal values) using the attribName and attribValue parameters. You can pass as many attribute/value pairs as you want.

Example  

The following statement:

 vElement:="Book"
 SAX OPEN XML ELEMENT($DocRef;vElement)

... writes the following line in the document:

<Book

If an invalid character is passed in tag, an error is generated.



See also 

SAX CLOSE XML ELEMENT
SAX OPEN XML ELEMENT ARRAYS

 
PROPERTIES 

Product: 4D
Theme: XML SAX
Number: 853

This command modifies the Error system variableThis command can be run in preemptive processes

 
HISTORY 

Created: 4D 2004

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)