Console Online Help
WSDLs
This section includes the following topics:
Overview of WSDLs
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:
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.
|
Binding
|
For a definition of a WSDL Binding, see http://www.w3.org/TR/wsdl#_bindings.
|
Port
|
For a definition of a WSDL port, see http://www.w3.org/TR/wsdl#_ports.
|
Service
|
A collection of related endpoints.
|
Endpoint
|
The transport URL for a service.
|
URL
|
The address at which a WSDL is located.
|
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:
Listing and Locating WSDLs
The Summary of WSDLs page enables 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.
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.
Note: Click View All to display all WSDLs.
Related Topics
Adding a WSDL
Viewing Unresolved WSDL References
Resolving Unresolved WSDL References
Adding a WSDL
The Create a New WSDL Resource page 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. 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:
- 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.
Related Topics
Listing and Locating WSDLs
Viewing and Changing WSDL Details
Deleting a WSDL
Resolving Unresolved WSDL References
Viewing and Changing WSDL Details
The WSDL Details page 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.
To View and Change WSDL Details
- Click the WSDL name. The WSDL Details page displays the following information for the WSDL:
Property
|
Description
|
Resource Name
|
The name and path assigned to this WSDL.
|
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:
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 State
|
The status of the WSDL:
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.
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:
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.
- 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.
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.
Related Topics
Viewing Unresolved WSDL References
Resolving Unresolved WSDL References
Deleting a WSDL
Deleting a WSDL
The Summary of WSDLs page enables 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.
Related Topics
Listing and Locating WSDLs
Adding a WSDL
Viewing and Changing WSDL Details
Viewing Unresolved WSDL References
Resolving Unresolved WSDL References
Viewing Unresolved WSDL References
The View Unresolved WSDL References page displays the following information for each WSDL reference. To learn more about WSDLs, see Overview of WSDLs.
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.
Related Topics
Listing and Locating WSDLs
Adding a WSDL
Viewing and Changing WSDL Details
Deleting a WSDL
Resolving Unresolved WSDL References
Resolving Unresolved WSDL References
The Edit the References of a WSDL Resource page enables 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.
- 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.
- 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.
Related Topics
Listing and Locating WSDLs
Adding a WSDL
Viewing and Changing WSDL Details
Deleting a WSDL
Viewing Unresolved WSDL References