XML-NODE-NAME attribute

Indicates the name of the XML element or attribute representing the ProDataSet, the temp-table, the temp-table buffer, or the temp-table buffer-field object name in an XML document.

Data type: CHARACTER

Access: Readable/Writeable

Applies to: Buffer object handle, Buffer-field object handle, ProDataSet object handle, Temp-table object handle

This attribute's purpose overlaps with the SERIALIZE-NAME attribute. Because of this overlap, the attributes interact as follows:

• The READ-XML( ) and WRITE-XML( ) methods always use the XML-NODE-NAME attribute value. If you set a value for the XML-NODE-NAME attribute, it keeps that value regardless of how you set the SERIALIZE-NAME attribute.
• If you do not set the XML-NODE-NAME attribute and set the SERIALIZE-NAME attribute, the AVM sets XML-NODE-NAME equal to SERIALIZE-NAME.
• If you do not set either attribute, the AVM sets both to the ABL object name.

This attribute allows you to work around ABL names that use illegal XML characters or to work around XML element or attribute names that are reserved words in ABL.

This attribute should not contain a colon (:). In XML, a colon represents the namespace prefix delimiter (namespace-prefix:value). If a colon appears in an XML document's element or attribute name, it is interpreted as namespace-qualified and does not match the actual dataset, temp-table or temp-table field name. This leads to missing data or parsing errors.

This attribute does not apply to database buffers and fields.

For more information about using this attribute, see Use XML with ABL Applications.

See also

READ-XML( ) method, SERIALIZE-NAME attribute, WRITE-XML( ) method