Create a new UDDI reference

Create a reference (a pointer) to a UDDI registry for use with service integration bus-enabled web services.

This topic assumes that we have already created a J2C authentication alias for each Authorized Name to associate with this UDDI reference. For more information about Authorized Names, see UDDI registries: Web service directories that can be referenced by bus-enabled web services.

A UDDI reference is a pointer to a UDDI registry. This registry can be a private UDDI registry such as the IBM WebSphere UDDI Registry, or a public UDDI registry. The service integration technologies interact with UDDI registries in two ways:

• When you configure an inbound service, we can create entries for the web service in one or more UDDI registries.

• When you configure an outbound service, specified the location of the target WSDL file that describes the web service. This WSDL file can be located at a URL or through a UDDI registry.

In the UDDI model, web services are owned by businesses, and businesses are owned by Authorized Names. Each UDDI reference gives access to the Web services that are owned by a single Authorized Name in a single UDDI registry. For more information about how the service integration technologies work with UDDI registries, see UDDI registries: Web service directories that can be referenced by bus-enabled web services and Publishing a web service to a UDDI registry. For more general information about UDDI and UDDI registries, see the UDDI community at uddi.org.

To create a new UDDI reference...

1. Start the console.

2. In the navigation pane, click Service integration -> Web services -> UDDI References. The UDDI references collection form is displayed.

3. Click New. The UDDI references settings form is displayed.

4. Type the following general properties:

   Name

   Type the name by which the UDDI reference is known. This name must be unique, and it must follow the following syntax rules:

   • It must not start with "." (a period).

   • It must not start or end with a space.

   • It must not contain any of the following characters: \ / , # $ @ : ; " * ? < > | = + & % '

   We might need more than one UDDI reference for a given UDDI registry. For more information, see UDDI registries: Web service directories that can be referenced by bus-enabled web services.

   Description

   Type the (Optional) description of the UDDI reference.

   Inquiry URL

   Type the web address that provides access to this registry for the SOAP inquiry API.

   Publish URL

   Type the web address that provides access to this registry for the SOAP publish API.

   Authentication alias

   Type the J2C authentication alias for the user ID and password of an "Authorized Name" that has update access to this registry.

   The alias you enter here must match the user ID of our owner of the corresponding business in the UDDI registry. We can see our owning user ID in UDDI by looking at the business details under the "Authorized Name" field. If the alias you enter here does not match the "Authorized Name" value for the business that owns the service, then the service is not published or found.

   If the business has more than one "Authorized Name", you might want to set up multiple UDDI references (each with a different authentication alias) to the same UDDI registry.

5. Click OK.

Results

If the processing completes successfully, the list of UDDI references is updated to include the new UDDI reference. Otherwise, an error message is displayed.

What to do next

To use this UDDI reference, select it when Making an internally-hosted service available as a web service or Making an externally-hosted web service available internally.

Subtopics

• Modify an existing UDDI reference
  Modify the configuration details for a UDDI reference that has been configured for use with service integration bus-enabled web services.

• Delete UDDI references
  delete UDDI references configured for use with service integration bus-deployed web services.

• Publish a web service to a UDDI registry
  When you configure an inbound or outbound service, you enable UDDI interaction by associating the service with a UDDI reference, and (depending upon what you are trying to do) either or both of the following pieces of information: The business key identifying UDDI business category under which we want the service to appear in the UDDI registry, and the service-specific part of the service key that the UDDI registry assigns to the service. To help you understand what UDDI business keys and service keys are, and where you find them in a UDDI registry, here is a description of how to publish a web service to a UDDI registry.

Related concepts

UDDI registries: Web service directories that can be referenced by bus-enabled web services