Appendix E Working With Rule Analyzer : Finding Entities in a BusinessEvents Tools Graph

Finding Entities in a BusinessEvents Tools Graph
BusinessEvents projects often generate large, complex graphs. The Find feature enables you to locate a single entity (object) when you are using Rule Analyzer or Rule Debugger. You can use simple find if you know the object name and project path:
If you don’t know the project path or complete entity name, you can use the Entity Chooser and provide whatever information you can. The chooser finds entities that contain the string you provide. To refine the search conditions, click the magnifying glass icon and choose options (shown on the right in the figure below).
To Find an Entity in a Graph
Find locates only entities currently displayed in the graph. If you have filtered the entities in the graph (Rule Analyzer only), then Find locates only entities that are shown within the filtered display. To find an entity in the unfiltered graph, first clear the filter, then find the entity.
1.
Click Ctrl-F.
You see the Find dialog.
2.
If you don’t know the project path and name of the entity you want to find, click the Find button to the right of the Object Name field. You see the Entity Chooser pop-up. Select an entity from the project tree.
You can use the text options to narrow the choice. See Using the Entity Chooser for more details.
3.
Click Find. The graph displays again, showing the entity you specified. The entity is selected. If no matching entity is found, you see the message: No Objects Found.
Using the Entity Chooser
The Entity Chooser is available to help you locate entities while you are using the Find and Filter features.
To Choose Entities Using Text (Type-Ahead)
For simple projects, it is easy to choose entities using the project tree: just select a checkbox (or multiple checkboxes if you are using Entity Chooser while filtering).
However, for complex projects you might find the type-ahead feature and the drop-down text options helpful. They narrow the search. Only matching entities display in the project tree so they are easier to find and select.
1.
To Filter Entities in a Graph
To Find an Entity in a Graph
2.
As desired, click the spyglass icon to reveal a drop-down list of matching options. Select one or more matching options to define how text strings are used. See Entity Matching Options for details.
3.
In the field below the text, "Type in to filter entities," enter a text string according to the text matching options you chose. For example, if you choose the "Match from start" option, you must enter a project path beginning with the forward slash.
The project tree displays only matching entities.
To remove all text from the field, click the X that displays towards the right of the field.
4.
Select one entity from the tree if you are using the Find feature. Select one or more entities from the tree if you are using the Filter feature.
All selected entities’ project paths appear in the Find dialog’s Object Name field, or in the Filter dialog’s Include Entities field.
Entity Matching Options
Specifying a matching option affects how the text you enter in the Type in to Include Entities field is used to match entities and folders in the project tree. You can use multiple options, for example, Case Insensitive and Match Anywhere.
Note: This setting also affects text you type directly into the Object Name (Find dialog) or Include Entities (Filter dialog) fields.
Select Match from Start if you want to narrow your search by project path. Specify the project path (beginning with forward slash) to show all matching entities in the specified path.
Select Match Anywhere to narrow your search using a text string that is part of a folder or entity name. Enter the text to show all folders and entities that contain the text you type.
Hide Nodes without Children