Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The current view search option allows you to search an item in the Current view and then highlight them in the viewIt can be accessed by clicking the Search icon:

Image Added

When clicked, the search panel will be displayed, listing all items currently displayed in the view:

Image Added

Entering a search string will automatically list items that match and are present in the current view - for example, the string "book" has been entered:

Image Added

Any items you want to highlight in the view can be selected individually, or you can select multiple items, or all items:

Image Added

Each selected item will be highlighted in the view:

Click to enlarge

Image Added

Anchor
standard
standard
All application (global) search options

The "all application" Search option allows you to search across the entire Application:

  • for specific objects using search strings , object types, tags and properties (Object search)
  • text added to the Document-It feature (Document search)
  • via the cypher query language (Cyper search) - users with the ADMIN role only

You can access the search feature as follows:

Custom scope - see User Guide - Custom scope

Image Added

Search icon in task bar

Image Added

Right click a node/object - search is limited to the selected node

This option only functions in Level 5:

Image Added

Object search

Anchor
A
A
Access via Search view menu or Search icon on task bar

The standard search popup will be displayed. To search for an object:

  • ensure you are working in the OBJECTS tab
  • enter the object name and/or filter on:

Image Added

Search only for objects

Enter the string to search for - i.e. the string to match specific object names. You can choose more advanced search options if required:

Image Added

Regex patternTick this to enable search via a regular expression.
Case sensitiveEnable/disables case sensitive search (disabled by default).
Search by: Name/FullnameSelect as appropriate. The search string will be applied to the options you choose.
Search by positionSelect as appropriate to specify where in the string the match should occur. By default this is set to Start.


Info

From ≥ 2.8.0-funcrel, these filter settings are persistent for the duration of the user session (i.e. until a log out occurs), therefore you will not need to re-enter them when you perform a new search.


Between filters

Image Added

You can use this option to configure whether you want to filter:

  • On strings (content of Search only for objects) AND specific object types/tags/object properties
  • On strings (content of Search only for objects) OR specific object types/tags/object properties
Select an object type(s)

Choose if you want to limit the search results to specific object types:

Image Added

Image Added

This filter is automatically set to use an OR option with tags and object properties.

Search a tag

Choose if you want to search for objects based on the tags that have been added in CAST Imaging (see User Guide - Working with tags for more information about Tags). You can select an AND or OR option:

Image Added

Properties


Info
Available in ≥ 2.9.0.

This section allows you to perform an object search based on specific object property values that were calculated during the analysis (before the application was imported into CAST Imaging). In the example below, multiple properties have been added using an AND configuration:

  • Match all objects with a Cyclomatic Complexity value equal to 1

AND

  • Match all objects with a Number of code lines value equal to 30

AND

  • Match all objects with an Essential Complexity value equal to 20

Image Added

You can add new properties using the drop down list - note that the list of properties available to search is controlled by the ADMIN/SUPER ADMIN. See Admin Center - Search panel.

Image Added

Use the red icon to remove properties that you have already added:

Image Added

Search results are displayed in the "List of objects" window:

Image Added

Select a single object or multiple objects to display them in the view (or tick the List of objects option to add all objects to the view). Click Visualize to view the view:

Click to enlarge

Image Added

Links between any objects selected for visualization will also be shown:

Click to enlarge

Image Added

Info
  • You can add additional objects/nodes to the Search view in successive searches without losing any existing nodes added to the view.
  • If you need to clear the view you can click the Clear icon located in the Investigate panel - see User Guide - GUI - Investigate panel.

Image Added

  • Existing nodes that have been added to the Search view can be removed by deselecting the nodes which will already be selected when the search is re-opened (by clicking the Search icon on the toolbar) and then clicking Visualize.

Access via node/object right click

Image Added

When using the search option via the node/object right click contextual menu whilst in Level 5, the search will be performed as a "selective expand" on the originally selected objects - i.e. results are limited to the children/children,callers,callees/children&callers/children&callees. Therefore, the search box is presented in a slightly different way:

Image Added

Scope selection:

Image Added

Results are displayed and handled in the same way as using the Access via Search view menu or Search icon on task bar.

Document search

Info
  • This feature is available in ≥ 2.0.0.
  • Currently documents added to nodes in Level views cannot be searched.

Document search allows you to search for text added using the Document-It feature:

  • ensure you are working in the DOCUMENT tab
  • Choose the search scope:
    • View document (a document added to a view)
    • Object document (a document added to a specific object or group of objects)
  • enter the search string and filter on a specific tag or tags - see User Guide - Working with tags for more information about Tags)

Image Added

Results are displayed and handled in the same way as using the Access via Search view menu or Search icon on task bar.

Anchor
cypher
cypher
Cypher search

Cypher search is a feature that allows you to directly query the Neo4j database using "cypher query" - a specific functional language. You can use the "Cypher" tab in the Search view to run your queries:

Image Added

Info

The Cypher search option is only enabled for users with the default SUPER ADMIN and ADMIN roles. If you would like to enable it for other users, either modify an existing role to enable the Cypher Search or create a new role specifically for that - see Admin Center - Roles panel:

Image Added

You need to enable at a minimum the READ and CREATE permissions to perform a query. The Cypher language is powerful and enabling the UPDATE and DELETE permissions will allow users to perform cypher queries which can update or delete existing application data.

Dedicated Document-It document search

When more than six Document-It documents have been added to a view, it is possible to perform a search of all the documents within the view. Use the following icon to access the search facility:

Image Added

