Page tree

Versions Compared


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


When using CAST Imaging you can choose how your application is displayed using one of the default "aggregation modes" available out of the box (depending on the scope you choose) - these default modes are explained in User Guide - GUI - Investigate panel.

However, you may find that these default modes do not meet your requirements for displaying your application data. If so, you can create your own custom aggregation mode and display your objects as you have designed. For example, you can choose to display on specific object types and/or group specific object types together:


Custom aggregation modes are both application and user specific. In other words, a custom aggregation will only be available for the specific application you created it for and by default initially only for the user that created it (access for additional users . Access can be granted to additional users/groups when creating the custom aggregation mode - see Grant access to the custom aggregation mode below.


In ≥ 2.17.1-funcrel, custom aggregations which re-use existing CAST supplied aggregations such as CAST Taxonomy, Module, Service etc. have a set limit of 100,000 nodes. If your aggregation contains more than the set limit, the following error message is displayed:

Image Added

This limit is set in order to avoid performance issues when the custom aggregation is used. In this situation, and as a last resort, it is possible to increase the limit (knowing that this may cause performance issues and other unexpected side effects) - see Configuring the custom aggregation node limit.

Note that the node limit is not applied when creating a custom aggregation from scratch and not using the existing CAST supplied aggregations.

Creating a new aggregation mode


When working in another scope at Object level (for example the User Guide - Application scope or the User Guide - Module scope) it is possible to select objects and add them directly to an existing custom node in a custom published and unpublished custom aggregation view. First select the objects you want to add to the custom node, right click the objects and select Associate to custom aggregation:


You will then be able to select:

  • the custom aggregation (


  • associated to the current application) whether published or unpublished
  • and whether you want to add the objects to an existing custom node or to a new one:

Image Modified


Use the Remove object from other existing nodes when you want to ensure that the object you are associating is not already associated to any custom nodes in the target custom aggregation. Ticking the box will disassociate the object from any custom nodes in the target custom aggregation, if they exist.

Grant access to the custom aggregation mode

By default a custom aggregation mode is only available to the user that created it. If you would like other users to be able to access the aggregation mode, then you need to explicitly grant them access using the following icon:


Or you can edit it (you can add/remove nodes, change the name, or change the access permissions) and then re-publish it to make it available for use:

Searching an internal object

In releases ≥ 2.15 you can search multiple objects at once in custom aggregation.

Image Added

You may either select the object name/s from the drop-down list or enter the object name in the search panel.

Image Added

Header options

1Add a new custom node into your custom aggregation mode.
2Aggregation mode selector.

Displays information about the aggregation mode:


Edit the current aggregation mode - this is restricted to the name:

5Delete the current aggregation mode. This is irreversible and will make the mode unavailable for use.

Grant permissions to additional users:

7Add a new custom aggregation mode.
8Publish a mode when changes are complete.

Working at Objects level with a custom aggregation based on Modules

When drilling down beyond level 5 into the Objects level view, the legend on the right hand side will indicate which "parent" item the current object belongs to:

Click to enlarge

Image Added

Visual grouping in custom aggregation

In releases ≥ 2.16, the newly created Custom Aggregations are supported in Visual Grouping.

Image Added

Click on Custom Agreegation icon. Following screen with an option to "Create New Aggregation View" is displayed.

Image Added

Enter a name for the new aggregation view and select the "Populate the aggregation using" from the drop-down. Click save.


The newly created custom aggregation is supported in Visual Grouping only when it is populated by any option except CAST Taxonomy.

Publish the newly created/saved Custom aggregation.

Image Added

The saved Custom Aggregation is displayed in the Aggregated by drop-down list.

Image Added

When you drill-down the custom aggregation, you may see the Visual Grouping enabled by default.

Image Added