NonStop SOAP 4.1 User's Manual

Table 17 SDL Values and DDL Comment Tags
EffectDDL Comment tag
present?
ProcessSoapDDL
Comments Value
SOAPDDLAttribute
Value
All the DDL leaf fields, except OCCURS
and OCCURS_DEP_ON leaf fields are
XML attributes.
Not ApplicableNoYes
All the DDL leaf fields are XML
attributes.
NoYesYes
The DDL fields overridden with a
comment tag are handled
YesYesYes
appropriately. All the other fields are
XML attributes.
Only the fields containing the comment
tags are processed.
YesYesNo
Specifying Base64 Encoding
A SOAP message might need to carry binary data or other characters that are considered invalid
by the W3C XML specifications. To represent the binary data or invalid XML characters as valid
XML content, the data must be transformed or encoded appropriately.
The NonStop SOAP 4 server enables the client to send encoded binary data or invalid XML
characters by using the Base64 encoding feature. The Base64 encoding feature, overrides any
other Request, Service, or Response encoding. To apply the Base64 encoding for an XML attribute
or element, in the DDL file, flag the @SOAP_BASE64 DDL comment tag.
The Base64 encoding was introduced by the Multipurpose Internet Mail Exchange (MIME) standard
(IETF MIME RFC) as a method for transmitting data that was binary in nature or contained values
representing control characters that would have undesired effects on the transmission. The Base64
encoding consists of 64 encoding characters (A-Z, a-z, 0-9, +, /) that are a subset of the ASCII
system and are considered valid in the XML specification.
The @SOAP_BASE64 comment tag can be present only at the DDL leaf level. The SoapAdminCL
tool validates this before creating the WSDL file. If this tag is present for a group field, it is flagged
as an error and the following error message is displayed:
SOAPADMIN ERROR >> Error processing DDL definition <definition name> for service
<service name>. The "@SOAP_BASE64" DDL comment tag cannot be
present at a group level DDL field <field name>.
Example 14 shows the @SOAP_BASE64 comment tag in the DDL file, the corresponding sample
XML message containing the Base64 data, and the XML schema representation with the Base64
schema type.
DDL Comments 225