KPI card graphic

A KPI card graphic displays the value of a key performance indicator (KPI) with customizable options like font size, unit position, and trend arrow style. These charts can help you track progress, identify trends, and make data-driven decisions.

Example

The following is a KPI card graphic.

Configure the graphic

Configure the following properties for this graphic:

• Follow asset context - The asset context affects properties that are configured to display asset stream ref data and asset metadata. When this is enabled:

  • If this content is in a visualization, it uses the visualization's asset context. For details, see Create a new visualization.

  • If this content is in an experience, it uses the navigation item's asset reference. For details, see the Add content to a pane section in Add content to panes in your navigation items.

• Follow time context - When this is enabled:

  • If this content is in a visualization, it uses the visualization's time context as the time range for the data it displays. For details, see Create a new visualization.

  • If this content is in an experience, it uses the time selected in the time selector content item as the time range for the data it displays. For details, see Add a time selector.

• Time - If Follow time context is disabled, select the time range for the data displayed in the content item.

• In the Options section:

  • Type - The type of data to display in the graphic.

    This determines the available properties.

  • Alignment - The position of text within the graphic.

    This is available when Type is String.

  • Statistics - The retrieval mode for the graphic.

    This is available when Type is Number. If Current is selected, configure the DataPoint property for each data point. If another option is selected, configure the DataPointReference, StartTime, and DataPointDuration properties for each data point.

    See Understand retrieval mode for details.

  • FontValue - The font size for the data in the graphic.

  • FontUnits - The font size for the units in the graphic.

    This is available when Type is Number and ShowUom is enabled.

  • UnitsPosition - The location of the UOM in relation to the data.

    This is available when Type is Number and ShowUom is enabled.

  • Rate - Enables an indicator for the current value compared to the Threshold and sets the direction of the green arrow.

    Select Up to have the arrow appear green and point up when the data point value is above the threshold. Select Down to have the arrow appear green and point down when the data point value is below the threshold. Available when Type is Number.

  • ShowTitleAs - Enables the Title property in the Graphic Properties area to set the graphic title and sets the font size.

    Title is a larger font. Subtitle is a smaller font.

  • ShowTimeProperties - Enables the DataPointDuration property.

    This option is not available when Statistics is Current or Simulation is enabled.

  • ShowUOM - Enables units of measure for the data points.

    This is available when Type is Number. Set the UOM property in the Graphic Properties section.

  • ShowCard - Displays a colored background behind the graphic.

  • Simulation - Displays test data for the graphic.

    This is available when Type is Number. If enabled, the Statistics and DataPoint properties are not available and the SimMax, SimMin, and SimPeriod properties are available.

• In the Graphic Properties section:

  • DataPointString - The data point or value for the graphic.

    This is available when Type is String.

    To select an asset stream reference or asset metadata, select the field and then select the pencil icon. In the DataPoint window, select Streams. In the Search window, use the filters to find and then select the stream, asset stream reference, or asset metadata to display.

  • DataPoint - The data point or value for the graphic.

    This is available when Type is Number, Statistics is Current, and Simulation is disabled.

    To select a data stream, select the field and then select the pencil icon. In the DataPoint window, select Streams. In the Search window, use the filters to find and then select the stream, asset stream reference, or asset metadata to display.

  • DataPointDuration - The period, in minutes, used when calculating statistics.

    This is available when Type is Number, Statistics is not Current, and ShowTimeProperties is enabled. It can't be zero, but it can be negative when a StartTime is specified.

  • DataPointReference - The data point reference or value.

    This is available when Statistics is not Current and Simulation is disabled.

    To select a data stream, select the field and then select the pencil icon. In the DataPointReference window, select Streams. In the Search window, use the filters to find and then select the stream, asset stream reference, or asset metadata to display.

    Ensure the Data Binding Mode is Constant when configuring this in combination with Statistics.

  • Decimals - The number of decimal places for the data point value, up to 2.

    Invalid values are discarded. This is available when Type is Number.

  • SimMax - The highest simulated value for the graphic, when Simulation is enabled.

    Default is 100. This value must be greater than the SimMin value.

  • SimMin - The lowest simulated value for the graphic, when Simulation is enabled.

    Default is 0. This value must be less than the SimMax value.

  • SimPeriod - The simulation refresh period, in seconds, from 1 to 60.

    This is available when Simulation is enabled.

  • StartTime - The start time for use with statistics.

    This is available when Statistics is not Current and ShowTimeProperties is enabled. If no value is specified, auto refresh is applied. The start and end times of the summary period are determined based on current time.

  • Threshold - The value to compare the data point against to determine the rate.

    This is available when Type is Number and Rate is Up or Down.

  • Title - The title text for the graphic.

    This is only available when ShowTitleAs is Title or Subtitle.

  • UOM - The unit of measure text, up to five characters.

    This is available when ShowUOM is enabled.

• In the Advanced tab:

  • Title - The title displayed for this content item in the grid visualization.

    This is not available in a canvas visualization or experience. Set this value in the Title property in the Graphic Properties section.