A WSDL (Web Service Definition Language) is the formal description of a Web service; in AquaLogic Service Bus, it describes a proxy service or a business service. A WSDL is used to describe what a Web service can do, where it resides, and how to invoke it.
You can base SOAP and XML services on an existing WSDL resource. A WSDL document is available for proxy and business services for any transport. This WSDL is used as the base for the final WSDL document.
When you create a business service or proxy service based on a WSDL, you can select only a WSDL port or a WSDL binding, as a WSDL may only have one of these entities defined. A WSDL port describes what the actual transport address is. You use it for a concrete interface. A WSDL binding describes the structure of the interface and how it is packaged. You use it to map the transport address.
To create a business service or a proxy service from a WSDL port, select WSDL port from under Create a New Service on the Add a Business Service - General Configuration page or Add a Proxy Service - General Configuration page respectively. To create a business service or a proxy service from a WSDL binding, select WSDL binding from under Create a New Service on the Add a Business Service - General Configuration page or Add a Proxy Service - General Configuration page respectively. To learn more, see Adding a Business Service and Adding a Proxy Service.
A WSDL document uses the following elements to define network services.
Table 7-1 WSDL Elements
Property
Description
Type
A container for data type definitions using a specific type system (for example, XML Schemas).
Message
An abstract, typed definition of the data being communicated.
Operation
An abstract description of an action supported by the service.
Port Type
An abstract set of operations supported by one or more endpoints. Defines the abstract interface of a service independent of the file instance specific details. The Port Type is local to the WSDL file.
The following table lists the WSDL pages you can access from the Resource Browser and Project Explorer modules. The tasks and help topics associated with each are provided.
Table 7-2 WSDL Pages, Tasks, and Help Topics
Page
Associated Tasks
Help Topics
Summary of WSDLs
View a list of WSDLs. The WSDL name and WSDL namespace are displayed.
The Summary of WSDLspage allows you to view a list of WSDLs. A WSDL is the formal description of a Web service; in AquaLogic Service Bus, it describes a proxy service or a business service. To learn more, see Overview of WSDLs.
To List and Locate WSDLs
From the left navigation pane, select WSDLs from under Resource Browser. The Summary of WSDLs page is displayed, which displays the following information for each WSDL. For a more detailed description of the properties, see Viewing and Changing WSDL Details.
Table 7-3 WSDL Details
Property
Description
WSDL Name
The unique name assigned to the WSDL. The name is a link to the WSDL Details page. To learn more, see Viewing and Changing WSDL Details.
Path
The path is the project name and the name of the folder in which the WSDL resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.
WSDL Namespace
The address of the WSDL. It is displayed in the format:
http://example.com/example/example
Options
Click the Delete icon to delete a specific WSDL. To learn more, see Deleting a WSDL.
To locate a specific WSDL, do one of the following:
Filter by WSDL name. In the Name, Path, and Name Space fields, enter the name, path, and name space of the search target, then click Search. The path is the project name and the name of the folder in which the WSDL resides. The WSDLs matching the search criteria are displayed.
Resort the list. Ascending and descending arrow buttons indicate sortable columns—in this case, the WSDL Name and Path columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.
The Create a New WSDL Resourcepage allows you to add a new WSDL. A WSDL is the formal description of a Web service; in AquaLogic Service Bus, it describes a proxy service or a business service. To learn more, see Overview of WSDLs.
To add a new WSDL, do one of the following:
Import an existing WSDL.
Enter data in the text fields to write a new WSDL.
Copy and paste data from an existing WSDL into the text fields.
To Add a New WSDL
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Project Explorer. The Project View page is displayed.
Select the project to which you want to add the WSDL. You can add a WSDL directly to the project, or you can add the WSDL to a selected folder that resides in the project.
Note:
Click the name of a folder to select it. The Folder View page is displayed.
From the Project View or Folder View page, in the Create Resource field, select WSDL from under Interface. The Create a New WSDL Resource page is displayed.
In the Resource Name field, enter a unique name for this WSDL. This is a required field.
In the Resource Description field, enter a description for the WSDL.
In the WSDL field, do one of the following:
Enter text for the new WSDL.
Click Browseto locate and import an existing WSDL.
Copy and paste text from an existing WSDL into this field.
Note:
This is a required field.
Do one of the following
To save the WSDL, click Save. The new WSDL is included in the list of resources.
Note:
When you click Save, if there any unresolved references for the new WSDL, the system displays them. To learn more, see Viewing Unresolved WSDL References.
To disregard changes, click Cancel.
Note:
The new WSDL is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
The WSDL Detailspage displays detailed information about a specific WSDL. A WSDL is the formal description of a Web service; in AquaLogic Service Bus, it describes a proxy service or a business service. To learn more, see Overview of WSDLs.
Click the WSDL name. The WSDL Details page displays the following information for the WSDL:
Table 7-4 WSDL Details
Property
Description
Resource Name
The name and path assigned to this WSDL.
Last Modified By
The user who created this WSDL or imported it into the configuration.
Last Modified On
The date and time that the user created this WSDL or imported it into the configuration.
References
The number of objects that this WSDL references. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Referenced by
The number of objects that reference this WSDL. If such references exist, click the link to view a list of the objects. For example, if you select this WSDL's port or binding as the service type for a specific business service or proxy service, the business service or proxy service is listed as a reference when you click the link. To learn more, see Viewing References.
Description
A description of this WSDL, if one exists.
The structural view of the WSDL is displayed by default, which includes the following information.
Table 7-5 WSDL Structure Details
Property
Description
Target Namespace
The namespace used to qualify any of the definitions included in the WSDL.
WSDL Definitions
The attributes and groups associated with the WSDL:
WSDL Port Types
WSDL Bindings
WSDL Ports
XML Schema Types
XML Schema Elements
WSDL Imports
XML Schema Imports
WSDL State
The status of the WSDL:
Valid
All of the locations for XML schemas or WSDLs included by the current WSDL are specified and are valid. Furthermore, all of the locations for nested XML schemas or WSDLs (XML schemas or WSDLs subsequently included by the included WSDLs or XML schemas) are specified and are valid.
Invalid
One or more of the locations for XML schemas or WSDLs included by the current WSDL is not specified or is not valid. Additionally, the location for one or more of the nested XML schemas or WSDLs (XML schemas or WSDLs subsequently included by the included WSDLs or XML schemas) may not be specified or may not be valid.To resolve an invalid XML schema or WSDL, click Edit References. To learn more, see Resolving Unresolved WSDL References.
Click Text view to display a text view of the WSDL details. The text view includes the following information.
Table 7-6 WSDL Text Details
Property
Description
Target Namespace
The namespace used to qualify any of the definitions included in the WSDL.
Text
The text for this WSDL.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session or click Edit to enter an existing session to make changes to the current configuration. To learn more, see Using the Change Center.
To make a change to the fields, click Edit. See Adding a WSDL for a description of the fields.
Make the appropriate edits.
Do one of the following:
To update the WSDL, click Save. The WSDL is updated.
The Summary of WSDLs page is displayed.
To disregard changes, click Cancel.
Notes:
The updated WSDL is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
Note:
The WSDL Details page may also include a Separate Callbacks button. This button is only displayed if the WSDL has port types with callback operations that can be rewritten. If you click this button, the WSDL is rewritten.
The Summary of WSDLs page allows you to delete WSDLs. A WSDL is the formal description of a Web service; in AquaLogic Service Bus, it describes a proxy service or a business service. To learn more, see Overview of WSDLs.
Note:
You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.
To Delete a WSDL
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select WSDLs from under Resource Browser. The Summary of WSDLs page is displayed.
In the Options field of the WSDL you want to delete, click the Delete icon.
The WSDL is removed from the list.
Note:
If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task.
The WSDL is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
The View Unresolved WSDL References page displays the following information for each WSDL reference. To learn more about WSDLs, see Overview of WSDLs.
Table 7-7 Unresolved WSDL Reference Details
Property
Description
WSDL Name
The name assigned to the WSDL. Click the name of a specific WSDL to view details for that WSDL.
Namespace
The address of the WSDL. It is displayed in the format:
http://example.com/example/example
To List and Locate References
To locate a specific reference, do one of the following:
Resort the list. Ascending and descending arrow buttons indicate sortable columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.
The Edit the References of a WSDL Resource page allows you to resolve unresolved WSDL references by configuring the mapping for WSDL references such as WSDL imports and XML schema imports. A WSDL may also have an unresolved reference to a WS-Policy. To learn more about WSDLs, see Overview of WSDLs.
To Resolve an Unresolved WSDL or XML Schema Reference
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
On the Summary of WSDLs page, in the WSDL Name column, click the appropriate WSDL name to view details of the unresolved reference. The WSDL Details page is displayed.
Click Edit References. The Edit the References of a WSDL Resource page is displayed.
In the Resource Type field, select WSDL or select XML Schema.
Click Browse. Depending on the resource type, the WSDL Browser or the XML Schema Browser is displayed.
In the WSDL Browser or XML Schema Browser, select a WSDL or XML Schema, then select a definition from the Definitions pane.
Click Submit. The WSDL or XML Schema you selected is displayed in the Resource Name field.
Do one of the following:
To resolve the reference, click Save. The WSDL Details page is displayed.
To disregard changes, click Cancel.
On the WSDL Details page, click OK. The state of the WSDL is displayed as Valid.
To Resolve an Unresolved WS-Policy Reference
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
On the Summary of WSDLs page, in the WSDL Name column, click the appropriate WSDL name to view details of the unresolved reference. The WSDL Details page is displayed.
Click Edit References. The Edit the References of a WSDL Resource page is displayed.
In the WS-Policy Name field, click Browse. The Policy Browser is displayed.
In the Policy Browser, select a WS-Policy.
Click Submit. The WS-Policy you selected is displayed in the WS-Policy Name field.
Do one of the following:
To resolve the reference, click Save. The WSDL Details page is displayed.
To disregard changes, click Cancel.
On the WSDL Details page, click OK. The state of the WSDL is displayed as Valid.
