addRecordNode

This method creates an element node with a group of child element nodes under a given parent element, where the group of created nodes is an XML representation of a buffer. The caller can specify which fields from the buffer to include in the XML or, alternatively, which fields to exclude.


Parameter Name	Type	Description	I/O	Req
nodeName	Char	Name to give the top-level element node to be created, under which element nodes corresponding to the fields in the buffer will be added as children.	I	Y
bufferHandle	Handle	Handle of the buffer whose contents will be used to create child element nodes.	I	Y
prefixToStrip	Char	A fixed prefix of characters (for example, a database table identifier) to be stripped from the XML element names derived from the buffer field names.	I	N
includeMode	Logical	Indicates whether the caller-provided list of buffer fields represent data to include in or exclude from the resulting XML.	I	N
fieldList	Char	A list of field names from the buffer that will be included/excluded from the resulting XML, depending on the includeMode parameter. The list is delimited by the ASCII 3 (Progress chr(3)) character.	I	N
parentNode	Handle	Handle to the element node under which the generated top-level element nodes will be placed as a child, and the elements corresponding to the buffer fields will be placed as grandchildren.	I	Y
newNode	Handle	Handle to the top-level node created.	O	Y