Generating a Web Service Definition from a message set

This task topic describes how to generate a Web Services Description Language (WSDL) document, which specifies the interface for a Web Service, from a message set.

Before you start:

To complete this task you must already have completed the following tasks:

Tip: You are recommended to replace any deprecated constructs before generating WSDL representations of your message models.

To generate a Web Service Definition:

  1. Switch to the Broker Application Development perspective.
  2. In the Resource Navigator, right-click the message definition file from which you want to generate a Web Service Definition.
  3. Open the New Message Set Web Service Definition wizard by clicking New > Message Set Web Service Definition. Alternatively, open the wizard by right-clicking anywhere in the Resource Navigator then clicking New > Message Set Web Service Definition on the pop-up menu, or by clicking File > New > Message Set Web Service Definition on the workbench menu.
  4. The message set that you selected is highlighted. If this is not the message set from which you want to generate a Web Service Definition, select the correct message set.
  5. Click Next.
    Tip: You do not need to continue to the final page before closing the wizard and generating your Web Service Definition: you can break out of the wizard by clicking the Finish button whenever it is active. If the Finish button and the Next button are both active, you have the option of either closing the wizard from the current page by clicking Finish, or of continuing on to further pages of configuration options by clicking Next.
  6. Specify a destination folder for the Web Service Definition.
    Tip: You can either select an existing folder or create a new folder. If you want to use an existing folder, the folder that you select must be within the project that contains the message set from which you are generating the Web Service Definition. If you select an existing folder, the previous contents are overwritten.

    To create a new folder for the Web Service Definition:

    1. Click the location for the new folder in the project hierarchy.
    2. Click Create New Folder and specify a name for the new folder.
    3. Click OK.
  7. Type the Company Domain Name, Definition Name, Port Type Name, and click the Operation Type in the drop down list.
    Note: These fields are compulsory and cannot be left blank.
  8. Click Next.
  9. Select the message categories for which you want to create operations. To select all the displayed categories, click Select All. (Note that clicking Deselect All deselects all your previous selections.)
    Tip: Only message categories which have their role type set to WSDL are available for selection.
  10. Click Next.
  11. Specify at least one binding and port addressing option by selecting one or more of the following check boxes:
    • SOAP (over JMS) for sending SOAP messages over the Java Messaging Service.
    • SOAP (over HTTP) for sending SOAP messages over the HTTP.
    • JMS (TextMessage) for sending Text messages over the Java Message Service.
  12. Click Next.
  13. Specify the binding and service properties for each binding and port addressing option that you have selected. For each option, there are two pages in the wizard, one for bindings and one for services. When you have completed the information on each page, click Next.
    Tip: The wizard completes some fields with default values, which you can change if required. If a field contains a value that cannot be changed, this field is unavailable for editing.
  14. When you have finished adding all the necessary details, click Finish to generate your Web Service Definition.
  15. To view a generated WSDL file, use the Resource Navigator to locate the destination directory that you specified in the New Message Set Web Service Definition wizard. Right-click the WSDL file that you want to view (*.wsdl file extension) then click Open on the pop-up menu.

Related concepts
The message model
Generate model representations

Related tasks
Working with a message set
Working with a message definition file
Working with message model objects
Working with a message category file

Related reference
WSDL generation