Configuring the Calendar component to view time-allocated tickets


As a developer or an application business analyst, you can use the Calendar component to provide a modern user experience of the calendar to the users so that they can see the relevant time-allocated tickets in a calendar view.

Calendar is available as a view component in the Common Components section in the View designer, and is visible only if you have deployed the following bundles:

  • Common Components
  • ITSM Application 

To add a Calendar component to a view definition

  1. Log in to BMC Helix Innovation Studioand navigate to the Workspace tab.
  2. Select the application for which you want to add a calendar component.
  3. On the Views tab, click the name of the view definition to which you want to add an action button.
  4. From Palette, drag the Calendar component to the canvas in the order that you want them to appear on the user interface.
  5. In the Properties pane on the right side, click the Settings icon 22_1_Settings icon.png, and then specify the properties.

    The following table provides information about the properties:

    Property

    Description

    Example

    View component name

    Enter a name to uniquely identify the view component.

    22_1_Calendar general settings.png

    Bundle Id

    Enter the Bundle Id for which you are using the calendar component. 

    External Base URL

    Enter the URL where you will view the complete ticket details. 

    Show side bar

    Select the toggle key to display the sidebar for the calendar.

    Open side bar on launch

    Select the toggle key to enable the option open or close the sidebar for the calendar.

    Start day of the week

    Select the start day of the week that you want to display on the calendar.

    Use 24h format

    Select the toggle key to set the time format that you want to display on the timeline.

    The default value is 12-hour time format. 

    Popover/tooltip width

    Select the maximum width (in pixels) for the tooltip that displays a short overview of the specific event or ticket in the calendar view.

    Page Size

    Select the number to define the tickets that you want to display in the calendar view.

    The default value is 50.

    Hidden

    Select the toggle key to hide the calendar in specific conditions, such as, if you want to disable the calendar at all times or when a specific condition is met.

    Record Details

    Record definition name

    Select the record from where you can fetch the data to display on the calendar. 

    22_1_Calendar record details settings.png


    Filter expression

    Click Click to build an expression to specify the qualification to fetch the data when we want to display the calendar.

    Sort order field

    Select the field based on which you want to sort the data in the calendar.

    Select record type field

    Select the toggle key to select the field from the record definition that holds the record type value.

    If you do not select the toggle key, then you can directly provide the record type value as a hardcoded string.

    Record type

    Select the field that you want to use to display the ticket type; for example,

     Change, Release, Outage.

    ID

    Select the field that you want to use to display the ID of the ticket type field.

    Start date

    Select the field that you want to use to display the start date of the ticket on the calendar.  

    End date

    Select the field that you want to use to display the end date of the ticket on the calendar.  

    Title 

    Select the field that you want to use to display the title of the ticket on the calendar.  

    Description

    Select the field that you want to use to display the description of the ticket on the calendar. 

    22_1_Calendar pill settings.png



    (Optional) Pill 1

    Select the field that you want to highlight for the ticket on the calendar; for example, 

    Risk.

    (Optional) Pill 2

    Select the field that you want to highlight for the ticket on the calendar; for example, 

    Priority

    (Optional) Pill 3

    Select the field that you want to highlight for the ticket on the calendar; for example

    Status

    Field mappings for filters

    Select the fields that you want to display in the Filters section. Users can filter data based on these fields. 


    Has Time Segment

    <need details>

    This field is used for the business time segment and based on this option the UI code will try to look for a specific field ID in the data page query results for the above record definition.

    Does your data contain time segment?

    Time Segment

    Select the field from the list that supports the time segment. 

    This field is visible only if you select the Has Time Segment option.

  6. Click Save.

The following image displays a calendar view of all scheduled business events, tickets, and outages for the scheduled date:

22_1_IS_Calendar_view.png

Where to go from here

Viewing the calendar



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Innovation Suite 25.4