Value

This widget displays aggregated case data, for example, the average order value at a given location.

Add and configure the widget

Follow these steps:

1. In your investigation or dashboard, click Add widget and select a widget.

   The widget configuration dialog opens. You define which data to display on the left, and preview this data on the right.

2. Define the following:

   Option	Mandatory	Description
   Name	no	The name is displayed as the widget title. If you don't provide a name while configuring this widget, a name is set for you. In this case, if configured using metrics, the metric name is used for the default name. For other configuration types, the widget type is used as the default name.
   Description	no	The description is displayed as info text when users click in the widget.
   Widget type	yes	Choose a configuration option: Attribute SIGNAL code Metric Read more in the sections below.

3. Depending on the chosen widget type, continue with one of the following:

   • Configure with attributes

   • Configure with a SIGNAL query

   • Configure with metrics

4. Set the number of decimal places and the rounding procedure. Read more in section Set decimal places and rounding procedure.

5. To preview the result of your data selection, use the following options in the preview area on the right:

   • Preview - Display the chart or diagram with the data that's retrieved

   • Data view - Display the query result as a table

   • SIGNAL view - Display the SIGNAL query

   • Attributes - Display the available case and event attributes

   It depends on the configuration type which preview option is available. For example, attributes can only be displayed here when the widget is configured with SIGNAL queries or metrics.

6. Click Save.

   The widget is added.

Configure with attributes

Option	Mandatory	Description
Attribute inputs	yes	Set the following: Attribute, for example cycle time, events, variant, or case attributes Function: SUM COUNT AVG MIN MAX
Unit	no	Choose an option: Currency Suffix Read more in section Add a unit.

Configure with a SIGNAL query

Option	Mandatory	Description
Unit	no	Choose an option: Duration The result of the SIGNAL query must be a value in milliseconds, otherwise an incorrect duration is displayed. Currency Suffix Read more in section Add a unit.
SIGNAL query	yes	Provide a SIGNAL query. A sample query is provided by default. Read about the SIGNAL editor functions like autocompletion, color scheme, and error linting in section The SIGNAL code editor.

With Save as New Metric, you can add the full code or the code snippet that you highlighted to the metric collection of your process. Read in section Edit a metric how to further customize the metric, if necessary.

If you click Save as New Metric again, another metric is created.

Configure with metrics

Option	Mandatory	Description
Metric	yes	Choose a metric. The following applies: You can select metrics with the status valid or invalid, and customize invalid metrics later if necessary. Only metrics of the aggregation type over cases are available here. Read more in section Where to use metrics.
Unit	no	Choose an option: Duration Currency Suffix Read more in section Add a unit.

What you can do in the widget

Drill down into data

Explore multidimensional data by navigating from one level down to a more detailed one. For this, you don't need to configure a new widget.

To drill down into your data, click in the widget and select an option. The result set is opened as a new widget.

The following options are available:

• Break down by another attribute you select

• View over time

• View distribution

Set decimal places and rounding procedure

You can determine the number of decimal places to be displayed for the value and assign an appropriate rounding procedure.

The following rounding procedures are available:

• No rounding

  Displays the calculated value as it is.

• Round up

  Rounds the decimal place to the next higher value.

• Rounds down

  Rounds the decimal place to the next lower value.

• Round to closest

  Rounds values above or equal "5" to the next higher value.

Follow these steps:

1. In the widget configuration dialog, select the rounding option from the drop-down list.

2. Click to decrease the decimal place of the value or to increase the decimal place again.

3. Confirm with Save.

   The value is displayed according to your settings.

Add a threshold

You can add a threshold to define boundaries for different regions of acceptance. You have the following options to set and visualize the threshold:

• 2 region

  The threshold value is displayed above the calculated metric. The color of the metric indicates whether the value is above or below the threshold. You can specify which color is used to indicate going below or above the threshold.

  View widgets with values above and below the threshold

  Metric (877) above threshold (850)
  Metric (877) below threshold (880)

• 3 regions

  The metric (877) is displayed as a green bar. A second bar below the metric bar displays the regions above, between, and below the threshold value according to the set colors. In addition, a goal (880) can be displayed by a dashed line.

  View a widget with 2 thresholds and a goal

  

Follow these steps:

1. Click in the widget, then Threshold.

   The threshold configuration dialog opens.

2. Select the threshold option.

3. Specify the value and a label for the threshold. If you like, add a goal, for example to indicate a target value.

4. You can re-assign the three available background colors. To do so, click the color bar and select the color. To swap the color assignment, click Swap color order.

5. Confirm with Save.

   The threshold is added according to your settings.

When you add thresholds to a widget, you can link it to a Live Insights shape in SAP Signavio Process Manager. Read more in section Add Live Insights.

To remove a threshold, select None in the threshold configuration dialog.

Add a unit

You can add a unit to the value. By default, no unit is configured in the widget.

To add a unit, follow these steps:

1. Open the widget configuration dialog.

2. Select a unit type from the drop-down list Choose unit type:

   • Duration: The duration is displayed in the widget.

     This option is only available for widgets that are configured with SIGNAL queries or metrics.

   • Currency: Choose a currency value from the drop-down list, for example EUR or USD.

   • Suffix: Enter your custom text. To include a space between the value and the text, enter a space first and then your text.

3. Confirm with Save.

A unit can be set in widgets and in metrics. The following rules apply:

• If a unit is neither set in the metric nor in the widget, no unit is displayed.

• If a unit is set in the metric, but not in the widget, the metric unit is displayed.

• If a unit is set in the widget, but not in the metric, the widget unit is displayed.

• If a unit is set in the metric and in the widget, the widget unit is displayed.

Read how to configure units in metrics in section Create a custom metric.

Next steps

Create an insight for an investigation

Filter a widget