O'Reilly logo

Real World XML Web Services: For VB and VB .NET Developers by Yasser Shohoud

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

4.6. Other WSDL Features

4.6.1. Documenting Your WSDL

The WSDL documents you've seen so far contain lots of information on the operations, messages, and parameters exposed by a Web service. They do not, however, contain any information on what each operation actually does. For example, the quote of the day service had an operation called getFortuneByDictionary, which had one input parameter called dictionaryName. How would a client know what values to pass in as the dictionaryName? And how would it know exactly what the method does, that is, how would it know that the method returns quotes and definitions?

To provide such information, you can add documentation to your WSDL using <document>, which may appear inside any WSDL element such as <operation> ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required