How to Define the Interface (WSDL) for a Web Service

As described in How to Add a Service Binding Component, a web service is a type of binding component that you can add to a SOA composite application. You must define the interface (WSDL) file for the web service.

To define the interface (WSDL) for a web service:

From the Technology section, drag a SOAP web service to the left Exposed Services swimlane.

This invokes the Create Web Service dialog shown in Figure 2-6.

Enter the details shown in Table 2-7:

Table 2-7 Create Web Service Dialog Fields and Values

Field	Value
Name	Enter a name for the service.
Type	Select the type (message direction) for the web service. Since you dragged the web service to the left swimlane, the Service type is the correct selection, and displays by default: Service (default) Creates a web service to provide an entry point to the SOA composite application Reference Creates a web service to provide access to an external service in the outside world Since this example describes how to create an entry point to the SOA composite application, Service is selected.

Field

Value

Name

Enter a name for the service.

Type

Select the type (message direction) for the web service. Since you dragged the web service to the left swimlane, the Service type is the correct selection, and displays by default:

Service (default)

Creates a web service to provide an entry point to the SOA composite application
Reference

Creates a web service to provide access to an external service in the outside world

Since this example describes how to create an entry point to the SOA composite application, Service is selected.

Select the WSDL file for the service. There are three methods for selection:
Click the Add icon above the Input table to display the Add Message Part dialog to add a new WSDL message part. If the WSDL file contains multiple messages, you can add a message part for each one. You can select XML schema simple types, project schema files, and project WSDL files for a message part.

For more information, click Help.
Click OK to return to the Create Web Service dialog.

Note the additional fields described in Table 2-8:

Table 2-8 Create Web Service Dialog Fields and Values

Field	Value
Port Type	Displays the port type.
Callback Port Type	Disabled, since this WSDL file is for a synchronous service. This field is enabled for asynchronous services.

Click OK.
From the File main menu, select Save All.
Note:
- Do not manually update the WSDL location in the WSDL file in Source View. This action is not supported. Only updates made in Design View are supported.
- WSDL namespaces must be unique. Do not just copy and rename a WSDL. Ensure that you also change the namespaces.