Created by James Hurrell on Apr 16, 2021

Add Linked Objects dialog box

The Add Linked Objects dialog box helps to narrow down the type of dependent objects that you want to add to the view. In essence, it enables you to create a filter to reduce search time and increase performance by excluding from or including in certain items.

Selection
Profile
This option enables you to load a pre-defined filter profile. The idea behind this function is to let you save filter profiles that you use often, thus allowing you to avoid entering the same filter parameters each time you add linked objects to your Graphical View. For example, you could save a profile that displays only objects that are of type Table, and Call your object or objects. 

If you want to create a new filter profile, you need to use the Profile Manager, this cannot be done from the Add Linked Objects dialog box.

Objects
This section lists all the object types that can be included in the filter.

The plus (+) sign next to an object indicates that this object is a parent object and that it contains other child (sub) objects. You can view these child objects by clicking the plus (+) sign.

The minus (-) sign next to an object indicates that all the child objects one level down have been displayed. Other child objects at a lower level may then become visible and will be indicated by another plus (+) sign.

If you want to include a certain type of object, select that particular object - a tick will then be visible next to the object. You can select all child objects stored under a parent object, regardless of the level, by selecting the parent object.

By default, all object types are pre-selected.

Notes

  • Object types displayed in this list will only reflect object types that you have stored in your Knowledge Base.

    Thus if, for example, you have not yet analyzed a Java project, no Java object types will be available for selection.

    As soon as you analyze a project and store the results in the Knowledge Base, its specific language type and corresponding object types will be displayed in this list and automatically selected.

  • If you want to select only some of the child objects, first clear the parent object which will also clear all the child objects, then select the child objects that you require. The parent object check box will then become gray, indicating that only some of its child objects have been selected.
Link type definition
This section displays all the types of links handled by the application and functions in exactly the same way as the Objects section above.

The Use escalated option will include Escalated Links in the Add Linked Objects search. If any Escalated Links are identified in the search, a secondary filter will be made to determine the Escalated Link's sub-type (whether Call, Use etc). Only those Escalated Links with a sub-type that corresponds to a type selected in the above list will be included in the View results as preview screen

Notes

  • You can find out more information about the Link types displayed in this dialog box by consulting the Links section.
  • It is possible to filter specifically on links without their sub link types. For example, a filter check box called "<LINK> Only" is available for all link types with sub links:

In functional domain
This section enables you to select and filter only those objects attached to certain Functional Domains. In this way the search or profile can be narrowed down even more.

By default, this section is unavailable and thus ignored. Activate it first by selecting the In functional domain check box. Now select the domains you wish to include in the filter.

See here for more details on using Functional Domains.

Ways
This section simply enables you to filter either Calling or Called objects.
  • Calling objects are those objects that call a selected object.
  • Called objects are those that are used or called by another object.
Select the appropriate option(s) according to you needs.
Like
The Like section enables you to filter on a search string. Only those objects matching this string will be found in the search or saved in the profile for use at a later date.

The two options underneath, Match whole word only, and Match case, are self-explanatory. Enter and check the options as you require.

View result as

This section displays a preview of the objects which conform to the filter parameters you selected in the previous sections, and which are linked to your original selected object or objects.

Two displays are available: 

  • List by Links > results displayed by link type
  • List by Objects > results displayed by object type - with expandable information showing link type

You can sort the objects alphabetically, both descending and ascending. Click on the appropriate column header and a small arrow will indicate the sort direction.

Show Full Name

Select this option if you want the objects found to be displayed with their complete names in the Preview section. Update is automatic.

Target

Finally this section enables you to select the destination of the objects that you want to add to the view.

If you want to add linked objects to a specific target Layer, you can select the Layer you want from the drop down list box. You can also create a new Layer by selecting the <New> option.

Please see the Layers Window for more details about how to use Layers.

Print option

You can print the list of objects displayed in the View Result As window:

  1. Right click an object in the View Result As window
  2. Select Print
  3. A standard Windows Print dialog box will be displayed enabling you to choose your print options
  4. Click Print to print the list.
See Also

Adding Linked Objects | Launching the Add Linked Objects function | What is the Add Linked Objects function?

CAST Website