Chapter 4 Using the UDDI Registry Site

UDDI registry interface

Web Services Toolkit allows you to publish a WSDL document that describes your Web service and its location to a UDDI registry Web site. A UDDI registry is a sort of yellow pages for businesses, the Web services they offer, and the technical foundations or specifications (called tModels) upon which they are written. You can specify a business name and description, contact information, and Web service properties for your business. Once your business or tModel is published potential customers can find it easily from a search. You can publish multiple Web services under the same business name, or create a new business name for different Web services.

Because Web Services Toolkit connects directly to UDDI registry host sites on the Web, you must first be a registered user on the site where you want to publish. To register, go to www.UDDI.org/register. The UDDI.org Web site maintains a current list of links to UDDI registry host sites where you can register. The information you publish from the Web Services Toolkit GUI to a UDDI registry host site is replicated by the host site to the other participating UDDI registry sites in approximately 24 hours.

This topic discusses:

• Connecting to a UDDI registry host site
• Adding a new UDDI business
• Adding properties to a UDDI Business
• Adding a service to a UDDI business
• Adding properties to a UDDI service
• Adding a contact to a UDDI business
• Adding a new UDDI tModel
• Add properties to a tModel
• Having trouble logging in to a UDDI registry site?

Connecting to a UDDI registry host site

To connect to a UDDI registry host site

1. Connect to Web Services Toolkit. See "Connecting Web Services Toolkit"for details.
2. Right-click on UDDI Entries under Web Services Toolkit in the main pane of Sybase Central. Select Login to a UDDI site. The UDDI Site Login dialog box opens.
3. From the Host Site drop-down list, select the site where you want to login. You must be a registered user on the site where you log in.
   
   If you have trouble logging in, see "Having trouble logging in to a UDDI registry site?".
4. Enter your userid and password for the UDDI site where you want to login. Click OK.

   To change the UDDI Registry host sites that appear in the drop-down list in the UDDI Site Login dialog box, edit the UDDISite.properties file in the Webservices directory in your EAServer installation.

To log out from a UDDI registry site

1. Right-click on UDDI Entries in the main pane of Sybase Central.
2. Select Logout from a UDDI Site.

Adding a new UDDI business

You can specify a business name on UDDI registry site. Once your business is published potential customers can find it easily from a search. You can publish multiple services under the same business name, or create a new business name for different services. Large companies often create business names for different divisions or sections.

   You cannot edit the properties of a UDDI service and publish them to a UDDI registry site unless you are connected to the site.

To create a new UDDI business

1. Connect to the UDDI registry site where you want to create a new business. Follow the steps in "Connecting to a UDDI registry host site".
2. Right-click Businesses in the main pane of Sybase Central. Select New UDDI Business. The New UDDI Business dialog box opens.
3. Enter a business name in the UDDI Business Name box.
4. Select a language from the Language drop-down list. (This step is optional.)
5. Enter a description of your business. (This step is optional.)
6. Click OK.

   If you are adding a second business, some UDDI registry sites require you to specify during initial registration, the ability to add more than one business. Check your UDDI registry site to see what their rules are on adding multiple businesses and how to gain permission to do so.

Adding properties to a UDDI Business

You can add properties to your business name that will help describe it in more detail. You can add to your business description, specify more detailed business categories, add Identifier Types and Values, and view a read-only Discovery URL.

Identifiers on a UDDI registry site

UDDI has adopted two specific systems of business identification:

• The Dun and Bradstreet D-U-N-S number
• The Thomas Register

The Dun and Bradstreet D-U-N-S Number

The Dun and Bradstreet (D&B) D-U-N-S Number is a unique nine-digit identification number, which provides unique identifiers of single business entities, while linking corporate family structures together. Used by many of the world's standards-setting organizations, it is recognized, recommended, or required by more than 50 global, industry, and trade associations, including the United Nations, the U.S. Federal Government, the Australian Government, and the European Commission.

For more information, go to the Dun and Bradstreet Web site www.dnb.com/duns_update/ .

The Thomas Register

The Thomas Register classifies products and companies under specific Product Headings, which helps users easily find who makes what. For example, if you search under the product Nails, you are given a list of Product Headings to help you narrow down what type of nails you are looking for, such as: nails: collated; nails: galvanized; or nails: drywall.

For more information, go to the Thomas Register Web site www.thomasregister.com/ .

To add properties to a UDDI business

