Tutorial - Learning the Environment

The registry browser has a simple clean looking interface which hides a great deal of functionality. Currently the browser is a Java/Swing based fat client. In future we will also be providing a HTML based thin client browser.

This chapter of the tutorial will introduce you to the basic features of the registry browser. After reading this chapter you should know how to log into a registry, identify the different sections of the browser and have an understanding of what the main functions are.

Connecting to a Registry

When you start up the ebxmlrr registry browser you will see a window that looks like Figure 2.1 This is the window you will see every time you open the browser. At this point there the browser looks very simple and in fact it is. There is very little you can do without being connected to a registry.

Connecting to a registry is accomplished by either choosing one from the drop down menu or manually typing in the URL of your registry in the Registry Location dialog box. If you do not have a registry set up, you may use our test registry for most sections of the tutorial. To connect to the test registry select the following URL from the drop down menu:


See Figure 2.2

Configuration Notes:

  • You can add items to the drop down menu by adding your registry URL inside the file: (User.Home)/jaxr-ebxml/registry-browser-config.xml

  • You can configure the browser to automatically connect to a specified URL on startup by configuring the following property with the (User.Home)/jaxr-ebxml.propertiesj file:


The browser must be restarted for the configuration changes to take effect.

Once you are connected to a registry the window will change to look like Figure 2.3


There four buttons on the tool bar that control the majority of the registry browser tasks and they are:

  • Find (Binoculars) - This button is used to search the ebxml registry using the business or ad hoc queries specified.

    NOTE: Business queries are mapped to ad hoc queries under the hood.

  • Classification Scheme (Hierarchical Tree) - This button displays the ClassificationSchemes Dialog. This dialog is used to display Classification Scheme instances and the Concepts within each ClassificationScheme. If the user is logged on then this dialog may also be used to create and update ClassificationSchemes and Concepts.

  • Logon (Key) - This button is used to logon as a registered user. Logging on simply tells the the JAXR provider who you are for when you perform secure operations such as save or delete. You can also change users by re-logging on as someone else. There is currently no timep-out after which the browser automatically logs you off. Auto-logoff is a planned feature for a future release.

  • Logoff (Key) - This button is used to logoff the currently logged on user.

  • User Registration Wizard (Person with +) - This button is used for creating a new user object as the name suggests. The user is fills in a number of dialog boxes and is then registered as a user of the registry.

  • Locale Selection (World Map) - This button is used to select the Locale preference of the user. The choice of Locale determines how the Registry Browser displays and saves localized content such as Name and Description. For example if you choose the locale en_US (default) you are choosing the English language as spoken in the country United States.

The buttons in the toolbar are highlighted in Figure 2.4

Menu Bar

In addition to the main buttons there is the main menu which contain three entities which are File , Edit , and Help . Clicking on one the items will bring up a sub menu with options to choose from. The Contents and functionality of each entity is listed below:

  • File
    • Exit - Exit the browser
  • Help
    • About - Displays the version of the registry browser

The buttons in the menu bar are highlighted in Figure 2.5

Browser Modes: Read-only and Editable

At any given time the browser operates in either Read-only mode or Editable mode. The user controls these two modes by logging on or off from the browser.

Read-only Mode

When the browser is first started it is in read-only mode. In this mode the user is presented with restricted capabilities and is not allowed to create, modify or delete data in the registry. In this mode most dialogs only show Cancel button and do not show OK button. Context sensitive popup menus (right click) do not allow actions such as Edit/Insert/Remove.

If the browser is in editable mode then it reverts to read-only mode whenever the currently logged on user logs off.

Editable Mode

When a registered user successfully logs on, the browser enters editable mode. In this mode the user is presented with additional capabilities and is allowed to create, modify or delete data in the registry.

Classification Schemes Dialog

The Classification Scheme Dialog displays ClassificationSchemes and Concepts within the registry. ClassificationSchemes are used to classify or categorize objects in the registry using unique Concepts defining valid values within that ClassificationScheme.

To open the Classification Scheme Dialog click the Show Classification Scheme/ Concept Dialog Button (Hierarchical Tree in Main Buttons). A pop-up window will appear with a listing of all the Classification Schemes. See figure 3.4 to clarify.

You can now use this window to browse through all the classification schemes. If you click on a scheme that is linked to classification nodes/concepts, a little magnifying glass will appear beside the chosen scheme. Click on the magnifying glass and the classification scheme will expand showing all the linked classification nodes. You can apply this method to view subsequent classification nodes where applicable. Click on the magnifying glass again to collapse the classification schemes. See figure 3.5