Chapter 6: Web Console—Registry Services

Searching and publishing to UDDI registries

This section describes how to search, query, and publish to UDDI registries.

Inquiries and searches

From the Web console, you can query the private UDDI registry as well as external UDDI registries to locate potential clients or suppliers based on business type, categories, services, and so on. Locate information about specifications, protocols, and namespaces of services and classification systems through the tModels that describe and identify them.

Searching UDDI registries

This section describes how to search a registry by business, service, or tModel entry.

Searching a registry

Select the Search folder.
Complete the search options for the type of search you want to perform and click Search. Table 6-2 describes the search properties.
When the search completes, click the Results folder to view the results.
Click any of the items returned from the search to view additional information about a business, service, or tModel.

**Table 6-2: Search properties**
Search type	Options	Description
Business	Business name	Enter a name of a business for which you are searching.
	Sort by name	Select this check box and click Ascending or Descending, depending on the order you want to display the businesses.
	Sort by date	Select this check box to sort businesses by the date they were created or modified.
	Case sensitive	Considers case when performing a search.
	Exact match	Search only for those businesses that exactly match the Business name.
	Advanced options	Advanced search options allow you to search by: Categories – can be used in searches to locate information in a registry based on business, service, or tModel category. Identifiers – an industry-standard identifier is unique to a business or tModel.
	Add Category	Add a category to this business. See “Categories” for more information about categories.
	Add Identifier	Add an identifier to this business. See “Identifiers” for more information about identifiers.
Service	Service name	Enter a name of a service for which you are searching.
	Sort by name	Select this check box and click Ascending or Descending depending on the order you want to display the service.
	Sort by date	Select this check box to sort services by the date they were created or modified.
	Case sensitive	Consider case when performing a search.
	Exact match	Search only for those services that exactly match the Business name.
	Add Category	Add a category to this business. See “Categories” for more information about categories.
tModel	tModel name	Enter a name of a tModel for which you are searching.
	Sort by name	Select this check box and click Ascending or Descending, depending on the order you want to display the tModel.
	Sort by date	Select this check box to sort tModels by the date they were created or modified.
	Case sensitive	Consider case when performing a search.
	Exact match	Search only for those services that exactly match the tModel name.
	Add Category	Add a category to this business. See “Categories” for more information about categories.
	Add Identifier	Add an identifier to this business. See “Identifiers” for more information about identifiers.

Publishing

You can publish and manage information about your business, its organization, Web services, or other services offered from the Web console to a UDDI registry. After the business or service is published, the information is accessible to the clients of the registry.

Businesses

A UDDI registry allows you to describe your business and publish information about the services of that business. You can list categories and identifiers to which the business belongs, which provides additional ways for clients to search your business for particular services. You can supply contact information so that your business can be located easily.

Adding a business

Expand the Publish folder.
Right-click the Published Businesses folder and select Add Business.
Follow the Add Business Entity wizard to add a business. See Table 6-3 for a description of the business properties.

Deleting a business

Expand the Publish folder.
Expand the Published Businesses folder.
Right-click the business you want to delete and select Delete.

**Table 6-3: Business properties**
Tab	Property	Description
Business	Name	The name of the published business.
	Description	A description of the business.
	Key	A unique key that is generated when the business is registered.
	Related businesses	The key of any related or similar businesses.
Summary		Displays a summary of your selections. Click Finish to create the business, or click Back to change selections.

For each published business, you can add a:

Service – see “Services”
Contact – see “Contacts”
Discovery URLs – see “Discovery URLs”
Categories – see “Categories”
Identifiers – see “Identifiers”

Services

Web services reside in businesses. Web services can be organized into categories using identifiers, and can include access information that provides easy access to clients.

Adding a service

Expand the Publish folder.
Right-click the Published Services folder and select Add Service. Or, to add a service to an existing business, expand the Published Businesses folder and select the Published Services folder within it and select Add Service.
Follow the Add Service Entity wizard to add a service. See Table 6-4 for a description of the service properties.

Deleting a service

Expand the Publish folder.
Expand the Published Services folder.
Right-click the service you want to delete and select Delete.

Table 6-4 describes the service properties.

**Table 6-4: Service properties**
Tab	Property	Description
General	Name	The name of the service.
	Description	The description of the service.
	Language	The language name and description.
Summary		Displays a summary of your selections. Click Finish to add a service, or click Back to change selections.

For each published service, you can add:

Bindings – see “Bindings”
Categories – see “Categories”
Identifiers – see “Identifiers”

tModels

tModels reference a technical specification or description of a Web service. They provide descriptions of Web services that define service types. Each tModel includes a unique identifier (key) and points to a specification that describes the Web service. tModels provide a common point of reference that allows you to locate compatible services.

Adding a tModel

Expand the Publish folder.
Right-click the Published tModels folder and select Add tModel.
Follow the Add tModel Entity wizard to add a tModel. See Table 6-5 for a description of the tModel properties.

