Using the Registry Browser

Using the Registry Browser

The Registry Browser is both a working example of a JAXR client and a GUI tool that enables you to search registries. You can examine the source code, as described in Implementing a JAXR Client (page 326).

Before you run the Registry Browser, start Tomcat. See Starting Tomcat (page 62) for details.

To start the browser, go to the bin directory of your Java WSDP installation or place this directory in your path.

To start the browser on a UNIX system, enter the following command:

jaxr-browser.sh

On a Microsoft Windows system, enter the following command:

jaxr-browser

After the browser starts, enter the URL of the registry you want to use in the Registry Location combo box, or select a URL from the drop-down menu in the combo box. There may be a delay of a few seconds while a busy cursor is visible.

When the busy cursor disappears, you have a connection to the URL. However, you do not establish a connection to the registry itself until you perform a query or update, so the browser will not report an invalid URL until then.

The browser contains two main panes, Browse and Submissions.

1 Querying a Registry

You use the Browse pane to query a registry.

Querying by Name

To search for organizations by name, perform the following steps.

1. Click the Browse tab if it is not already selected.

2. In the Find By panel on the left side of the Registry Browser window, do the following:

   1. Select Name in the Find By combo box if it is not already selected.

   2. Enter a string in the text field.

   3. Press Enter or click the Search button in the toolbar.

After a few seconds, the organizations whose names begin with the text string appear in the right side of the Registry Browser window. An informational dialog box appears if no matching organizations are found.

Double-click on an organization to show its details. An Organization dialog box appears. In this dialog box, you can click Show Services to display the Services dialog box for the organization. In the Services dialog box, you can click Show ServiceBindings to display the ServiceBindings dialog box for that service.

Querying by Classification

To query a registry by classification, perform the following steps.

1. Select Classification in the Find By combo box.

2. In the Classifications pane that appears below the combo box, double-click a classification scheme.

3. Continue to double-click until you reach the node you want to search on.

4. Click the Search button in the toolbar.

After a few seconds, one or more organizations in the chosen classification may appear in the right side of the Registry Browser window. An informational dialog box appears if no matching organizations are found.

2 Managing Registry Data

You use the Submissions pane to add, modify, or delete registry data.

To get to the Submissions pane, do either of the following:

• Click the Submissions tab.

• If you used the Browse pane to locate an organization for which you want to modify data, right-click on the organization and choose either Edit RegistryObject or Delete RegistryObject from the pop-up menu. In order to modify data, you need to be connected to a registry that allows you to publish data. If you were previously using a URL that only allows queries, change the URL to the publish URL.

If you click Delete RegistryObject, an authorization dialog box appears. To delete the organization, enter your username and password and click OK. To close the window without deleting the organization, click Cancel.

Adding an Organization

To enter or modify information about an organization, use the Organization panel on the left side of the Submissions pane.

Use the Organization Information fields as follows:

• Name: Enter the name of the organization.

• Id: You cannot enter or modify data in this field; the ID value is returned by the registry after you submit the data.

• Description: Enter a description of the organization.

Use the Primary Contact Information fields as follows:

• Name: Enter the name of the primary contact person for the organization.

• Phone: Enter the primary contact's phone number.

• Email: Enter the primary contact's e-mail address.

For information on adding or removing classifications, see Adding and Removing Classifications (page 341).

Adding Services to an Organization

To add or modify information about an organization's services, Use the Services panel on the right side of the Submissions pane.

To add a service, click the Add Services button in the toolbar. A subpanel for the service appears in the Services panel. Click the Add Services button more than once to add more services in the Services panel.

Each service subpanel has the following components:

• Name, Id, and Description fields

• Edit Bindings and Remove Service buttons

• A Classifications panel

Use these components as follows:

• Name field: Enter a name for the service.

• Id field: You cannot enter or modify data in this field; the ID value is returned by the registry after you submit the data.

• Description field: Enter a description of the service.

• Click the Edit Bindings button to add or edit service bindings for the service. An Edit ServiceBindings dialog box appears.

• Click the Remove Service button to remove this service from the organization. The service subpanel disappears from the Services panel.

• To add or remove classifications, use the Classifications panel.

Adding Service Bindings to a Service

To add service bindings for a service, click the Edit Bindings button in a service subpanel in the Submissions pane. The Edit ServiceBindings dialog box appears.

If there are no existing service bindings when the dialog box first appears, it contains an empty Service Bindings panel and two buttons, Add Binding and Done. If the service already has service bindings, the Service Bindings panel contains a subpanel for each service binding.

Click Add Binding to add a service binding. Click Add Binding more than once to add multiple service bindings.

After you click Add Binding, a new service binding subpanel appears. It contains three text fields and a Remove Binding button.

Use the text fields as follows:

1. Description: Enter a description of the service binding.

2. Access URI: Enter the URI used to access the service.

Use the Remove Binding button to remove the service binding from the service.

Click Done to close the dialog box when you have finished adding or removing service bindings.

Adding and Removing Classifications

To add classifications to, or remove classifications from, an organization or service, use a Classifications panel. A Classifications panel appears in an Organization panel or service subpanel.

To add a classification:

1. Click Add.

2. In the Select Classifications dialog, double-click one of the classification schemes.

• If you clicked ntis-gov:naics, you can add the classification at any level of the taxonomy hierarchy. When you reach the level you want, click Add.

• If you clicked Geography, locate the appropriate leaf node (the country) and click Add.

The classification appears in a table in the Classifications panel below the buttons.

Follow these steps more than once to add multiple classifications to the organization or service.

Click Close to dismiss the window when you have finished.

To remove a classification, select the appropriate table row in the Classifications panel and click Remove. The classification disappears from the table.

Submitting the Data

When you have finished entering the data you want to add or modify, click the Submit button in the toolbar.

An authorization dialog box appears. To continue with the submission, enter your username and password and click OK. To close the window without submitting the data, click Cancel.