A Quick Introduction to WSML

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

In addition to creating a Web Services Description Language (WSDL) file describing the services and operations on the server, you must create a Web Services Meta Language (WSML) file on the server.

Note

The use of a WSML file is specific to SOAP Toolkit.

A WSML file provides information that maps the operations of a service, as described in the WSDL file, to specific methods in the COM object. The WSML file determines which COM object to load to service the request for each operation.

At the root level of a WSML file is the <servicemapping> element. This element can have one or more <service> elements and each <service> element, in turn, can have one or more <using> elements and <port> elements. Further, each <port> element can have one or more <operation> elements.

This following syntax example WSML file has a single <service> element that has a single <using> element and <port> element.

<servicemapping name='Calc'>
  <service name='Calc'>
    <using PROGID='CalcSvcRpcCpp.Calc.1' cachable='1' ID='CalcObject' />
    <port name='CalcSoapPort'>
      <operation name='Multiply'>
        <execute uses='CalcObject' method='Multiply' dispID='4'>
          <parameter callIndex='1' name='A' elementName='A' />
          <parameter callIndex='2' name='B' elementName='B' />
          <parameter callIndex='-1' name='retval' elementName='Result' />
        </execute>
      </operation>
      <operation name='Divide'>
        <execute uses='CalcObject' method='Divide' dispID='3'>
          <parameter callIndex='1' name='A' elementName='A' />
          <parameter callIndex='2' name='B' elementName='B' />
          <parameter callIndex='-1' name='retval' elementName='Result' />
        </execute>
      </operation>
    </port>
  </service>
</servicemapping>

WSML File Example

For a working example of a WSML file and a detailed description of the file's contents, see About the Calc.wsml File.

See Also

Concepts

SOAP Application Development
A Quick Introduction to WSDL
Client-Side Data Flow
Server-Side Data Flow