Working with UDDI Registry

A UDDI registry (Universal Description, Discovery, and Integration) is an XML-based registry for businesses worldwide to list themselves on the Internet. It allows users to view, find, and share web services.

When working with a UDDI registry from Designer you can:

  • Discover the web services published in a UDDI registry.

    Designer displays a list of the web services that are published in a UDDI registry. By default, Designer displays all published services, but you can use a filter to limit the number of services shown.

  • Incorporate a web service into Integration Server.

    You can incorporate a web service in the UDDI registry into your integration solution by creating a consumer web service descriptor from the web service. Designer automatically generates a web service connector for each operation in the web service, which can be invoked in the same way as any other IS service. For more information, see Web Services Developer’s Guide.

  • Publish services to a UDDI registry.

    You can make a service that resides on Integration Server (such as a flow service, Java service, C service, or adapter service) available as an operation of a web service and then publish the web service to a UDDI registry.

Opening UDDI Registry View

About this task

To connect to a UDDI registry from Designer, you must open the UDDI Registry view.

The UDDI Registry view contains icons to represent the UDDI registry, the registered business entities, and the web services published to the UDDI registry. The UDDI Registry view also contains a toolbar with buttons for performing various operations.

Note: If your UDDI registry is CentraSite, you will also be able to use the Registry Explorer view in Designer in addition to the UDDI Registry view. The Registry Explorer view displays the contents of the CentraSite registry to which Designer is currently connected. To open the Registry Explorer view, select Window > Show View > Other and in the Show View dialog box, select CentraSite > Registry Explorer.

To open the UDDI Registry view

Procedure

  1. In Designer: Window > Show View > Other.
  2. In the Show View dialog box, select Software AG Service Development > UDDI Registry.
  3. Click OK. Designer displays the UDDI Registry view.

Connecting to a UDDI Registry

About this task

To use Designer to view or publish web services, you must first connect to a UDDI registry.

Keep the following points in mind when connecting to a UDDI registry:

  • Designer supports UDDI v3 only. It will not connect to a registry based on earlier versions of UDDI.
  • You must have a valid UDDI v3 registry account, configured with the proper permissions to perform UDDI activities.
  • The specified UDDI v3 registry must contain at least one business entity. A business entity is a logical grouping of web services, used to represent businesses and providers within UDDI. You must publish each web service within a business entity.
  • You can only connect to one UDDI registry at a time from Designer. To connect to another UDDI registry, you must first disconnect from the existing session.
  • While connecting to a UDDI registry, if you enter only the Inquiry URL, the UDDI connection will be unauthenticated. You can only view entities or services that are viewable anonymously as per the registry policies. To publish a web service, you must authenticate the connection by providing Security URL, Publish URL, UDDI user ID, and password.

To connect to a UDDI registry

Procedure

  1. In UDDI Registry view, right-click and select Open UDDI Registry Session.
  2. In the Open UDDI Registry Session dialog box, select Add New Registry.
  3. In the Registry Name field, enter a name for the UDDI registry.
  4. Enter information in the following fields as appropriate:
    In this field... Enter
    Inquiry URL The URL configured for browsing the UDDI registry. This field is mandatory.
    Security URL The security URL for the UDDI registry. This field can be mandatory or optional, depending on the registry.
    Publish URL The URL configured for publishing services to the UDDI registry. This field is mandatory if you want to publish a web service descriptor to the UDDI registry.
  5. Enter your UDDI registry user ID and password.
  6. Click Finish.

Disconnecting from a UDDI Registry

Procedure

In UDDI Registry view, right-click and select Close UDDI Registry Session.

Refreshing a UDDI Registry Session

About this task

Designer refreshes the contents of the UDDI Registry view when you create a web service automatically. However, you will need to refresh the UDDI registry session in the following situations:
  • Other users add or delete web services from the UDDI registry.
  • Designer loses its connection to a UDDI registry.
  • The UDDI registry operates with some form of governance and a newly added web service does not appear immediately.

To refresh a UDDI registry session

Procedure

In UDDI Registry view, right-click and select Refresh UDDI Registry Display. Integration Server refreshes the display of the UDDI registry.

Browsing for Web Services in a UDDI Registry

After you connect to a UDDI registry, you can browse for web services that you would like to incorporate into your integration solution. You can discover web services by scrolling through the UDDI Registry view. By default, the UDDI Registry view displays all services published in the UDDI registry.

To help find a particular web service, you can reduce the number of displayed web services by filtering the contents of the UDDI Registry view based on the value of a specified web service property.

Applying a Filter to UDDI Registry

About this task

To make it easier to find a particular web service from the list of all the services published in the UDDI registry, you can filter the contents of the UDDI Registry view.

When applying a filter to the UDDI Registry view, keep the following points in mind:

  • Designer continues to apply the specified filter until you explicitly clear the filter. Designer saves the filter string across Designer and UDDI registry sessions.
  • If you publish a service that does not meet the criteria specified in the currently applied filter, Designer does not display the newly published web service in the UDDI Registry view.
  • Designer applies each filter that you create to the entire contents of the UDDI registry. For example, if you apply two filters in succession, Designer clears the first filter before applying the second filter. Designer does not apply the second filter to the results of the first filter.

