Develop > Customize KPIs, Metrics, Pages, and More > Enrich the Dashboard Contents in the Studio > Metric Breakdowns

Metric Breakdowns

You can create and manage Breakdowns for a Metric according to the Metric dimensions.

  • The total number of KPI Breakdowns (STUDIO and on-Demand) is limited to 5000 per dimension.
  • If the calculation of a KPI or Metric ends in error, check the engine.log for a number of Breakdowns being larger than the default value. You can update the default value in $HPBA_Home\glassfish\glassfish\domains\BTOA\config\settings\engine-settings.xml to be more or less 5000. 5000 is the recommended breakdown size. Larger numbers may bring performance and stabilization issue.

ClosedTo access:

Select a Metric Breakdown in the Active KPIs pane.

ClosedAbout Metric Breakdown

A Metric represents a business context (universe). The value of the Metric is calculated based on the entities (facts or dimensions) that provide information on the business context. A business context can include lots of facts or dimensions.

The administrator creates multiple levels of Metric Breakdown depending on the definition of the Metric  and on the Metric universe. These definitions provide the different levels of breakdown that enable you to obtain very detailed information.

In the Studio, you can configure Breakdowns according to their dimensions. For each Metric, a list of the relevant entities is provided in a menu and the dimensions of these entities in sub-menus. Metrics can have many levels of breakdowns (limited to 6 levels).

Note  When you configure the breakdown you are locking the context of the Metric for which you are creating the Breakdown because the Breakdown inherits the definitions of the Metrics (for example, the Period definition). You cannot specify a different definition for the Breakdown, and you cannot change the definition of the Metric for which you have created Breakdowns. To unlock the Metric context you must remove the Breakdown.

The list of fields that are available for breakdowns is configured in the Context Designer. By default,numeric fields are not dimensions, therefore they are not available for breakdowns. If you want them to be available for breakdown, open the Context Designer and in the Entities area, click to enable the creation of Breakdowns. For details, see Semantic Layer - Context Designer

Date fields are not available for breakdowns.

Tip  

  • If you change the name of a KPI that has KPI Breakdowns or the name of a Metric that has Metric Breakdowns, you must perform a new calculation to update names of their overrides. For details about overrides, see KPI and Metric Breakdown Overrides.
  • The names of the KPI or Metric Breakdowns are not automatically updated after you change the name of the KPI or Metric parent even after a new calculation.You must access the Studio and manually change the names of the KPI or Metric Breakdowns to match the new parent KPI or Metric names.

ClosedImpact of changes to configurations in the Studio on the display in Dashboard and the EXPLORER tab

Changes in the STUDIO have impacts on the display in Dashboard and EXPLORER. For details, see Synchronization of Changes in the Studio with Display in the Dashboard and the EXPLORER tab.

ClosedCreate a Metric Breakdown

  1. Click the Studio button (top right corner) to open the Studio.
  2. In the Active KPIs pane, perform one of the following actions:
    • Select the relevant Metric, and click the Create a breakdown for the Metric button in the toolbar.
    • Right-click the relevant Metric, and select Breakdown in the menu that opens.
  3. In the list of entities that opens, select the required dimension.
  4. The Metric Breakdown is inserted as a child of the Metric with the Breakdown icon.
  5. You can add more Metric Breakdowns.

ClosedCreate a Metric Breakdown  of a Metric Breakdown

  1. Click the Studio button (top right corner) to open the Studio.
  2. In the Active KPIs pane, perform one of the following actions:
    • Select the relevant Metric Breakdown, and click the Create a breakdown for the KPI button in the toolbar.
    • Right-click the relevant Metric Breakdown, and select Breakdown in the menu that opens.
  3. In the menu that opens, select the required entity, and if relevant select the required dimension.

    A new Metric Breakdown is inserted as a child of the Metric Breakdown in the relevant Scorecard tree with the Breakdown icon.

  4. You can add more breakdown levels depending on the selected dimensions. The dimensions you selected in higher levels of the breakdown are disabled for lower levels.

ClosedRemove a Breakdown

To remove a Breakdown, proceed as follows:

  1. Click the Studio button (top right corner) to open the Studio.
  2. In the Active KPIs pane, perform one of the following actions:
    • Select the relevant Metric Breakdown, and click the Delete the currently selected node button in the toolbar.
    • Right-click the relevant Metric Breakdown, and select Delete option in the menu that opens. If you select a Breakdown that has child Breakdowns, these child Breakdowns are also deleted after you confirm the action.
  3. Confirm the deletion when you are prompted to do so.

ClosedConfiguration Details Tab for a Metric Breakdown

User interface elements are described below (when relevant, unlabeled elements are shown in angle brackets):

UI Element

Description
General - Metric Breakdown
Entity The name of the entity you selected when creating the Metric Breakdown.
Dimension The name of the dimension you selected when creating the Metric Breakdown.
Name
The name of the Metric Breakdown.
Its format is
<Metric_name> by <entity_name> <dimension_name>.
Description

The description of the Metric.

Limitations: The maximum number of characters is 1000.

Overrides

Add a breakdown override
Click to open the Add a Breakdown Override dialog box. For details, see KPI and Metric Breakdown Overrides.
Name

The name of the override you just created. Its format is:
<Metric_name>: <result_kpi_to_override>
Edit. Click to edit the selected override. For details, see KPI and Metric Breakdown Overrides.
Remove. Click to delete the selected override.
Test Metric

Click to test the Metric.

 The button is disabled for Metric Breakdowns.

Save Click to save the changes.
Discard Click to discard the changes you have made since the last Save operation.

Send Help Center feedback