Searching the Registry

The Search and Explore links in the menu area allow you to search the Registry.

Using the Search Menu

Click Search in the menu area. The Search form opens. It contains the following components:

Click Hide Search Form to close the Search form and clear the results area.

The next few sections describe how to use these components.

Selecting a Query

The Select Predefined Query drop-down list contains the items shown in Table 7-2.

Table 7-2 Predefined Queries 
Query Name
Search Purpose
Basic Query
The default generic query, which allows you to search by object type, name, description, and classification
Basic Query - Case Sensitive
Case-sensitive version of Basic Query
Finds all objects owned (published) by the user who makes the query; may take a long time if the user owns many objects
Finds the User object for the user who makes the query

The default selection is Basic Query. The following sections describe how to perform basic queries:

Use the FindAllMyObjects and GetCallersUser queries to search for all the objects you have published and to view and modify data for the user you created when you registered.

Searching by Object Type

The simplest search is by object type only.

The default choice in the Object Type drop-down list is RegistryObject, which searches all objects in the Registry. To narrow the search, change the object type.

Follow these steps:

  1. Choose an object type from the Object Type drop-down list.
  2. Click the Search button.

The search returns all objects of the specified type. You can narrow the search by specifying a name, description, or classification.

Searching by Name and Description

To search by the name or description of an object, follow these steps:

  1. From the Select Predefined Query drop-down list, select either Basic Query or Basic Query -- Case Sensitive.
  2. Type a string in the Name or Description field.
  3. Click Search.

By default, the search looks for a name or description that matches the entire string you typed. You can use wildcards to find a range of objects.

The wildcard characters are percent (%) and underscore (_).

The % wildcard matches multiple characters:

The underscore wildcard matches a single character. For example, the search string _us_ would match objects named Aus1 and Bus3.

Searching by Classification

Classification objects classify or categorize objects in the registry using unique concepts that define valid values within a classification scheme. The classification scheme is the parent in a tree hierarchy containing generations of child concepts. Table 7-3 describes the classification schemes provided by the Registry specifications. Many of the terms in this table are defined in the Registry specifications.

Table 7-3 Classification Scheme Usage 
Classification Scheme Name
Description or Purpose
Defines the types of associations between RegistryObjects. Used as the value of the associationType attribute of an Association instance to describe the nature of the association.
Defines the types of content management services. Used in the configuration of a content management service, such as a validation or cataloging service.
Defines the data types for attributes in classes defined by this document. Used as the value of the slotType attribute of a Slot instance to describe the data type of the Slot value.
Defines the values for the deletionScope attribute of the RemoveObjectsRequest protocol message.
Defines the types of email addresses.
Defines the types of error handling models for content management services.
Defines the different error severity types encountered by the Registry while processing protocol messages.
Defines the types of events that can occur in a registry.
Defines the different ways that a content management service may be invoked by the Registry.
Defines the different ways in which a ClassificationScheme may assign the value of the code attribute for its ClassificationNodes.
Defines the different ways in which a client may wish to be notified by the registry of an event within a Subscription.
Defines the different types of RegistryObjects a registry may support.
Defines the types of telephone numbers.
Defines the query languages supported by the Registry.
Defines the different types of status for a RegistryResponse.
Defines the different types of status for a RegistryResponse.
Defines the groups that a user can belong to for access control purposes.
Defines the roles that can be assigned to a user for access control purposes.

In the menu area, the root of the ClassificationScheme tree is below the Description field.

To search by classification, follow these steps:

  1. Expand the root node to view the full list of classification schemes.
  2. The number in parentheses after each entry indicates how many concepts the parent contains.

  3. Expand the node for the classification scheme you want to use.
  4. Expand concept nodes beneath the classification scheme until you find the leaf node (a node with no concepts beneath it) by which you want to search.
  5. Select the leaf node.
  6. Optionally, restrict the search by choosing an object type or specifying a name or description string.
  7. Click the Search button.

Viewing Search Results

Objects found by a search appear in the Registry Objects area.

The Registry Objects area consists of the following:

Viewing Object Details

In the search results table, click the Details link for an object to open the Details area immediately below the Registry Objects area.

This section has a row of buttons and a row of tabs:

Click a tab to find out if the object has any values for the attribute. If it does, click the Details link for the attribute value to open a web browser window with the details for the attribute value.

The Audit Trail tab does not produce a table with a Details link. Instead, it produces a table containing the event type, the date and time of the event, and the name of the User that caused it.

For every object, the Unique Identifier is an active link. Click this link to view the XML for the object in a web browser window. (All registry objects are stored in XML format.)

If the object is an ExternalIdentifier, the details panel has a Display Content link. Click this link to view the object in a web browser window.

If the object is an ExtrinsicObject, the details panel has a View Repository Item Content link. Click this link to view the repository item in a web browser window.

Using the Explore Menu

The Explore menu allows you to navigate through Registry and Repository content using the metaphor of a hierarchy of file folders. The root folder, named root, contains all Registry content, and is similar to the UNIX root directory.

To use the Explore menu, follow these steps:

  1. Click the Explore link.
  2. Expand the folder named "root". It contains two subfolders: userData, where all user content is placed, and ClassificationSchemes.

To explore the classification schemes, follow these steps:

  1. Click the ClassificationSchemes folder (not the node symbol). All the ClassificationScheme objects appear in the Registry Objects area. Follow the instructions in Viewing Search Results to view the objects.
  2. Expand the ClassificationSchemes node to open the ClassificationSchemes tree hierarchy in the menu area.
  3. Click any file icon to view that classification scheme in the Registry Objects area.
  4. Expand a classification scheme node to see the Concept folders beneath it.
  5. Not all classification schemes have concepts that are viewable in the Explore menu. The last seven classification schemes have concepts that are not viewable here.

  6. Click a Concept folder to view that concept in the Registry Objects area.

To explore the userData folder, follow these steps:

  1. Expand the userData node.
  2. Expand the RegistryObject node. Do not click the folder unless you want to view all registry objects.
  3. (The node named "folder1" has no content.)

  4. Click a folder to view the registry objects of that type. Expand a node to view the object types at the next level.

When you have finished, click Hide Explorer to close the Explore menu and clear the results area.