tModels

Learn about tModels, which represent definitions of UDDI web service types and are used to define pointers to the technical specification of a web service and for configuring identifier and category taxonomies to facilitate advanced discovery.

Table of Contents

About tModels

Some information about tModels:

  • The tModel definition is stored in a businessEntity construct in a bindingTemplate, and contains a key (tModelKey) that provides a unique technical fingerprint.
  • The tModels portion of the Registry provides an interface for cataloging the technical model (tModel) of web services.
  • tModel definitions facilitate the discovery process by providing meaningful information about a web service, including:
    • The abstract interface.
    • Technical specifications (for example, binding templates).
  • The web service discovery process can be further enhanced by defining these optional components:
    • Identifier Schemes (for example, identification numbers for a tModel).
    • Categories (for example, used to record taxonomy information such as industry, product, or geographic codes).
  • Registering these additional numbering and grouping elements enhances the search process and helps ensure that your published web services will be found.
  • tModels are organized into logical groups, Category Scheme Group tModels.

View tModels Summary

The tModels Summary page provides a listing of tModel definitions that are currently defined in the Registry.

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

The default installation includes several industry-focused tModels including:

  • NAICS (an industry code taxonomy)
  • UNSPC (a product and service category code taxonomy)
  • ISO 3166 (a geographical region code taxonomy)

View tModel Details

View the tModel Organization.

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

  2. Select the line item corresponding to the tModel definition you want to see details for.
  3. Click View tModel.

    The tModel Details page is displayed, showing:

    • Key
    • Name
    • Description
    • Overview Document URL
    • Overview document URL Description

Category Group tModels

You can group categories together. To create a Category Group you'll need to:

  1. Add a new tModel.
  2. Assign the uddi-org:category_types category.
  3. Identify this tModel as a Category Group System.
  4. Specify whether the Category Group will be used for tModels or for Binding Templates.

Add tModel

Define the key, name, description, and URL information of a tModel.

Note: Data for specified display fields is stored in the tModel construct within a bindingTemplate.

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

  2. Click Add tModel.

    The Add tModel pop-up window is displayed.

  3. Enter a unique identifier Key (tModelKey) for the tModel definition. Select one of the following:
    • For system-generated tModelKeys—Leave the Key field display blank. A system-generated key will be created when you save the tModel definition.
    • For manually entered tModelKeys—Enter the unique identifier into the Key field display. The tModel key should contain alphanumeric, dashes, and colons only.
  4. In the Name field, enter the tModel name.

    Note: This field is optional and maps to the <name> field in your tModel construct.

  5. In the Description field, enter the tModel description.

    Note: This field is optional and maps to the <description> field in your tModel construct.

  6. In the Overview Document URL field, enter the Overview URL.

    Note: This field is optional and maps to the <overviewURL> field in your tModel construct.

  7. In the Overview Document URL Description field, enter the Overview URL Description.

    Note: This field is optional and maps to the <description> field in your tModel construct.

  8. Click Apply. The new tModel definition is displayed on the tModel Summary page.

Delete tModel

  1. Go to Configure > Registry > tModels. The tModels Summary page is displayed.
  2. Select the line item corresponding to the tModel definition you want to delete.
  3. Click Delete tModel.
  4. At the confirmation message, click OK. The tModel definition is deleted.

Modify tModel

You can modify the name, description, or URL information of a tModel.

Note: Data for specified fields is stored in the tModel construct within a bindingTemplate.

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

  2. Select the line item corresponding to the tModel definition you want to modify.
  3. Click View tModel.

    The tModel Details page is displayed, showing a view-only image of the selected tModel.

  4. Click Modify tModel.

    The Modify tModel page is displayed.

  5. Modify one or more of the fields, as needed. For information about the specific fields, see steps 5 through 10 of Add tModel.

    Note: You cannot edit the tModelKey.

  6. Save your changes.

About tModel Identifiers

Identifiers provide a method of configuring a web service with unique reference information. Identifiers are generally trade-focused and indicate:

  • The identity of the businessEntity or publishing party (for example, D-U-N-S numbers)
  • The Global Location Number (GLM)
  • The identifiers associated with the web service or tModel (for example, tax identifiers)

You can view a listing of tModel Identifier Schemes that are defined for the current tModel definition on the tModel Identifiers Summary page.

To view tModel Identifiers

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

  2. Fine the tModel that you want to look at.
  3. Click View tModel. The tModel Details page is displayed.
  4. Click the Identifiers tab.

    The tModel Identifiers Summary page is displayed.

