Exploring Additional Configuration-Driven Modifications to Generated IRIS SOAP Web Service WSDL
Several configuration options for InterSystems IRIS web services alter the <types> segment and other WSDL components.
Defaults to 0; set INCLUDEDOCUMENTATION to 1 on the web service to embed triple-slash (///) comments from type clases as <s:annotation><s:documentation> elements. For example, editing ArithmeticWithComplexPairs service to include Parameter INCLUDEDOCUMENTATION = 1; while the paired type ImaginaryRealNumber has comments:
Class MyMath.ImaginaryRealNumber Extends %SOAP.DataType
{
/// Represents a pair of real and imaginary components for a complex value
Property Real As %Double;
/// Imaginary component coefficient
Property Imaginary As %Double;
}
The WSDL <types> section would then include:
...
<s:complexType name="ImaginaryRealNumber">
<s:annotation>
<s:documentation>Represents a pair of real and imaginary components for a complex value</s:documentation>
</s:annotation>
<s:sequence>
<s:element minOccurs="0" name="Real" type="s:double">
<s:annotation>
<s:documentation>Real component coefficient</s:documentation>
</s:annotation>
</s:element>
<s:element minOccurs="0" name="Imaginary" type="s:double">
<s:annotation>
<s:documentation>Imaginary component coefficient</s:documentation>
</s:annotation>
</s:element>
</s:sequence>
</s:complexType>
...
SOAPBINARY=1modifies<types>and related sections for IRIS-specific binary SOAP encoding.SOAPSESSION=1introduces WSDL elements dedicated to managing SOAP session state.- Defining the
SoapTypeNameSpaceclass keyword overrides the default XML namespace used for types within the<types>block. - Setting
REQUIRED=1on a web method parameter, property, or type field enfocresminOccurs="1"in the corresponding XML schema element. - Applying the
SoapRequestMessagemethod keyword replaces the default<operation>input element name with the specified value instead of the method’s original identifier. - The
ALLOWREDUNDANTARRAYNAMEservice parameter controls how colllection properties (like lists or arrays) map to XML schema structures within<types>.