Service Definition File Reference

SOAP/AM Server Development >

Service Definition File Reference

Previous pageReturn to chapter overviewNext page

A SOAP/AM Service Definition File (SDF) is an instance of an XML document that is stored in SOAP/AM Server's Virtual File System (VFS) as a text file with the ".sdf" filename extension. The SDF contains all the information that SOAP/AM Server needs to a) dynamically generate as standard WSDL file and b) map incoming SOAP requests to the appropriate Pathway or Guardian server in the interprocess message format it expects and c) map the server's reply into a SOAP response that is returned to the client.

 

You can use the SOAP/AM Service Definition Wizard to create or maintain your SDF. However, to take advantage of all SOAP/AM Server features, you may need to modify the SDF manually. This section describes the content of the SDF.

 

The XML schema for SOAP/AM Service Definition Files is located at http://www.nuwave-tech.com/schemas/soapam/sdf/sdf.xsd. If you have an XML-aware editor such as XMLSpy, the schema may be helpful in creating and/or validating your SDFs.

 

Below is an outline of a Service Definition File. Refer to the documentation for each element for detailed information. Click the element name for detailed information.

 

<definitions>[1]

   <types>[1]

       <type>[1:∞]

           <element/>[1:∞]

       </type>

   </types>

   <servers>[1]

       <server/>[1:∞]

   </servers>

   <service>[1]

       <applicationSecurity/>[0:1]

       <documentation>[0:1]

       </documentation>

       <methods>[1]

           <method>[1:∞]

               <documentation>[0:1]

               </documentation>

               <headers>[0:1]

                   <header/>[1:∞]

               </headers>

               <parameters>[0:1]

                   <parameter/>[1:∞]

               </parameters>

               <transactionControl/>[0:1]

               <request>[1]

                   <initializers>[0:1]

                       <initializer/>[1:∞]

                   </initializers>

                   <mappings>[0:1]

                       <mapping/>[1:∞]

                   </mappings>

               </request>

               <replies>[1]

                   <reply>[1:∞]

                       <mappings>[0:1]

                           <mapping/>[1:∞]

                       </mappings>

                   </reply>

               </replies>

           </method>

       </methods>

   </service>

</definitions>

 

The bracketed notation indicates the minimum and maximum number of occurrences [minOccurs:maxOccurs] for the element. [1] indicates the element must occur exactly once. ∞ indicates that maxOccurs is unbounded.