A search box will then be displayed showing all the documents present on the view. Enter a search string to perform the search - searches are actioned on the title, description text and tags:

Image Added

Clicking an item in the results list will display the corresponding document in the view.


Panel

Table of Contents


Info

Summary: A description of the various search methods available in CAST Imaging.

Anchor
current
current
Current view search

Info
The search option is limited to the current view.

The current view search option allows you to search an item in the Current view. It can be accessed by clicking the Search icon in the current view.

...

Selecting one or multiple items - each selected item will be highlighted in the view:

Anchor
standard
standard
All application (global) search options

The "all application" Search option allows you to search across the entire Application:

  • for specific objects using search strings , object types, tags and properties (Object search)
  • text added to the Document-It feature (Document search)
  • via the cypher query language (Cyper search) - users with the ADMIN role only

...

Custom scope - see User Guide - Custom scope

Search icon in task bar

Right click a node/object - search is limited to the selected node

This option only functions in Level 5:

Object search

Anchor
A
A
Access via Search view menu or Search icon on task bar

The standard search popup will be displayed. To search for an object:

  • ensure you are working in the OBJECTS tab
  • enter the object name and/or filter on:

Image Modified

Search only for objects

Enter the string to search for - i.e. the string to match specific object names. You can choose more advanced search options if required:

Image Modified

Regex patternTick this to enable search via a regular expression.
Case sensitiveEnable/disables case sensitive search (enabled by default).
Search by: Name/FullnameSelect as appropriate. The search string will be applied to the options you choose.
Search by positionSelect as appropriate to specify where in the string the match should occur. By default this is set to Start.
FiltersFilter on object types AND tags or switch to object types OR tags.


Info

From ≥ 2.8.0-funcrel, these filter settings are persistent for the duration of the user session (i.e. until a log out occurs), therefore you will not need to re-enter them when you perform a new search.


Between filters

Image Added

You can use this option to configure whether you want to filter:

  • On strings (content of Search only for objects) AND specific object types/tags/object properties
  • On strings (content of Search only for objects) OR specific object types/tags/object properties
Select an object type(s)

Choose if you want to limit the search results to specific object types:

Image Added

This filter is automatically set to use an OR option with tags and object properties.

Search a tagIf tags have been added, you can select them to further limit the search results.Between tagsFilter tags using an AND (match all tags) or OR (match any tag).

Choose if you want to search for objects based on the tags that have been added in CAST Imaging (see User Guide - Working with tags for more information about Tags). You can select an AND or OR option:

Image Added

Properties


Info
Available in ≥ 2.9.0.

This section allows you to perform an object search based on specific object property values that were calculated during the analysis (before the application was imported into CAST Imaging). In the example below, multiple properties have been added using an AND configuration:

  • Match all objects with a Cyclomatic Complexity value equal to 1

AND

  • Match all objects with a Number of code lines value equal to 30

AND

  • Match all objects with an Essential Complexity value equal to 20

Image Added

You can add new properties using the drop down list - note that the list of properties available to search is controlled by the ADMIN/SUPER ADMIN. See Admin Center - Search panel.

Image Added

Use the red icon to remove properties that you have already added:

Image Added

Search results are displayed in the "List of objects" window:Click to enlarge

Image Modified

Select a single object or multiple objects to display them in the view (or tick the List of objects option to add all objects to the view). Click Visualize to view the view:

Click to enlarge

Image Modified

Links between any objects selected for visualization will also be shown:

...

Info
  • You can add additional objects/nodes to the Search view in successive searches without losing any existing nodes added to the view.
  • If you need to clear the view you can click the Clear icon located in the Investigate panel - see User Guide - GUI - Investigate panel.

  • Existing nodes that have been added to the Search view can be removed by deselecting the nodes which will already be selected when the search is re-opened (by clicking the Search icon on the toolbar) and then clicking Visualize.

Access via node/object right click

When using the search option via the node/object right click contextual menu whilst in Level 5, the search will be performed as a "selective expand" on the originally selected objects - i.e. results are limited to the children/children,callers,callees/children&callers/children&callees. Therefore, the search box is presented in a slightly different way:

Image Modified

Scope selection:

Image Added

Results are displayed and handled in the same way as using the Access via Search view menu or Search icon on task bar.

Document search

Info
  • This feature is available in ≥ 2.0.0.
  • Currently documents added to nodes in Level views cannot be searched.

...

  • ensure you are working in the DOCUMENT tab
  • Choose the search scope:
    • View document (a document added to a view)
    • Object document (a document added to a specific object or group of objects)
  • enter the search string and filter on a specific tag or tags - see User Guide - GUI for Working with tags for more information about Tags)

...

Results are displayed and handled in the same way as using the Access via Search view menu or Search icon on task bar.

Anchor
cypher
cypher
Cypher search

Cypher search is a feature that allows you to directly query the Neo4j database using "cypher query" - a specific functional language. You can use the "Cypher" tab in the Search view to run your queries:

...

Info

The Cypher search option is only enabled for users with the default SUPER ADMIN and ADMIN roles. If you would like to enable it for other users, either modify an existing role to enable the Cypher Search or create a new role specifically for that - see Admin Center - Roles panel:

You need to enable at a minimum the READ and CREATE permissions to perform a query. The Cypher language is powerful and enabling the UPDATE and DELETE permissions will allow users to perform cypher queries which can update or delete existing application data.

Dedicated Document-It document search

When more than six Document-It documents have been added to a view, it is possible to perform a search of all the documents within the view. Use the following icon to access the search facility:

...