Service Registry 3 2005Q4 Administration Guide

Configuring the Web Console

As an administrator, you can customize some aspects of the Web Console display by editing configuration files. This section describes the following tasks:

For information about using the Web Console, see the Service Registry 3 2005Q4 User’s Guide.

Adding Predefined Queries

Service Registry includes several predefined queries, which appear in the Web Console Search form in the Select Predefined Query drop-down list. As an administrator, you can add new queries to the drop-down list that are specific to your installation of the Registry.

To Add a Predefined Query

Steps

Use the Web Console to publish an AdhocQuery object to the Registry.

The name and description you specify for the query will appear in the drop-down list of predefined queries. In the SQL statement for the query, specify placeholders for user-supplied data by enclosing them in pairs of single quotes, as follows:
```
select * from registryobject where id = ''$lid''
```

Make a note of the unique identifier of the AdhocQuery object and of any placeholders in the SQL statement.

Change to the directory RegistryDomain-base/3.0/jaxr-ebxml.

Open the file registry-browser-config.xml in a text editor.

Add an entry to the registry-browser-config.xml file, using the following format. Specify a Parameter element for each placeholder in the SQL statement.
```
<Query>
  <AdhocQueryRef id="unique_identifier"/>
  <Parameter parameterName="$placeholder_name" datatype="string">
    <rim:Name>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter_name_in_en_locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter_name_in_fr_locale"/>
    </rim:Name>
    <rim:Description>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter_description_in_en_locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter_description_in_fr_locale"/>
    </rim:Description>
  </Parameter>
  ...
</Query>
```
The unique_identifier is the unique identifier of the AdhocQuery object.

The parameterName attribute value for each parameter must come from a placeholder in the SQL statement for the query.

The datatype attribute can have any of the following values:
- string: The parameter appears as a text field in the Search form.
- taxonomyElement: The parameter appears as a drop-down list in the Search form. If you specify a taxonomyElement data type, the Name and Description elements must be followed by a SlotList element that looks like this:
```
<rim:SlotList>
  <rim:Slot name="domain">
    <rim:ValueList>
      <rim:Value>
      classification_scheme_or_concept_id
      </rim:Value>
    </rim:ValueList>
  </rim:Slot>
</rim:SlotList>
```
  The classification_scheme_or_concept_id is the unique identifier of the classification scheme or concept whose concepts (or subconcepts) must appear in the drop-down list. You must publish the classification scheme if it does not already exist in the registry.
  
  The slot name must be "domain".
- boolean: The parameter appears as a checkbox in the Search form.
If the datatype is string or boolean, you can also add a defaultValue attribute to the Parameter element to specify a default value to appear in the Search form.

Specify localized string values for each parameter name and description for any locales you support. The parameter_name in the current locale appears as the label of the parameter in the Search form.

Use the existing entries in the registry-browser-config.xml file as a reference.

Save and close the registry-browser-config.xml file.

Follow the instructions in To Stop and Restart the Application Server Domain for the Registry.

Changing the Default Query

The query that appears as the default in the Select Predefined Query drop-down list is Basic Query, which allows users to search for registry objects by name, description, and classification.

As an administrator, you can change this default to a query that is appropriate to your installation. For example, you might want the default query to be a new predefined query that you added to the Registry, as described in Adding Predefined Queries. To make this change, edit a property in a configuration file.

To Change the Default Query

Steps

Change to the directory RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes.

Open the file jaxr-ebxml.properties in a text editor.

Find the definition of the property jaxr-ebxml.thin.defaultQueryPanel. By default, this property is commented out:
```
#jaxr-ebxml.thin.defaultQueryPanel=
```

Remove the comment character (#).

Set the value of the property by specifying the logical identifier of the query that will be the default, as in the following example:
```
jaxr-ebxml.thin.defaultQueryPanel=urn:oasis:names:tc:ebxml-regrep:query:MyQuery
```

Save and close the jaxr-ebxml.properties file.

Follow the instructions in To Stop and Restart the Application Server Domain for the Registry.

Hiding Classification Schemes

A tree structure of classification schemes appears in the following areas of the Web Console:

The Search form area, when Basic Query is selected
The Explore menu area
The ClassificationScheme/Concept Selector window that appears when you need to choose a concept for some kinds of registry objects

As an administrator, you can hide classification schemes from view if you do not want the classification schemes to be available to users of Service Registry. To hide classification schemes, define a property in a configuration file.

To Hide Classification Schemes

Steps

Change to the directory RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes.

Open the file jaxr-ebxml.properties in a text editor.

Set the property jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList by using the following syntax. All of the property definition must be on one line and must not contain spaces.
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
class_scheme_id1|class_scheme_id2|...
```
Specify the logical identifier of each classification scheme that is to be hidden. If you specify more than one identifier, separate the identifiers with a vertical bar (|), as in the following example:
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
urn:oasis:names:tc:ebxml-regrep:classificationScheme:StatusType|
urn:oasis:names:tc:ebxml-regrep:profile:ws:classificationScheme:BindingType
```

Save and close the jaxr-ebxml.properties file.

Follow the instructions in To Stop and Restart the Application Server Domain for the Registry.

Configuring the Search Results Display

By default, the Web Console displays 10 search results at a time for each query. If the search returns more than 10 results, users can display additional pages of results. As an administrator, you can modify the number of search results that appears on each page.

By default, the Web Console displays certain columns in the search results area. For each object, it displays the object type, name, description, version, and version comment. For some object types, a non-default display is configured. For example, for a ServiceBinding object, the display includes the endpoint instead of the version information. As an administrator, you can add configuration information to display non-default data for object types of your choice.

To perform each of these tasks, you edit a configuration file.

To Configure the Number of Rows in the Search Results Display

Steps

Change to the directory RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF/classes.

Open the file jaxr-ebxml.properties in a text editor.

Find the definition of the property omar.client.thinbrowser.numSearchResults:
```
omar.client.thinbrowser.numSearchResults=10
```

Change the value 10 to the value you prefer.

Save and close the jaxr-ebxml.properties file.

Follow the instructions in To Stop and Restart the Application Server Domain for the Registry.

To Configure the Columns in the Search Results Area

Steps

Change to the directory RegistryDomain-base/3.0/jaxr-ebxml.

Open the file registry-browser-config.xml in a text editor.

Add an entry to the registry-browser-config.xml file, using the following format.

This example configures a non-default display for Service objects.

<ObjectTypeConfig 
    className="org.freebxml.omar.client.xml.registry.infomodel.ServiceImpl" 
    id="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Service">
  <SearchResultsConfig>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Object Type" columnWidth="25" editable="false" 
      method="getObjectType"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Name" columnWidth="25" editable="true" method="getName"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Description" columnWidth="30" editable="true" 
      method="getDescription"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Status" columnWidth="15" method="getStatusAsString"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Version" columnWidth="5" method="getVersionName"/>
  </SearchResultsConfig>
</ObjectTypeConfig>

The registry-browser-config.xml provides syntax for the ObjectTypeConfig element. Use the elements that are already in the file as examples. These elements configure the default display for registry objects as well as non-default displays for ExternalLink, ExtrinsicObject, and ServiceBinding objects.

For the most part, you can deduce the method names from the class attributes in the ebXML Registry Information Model Version 3.0 specification (see Before You Read This Book for details). The getStatusAsString method can be found in the RegistryObjectImpl implementation class. (This release of Service Registry does not include API documentation, however.)

Save and close the registry-browser-config.xml file.

Follow the instructions in To Stop and Restart the Application Server Domain for the Registry.

To verify the reconfiguration, use the Search or Explore menu of the Web Console to display the objects whose columns you changed.