KPI - Conditional Styles

First conditional style whose condition has been met is applied.

  • Mode
    For information about setting the condition, see Condition section.
    A condition that needs to be met for the conditional style to apply.

  • Description
    A short definition of the usage of the conditional style.

  • Appearance
    A style of the condition.

    • Presentation Type
      Inheritable
      Defines how value should be presented.

      • Alphanumeric - The value is presented as a pure text, without any additional graphical elements.

      • Semaphore - The value is enveloped in a colored circle. The circle changes color based on configured conditional styles. The semaphore is used, when the state is more important than the value itself.

      • Circle - The value is accompanied by a circle indicator. The indicator represents the level of fulfillment of a configured goal.

      • Semi Circle - The value is accompanied by a semi-circle indicator. The indicator represents the level of fulfillment of a configured goal.

      • Horizontal/Vertical Bar - The value is accompanied by a rectangular indicator. The indicator represents the level of fulfillment of a configured goal.

      • Image - An image is applied, when the condition is met.

      • Static Color - A static color is applied, when the condition is met.

    • Display Format
      Inheritable
      Format in which the value should be displayed. When Raw is selected, the value is displayed without any transformation.

    • Custom Display Format
      Available only when “Custom” is selected as a Display Format
      For more information see Custom Display Format section.
      Custom format in which the value should be displayed.

    • Text Color
      Inheritable
      For more information see Color Field section.
      Color of the text.

    • Semaphore/Circle/Semi Circle/Bar Color
      Inheritable
      According to the selected presentation type
      For more information see Color Field section.
      Color of the Semaphore/Circle/Semi Circle/Bar.

    • Empty Bar Color
      Inheritable
      Available only when “Horizontal/Vertical Bar” is selected as a presentation type
      For more information see Color Field section.
      Background color of the bar itself.

    • Background Color
      Not available, if the “Image” presentation type is selected
      For more information see Color Field section.
      Color of the background.

    • Text Style
      Not available, if the “Image” presentation type is selected
      For more information see Text Style section.
      Type of font to use and whether bold or italic text should be used.

    • Text Sizing
      Not available, if the “Image” or “Static color” presentation type is selected
      Controls, how the font size is calculated.

      • Regular - Font is sized relatively to KPI’s height.

      • Best Fit - Font is dynamically sized to always fit inside KPI.

    • Text Wrapping
      Available inly if “Regular” is selected as a text sizing.
      Whether the text should be splitted into multiple lines if the text is wider than the whole segment.

    • Preserve Whitespace
      Available inly if “Regular” is selected as a text sizing.
      Whether whitespaces should be preserved as they are, or be replaced with a single space character.

    • Enable Hyperlink
      Whether the KPI should be clickable and trigger configured action.

      • Text
        Not available if “Image” presentation type is selected
        Defines a text that will be displayed as a hyperlink instead of current KPI value. {{value}} placeholder can be used to insert current KPI value anywhere in the text. This placeholder is replaced with value that is formatted using configured display format at runtime. This setting allows users to customize the text for a more descriptive or interactive experience.

      • Uri
        Defines a Uniform Resource Identifier (URI) that determines the action triggered upon clicking the KPI. {{value}} placeholder can be used to insert current KPI value anywhere in the text. This placeholder is replaced with value that is not formatted at runtime. Users can specify:

        • Webpage URLs (e.g., “https://example.com”) to open specific websites.

        • Email addresses (e.g., “mailto:example@mail.com”) to compose an email using the default mail client.

        • Phone numbers (e.g., “tel:0123456”) to initiate a phone call on compatible devices.

        • Custom URIs (e.g., “im:John Smith”) for instant messaging, which opens the default messaging app to send a message.

      • Target
        Defines the target window or tab where the URI action will be executed:

        • New Tab: Opens the specified URI in a new browser tab.

        • Current Tab: Loads the URI in the current browser tab, replacing the current content.

        • Pop-up: Displays the URI content in a new pop-up window.

        • None: Disables any specific target behavior, allowing the browser’s default action.

    • Font Size Coefficient
      Available only when “Regular” is selected as a text sizing
      Not available if “Image” or “Solid Color” is selected as a presentation type
      The font size is calculated by multiplying available height for the text by font size coefficient. In the case of semicircle, circle and semaphore presentation type combined with the regular sizing, available height is defined by the height of the circle/semicircle/semaphore. Otherwise, by the height of the container.

    • Horizontal Alignment
      Available only when “Regular” is set as text sizing and “Alphanumeric” is set as presentation type
      Controls, where the value should be aligned on the horizontal axis.

      • Left - The value is aligned to the left.

      • Center - The value is centered.

      • Right - The value is aligned to the right.

    • Padding
      Available only when “Center” is not selected as the horizontal alignment
      The size of a padding between the value and segment’s border in “em” units. 1 em equals to the font size of the associated text.
      The padding is applied to the side where the text is horizontally aligned.

    • Display Range Min/Max
      Required
      Available only when “Circle”, “Semi Circle” or “Bar” presentation type is selected.
      Specifies the range of values, graphical indicators can display.

    • File
      Available only when “Image” presentation type is selected
      For more information see Static content chapter.
      Relative path of the image, that should be displayed. Using the {{value}} placeholder in the path, an image can dynamically change, based on the KPI value.

    • Image Horizontal Alignment
      Available only when “Image” presentation type is selected
      Controls, where the image should be aligned on the horizontal axis.

      • Left - The image is aligned to the left.

      • Center - The image is centered.

      • Right - The image is aligned to the right.

    • Image Vertical Alignment
      Available only when “Image” presentation type is selected
      Controls, where the image should be aligned on the vertical axis.

      • Top - The image is aligned to the top.

      • Middle - The image is centered.

      • Bottom - The image is aligned to the bottom.

    • Image Size
      Available only when “Image” presentation type is selected
      Decides, how the image is adjusted to the Segment’s size.

      • Cover - The image is resized to cover the whole Segment, without deforming the image. No uncovered spaces are present. However one of image’s axis may overlap outside of the Segment’s boundaries.

        ../../../../_images/image-cover.png

      • Contain - The image The image is resized to be fully displayed, in largest possible size, without deforming the image. Uncovered spaces, filled with the Background Color, are present.

        ../../../../_images/image-contain.png

      • Fill - The image fully fills the entire Segment’s size. The image may be deformed. No uncovered spaces or overlapping occurs.

        ../../../../_images/image-fill.png

      • Custom - When selected, Custom Size Height and Custom Size Width fields are displayed. These fields define size of the image in percentages of the Segment’s size.

        ../../../../_images/image-custom.png

    • Effects and Filters
      Available only when “Image” presentation type is selected
      Controls, adjusting the image, such as Brightness, Contrast, Opacity etc. Click to revert image to its default values.

    • Blink Background
      Whether a background should blink, when the condition is met.

      • Color
        Inheritable
        For more information see Color Field section.
        Color of the blinking background.

    • Play Audible Alert
      Whether audio sound should be played, when the condition is met.

      • Audio File
        Inheritable
        For more information see Static content chapter.
        The alert sound that will be played.

      • Repetition
        Inheritable
        Defines how many times audio alert should be played.

        • Repeat - The sound is continuously repeated while the bad value is present.

        • Don’t Repeat - The sound is played only once, when the bad value is first displayed.

    • Title and Paging Info
      Title and paging info.

      • Content
        Inheritable
        Content of the title.

        • Title - Title is displayed.

        • Paging Info - Paging info is displayed.

        • Title and Paging Info - Both title and paging info are displayed.

      • Text Color
        Inheritable
        For more information see Color Field section.
        Color of the text.

      • Background Color
        Inheritable
        For more information see Color Field section.
        Color of the background.

      • Text Style
        Inheritable
        For more information see Text Style section.
        Type of font to use and whether bold or italic text should be used.

      • Font Size Coefficient
        Inheritable
        The font size is calculated by multiplying available height for the text by font size coefficient.

      • Horizontal Alignment
        Inheritable
        Position of the text on horizontal axis.

        • Left - Text is aligned to the left.

        • Center - Text is aligned to the center.

        • Right - Text is aligned to the right.

      • Padding
        Available only when “Left” or “Right” is selected as horizontal alignment.
        Inheritable
        The size of a padding between the Title text and Title’s border in “em” units. 1 em equals to the font size of the associated text.
        The padding is applied to the side where the text is horizontally aligned.