This view displays the results of the reference search
requested for the instance currently selected in the Design
explorer view. This search was requested from the selected
instance, via the References choice of its
contextual menu.
The search follows the composition links of the instance.
The view title indicates which type of references is currently displayed,
according to your search request:
- The super-references, i.e. the instances which reference the current
instance,
- Or the sub-references, i.e. the instances which are referenced
by the current instance.
Example: If you search
for a Program's sub-references, you will see all the instances that
this Program calls, down to the finest level: Data Structures, Segments
and Data Elements. Moreover, the sub-referrences always include the
Library which contains the generation parameters of the
instance.
Example: If you search
for a Data Element's super-references, you will see all the instances
which call this Data Element, up to the highest level: Segments, Data
Structures, and Programs.
If you right-click on an instance
in the reference tree, you can:
- Open its editor.
- Search for its own super-references or sub-references, which will
then in turn be displayed in the References view.
The
References view contains a toolbar
on the upper right-hand corner, which enables you to:
- Cancel the current search (
button).
- View the previous reference searches (
button). Click on the arrow next
to the icon to display a menu which contains: - The previous instances from which you requested a reference search.
Select one of these instances to see its references in the view.
- The History choice. This choice opens a
window which shows the previous instances from which you requested
a reference search. From this window, you can:
- Select an instance and display its references (Open or Open
in new view button) or remove this instance from the history
(Remove button),
- Change the number of instances displayed in the history (10 is
the default) by clicking the Configure link.
- The Clear History choice, to remove all
the previous searches from the history.
- Switch from the super-references to the sub-references of the
current instance (
button),
- Switch from the sub-references to the super-references of the
current instance (
button).
- Modify the way the instances are shown in the References view.
Click the white upside-down triangle icon and select:
- Top Level Elements to indicate which element
type will constitute the top of the hierarchy in the tree: folders
(default. These are represented by the entity types), packages or
projects.
- Sort to specify a new sort criterion: by
name, package or project.
- Display to display additional information
on each instance line in the tree: package, project, label and/or
relation. You can combine the four choices. If you want to remove
one of the selected information from the line, just select it again
in the menu.
Note: The relation is the name of the link between the
source instance and the target instance. If this link occurs more
than once (eg: if a Program calls the same Segment several times),
the occurs number is displayed in parentheses, next to the relation
name.
This new setting will then automatically be saved and associated
with the References view, until you change it
again.