Tutorial - Publishing and Editing Objects

So far we have learned how to discover objects in the registry and browse their detailed attributes as well as their relationships with other object. We will now learn how these objects are published in the registry and how they are subsequently edited (updated).

Logon

Before you can publish or update any objects in the registry you must perform a Logon with the Registry Browser Java UI. The Logon step does not actually maintain a session with the registry. It only authenticates you with the client key store, retrieves your security credentials (e.g. public key) from the client key store and set (cache) these credentials within the JAXR Connection that will be used to communicate with the registry.

Once you are Logged On the browser enters Editable mode and allows you to perform publish and update operations. In particular, the browser display the Submission tabbed panel's tab just below the Registry Location combo.

Creating New Objects

The submission tabbed panel is used for creating registry objects to be submitted to the registry. To access the submission panel click on the Submission tab (located right beside the discovery tab and below the Registry Location combo). See Figure 5.1

You will notice that the Submission Panel is a larger version of the Graph Panel that was used to Browse objects graphically. They are functionally identical and for that reason we will refer to either as Graph Panel when speaking generically.

On the toolbar there is a drop down menu for choosing the type of registry objects and a few groups of buttons for various functions. The groups of buttons and their individual functions are listed below (in order from left to right).

    • Insert - Inserts a registry object of the type selected in the drop down menu. Once the icon for the new object appears in the submission panel you can Edit it and enter the detailed values for the object's attributes. You may need to move the icon for the newly added object as it may overlap with the previously added object. Moving objects is done by using a drag action with left mouse button. You can also relate two objects together in meaningful ways.
    • Toggle Connect Mode - Controls the ability to connect registry objects together (on/off). This is rarely used.
    • Undo - Undo last action. This is your safety net and friend to undo past sins.
    • Redo - Redo last undone action. This is to undo an undo if you got carried away and did one to many Undos.
    • Remove - Remove object(s)
    • Zoom - Sets view to normal size.
    • Zoom In - Make things appear bigger.
    • Zoom Out - Make things appear smaller.
    • To Front - Bring the selected object(s) to front
    • To Back - Send the selected object(s) to back

Note: Don't forget to save your changes frequently!

Adding Object Relationships

Any two objects that are on the Graph Panel may be connected graphically into a relationship. To do so you simply left mouse click in the center of one object and drag to the center of the second object before releasing the mouse button. This operation requires that the Connect Mode is ON (default) using the Toggle Connect Mode button of the Graph Panel toolbar.

Relationship Dialog

Once you release the mouse on the center of the second object the Relationship Dialog pops up. This dialog offers a radio button choice of either:

  • Association: To associate the two objects using an arbitrary Association object.
  • Reference: To set a reference value of a reference attribute from one object to the other. Note that if no reference attribute is possible between the two types of objects then the system will be smart and not offer you the choice and instead will simply display the Association choice.

Upon selecting OK on the Relationship dialog you will see an edge connecting the icons for the two objects. The edge will have an appropriate label based upon the Association or reference.

Note: Don't forget to save your changes frequently!

Editing Objects

An objects detailed attribute values may be edited and updated using the Edit action to display the Edit dialog for that type of object. The Edit dialog is essentially the same as the Details Dialog but it is in editable mode and allows you to make changes.

You can open the Edit dialog for an object from either the Search Results panel a using the Edit action in a manner similar to the Show Details action. You can also open the Edit dialog for an object from the Graph Panel by clicking the right mouse button on the icon for an object and selecting the Edit action.

Once you've opened up an editor panel you will see all the fields associated with that object. Most of those fields except the unique identifier can be edited.

Fields that are single values can be edited directly when you click on the field text. Fields that can have multiple values, such as the lists of slots or classifications for an object, can be edited by clicking on the field with the right mouse button and selecting one of "Edit", "Insert", or "Remove" as appropriate. See Figure 7.1.



Figure 7.1 - Right mouse button selects an action

Selecting Objects

A single object in the Graph Panel may be selected by clicking on its icon with the left mouse button.

A selected object shows a dotted outline in its icon to indicate that it is selected.

Multiple objects may be selected by using a drag operation (left mouse down, hold move mouse and release left mouse) to define a selection region around the object. Object may be added to the selected set of objects by holding down the CONTROL key when you left click on another object.

Saving Objects

At any point during the course of adding objects to the Graph Panel, adding relationships between objects or editing values for attributes of objects, you can save your changes. Like any text editor, you should save periodically to avoid losing your work in case of a failure.

To save one or more objects select those objects and the right click and choose Save from the popup menu. You will be prompted to Logon if you haven't already done so. Note that by default you can only make changes to objects that you created. Read the section User Registration for details on registration and Logon. If you are unsure who created an object, right-click the object and choose Show Audit Trail to view the object's details.

Note: Saving will save ALL selected objects as well as implicitly save any objects related to or referenced by the objects being saved.