Working with relationship data

An important feature of Relationship Manager is its ability to access and manipulate relationship runtime data contained in the relationship tables. The following topics describe how to use Relationship Manager to manipulate and access runtime data:

Searching for participants

Filtering the displayed participants

Cleaning up participants

Printing relationship data

Searching for participants

You can search for participant instances based on different criteria. Depending on how specific your search criteria is, your searches can locate a unique participant instance or a group of participant instances. You can find participant instances in the following ways:

Finding instances by business object

This option searches for instances whose data type is an attribute in a business object.

Do the following to search for instances by business object:

  1. Select a participant instance in Relationship Manager.
  2. Select Edit > Find Instances by Business Object from the menu bar.

    Relationship Manager displays the "Participant" window, as shown in Figure 4.

  3. Type the participant value by which you want to search in the Value cell.
  4. Click OK.

    Relationship Manager displays any matching instances in a dialog box.

  5. Double-click any of the instances in the dialog displayed by Relationship Manager to navigate to and highlight the instance.

Finding instances by data

This option searches for instances whose type is Data.

Do the following to search for instances by data:

  1. Select a participant instance in Relationship Manager.
  2. Select Edit > Find Instances by Data from the menu bar.

    Relationship Manager displays the "Find Instances by Data" window, as shown in Figure 5.

    Figure 5. Finding instances by data


  3. Type the participant value by which you want to search in the Enter the data cell.
  4. Click OK.

    Relationship Manager displays any matching instances in a dialog box.

  5. Double-click any of the instances in the dialog displayed by Relationship Manager to navigate to and highlight the instance.

Filtering the displayed participants

You can filter the participants to only display those created or modified between certain dates. Do the following to filter the displayed participants:

  1. Select a participant in Relationship Manager.
  2. Select View > Filter from the menu bar.

    Relationship Manager displays the "Filter" dialog, as shown in

    Figure 6. Filtering participant results


  3. In the "Filter" dialog, enter the earliest date of creation or modification for the participant in the from field and the latest date of creation or modification for the participant in the to field.

    Use the following techniques to enter the date value:

  4. Click the Include inactive participants as well checkbox if you want to include inactive participants in the resulting display.
  5. Click OK.

    Relationship Manager displays the history of activity for the filtered interval in the "Filter Results" dialog. The filtered display includes inactive participants if the Include inactive participants as well option box is checked. Figure 7 shows the "Filter Results" dialog.

    Figure 7. Viewing filtered participant data


Cleaning up participants

Do the following to clean up participants due to inconsistent or corrupt data in the source application or generic object:

  1. Select a participant in Relationship Manager.
  2. Select Edit > Clean Up Participants from the menu bar.

    Relationship Manager displays the "Clean up Participants" dialog, as shown in Figure 8.

    Figure 8. Cleaning up participants


  3. In the "Clean Up Participants" dialog box, enter the date to which you want to revert the participant values to in the Clean up from field.

    Use the following techniques to enter the date value:

  4. Click OK.

    All participant adds, deactivations, and activations since that point in time are erased from the database. A participant that has been deleted or whose value has been modified cannot be cleaned up.

Printing relationship data

Relationship Manager allows you to print information about a relationship's runtime data. It creates a tree representation of the runtime data, much like the data appears in the tool's main window.

Sending relationship data to a printer

The printing ability of Relationship Manager sends the current contents of the relationship tree in the main window to the printer. Do the following to print relationship runtime data:

  1. Expand the relationship tree of Relationship Manager so that the information you want to print is displayed.
  2. If you want to print only a portion of the relationship instances, select only those instances by highlighting them.
  3. Print relationship runtime data in any of the following ways:
  4. The Print Relationship Instances dialog appears. Select either "all instances" or "selected instances," then click OK.

[ Top of Page | Previous Page | Table of Contents ]

Copyright IBM Corp. 1997, 2003