After you enable Microsoft Enterprise Universal Description, Discovery, and Integration (UDDI) Services on Windows Server 2003, you can use the user interface that UDDI Services provides to register XML Web services for your Connected Services Framework (CSF) distributed application.
Note. You should use the UDDI Publish command line tool to register Web services in the Service Catalog. You can also populate the Service Catalog by using the user interface that is provided by UDDI Services, however, by using the UDDI Publish tool you dramatically reduce the possibility of introducing errors to a t-Model and the services that you register in the Service Catalog.
The following related procedures are also part of the process for registering a Web service in the Service Catalog:
- Before you can publish a Web service, you must first create its provider. This provider represents the group or organization that is responsible for the service you are ready to publish and should be defined in accordance with your publishing guidelines.
- Optionally, you can add a contact for each person or contact point within your organization that can be contacted for support or assistance about a provider or the services it provides.
- Optionally, you can create a new service entity within its provider. This service represents the XML Web service that you want to publish in UDDI Services and should be defined in accordance with your publishing guidelines.
- You should create a binding for each of the access points to your service that you want to publish and expose. An access point is any point within your application or Web service where a function can be invoked. The number of bindings you publish depends upon the number of access points that you want to expose through UDDI Services.
- Optionally, you can create a t-Model to contain the properties of the Web service.
- You must create an Instance Info for each interface to a binding that you want to publish. An Instance Info creates an association between a Web service and the t-Model that contains the property values for the Web service.
- When you have added all the required Instance Info items to each binding, go back through your entire publication and verify that the information is accurate. Search for your service and its provider by using the various search mechanisms that are available, and verify that you can locate all of your information intuitively.
This set of procedures assumes that you have the UDDI Services UI open and that you have not created a provider for your Web service.
Note. When you run the CSF installer, you automatically become the owner of the Microsoft Connected Services Framework 3.0 UDDI provider. Only the owner of this provider can edit the Service Catalog entries for the Core services on the CSF 3.0 UDDI provider. The installer registers all Core services. Additionally, if you create provider for value added services (VASs), other than the CSF core services, only you can register services for that provider.
To Publish a Service Provider
- On the UDDI Services menu, click Publish.
- On the Providers tab, click Add Provider.
- On the Details tab, assign to this provider a name and description in all of the languages that are appropriate for your organization. Names and descriptions help users to search for this provider, identify who or what it is, and understand the types of services it provides. If this provider shares services with users in different languages, you can provide additional names and descriptions for each language as required.
- (Optional) On the Identifiers tab, add and define the identification schemes that are appropriate to this provider. Identification schemes provide an additional means of grouping entities together and enable the search for logically-grouped entities.
- On the Categories tab, add the categories that describe and classify this provider. Categories provide descriptive information about this provider, such as its geographical location, the services it provides, or any other appropriate classification. They are used during searches and queries to locate providers of a particular type, classification, or attribute. Assign the appropriate classifications to this provider so that it can be discovered logically and intuitively by either human search or programmatic query.
- (Optional) On the Discovery URLs tab, add any additional discovery URLs, if necessary. If you have additional information about this provider that you want make available, add a discovery URL that points to the location where this information can be located.
- (Optional) On the Relationships tab, publish any relevant relationships with this provider, if appropriate. Relationships are useful when you describe an organizational structure or for advertising partnerships between providers. If you create a relationship with a provider owned by another publisher, that relationship is not published until it is approved by the other publisher.
To Add Contact Information
- On the UDDI Services menu, click Publish.
- On the Providers tab, locate the provider to which you want to add a contact, and next to its name, click View.
- On the Contacts tab, click Add Contact.
- On the Details tab, assign to this contact a name, use type, and description for all of the appropriate languages. Names, use types, and descriptions provide a means of identifying who or what this contact is and the type of assistance or support they provide.
- (Optional) On the E-mail tab, add the e-mail addresses that are available for this contact.
- (Optional) On the Phone tab, add the phone numbers that are available for this contact.
- (Optional) On the Address tab, add the addresses that are available for this contact.
To Publish a Service
- On the UDDI Services menu, click Publish.
- Click the Providers tab, locate the provider that you would like to add a service to and, next to its name, click View.
- On the Services tab, click Add Service.
- On the Details tab, assign to this service a name and description for each appropriate language. Names and descriptions help you to search for this service, identify what it is, and understand the types of functions it serves.
- On the Categories tab, add the categories that describe this service and the functions it provides. Categories are used during searches and queries to locate services of a particular type, classification, or attribute. Assign the classifications that are appropriate to this service so that it can be discovered by either searching or programmatic inquiry.
To Publish a Binding
- On the UDDI Services menu, click Publish.
- On the Providers tab, locate the provider that contains the service that you want to add a binding to and, next to its name, click View.
- On the Services tab, select the service to which you want to add a binding.
- On the Bindings tab, click Add Binding.
- On the Details tab, define the access point where this interface can be invoked and provide descriptions about it for each appropriate language. The access point describes the URL where this interface can be accessed and the protocol it supports, such as: http://www.contoso.com/mywebservice.asmx (http).
To Publish a t-Model
- On the UDDI Services menu, click Publish.
- On the t-Models tab, click Add t-Model.
- Under the Name section, click Edit, type the name of the t-Model and then click Update.
- On the Identifiers tab, under Identifiers section, click Add Identifier.
- In the t-Model item list, click the appropriate entry for your t-Model.
- In the Key Name field, type the property name, in the Key Value field type the property value, and then click Update.
- Repeat steps 7 through 9 until you have added all of the property key-value pairs for the Web service.
- On the Categories tab, under Categorizations, click a categorization scheme and its child schemes until the Add Category button becomes active, and then click Add Category.
- On the Overview Document tab, type the URL to the WSDL file or specification document you want to associate with the t-Model.
To Add Instance Information
- On the UDDI Services menu, click Publish.
- On the Providers tab, locate the provider that contains the service that contains the binding to which you want to add an Instance Info and, next to its name, click View.
- On the Services tab, locate the service that contains the binding to which you want to add an Instance Info and, next to its name, click View.
- On the Bindings tab, locate the binding to which you want to add an Instance Info and, next to its name, click View.
- On the Instance Info tab, click Add Instance Info.
- Locate any t-Models that contain relevant technical information for the binding and create an Instance Info of each. Define the attributes for each instance Info you associate with this binding.
- On the Details tab, provide a description for this Instance Info for all of the appropriate languages.
- (Optional) On the Instance Details tab, add and describe the parameters that are supported by this Instance Info.
- (Optional) On the Overview Document tab, type the URL where the overview document for this Instance Info is located, if necessary. This information supplements the information already associated with the t-Model referenced by this Instance Info.
See Also