DOM Builder Reference > General XML API Methods > addRecordNode
  
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.The following table lists parameters of addRecordNode.
 
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