NonStop SOAP 4.1 User's Manual

The presence of the @SOAP_ATTRIBUTE comment tag at the leaf level denotes that the field must
be translated to an XML attribute. If the @SOAP_ATTRIBUTE tag is present at the group level, it
denotes that all the child leaf fields must be translated to XML attributes.
The @SOAP_ELEMENT comment tag also works in the same manner as the @SOAP_ATTRIBUTE
comment tag for the leaf and group levels, but translates the field(s) as XML elements, not as XML
attributes.
NOTE: A service that uses a DDL file with the @SOAP_ELEMENT and @SOAP_ATTRIBUTE
comment tags must have its ProcessSoapDDLComments attribute set to yes in an SDL file for
NonStop SOAP 4 to process the comment tags.
To customize the XML representation of the DDL fields, the @SOAP_ELEMENT and
@SOAP_ATTRIBUTE comment tags can be combined and matched within the same group level
based on the following rules:
• A single DDL field cannot have both the @SOAP_ATTRIBUTE and @SOAP_ELEMENT comment
tags present.
• A service using a DDL file with the @SOAP_ATTRIBUTE or @SOAP_ELEMENT comment tags
must have its ProcessSoapDDLComments attribute set to yes in an SDL file for NonStop
SOAP 4 to process the comment tags.
• If the comments appear on a particular field, it is valid for the entire hierarchy under that field
(if any) unless overridden by another tag at a child level. The default value is controlled by
the value of the SoapDDLAttribute attribute set in the SDL file.
• If the SoapDDLAttribute attribute is present and is set to yes, by default, all the leaf fields
are treated as attributes, unless a comment pertaining to a DDL hierarchy changes it (provided
that the ProcessSoapDDLComments attribute is set to yes).
• The @SOAP_ATTRIBUTE and @SOAP_ELEMENT comment tags are ignored for services that
have the SoapMessageType attribute set to rpc.
Examples
Example 12 shows the @SOAP_ATTRIBUTE and @SOAP_ELEMENT comment tag at the leaf and
group levels.
DDL Comments 223