One of the most important features of the ebxmlrr browser is the ability to explore the registry and extract the information that you are looking for. There are two to ways to discover objects of interest within the registry:
The discovery panel is split into two areas:
One the easiest and most intuitive ways to explore the registry is through business queries. To use Business Queries make sure you select the Business Query radio button near the top of the Search Parameters Panel.
Business Queries allow you to search for objects using any combination of the following selection criteria:
The Object Type combo box allows you to specify the type of objects you are looking for. The choices are defined by the ObjectType Classification Scheme as shown in the Classification Schemes Dialog. There are several pre-defined ObjectTypes to choose from. In addition a registered user may also define additional custom ObjectTypes within the ClassificationSchemes dialog after logging on.
The ObjectTypes are organized hierarchically. This means that you can narrow or broaden your search by choosing an Object type lower (more specific) or higher (more general) in the hierarchy.
You can configure which ObjectType should be selected by default by configuring the
index (from 0 to N) in the following property within the
The Name text field allows you to narrow your search by specifying a name pattern for the objects you are looking for. You can either type the exact name but more typically you may type a name pattern using '%' as a wild card character to match any number of characters.
Example: The following entries in the name dialog box will find the entry ebxml
The Description text field allows you to narrow your search by specifying a description pattern for the objects you are looking for. You can either type the exact description but more typically you may type a description pattern using '%' as a wild card character to match any number of characters.
Name and description based searched are case-insensitive by default. Check the Case Sensitive CheckBox above Name filed if you wish to make your search match name and description in a case sensitive manner.
The most powerful way to discover objects of interest is to search by Classifications. Objects in the registry are often classified using one or more Classifications based upon values defined as Concepts within a ClassificationScheme.
To enter one or more Classifications in the Classifications List box do the following:
A less commonly used Search criteria is to search for registry objects by ExternalIdentifiers associated with the objects. An ExternalIdentifier is similar to a Classification. The main difference is that instead of specifying a Concept within a Classification Scheme you specify a ClassificationScheme and a textual value within that ClassificationScheme. For example the ClassificationScheme may be "US Social Security #" while the value may be the actual US Social Security Number for an individual.
Entering an ExternalIdentifier is done in a similar manner as described for entering Classifications.
A less commonly used Search criteria is to search for registry objects by ExternalLinks associated with the registry objects. An ExternalLink is essentially a glorified HTTP address (URL). So ExternalLInk based searches allow you to search for any object that has certain URL patterns associated with it. For example you can find all objects with the URL pattern of '%ebxml%'.
Entering an ExternalLinkr is done in a similar manner as described for entering Classifications.
When you have specified one or more Search Parameters for the Business Query, select Search button to search for objects matching all the specified Search Parameters.
Adhoc queries allow you to use powerful SQL queries to specify exactly what objects you are interested in. Unlike Business Queries that have fixed semantics where all specified criteria must match, ad hoc queries allow you to specify arbitrary predicate conjugation using the rich expressive syntax of the SQL 92 query syntax.
To use Ad hoc Queries make sure you select the Ad Hoc Query radio button near the top of the Search Parameters Panel. See Figure 3.3 for a picture of the Ad hoc Query Search Parameters Panel.
While SQL queries are very powerful, they are also not very user friendly and can be intimidating to most users. The Registry Browser's ad hoc query capability provides you with the best of both worlds by hiding the complexity of ad hoc queries behind parameterized forms.
Any number of ad hoc queries may be configured for the registry browser. Each ad hoc query may have any number of parameters defined. A user selects a pre-configured query and simple enters the parameters for that query and performs the search. From a user's perspective ad hoc queries are even simpler than Business Queries to use. The next sections describe how to use ad hoc queries.
The first thing you must do is to select a previously configured ad hoc query using the Select Query combo box. All queries in this combo are user configurable and extensible as defined later.
The following queries have been pre-configured in the standard distribution:
When you select a query the Ad hoc Query Parameters form below the Select Query combo changes to display the form appropriate for the configured query. The fields in the form are chosen according to the data type of the field. Enter parameters in the fields.
When you have specified the Search Parameters for the Ad hoc Query, select Search button to search for objects matching the specified Search Parameters.
While use of Ad hoc queries is simple, their configuration is the
harder task and requires knowledge of SQL-92 as well as the relational
schema defined in file
When the user performs a Search, the objects matching the search are displayed in the Search Results table. Each row in the table represents an object that was matched. Each column represents an attribute of the object being displayed in that row. The columns of the table vary depending upon the type of type of objects being displayed and is completely configurable by the user. In case the search matches multiple types of objects, the browser will use the configuration matching the most specific (lower in hierarchy) ObjectType that is a common base type for all the objects.
The Search Results table may be sorted by the values in any column. Simply click on the column header and the entire table will re-sort according to the values in that column. To sort in reverse order simply hold down the SHIFT key when clicking on the column header.
The Search Results Table cells display HTTP URLs using a blue hyper link visual style. Clicking on a hyper link will launch a Web Browser displaying that web page. If this does not work for you you may need to configure the following property in your <user.home>/jaxr-ebxml.properties file:
In this property you specify the actual URL using the variable '$url'. Below is a sample configuration that works with Mozilla and Netscape browser family:
The Search Results Table is configured within the <user.home>/jaxr/ebxml/registry-browser-config.xml fileObjectTypeConfig
This element defines configuration for handling a specific type of object within the Registry Browser. In particular it configures the Search Results table columns in the browser. The details of ObjectTypeConfig, its attributes and sub-elements are describes as annotations within the XML Schema file:<jaxr>/src/com/sun/xml/registry/client/browser/conf/browserConfig.xsd
For some example of use see:<jaxr>/src/com/sun/xml/registry/client/browser/conf/config.xml