> Using the AquaLogic Service Bus Console > WSDLs

Using the AquaLogic Service Bus Console

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

WSDLs

A WSDL (Web Service Definition Language) is the formal description of a Web Service; in ALSB, 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. See Create/Edit a Proxy Service - General Configuration page and Creating and Configuring Business Services.

For more information, see How WSDL is Used in ALSB in the AquaLogic Service Bus User Guide.

Locating WSDLs

  1. Do either of the following:
  2. To locate a specific WSDL:
    • Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
    • To restrict the number of items in the list, you can filter by name, path, and namespace. In the Name, Path, and Namespace fields, enter the name, path, and namespace of the search target(s), then click Search.

      • The path is the project name and the name of the folder in which the WSDL resides.

    • Click View All to remove the search filters and display all WSDLs.

      • Table 6-1 WSDL Details 
      Property
      Description
      WSDL Name
      The unique name assigned to the WSDL. The name is a link to the View WSDL Details page. See Editing WSDLs.
      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. See Qualifying Resource Names Using Projects and Folders.
      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. See Deleting WSDLs.

Adding WSDLs

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Project Explorer, then select a project or folder in which to add the WSDL. The Project/Folder View page is displayed.
  3. From the Create Resource drop-down list, select WSDL from under Interface to display the Create a New WSDL Resource page.
  4. In the Resource Name field, enter a unique name for this WSDL. This is a required field.
  5. In the Resource Description field, enter a description for the WSDL.
  6. In the WSDL field, do one of the following:
    • 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.

      • This is a required field.

  7. Click Save. The new WSDL is saved in the current session.

    8. When you click Save, if there any unresolved references for the new WSDL, the system displays them. See Viewing Unresolved WSDL References.

  8. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Editing WSDLs

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Locate the WSDL, as described in Locating WSDLs.
  3. Click the WSDL name. The View WSDL Details page displays the information shown in Table 6-2, Table 6-3, and Table 6-4.

    4. Table 6-2 WSDL Details 
    Property
    Description
    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. Click the date and time link to view the change history of this resource. See View Change History page.
    References
    The number of objects that this WSDL references. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
    Referenced by
    The number of objects that reference this WSDL. If such references exist, click the numeric link to view a list of the objects. For example, if you select this WSDLs 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. See Viewing References to Resources.
    Description
    A description of this WSDL, if one exists.

    The structural view of the WSDL is displayed by default, which includes the information shown in Table 6-3.

    Table 6-3 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
    • WS-Policy References
    • Implicit WS-Policy References
    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. See Resolving Unresolved WSDL References.

  4. Click Text view to display a text view of the WSDL details. The text view includes the information shown in Table 6-4.

    5. Table 6-4 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.

  5. To make a change to the fields, click Edit. See Adding WSDLs for descriptions of the fields.
  6. Make the appropriate edits.
  7. Click Save to commit the updates in the current session.
  8. To end the session and deploy the configuration to the run time, click Activate under Change Center.
Note: The View 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.

Deleting WSDLs

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Resource Browser > WSDLs.
  3. Click the Delete icon in the Options field of the WSDL you want to delete. The WSDL is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
  4. To end the session and deploy the configuration to the run time, click Activate under Change Center.

Viewing Unresolved WSDL References

The View Unresolved WSDL References page displays the information shown in Table 6-5.

Table 6-5 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 locate a specific reference:

Resolving Unresolved WSDL References

Use the Edit the References of a WSDL Resource page 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.

Resolving an Unresolved WSDL or XML Schema Reference
  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Resource Browser > WSDLs.
  3. On the Summary of WSDLs page, in the WSDL Name column, click the appropriate WSDL name to view details of the unresolved reference. The View WSDL Details page is displayed.
  4. Click Edit References to display the Edit the References of a WSDL Resource page.
  5. In the Resource Type field, select WSDL or select XML Schema.
  6. Click Browse. Depending on the resource type, the WSDL Browser or the XML Schema Browser is displayed.
  7. In the WSDL Browser or XML Schema Browser, select a WSDL or XML Schema, then select a definition from the Definitions pane.
  8. Click Submit. The WSDL or XML Schema you selected is displayed in the Resource Name field.
  9. Click Save to resolve the reference.
  10. On the View WSDL Details page, click OK. The state of the WSDL is displayed as Valid.
Resolving an Unresolved WS-Policy Reference
  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
  2. Select Resource Browser > WSDLs.
  3. On the Summary of WSDLs page, in the WSDL Name column, click the appropriate WSDL name to view details of the unresolved reference. The View WSDL Details page is displayed.
  4. Click Edit References to display the Edit the References of a WSDL Resource page.
  5. In the WS-Policy Name field, click Browse. The Policy Browser is displayed.
  6. In the Policy Browser, select a WS-Policy.
  7. Click Submit. The WS-Policy you selected is displayed in the WS-Policy Name field.
  8. Click Save to resolve the reference.
  9. On the View WSDL Details page, click OK. The state of the WSDL is displayed as Valid.

  Back to Top       Previous  Next