SERIALIZE-NAME attribute

Indicates the name of a ProDataSet, a temp-table, a temp-table buffer, or a temp-table buffer-field object as it should appear when serialized, for example into JSON or XML.

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 XML-NODE-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.

Use this attribute when the serialized name either contains invalid characters for an ABL name or the serialized name is an ABL keyword.

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 the Use XML with ABL Applications or Use JSON with ABL Applications.

See also

READ-JSON( ) method, READ-XML( ) method, WRITE-JSON( ) method, WRITE-XML( ) method, XML-NODE-NAME attribute