Home | PDF | API | FAQ | Search | Feedback | History

Searching the Registry

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

Using the Search Menu
Selecting a Query
Searching by Object Type
Searching by Name and Description
Searching by Classification
Viewing Search Results
Using the Explore Menu

Using the Search Menu

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

Select Predefined Query drop-down list
Name text field
Description text field
ClassificationSchemes tree

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
FindAllMyObjects	Finds all objects owned (published) by the user who makes the query; may take a long time if the user owns many objects
GetCallersUser	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:

Searching by Object Type
Searching by Name and Description
Searching by Classification

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:

Choose an object type from the Object Type drop-down list.
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:

From the Select Predefined Query drop-down list, select either Basic Query or Basic Query -- Case Sensitive.
Type a string in the Name or Description field.
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:

Type %off% to return words that contain the string off, such as Coffee.
Type %nor to return words that start with Nor or nor, such as North and northern.
Type ica% to return all words that end with ica, such as America.

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	Usage	Description or Purpose
AssociationType	Frequently	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.
ContentManagementService	Rarely	Defines the types of content management services. Used in the configuration of a content management service, such as a validation or cataloging service.
DataType	Frequently	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.
DeletionScopeType	Occasionally	Defines the values for the deletionScope attribute of the RemoveObjectsRequest protocol message.
EmailType	Rarely	Defines the types of email addresses.
ErrorHandlingModel	Rarely	Defines the types of error handling models for content management services.
ErrorSeverityType	Rarely	Defines the different error severity types encountered by the Registry while processing protocol messages.
EventType	Occasionally	Defines the types of events that can occur in a registry.
InvocationModel	Rarely	Defines the different ways that a content management service may be invoked by the Registry.
NodeType	Occasionally	Defines the different ways in which a ClassificationScheme may assign the value of the code attribute for its ClassificationNodes.
NotificationOptionType	Rarely	Defines the different ways in which a client may wish to be notified by the registry of an event within a Subscription.
ObjectType	Occasionally	Defines the different types of RegistryObjects a registry may support.
PhoneType	Rarely	Defines the types of telephone numbers.
QueryLanguage	Rarely	Defines the query languages supported by the Registry.
ResponseStatusType	Rarely	Defines the different types of status for a RegistryResponse.
StatusType	Occasionally	Defines the different types of status for a RegistryResponse.
SubjectGroup	Rarely	Defines the groups that a user can belong to for access control purposes.
SubjectRole	Rarely	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:

Expand the root node to view the full list of classification schemes.

The number in parentheses after each entry indicates how many concepts the parent contains.

Expand the node for the classification scheme you want to use.
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.
Select the leaf node.
Optionally, restrict the search by choosing an object type or specifying a name or description string.
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:

Buttons labeled Save, Approve, Deprecate, Undeprecate, Relate, and Delete, which allow you to perform actions on objects. You must be the object's creator to perform any of these actions.
A found objects display consisting of a search results table with the following columns:
Pick checkbox. Select any two objects to activate the Relate button. See Creating Relationships Between Objects for details.
Details link. Click this link to open the Details area directly below the Registry Objects area (see "Viewing Object Details").
Object Type field.
Name field.
Description field.
Version field.
VersionComment field.
Pin checkbox. Select this checkbox to "pin" this object in place while you perform another search. You can then relate two different objects by selecting both objects.

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:

The buttons are Save, Approve, Deprecate, Undeprecate, and Delete. The buttons represent actions you can perform on the object.
The tabs represent the object's attributes. The tabs you see vary depending on the object type. Table 7-4 describes the tabs and the objects they apply to.

Table 7-4 Attribute Tabs in the Details Area 

Tab Name	Applies To
Object Detail	All objects
Classifications	All objects
ExternalIdentifiers	All objects
Associations	All objects
ExternalLinks	All objects
Audit Trail	All objects
PostalAddresses	Organization, User
TelephoneNumbers	Organization, User
EmailAddresses	Organization, User
Users	Organization
Organizations	Organization
ServiceBindings	Service
SpecificationLinks	ServiceBinding
ChildConcepts	ClassificationScheme

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:

Click the Explore link.
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:

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.
Expand the ClassificationSchemes node to open the ClassificationSchemes tree hierarchy in the menu area.
Click any file icon to view that classification scheme in the Registry Objects area.
Expand a classification scheme node to see the Concept folders beneath it.

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.

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

To explore the userData folder, follow these steps:

Expand the userData node.
Expand the RegistryObject node. Do not click the folder unless you want to view all registry objects.

(The node named "folder1" has no content.)

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.

All of the material in The Java(TM) Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.