Custom Aggregation (RESERVED)

Custom Aggregation APIs allow you to create, manage, and visualize custom views that group objects based on specific criteria. Custom views enable users to organize application objects into meaningful groups for analysis.

Key Concepts

  • Custom View: A container that holds custom nodes. Views can be private or published for sharing.
  • Custom Node: A grouping of objects within a view, defined by filter criteria (transaction, object type, insight, or name pattern).
  • Dynamic View: The active custom-view model. Its graph is computed dynamically from node definitions.
  • Escalated Relationships: Object-level relationships promoted across hierarchy levels. They are included automatically in computed custom-view edges and architecture validation.
  • Link Mode: For an Architecture view, whether the links drawn in it are the dependencies that are allowed (authorized) or the ones that are forbidden (unauthorized). It is chosen when the view is created and can be switched later with Switch Aggregation Link Mode, which deletes the links already drawn.
  • User Links: The links a user draws in an Architecture view. After validation they can be shown together with the real dependencies, to compare the intended design with the code.
  • Unassigned Node: An optional synthetic node in Dynamic and Architecture views representing objects not matched by any custom node.
  • Static View: A legacy stored custom-view graph. It remains readable only.

Available Operations

Custom Views

  • Create dynamic custom views
  • List static and dynamic custom views
  • Rename or delete custom views
  • Clone a custom view together with its nodes
  • Publish or unpublish dynamic custom views for sharing

Custom Nodes

  • Create nodes with filter criteria in dynamic custom views
  • Expand nodes to see contained objects
  • Delete nodes from dynamic custom views

Dynamic Aggregation

  • Get the graph representation of a dynamic custom view
  • Page through the objects represented by an enabled Unassigned node

Static Aggregation

  • Get the stored graph representation of a static custom view