KPI - Conditional Styles¶
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.
Hyperlinks are not clickable in edit mode. Target Layout
Whether clicking on the value should open a specific Layout.Layout
Available only when “Target Layout” is enabled
The Layout that should be opened when the value is clicked.Query String Parameters
Available only when “Target Layout” is enabled
Parameters that will be added to the targeted layouts URL. Parameters are used for passing values to dynamic filters in grid-like sources. For more information about dynamic filters and URL parameters, see Filtering using URL parameters chapter.Name
Name of the query string parameter.Value
Value of the parameter. The {{value}} placeholder allows referencing the current value.
Text
Not available if “Image” presentation type is selected
Defines a text that will be displayed as a hyperlink instead of current value. {{value}} placeholder can be used to insert current 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
Not available if “Target Layout” is enabled
Defines a Uniform Resource Identifier (URI) that determines the action triggered upon clicking. {{value}} placeholder can be used to insert current 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 where the hyperlink should be opened: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. This option should probably be used when provided Uri is email addresses, phone number or custom URI.
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.
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.
Fill - The image fully fills the entire Segment’s size. The image may be deformed. No uncovered spaces or overlapping occurs.
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.
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.