Using the AquaLogic Service Bus Console
|
 |
 |
|
 |
 |
WSDLs
This section includes the following topics:
- Overview of WSDLs
- Listing and Locating WSDLs
- Adding a WSDL
- Viewing and Changing WSDL Details
- Deleting a WSDL
- Viewing Unresolved WSDL References
- Resolving Unresolved WSDL References
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:
|
A container for data type definitions using a specific type system (for example, XML Schemas). |
|
|
An abstract, typed definition of the data being communicated. |
|
|
An abstract description of an action supported by the service. |
|
|
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. |
|
|
For a definition of a WSDL Binding, see http://www.w3.org/TR/wsdl#_bindings. |
|
|
For a definition of a WSDL port, see http://www.w3.org/TR/wsdl#_ports. |
|
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.
- 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 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. |
|
|
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. |
|
|
Click the Delete icon to delete a specific WSDL. To learn more, see Deleting a WSDL. |
Related Topics
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.
- 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.
- 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.
- Enter text for the new WSDL.
- Click Browse to locate and import an existing WSDL.
- Copy and paste text from an existing WSDL into this field.
- 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: Click the name of a folder to select it. The Folder View page is displayed.
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
Viewing and Changing WSDL Details
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
- Locate the WSDL. To learn more, see Listing and Locating WSDLs.
The structural view of the WSDL is displayed by default, which includes the following information:
The namespace used to qualify any of the definitions included in 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:
- 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.
|
The user who created this WSDL or imported it into the configuration. |
|
|
The date and time that the user created this WSDL or imported it into the configuration. |
|
|
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. |
|
|
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. |
|
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
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.
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
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.
|
The name assigned to the WSDL. Click the name of a specific WSDL to view details for that WSDL. |
|
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
Viewing and Changing WSDL Details
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 Browse. Depending on the resource type, the WSDL Browser or the XML Schema Browser is displayed.
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.