Deleting a tModel

Expand the Publish folder.
Expand the Published tModels folder.
Right-click the tModel you want to delete and select Delete.

**Table 6-5: tModel properties**
Tab	Property	Description
General	Name	Name of the tModel.
	Description	Description of the tModel.
	Language	The language name and description.
Summary		Displays a summary of your selections. Click Finish to create the tModel, or click Back to change selections.

For each published tModel, you can add a:

Discovery URL– see “Discovery URLs”
Categories – see “Categories”
Identifiers – see “Identifiers”

Additional registry information for published businesses, tModels, and services

After you have published businesses, tModels, or services to a registry, you can add additional information to each.

Bindings

Bindings are the mechanisms that bind the abstract definition (overview document, or description) of a Web service to the concrete representation (access point) of that service.

Adding a binding to a service

Expand the Publish folder.
Expand the Published Services folder.
Expand the service to which you are adding a binding.
Right-click the Bindings folder and select Add ServiceBinding.
Follow the Add ServiceBinding Entity wizard to add a binding. See Table 6-6 for a description of the binding properties.

Deleting a binding from a service

Expand the Publish folder.
Expand the Published Services folder.
Expand the service to which the binding you are deleting belongs.
Expand the Bindings folder.
Right-click the binding you want to delete and select Delete.

Table 6-6 describes the binding properties.

**Table 6-6: Binding properties**
Tab	Property	Description
General	Description	A description of the binding.
	Access point	An address for accessing a Web service must be a valid URL.
	Language	The language name and description.
Summary		Displays a summary of your selections. Click Finish to create the binding, or click Back to change selections.

**Table 6-7: Category properties**
Tab	Property	Description
General	Categorization Scheme	Select the categorization scheme to use with the Web service, tModel, or business.
	Name	The name of the category.
	Value	Each category has a corresponding value.
	Key	A unique key that is generated when the category is registered.

Identifiers

Similar to categories, identifiers provide identification information, which allows businesses, services, and tModels to be associated with some identification scheme, such as model identification, or an industry group identification number.

Adding an identifier to a business, service, or tModel

Expand the Publish folder.
Expand the Published Businesses, Services, or tModels folder.
Expand the business, service, or tModel for which you are adding an identifier.
Right-click the Identifiers folder and select Add Identifier.
Follow the Add Identifier Entity wizard to add an identifier. See Table 6-8 for a description of the identifiers properties.

Deleting an identifier from a business, service, or tModel

Expand the Publish folder.
Expand the Published Businesses, Services, or tModels folder.
Expand the business, service, or tModel to which the identifier you are deleting belongs.
Expand the Identifiers folder.
Right-click the identifier you want to delete and select Delete.

**Table 6-8: Identifier properties**
Tab	Property	Description
General	Identification scheme	Select the identification scheme to use with the Web service.
	Name	The name of the identification.
	Value	Each identifier has a corresponding value.
	Key	A unique key that is generated when the identifier is registered.
Summary		Displays a summary of your selections. Click Finish to create the identifier, or click Back to change selections.

Contacts

A contact (name, phone number, address) for a given business or business service.

Adding a contact to a business

Expand the Publish folder.
Right-click the Published Businesses folder.
Right-click the business to which you are adding a contact and select Add Contact.
Follow the Add Contact wizard to add a contact. See Table 6-9 for a description of the contact properties.

Deleting a contact from a business

Expand the Publish folder.
Expand the Published Businesses folder.
Expand the business which contains the contact you are deleting.
Right-click the contact you want to delete and select Delete.

**Table 6-9: Contact properties**
Tab	Property	Description
General	Contact	The name of the contact; this could be a company or organization name.
	Description	A contact description.
	Contact person	A contact person.
	Address	The address of the contact.
	Phone number	The phone number of the contact.
Summary		Displays a summary of your selections. Click Finish to create the contact, or click Back to change selections.

Discovery URLs

A discovery URL is used to retrieve discovery documents for a specific instance of a business entity.

Adding a discovery URL to a business or tModel

Expand the Publish folder.
Right-click the Published Businesses or Published tModel folder.
Right-click the business or tModel to which you are adding a discovery URL and select Add Discovery URL.
Follow the Add Discovery URL wizard to add a Discovery URL. See Table 6-10 for a description of the Discovery URL properties.

Deleting a discovery URL from a business or tModel

Expand the Publish folder.
Expand the Published Businesses or Published tModel folder.
Expand the business or tModel which contains the discovery URL you are deleting.
Right-click the discovery URL you want to delete and select Delete.

**Table 6-10: Discovery URL properties**
Tab	Property	Description
General	Discovery URL	URL to the discovery document.
	Description	A description of the discovery document.
	Use type
	Language	The language name and description.
Summary		Displays a summary of your selections. Click Finish to create the discovery URL, or click Back to change selections.