1. Under UDDI Entries in the main pane of Sybase Central, right-click on the business to which you want to add properties. Select Properties. The UDDI Business Properties dialog box opens.
2. Select the tab for the property you want to add. The four tabs are:
   • General - to change the language from the drop-down list, or add information to the Description box.
   • Categories - to select specific categories from the drop-down list that more specifically fit your business. Click Add to see the drop-down list. You can select multiple categories by holding down the Control key and clicking the mouse button. Select one or more categories and click OK.
     
     To delete a category, select the category listed and click Delete.
   • Identifiers - to add Identifier Types and Values.
     
     Identifier Types are unique identifiers issued to you from either Dun and Bradstreet, the Thomas Register, or a Custom type you create. To apply for a D&B D-U-N-S number, go to their Web site http://www.dnb.com/duns_update/ . To apply for a number from the Thomas Register, go to their Web site http://www.thomasregister.com/ .
     
     Click Add to add identifiers and their values.
     
     To delete an identifier, select the identifier and click Delete.
   • Discovery URL - generated from the UDDI registry site where you published your business. This tab is read-only.

Adding a service to a UDDI business

To add a new service to a UDDI business

1. Follow the steps in "Connecting to a UDDI registry host site".
2. Double-click Business to display your businesses.
3. Double-click the business to which you want to add a service. The Services and Contacts folders appear in the Details pane.
4. Right-click the Services folder in the Details pane. Select Add Service. The Add Service dialog box opens.
5. Enter a service name in the Service Name text field.
6. Select a language from the Language drop-down list. (This step is optional.)
7. Enter a description of your service. (This step is optional.)
8. Click OK to save your changes. The main window of Sybase Central appears.

Adding properties to a UDDI service

To add properties to a UDDI service

1. Follow the steps in Connecting to a UDDI registry host site.
2. Double-click the Business folder to display your businesses.
3. Double-click the business that contains the service you want to modify. The Services and Contacts folders appear in the Details pane.
4. Double-click the Services folder in the main pane of Sybase Central. The existing services appear.
5. Right-click on the service you want to modify. The UDDI Service Properties dialog box opens.
6. Select the tab for the property you want to add. The four tabs are:
   • General - You can change the language from the drop-down list, or add information to the Description box.
   • Categories - You can select specific categories from the drop-down list that more specifically fit your business. Click Add to see the drop-down list. You can select multiple categories by holding down the Control key and clicking the mouse button. Select one or more categories and click OK.
     
     To delete a category, select the category listed and click Delete.
   • Binding - You set the following values for your UDDI Web service:
     • Access Type-choose HTTP, HTTPS, mailto, FTP, fax, or phone
     • Access Point - contains the network end point address for your Web service.

          If the Access Type and Access Point fields contain data, a tModel must be associated with the binding.

     • Description - describes the binding. This step is optional.
     • Get tModel - specifies the tModel that describes the service in technical detail.

          To find the tModel in the UDDI registry, you must enter the tModelKey. You can find the tModelKey for tModels you create in the second column of the Details tab, when you select tModels in the main pane of Sybase Central.

     • Parameters - specifies settings, parameters or a URL reference to a file that contains settings or parameters required to use a facet of the Binding Template. If it contains the actual settings or parameters, Sybase recommends that the data be specified as a namespaced-qualified XML string. This step is optional.
     • Parameters Description - describes more details about the parameters. This step is optional.
7. Click OK to save your changes.

Adding a contact to a UDDI business

To add a contact to a UDDI business

1. Follow the steps in Connecting to a UDDI registry host site.
2. Double-click the Business folder.
3. Double-click the business to which you want to add a contact. The Services and Contacts folders appear in the Details pane.
4. Right-click the Contacts folder in the Details pane. Select Add Contact. The Add Contact dialog box opens.
5. Enter a contact name in the UDDI Service Name box.
6. Select a language from the Language drop-down list. (This step is optional.)
7. Enter a description of your contact. (This step is optional.)
8. Click OK. The main window of Sybase Central appears.

Adding properties to a UDDI business contact

To add properties to a contact:

1. Follow the steps in Connecting to a UDDI registry host site.
2. Double-click the business to which you want to add properties to a contact. The Services and Contacts folders appear beneath the business name.
3. Double-click the Contacts folder in the main pane of Sybase Central.
4. Right-click the contact name in the Details pane to which you want to add properties. Select Properties. The UDDI Contacts Properties dialog box opens.
5. Select the tab for the property you want to add. The three tabs are:
   • General-You can change the contact name, the contact role, the language from the drop-down list, or add information to the Description box.
   • E-mail list-Click Add and then click on the E-mail Usage field to enter a description for the e-mail. Click on the E-mail Address field to and enter the e-mail address. The E-mail Usage field is required only if more than one e-mail address is entered. When you enter more than one E-mail address, a description is required for each E-mail entry.
     
     To delete an e-mail, select the E-mail Usage or E-mail Address and click Delete.
   • Phone Number List-Click Add and then click on the Phone Usage field to enter a description for the phone number. Click on the Phone Number field and enter the telephone number. The Phone Usage field is required only if more than one phone number is entered. When you enter more than one phone number, a description is required for each Phone entry.
