FRAGMENT attribute
Specifies if the output of a SAX-writer object is a complete document or a fragment.
Data type: LOGICAL
Access: Readable/Writeable
Applies to: SAX-writer object handle
The default value is FALSE.
TRUE indicates that the writer should not include the XML declaration or require a root node. This behavior allows the developer to create XML fragments which can be used to create larger documents. For example, one SAX-writer object’s document fragment LONGCHAR could be used as the parameter of WRITE-FRAGMENT for another SAX-writer.
FALSE indicates the SAX-writer should create a complete XML document with the XML declaration and root node.
You can read this attribute at all times, but you can only write to it when the WRITE-STATUS is either SAX-WRITE-IDLE or SAX-WRITE-COMPLETE. That is, the attribute can only be changed when the SAX-writer is not writing, otherwise it fails and generates an error message.
OpenEdge Release 10.2B
|