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:
- Select a participant instance in Relationship Manager.
- Select Edit > Find Instances by Business Object from the
menu bar.
Relationship Manager displays the "Participant" window, as shown in
Figure 4.
- Type the participant value by which you want to search in the
Value cell.
- Click OK.
Relationship Manager displays any matching instances in a dialog
box.
- 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:
- Select a participant instance in Relationship Manager.
- 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

- Type the participant value by which you want to search in the Enter
the data cell.
- Click OK.
Relationship Manager displays any matching instances in a dialog
box.
- 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:
- Select a participant in Relationship Manager.
- Select View > Filter from the menu bar.
Relationship Manager displays the "Filter" dialog, as shown in
Figure 6. Filtering participant results

- 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:
- Type letters in the text field to cycle through days of the week.
For instance, type S to cycle through dates that occur on Saturdays
and Sundays.
- Click the small up and down arrows to increment or decrement the date by
one day.
- Click the large down arrow to display a calendar that you can use to
select a date.
- Click the Include inactive participants as well checkbox if you
want to include inactive participants in the resulting display.
- 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:
- Select a participant in Relationship Manager.
- 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

- 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:
- Type letters in the text field to cycle through days of the week.
For instance, type S to cycle through dates that occur on Saturdays
and Sundays.
- Click the small up and down arrows to increment or decrement the date by
one day.
- Click the large down arrow to display a calendar that you can use to
select a date.
- 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:
- Expand the relationship tree of Relationship Manager so that the
information you want to print is displayed.
- If you want to print only a portion of the relationship instances, select
only those instances by highlighting them.
- Print relationship runtime data in any of the following ways:
- Select File > Print from the menu bar.
- Use the keyboard shortcut Ctrl+P.
- Click Print in the toolbar.
- The Print Relationship Instances dialog appears. Select either "all
instances" or "selected instances," then click OK.
[ Top of Page | Previous Page | Table of Contents ]