To filter the contents of the UDDI Registry view

Procedure

  1. In UDDI Registry view, right-click and select Filter UDDI Registry Display.
  2. In the Filter UDDI Registry Display dialog box, in the Enter Filter Text field, type the text to use as the filter criteria.

    Integration Server treats the text as a partial string. For example, if you enter “vic”, “victory” and “services” will both fit the search criteria. The percent sign (%) can be used for an approximate search within the text. For example, for “a%n”, “ain” and “Amazon” fit the search criteria.

  3. Select the check boxes for WebService Name, WebService Description, or both to specify which properties you want Designer to examine for the Enter Filter Text text string.
  4. Click OK to apply the filter.

Clearing an Applied Filter

About this task

If you have applied a filter to limit the contents of the UDDI Registry view, Designer continues to use this filter until you explicitly remove the filter. If the button on the UDDI Registry view toolbar is active, it indicates that Designer is using a filter to limit the displayed web services.

To clear a filter

Procedure

  1. In UDDI Registry view, right-click and select Clear UDDI Filter.
  2. Click OK to confirm removing the filter.

    Designer removes the filter and displays all the published web services in the UDDI registry.

Creating a Web Service Descriptor from a UDDI Registry

About this task

You can create a consumer or WSDL first provider web service descriptor from a web service in the UDDI registry.

To create a web service descriptor from a web service in a UDDI registry

Procedure

  1. In UDDI Registry view, right-click and select Create Web Service Descriptor.
  2. In the New Web Service Descriptor dialog box, select either Provider (Inbound Request) or Consumer (Outbound Request).

    Follow the prompts that Designer displays and enter the required information for the type of web service descriptor you are creating. Designer creates the provider web service descriptor and saves it to the folder you specified. Designer also creates supporting IS elements, such as flow services and IS document types.

What to do next

Note: You can also create a web service descriptor by dragging and dropping a service from the UDDI Registry view to a folder in the Package Navigator view.

Publishing a Service to UDDI Registry

About this task

For a service (flow, Java, C, adapter) to be available as a web service through a UDDI registry, you must first create a service first provider web service descriptor that uses the IS service as an operation and then publish that web service descriptor to the UDDI registry.

When you use Designer to publish a web service to a UDDI registry, the Integration Server creates a WSDL file and adds it to the registry.

Keep the following points in mind when you publish a service to a UDDI registry using Designer:

  • You can publish a service by creating a provider web service descriptor for the service and dragging it directly from the Package Navigator view to the UDDI Registry view or by right-clicking a provider web service descriptor in the Package Navigator view and selecting Publish Web Services to a UDDI Registry. Designer publishes the service in the UDDI registry with the following characteristics:
    • SOAP 1.1 as the protocol
    • SOAP Document/Literal as the style and use
    • http://host:port as the as the address of the web service
  • You can publish a provider web service descriptor to the CentraSite UDDI registry in two different ways:
    • By publishing the package that contains the provider web service descriptor via metadata publishing.
    • By publishing the provider web service descriptor through the UDDI Registry view.

    If you want to publish IS assets in addition to web services, publish the provider web service descriptor by publishing the entire package. If you expect to publish only web services to CentraSite, publish the individual provider web service descriptor through the UDDI Registry view. Typically, users choose one way or the other for publishing web service assets. Software AG does not recommend using a mixture of publishing methods.

  • Before publishing a service to a UDDI registry, be sure to create a provider web service descriptor using the IS service as an operation of the web service.

To publish a service to a UDDI registry

Procedure

  1. From UDDI Registry view, connect to the UDDI registry in which you want to publish the web service.
  2. In Package Navigator view, copy the provider web service descriptor that contains an operation for the IS service that you want to expose as a web service.
  3. In UDDI Registry view, right-click the entity to which you want to publish the web service and select Publish Web Service.

    Designer publishes the service to the UDDI registry.

Results

Notes:
  • The governance policies established in the registry may delay the display of the published web service in the UDDI Registry view. Refresh the UDDI registry by selecting Refresh UDDI Registry Display from the context menu to view the published service.
  • If Designer cannot display the service you just published in the UDDI Registry view because of the filter setting, Designer will display a message stating so. Clear the applied filter by selecting Clear UDDI Filter from the context menu.
  • If you publish the same web service descriptor to a registry twice (without first deleting the original version), two web services will exist with the same name in the registry. However, the Service Key property values will be different for these two services. If you cannot determine which version is the newest, delete both web services from the UDDI registry and re-publish the new version.

Deleting a Service from UDDI Registry

About this task

Perform the following steps to delete a web service from a UDDI registry. When you remove a web service from a registry, the associated web service descriptor and its supporting elements still exist on the Integration Server but the web service is no longer published in the UDDI registry.
Note: You cannot delete a web service from another business’ folder in the registry. The Delete button will be disabled.

To delete a web service from UDDI registry

Procedure

  1. In UDDI Registry view, right-click the web service that you want to remove and select Delete.
  2. Click Yes to confirm deleting the web service.