Working with relationship data in Relationship Manager

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

Steps for searching for participants

Steps for filtering the displayed participants

Steps for cleaning up participants

Steps for printing relationship data

Steps for 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.

Perform the following steps to search for instances by business object:

  1. Select a participant instance in Relationship Manager.
  2. Click Edit > Find Instances by Business Object.

    The Find Instances by Business Object window appears (see Figure 41).

    Figure 41. Find Instances by Business Object dialog box


  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 box to navigate to and select the instance.

Perform the following steps to search for instances by data:

  1. Select a participant instance in Relationship Manager.
  2. Click Edit > Find Instances by Data.

    Relationship Manager displays the Find Instances by Data dialog box, as shown in Figure 42.

    Figure 42. Find Instances by Data dialog box


  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 box to navigate to and select the instance.

Steps for filtering the displayed participants

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

Perform the following steps to filter the displayed participants:

  1. Select a participant in Relationship Manager.
  2. Click View > Filter.

    The Filter dialog box appears, as shown in Figure 43.

    Figure 43. Filter dialog box


  3. In the Filter dialog box, 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.
  4. Select the Include inactive participants as well check box if you want to include inactive participants in the results.
  5. Click OK.

    Relationship Manager displays the history of activity for the filtered interval in the Filter Results dialog box. The dialog box includes inactive participants if Include inactive participants as well is selected. Figure 44 shows the Filter Results dialog box.

    Figure 44. Filter Results dialog box


Steps for cleaning up participants

You can remove incorrect participant information caused by inconsistent or corrupt data from the source application or generic object.

Perform the following steps to clean up participants in System Manager:

  1. Select a participant in Relationship Manager.
  2. Click Edit > Clean Up Participants.

    The Clean Up Participants dialog box appears, as shown in Figure 45.

    Figure 45. Clean Up Participants dialog box


  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.
  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.

Steps for printing relationship data

Relationship Manager allows you to print information about a relationship's run-time data. It creates a tree representation of the run-time data, much like the data appears in the tool's main window. The print command in Relationship Manager sends the current contents of the relationship tree in the main window to the printer.

Perform the following steps to print relationship run-time 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, designate those instances by selecting them.
  3. Print relationship run-time data in any of the following ways:
  4. The Print Relationship Instances dialog box appears. Select either all instances or selected instances, then click OK.

Copyright IBM Corp. 2004