6. Click OK to save your changes.

Adding a new UDDI tModel

A tModel is an abstract construct that allows Web service providers to publish technical information about the Web services they offer. A tModel is used within UDDI to publish a technical document that describes a Web service, and to provide a way to indicate how a Web service is associated with a specification, concept, or design. tModels are associated with Service Binding Templates, but are created as independent entities at the save level as a Business entity. tModels provide a common point of reference that allows a technical interface to be registered, and compatible implementations of those interfaces to be easily identified.

To create a new tModel:

1. Connect to the UDDI registry site where you want to create a new tModel. Follow the steps in Connecting to a UDDI registry host site.
2. Double-click on UDDI Entries in the main pane of Sybase Central.
3. Right-click on tModels and select New UDDItModel. The New UDDI tModel dialog box opens.
4. Enter a tModel name in the UDDI tModel Name box.
5. Select a language from the Language drop-down list. This step is optional.
6. Enter a description of your tModel. This step is optional.
7. Enter the Overview URL. This URL specifies the location of an attached document. This step is optional.
8. Enter the Overview Description. This step is optional.
9. Click OK.

Add properties to a tModel

You can change or add properties to your tModel if you want to provide more details about it. Using the Categories tab, you can specify which industries your tModel applies to. Using the Identifiers tab, you can add unique identifiers that can make your tModel discoverable to other businesses.

To add properties to a UDDI tModel:

1. Connect to the UDDI registry site where you want to create a new tModel. Follow the steps in Connecting to a UDDI registry host site.
2. Double-click on UDDI Entries in the main pane of Sybase Central.
3. Click on tModels to show the list of tModels.
4. Right-click on the name of the tModel in the Details pane, to which you want to add properties. Select Properties. The UDDI tModel Properties dialog box opens.
5. Select the tab for the property you want to add. The three tabs are:
   • General-You can change tModel name, the tModel Description, the language from the drop-down list, the Overview URL, or the Overview Description.
   • Categories-You can select specific categories from the drop-down list that more specifically fit your business. Click Add to see the drop-down list. You can select multiple categories by holding down the Control key and clicking the mouse button. Select one or more categories and click OK.
     
     To delete a category, select the category listed and click Delete.
   • Identifiers-You can add Identifier Types and Values.
     
     Identifier Types are unique identifiers issued to you from either Dun and Bradstreet, the Thomas Register, or a Custom type you create. To apply for a D&B D-U-N-S number, go to http://www.dnb.com/duns_update/. To apply for a number from the Thomas Register, go to http://www.thomasregister.com/.
     
     Click Add to add identifiers and their values.
     
     To delete an identifier, select the identifier and click Delete.
6. Click OK.

   When you delete a tModel in the Web Services Toolkit GUI, you will continue to see the tModel in the GUI, but it will not be visible on the UDDI registry site where it was published.

Having trouble logging in to a UDDI registry site?

Any of the following suggestions can help you log in to a UDDI registry site if you are having trouble.

• Before you can publish a Web service on a UDDI Registry site, you must have a user ID and password for that site. To get a user ID and password, go to the UDDI Web site www.uddi.org/register.html , which maintains a current list of links to UDDI registry host sites where you can register.
• If you already have a valid user ID and password and are still unable to connect, make sure your transport.props file in the Webservices directory in your EAServer installation is pointing to the correct location of the cacerts file you want to use. If you change this file, you must shut down and restart Jaguar Manager.
  
  The proxy uses the cacerts file when sending SOAP requests over HTTPS. The server uses the transport.props file when logging in to the UDDI registry site. For more information about the cacerts file, certificates, or Secure Socket Layers (SSL), refer to the Sun Java Secure Socket Extension API User's Guide .
• You can also try logging directly in to the UDDI registry site where your business is registered. Your login may not be valid, or the site may be temporarily down.
• Check the UDDI Registry sites that appear in the drop-down list in the UDDI Site Login dialog box. They need to be the valid URLs that point to the sites. To check the UDDI Registry sites that appear in the drop-down list, see the UDDISite.properties file in the Webservices directory in your EAServer installation.

Copyright © 2002 Sybase, Inc. All rights reserved.