Calendar

Related Videos

The Calendar presents a historical view of a specific calculation. Each day in the configured time period is displayed as a tile. The color of the tile indicates to which range value of the day falls under. Multiple months can be displayed by a single calendar segment.

For general information about this segment, see Calendar chapter.

• Calculation
  For more general calculation options, see Editing Scalar Valued Calculations chapter.
  The calculation options control, how the displayed values are calculated. Only calculation functions that produce numeric results can be selected in calendar.

  • Period Settings
    This group defines period over which we want to display values.

    • Period
      A desired type of time period to be displayed in calendar.

      • Month - A month like calendar view will be displayed.

      • Week - A week like calendar view will be displayed.

    • Number of Displayed Periods
      Required
      The number of months/weeks to display.

    • Displayed Period/Last Displayed Period
      Required
      When only one period should be displayed this option defines which period it will be.
      When multiple periods should be displayed this option defines which will be the last displayed period.

      • This Period - The calendar displays the currently ongoing Month or Week.

      • Last Period - The calendar displays the previous Month or Week.

      • Other Period - If this option is chosen, how far into the past the Displayed Period/Last Displayed Period is has to be provided.

    • Last Displayed Period - # Periods Ago
      Available only when “Other Period” is selected as Displayed Period/Last Displayed Period
      When multiple periods should be displayed this option defines which will be the last displayed period.

    • Value of the Day
      Required
      Defines, what result should be used in the Calendar.

      • First - The first recorded result of each day is displayed.

      • Last - The last recorded result of each day is displayed.

      • Min - The minimal recorded result of each day is displayed.

      • Max - The greatest recorded result of each day is displayed.

      • Delta - The difference between the Last result of the day and the one before is displayed.

    • Show Current Day
      Available only when “This Period” is selected as Displayed Period
      Whether the value for current day should be displayed. Value is being automatically updated if displayed.

    • Weekdays
      The Calendar can be configured to display only certain relevant days of the week.

      • First Day Of Week
        Inheritable
        Specifies, which day should be displayed and considered as first of each week.
        

        • Monday

        • Tuesday

        • Wednesday

        • Thursday

        • Friday

        • Saturday

        • Sunday

      • Monday, …, Sunday
        Inheritable
        Visibility of each day can be configured with its corresponding dropdown. Non-Working days are hidden.

        • Working Day - The day is displayed and considered as a working day.

        • Non-Working Day - The day is hidden and considered as a non-working day.

• Appearance
  The style of a Calendar

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

  • Headers
    Visual configuration of calendar headers.

    • Day Headers
      Inheritable
      Controls, whether the day of the week should be displayed above all calendar day columns.

      • Show - The day of the week is displayed.

      • Hide - The day of the week is not displayed.

    • Period Headers
      Inheritable
      Controls, whether the displayed time period should be described in header.

      • Show - The time period is displayed.

      • Hide - The time period is not displayed.

    • Height
      Inheritable
      Height of the headers, that is measured in permilles of the entire Layout’s height.

    • 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.

  • Day Numbers
    Visual configuration of day numbers.

    • Visibility
      Inheritable
      Whether day numbers should be visible.

      • Show - Day numbers are displayed.

      • Hide - Day numbers are not displayed.

    • Content
      Inheritable
      Content of the day numbers.

      • Title - Only the title of the day is displayed.

      • Paging Info - Only the paging info of the day is displayed.

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

    • Position
      Position of the day numbers. If Float on Top or Float on Bottom is selected, day numbers float over the segment which may cause overlapping.

      • Float on Top - Day numbers float over the segment.

      • Float on Bottom - Day numbers float under the segment.

      • Top - Day numbers are displayed on the top of the segment.

      • Bottom - Day numbers are displayed on the bottom of the segment.

    • Height
      Inheritable
      Height of day numbers.

    • Text Color
      Inheritable
      For more information see Color Field section.
      The color of the day number, displayed in the tile.

    • Background Color
      Inheritable
      For more information see Color Field section.
      Color of the day numbers 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 day numbers on horizontal axis.

      • Left - Day numbers are aligned to the left.

      • Center - Day numbers are aligned to the center.

      • Right - Day numbers are aligned to the right.

    • Padding
      Inheritable
      Available only when the horizontal alignment is “Left” or “Right”
      The size of a padding between the day numbers and day numbers’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.

  • Values
    Visual configuration of calendar’s day tiles.

    • Presentation Type
      Required
      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.

      • Static Color - A static color is applied.

        

    • Display Format
      Required
      Format in which 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 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
      Inheritable
      Not available, if the “Image” presentation type is selected
      For more information see Color Field section.
      Color of the background.

    • Text Style
      Inheritable
      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
      Inheritable
      Not available, if the “Image” or “Static color” presentation type is selected
      Controls, how font size is calculated.

      • Regular - Font is sized relatively to calendar’s cell height. In case of Circle, Semi Circle and Semaphore presentation type, font is sized relatively to Circle’s/Semi Circle’s/Semaphore’s height.

      • Best Fit - Font is dynamically sized to always fit inside calendar’s cell.

    • Font Size Coefficient
      Inheritable
      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.

    • Text Wrapping
      Whether the text should be split into multiple lines if the text is wider than the whole segment.

    • Preserve Whitespace
      Whether whitespaces should be preserved as they are, or be replaced with a single space character.

    • Enable Hyperlink
      Whether the value 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.

    • Choose Display Range Min Manually
      Available only when “Circle”, “Semi Circle” or “Bar” presentation type is selected.
      Whether the minimum on the value range is defined manually.

      • Min
        Value, that defines the minimum on the value range.

    • Choose Display Range Max Manually
      Available only when “Circle”, “Semi Circle” or “Bar” presentation type is selected.
      Whether the maximum on the value range is defined manually.

      • Max
        Value, that defines the maximum on the value range.

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

      • Left - The value is aligned to the left.

      • Center - The value is aligned to the center.

      • Right - The value is aligned to the right.

    • 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 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 aligned to the center.

      • 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 aligned to the middle.

      • 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 Reset to revert image to its default values.

    • Custom Null Value
      Inheritable
      A custom value that is displayed when the value is null.

    • Corner Radius
      Inheritable
      Corner radius of the values can be adjusted with a slider or a text field for a custom value. Measured in permilles of the entire Layout’s height.

  • Conditional Styles For more information see Conditional Styles chapter.
    Conditional Styles are used to modify appearance of the value based on its data.

• Conditional Styles