Publishing  Locate

Under the Catalog main menu tab, you can use publishing wizards to publish data to Oracle Service Registry.

[Note]Note

You must be logged in to publish data to Oracle Service Registry. See User Account to learn how to register your user account.

[Tip]Tip

To try publishing wizards, you can use the demo data account with the username demo_john and password demo_john.

Figure 12. Catalog Tree

Catalog Tree

You can publish the following data to Oracle Service Registry:

We will demonstrate publishing wizards in the following examples:

Publishing Providers  Locate

In this section we show, step by step, how to publish a provider. We will create the provider HR Services. To publish this provider:

  1. Login to Oracle Service Registry using the link under the Home main menu tab.

  2. Click on the Catalog main menu tab. Click on the Providers link in the Catalog tree. Then, click on the Publish a new provider link in the right-hand display area.

    [Note]Note

    If you do not see the Catalog main menu tab, log in with username demo_john and password demo_john in order to follow this example.

  3. The page shown in Figure 13 appears.

    Figure 13. Publish Provider - Step 1

    Publish Provider - Step 1
  4. Enter the provider name and description. You can also enter the home page URL of the provider. Click Next.

  5. The page shown in Figure 14 appears.

    Figure 14. Publish Provider - Step 2

    Publish Provider - Step 2
  6. Enter the contact's data, and click Add. This returns a list of contacts you have entered and a blank New Contact form. Click Finish when you have entered all of your contacts.

    The person's name is only a required field when you enter any contact information. It is possible to create a provider without a contact.

  7. On a publication registry, you then have the opportunity to request approval for the new provider as shown in Figure 15.

    Figure 15. Publish Provider - Approval Step

    Publish Provider - Approval Step

    For more information see Requestor's Actions.

Publishing Services  Locate

In this section, we will show you how to publish a business service step-by-step. The service will be created from a WSDL file accessible from the registry server. Note that it is also possible to publish a service without a WSDL, in which case some additional details must be entered.

The following locations are supported for the WSDL and documents it imports:

  • the server filesystem, perhaps on a network drive shared with user workstations;

  • an HTTP server, optionally:

    • requiring HTTP Basic authentication;

    • using SSL (https);

If Oracle Service Registry receives the response 401-Unauthorized when attempting to retrieve the WSDL or a (direct or indirect) import, you will be prompted for HTTP Basic authentication credentials (a login name and password). If necessary these will be used to retrieve subsequent imports. This assumes that the server for each import requires the same credentials or none at all.

[Note]Note

Oracle Service Registry will always attempt to retrieve imported documents without credentials first and will only try sending credentials if this results in a 401-Unauthorized response. A potential security issue is that a third-party server may be intentionally configured to return the 401-Unauthorized response to gain knownledge of credentials from Oracle Service Registry.

[Tip]Tip

In an SOA it is desirable for such documents to be widely accessible without unnecessary security constraints. Furthermore, once published to the registry, the documents will be accessible without the same credentials. The security policies governing the registry and servers from which WSDL documents and imports are retrieved, must take these issues of trust into account.

You can easily retrieve the WSDL URL for a service you want to publish using the Web Services Inspection Language (WSIL) service browser application deployed by default to Oracle Application Server 10.3. This application uses WSIL to find and expose the URL for every WSDL available within an Oracle Application Server cluster. You can simply locate the WSDL URL you need, then copy and paste it into the Registry's publication wizard.

To retrieve a WSDL URL using the WSIL service browser:

  1. Launch the WSIL service browser.

    Enter the following URL in a Web browser to access the WSIL service browser:

    http://ohs_host:ohs_port/inspection.wsil

    ohs_host and ohs_port have the following definitions:

    • ohs_host is the address of the OHS host machine.; for example, server07.company.com

    • ohs_port is the HTTP listener port assigned to OHS

  2. Locate the service you want to publish in the browser.

  3. Copy the WSDL URL for the selected service.

    The WSDL URL appears as the value of the location attribute.

To publish a business service:

  1. Login to Oracle Service Registry using the link under the Home main menu tab.

  2. Click on the Catalog main menu tab. Click on the WSDL Services link in the Catalog tree. Then, click Publish a new service in the right-hand display area.

    [Note]Note

    If you do not see the Catalog main menu tab, log in with username demo_john and password demo_john.

  3. The page appears as in Figure 16:

    Figure 16. Publish Services - Step 1

    Publish Services - Step 1

  4. From the Provider drop down list, select a provider. Which providers are listed depends on the user's permissions. The user must have permission to write to the provider. You can use the provider created in the previous section.

    Enter the location of the WSDL file. You can use the WSDL in the demo data located in the REGISTRY_HOME/demos/conf/employeeList.wsdl. You need to prefix the path with file:// in that case. For example, under windows the path might be file:///c:/oracle/registry/demos/conf/employeeList.wsdl.

    Click Next.

  5. If HTTP Basic authentication is required to access the WSDL then you will be presented with the screen shown in Figure 17.

    Figure 17. Entering HTTP Basic credentials

    Entering HTTP Basic credentials

    Enter credentials and click Next.

  6. The page shown in Figure 18 will appear.

    Figure 18. Publish Service - Service Properties

    Publish Service - Service Properties

  7. You can optionally specify service properties. The service Usage will classify the service by functional areas. You can enter the service certification status, release date, version and milestone. Then click Next .

  8. The next step allows you to specify service interface properties. You can specify the interface status and compliance.

    Figure 19. Publish Service - Interface Properties

    Publish Service - Interface Properties

    Then click Next.

  9. The last step of the wizard allows you to specify service endpoint properties.

    Figure 20. Publish Service - Endpoint Properties

    Publish Service - Endpoint Properties

    Then click Finish.

  10. A summary of how the service has been published to Oracle Service Registry will appear, as shown in Figure 21.

    Figure 21. Publish Service - Summary

    Publish Service - Summary

    On a publication registry, you then have the opportunity to request approval for the new service as shown in Figure 21. For more information see Requestor's Actions.