7 WSDLs

This chapter describes how to create, locate, edit, delete, and fix unresolved references to WSDL resources using the Oracle Service Bus Administration Console.

A WSDL (Web Service Definition Language) is the formal description of a Web Service; in Oracle 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. See Section 20.2.1, "General Configuration Page" and Section 19.1, "Creating and Configuring Business Services."

For more information, see "How WSDL is Used in Oracle Service Bus" in the Oracle Fusion Middleware Administrator's Guide for Oracle Service Bus.

7.1 Locating WSDLs

To locate WSDLs:

  1. Do either of the following:

    • Select Project Explorer to display the Projects View Page or the Project/Folder View page. Then navigate through projects and folders to find the WSDL.

    • Select Resource Browser > WSDLs. The Summary of WSDLs page displays the information shown in Table 7-1. For a more detailed description of the properties, see Section 7.3, "Editing WSDLs."

  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 7-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 Section 7.3, "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 Section 4.1.1, "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 Section 7.4, "Deleting WSDLs."


7.2 Adding WSDLs

Before You Begin: If the WSDL resource you want to create contains URL references to external schemas that do not currently exist in Oracle Service Bus, such as http://www.w3.org/2001/XMLSchema.xsd, you must import those URL-referenced schemas—and any dependent schemas—into Oracle Service Bus by creating XML Schema resources. WSDL resources in Oracle Service Bus can only reference locally available schemas. For more information, see Section 5.2, "Adding XML Schemas."

To add a WSDL:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "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 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.

    Follow the Section 2.3, "Resource Naming Restrictions" for naming guidance.

  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.

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

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

7.3 Editing WSDLs

To edit a WSDL:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "Using the Change Center."

  2. Locate the WSDL, as described in Section 7.1, "Locating WSDLs."

  3. Click the WSDL name. The View WSDL Details page displays the information shown in Table 7-2, Table 7-3, and Table 7-4.

    Table 7-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 Section 4.23, "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 Section 4.22, "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 Section 4.22, "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 7-3.

    Table 7-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 Section 7.6, "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 7-4.

    Table 7-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 Section 7.2, "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.

7.4 Deleting WSDLs

To delete a WSDL:

  1. If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Section 3.1, "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.

7.5 Viewing Unresolved WSDL References

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

Table 7-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:

  • Resort the list. Click on an underlined column name. Ascending and descending arrows indicate the sort order. Click the column name to change the sort order.

  • Scroll through the pages. Use the page controls above or below the table. 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.

7.6 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 Section 3.1, "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 Section 3.1, "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.