An important feature of Relationship Manager is its ability to access and manipulate relationship runtime data contained in the relationship tables. This section describes how to use Relationship Manager to manipulate and access runtime data.
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:
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:
Relationship Manager displays the "Participant" window, as shown in Figure 47.
Relationship Manager displays any matching instances in a dialog box.
This option searches for instances whose type is Data.
Do the following to search for instances by data:
Relationship Manager displays the "Find Instances by Data" window, as shown in Figure 48.
Relationship Manager displays any matching instances in a dialog box.
You can filter the participants to only display those created or modified between certain dates. Do the following to filter the displayed participants:
Relationship Manager displays the "Filter" dialog, as shown in
Use the following techniques to enter the date value:
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 50 shows the "Filter Results" dialog.
Do the following to clean up participants due to inconsistent or corrupt data in the source application or generic object:
Relationship Manager displays the "Clean up Participants" dialog, as shown in Figure 51.
Use the following techniques to enter the date value:
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.
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. You can manage the printing of this output tree with the following print features:
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:
Do the following to preview the output of relationship data as it would be printed:
Relationship Manager tries to print the output tree as it appears in the tool's main window. If the output tree is narrow enough to fit on the page, you do not need to take any special formatting tasks. If, however, the output tree does not fit on the page, you can set formatting options to change the layout of the output tree so that it fits on the page.
You can set up the print format with the "Print Page Setup" feature, which you initiate in any of the following ways:
Any of these commands invokes the "Print Page Setup" dialog.
From the "Print Page Setup" dialog, you can provide the following formatting information:
Table 19. Column formatting options
Column formatting option | Description | |
---|---|---|
Column headers on every page | When this option is enabled, the column headers (such as Relation, Type, Value) appear on every page, not just the first one. | |
Resize columns to fit all data | When this option is enabled, Relationship Manager attempts to enlarge each column to fit any strings wider than the column itself. If the resulting tree does not fit onto the printed page, Relationship Manager tries to eliminate any extra room inside the columns. If this field and its subfields are greyed out, their values indicate the default values that Relationship Manager uses when formatting the output tree. Leave these fields in their greyed-out state if you want to confirm the formatting every time Relationship Manager generates the output tree. If you activate these fields, Relationship Manager uses the options you set for every output tree it generates. | |
| Use smaller font if necessary | When this option is enabled, Relationship Manager tries to reduce the font size if data is still larger than the page. It reduces font size in three steps. At each step, it reduces the font size by 20%. |
| Confirm new font size | When this option is enabled, Relationship Manager prompts you to choose
how to continue when it has reduced the font size sufficiently to fit the
output tree on a page. It provides you with the following
choices:
|
| If altered during print/preview, adjust column widths | When this option is enabled, Relationship Manager saves any changes to the column sizes that it has made to get the output tree to fit on a page. It uses the saved settings for future printings of the output tree. |
The Resize columns to fit data field and its associated subfields indicate the actions that Relationship Manager takes when it formats the output tree. These fields can appear in one of three states:
As Table 19 indicates, these fields initially display in a greyed-out state. You can set these fields from the confirmation dialogs that display during the formatting process. For example, if the values in a column do not fit in the current width of this column, Relationship Manager displays a confirmation dialog with the Yes and No options and a Make this the default choice field. If you select the Make this the default choice check box, Relationship Manager sets the Resize columns to fit data field based on the option you have selected from the confirmation dialog, as follows:
Table 20. Margin formatting options
Margin formatting option | Description |
---|---|
Use maximum page area | When this option is enabled, Relationship Manager uses the maximum printing area of the page (according to your printer's capabilities). |
Use these margins (inches) | When this option is enabled, you can set the left, right, top and bottom margins to specified values. |
Table 21. Page formatting options
Page formatting option | Description |
---|---|
Print page header on every page | When this option is enabled, Relationship Manager puts the relationship name and print time at the top of every page, not just the first one. |
Print page footer | When this option is enabled, Relationship Manager puts page numbers at the bottom of every page. |
Synchronize document with print preview | When this option is enabled, Relationship Manager displays in its main window the relationship data that you were last viewing in the print preview. For example, if you had paged through the print preview to the third "page" of instances and then exited from the print preview, Relationship Manager scrolls through the relationship data so that this same "page" of instances appears in its main window. When this option is disabled, Relationship Manager displays in its main window the same data it displayed before you performed the print preview. |
Table 22. Grid formatting options
Grid formatting option | Description |
---|---|
Print grid (uncheck to reset) | When this option is enabled, Relationship Manager includes grid in the output tree to separate rows and columns. When you click this field twice, you include both vertical and horizontal g rid lines in the output tree. |
Horizontal grid only | When this option is enabled, Relationship Manager includes only a horizontal grid (to separate rows) in the output tree. If the output tree does not include a horizontal grid, each printed page can fit an additional 2-3 rows of data. |
Vertical grid only | When this option is enabled, Relationship Manager includes only a vertical grid (to separate columns) in the output tree. |