Assign tModel Identifiers

You can assign an Identifier Scheme, Key Name, and Key Value that represent lookup elements that will be invoked during a search.

  1. Follow steps #1 through #4 of To view tModel Identifiers above.
  2. Click Assign Identifier.

    The Assign Identifier pop-up window is displayed.

  3. Select the desired Identifier Scheme from the drop-down list box.
  4. Enter the Key Name [physical name] to associate with the selected Identifier Scheme.
  5. Enter the internal Key Value being referenced in the selected Identifier Scheme.
  6. Click Apply to save and return to the tModel Identifiers Summary.

Unassign tModel Identifiers

You can remove the identifier association from the current tModel definition.

Removing an identifier could become necessary if, for example, the established association with the selected identifier scheme is no longer valid, or the tModel definition changed requiring a new identifier association.

To unassign a tModel identifier

  1. Follow steps #1 through #4 of To view tModel Identifiers above.
  2. Find the Identifier Scheme you want to unassign, and click Unassign Identifier.
  3. At the confirmation message, click OK. The identifier assignment is removed.

About tModel Categories

Categories are a set of classification codes that represent different aspects of a web service (for example, products, services, or technical specifications).

Within UDDI, a categorization tModel is used for structuring category content.

On the tModel Categories Summary page, you can view a list of tModel Category Schemes that are defined for the current tModel definition.

To view tModel Categories

  1. Go to Configure > Registry > tModels.

    The tModels Summary page is displayed.

  2. Find the tModel definition you want to view, and click View tModel.

    The tModel Details page is displayed, showing a view-only image of the selected tModel.

  3. Click the Categories tab.

    The tModel Categories Summary page is displayed.

Assign tModel Categories

  1. Follow steps #1 through #4 of the About tModel Categories section of this page.
  2. Click Assign Category.

    The Assign Category page is displayed, showing the Category Hierarchy.

  3. Select a Category Scheme.
  4. Navigate the tiers of the Category Scheme and select a Category Value to apply to the current tModel definition.
  5. Click Finish.

    The system assigns the selected category value to the current organization definition, and you are returned to the Add Categories Summary page.

  6. Click Close to exit.

Unassign tModel Categories

You can remove the category association from the current tModel definition.

Removing a category could become necessary if, for example, the established association with the selected category is no longer valid, or the tModel definition changed requiring a new category association.

  1. Follow steps #1 through #4 of the About tModel categories section of this page.
  2. Select the line item for the Category Scheme you want to unassign.
  3. Click Unassign Category.
  4. At the confirmation message, click OK.

Assign tModel Category Group

Category Groups allow you to categorize service relationships with a higher level of granularity. They contain a list of business categories that describe specific business aspect of the Providers, Services, Bindings, or tModels.

Examples of categories are:

  • Industry
  • Product Category
  • Geographic Region

Each Provider, Service, Binding, or tModel is assigned one or more Category Groups.

To assign a tModel category group

  1. Go to Configure > Registry > tModels. The tModels Summary page is displayed.
  2. Find the tModel you want to modify, and click View tModel. The tModel Details page is displayed, showing a view-only image of the selected tModel.
  3. Click the Categories tab. The tModel Categories Summary page is displayed, showing a listing of category definitions associated with the current tModel.
  4. Click Assign Category Group.

    The Select Category Group page is displayed, showing a list of Category Groups for the current tModel.

  5. Select the button next to the Category Group that you want to assign new categories to.
  6. Click Next. The Select Categories page is displayed.
  7. Select a Category Scheme.
  8. Navigate the tiers of the Category Scheme and select a Category Value to apply to the current tModel definition.
  9. Click Finish. The system assigns the selected category value to the current Category Group assigned to the tModel, and you are returned to the Add Category Group Summary.
  10. Click Close.

Unassign tModel Category Group

You can remove the category group association from the current tModel definition.

Removing a category group could become necessary if, for example, the established association with the selected category group is no longer valid, or the tModel definition changed requiring a new category group association.

  1. Go to Configure > Registry > tModels. The tModels Summary page is displayed.
  2. Find the tModel you want to modify, and click View tModel. The tModel Details page is displayed, showing a view-only image of the selected tModel.
  3. Click the Categories tab. The tModel Categories Summary page is displayed, showing the categories associated with the current tModel.
  4. Select the line item corresponding to the Category Group you want to unassign.
  5. Click Unassign Category Group.
  6. At the confirmation message, click OK.