Configuring dashboards with additional customizations

As a reporting administrator or editor, you can configure dashboards with the following customizations:

Configure the time range for a dashboard
Customize the Home page
Configure the default data source component
Configure the default date and time format
Add descriptions and tags

To configure the time range for a dashboard

As a tenant administrator or an editor, you can control the time range that is used in the dashboards to further refine your data. To change the time range:

On a dashboard, click the Time Range icon and select an absolute time range or a relative time range for your report.
For example, filter the data in the dashboard by days, months, year, fiscal quarter, fiscal year, and so on. To filter data on a dashboard by fiscal time ranges, perform the following actions:
- Select the fiscal time range and click Change time settings on the Time Range pop-up window.
- Select the Fiscal year tab.
- Select the fiscal year start month.
  By default, January is selected. Based on this selection, the data in the dashboard is filtered by the fiscal time range.
  Example
  Jordan, a tenant administrator, wants to view ticket resolution dates for the current fiscal year. He can filter the dashboard by This fiscal year to display tickets that have a resolution date within this fiscal year. However, if Jordan wants to see only those tickets that have a resolution date till date, he can select This fiscal year so far to filter the dashboard.
Apply your time range.

The dashboard displays data for the time range that you selected.

To customize BMC Helix Dashboards Home page

As a tenant administrator or editor, you can customize the Home page of BMC Helix Dashboards. The Home page of BMC Helix Dashboards is a dashboard with multiple panels that can be edited.

To customize the Home page, do any of the following:

Copy and edit the Home page:
1. Copy the Home page of BMC Helix Dashboards. For more information about copying a dashboard, see To copy a dashboard.
2. Access and edit the newly created copy of the Home page. For more information about editing the Home page, see To edit a dashboard.
3. Set the the newly created copy of the Home page as default. To set the default Home dashboard, from the navigation menu , click Administration > General > Default preferences and select this newly created Home page under Home Dashboard list.
Save and edit the Home page:
1. Click the icon from the BMC Helix Dashboards Home page and then edit the details and save.
2. Access and edit the newly created copy of the Home page. For more information about editing the Home page, see To edit a dashboard.
3. Set the the newly created copy of the Home page as default. To set the default Home dashboard, from the navigation menu , click Administration > General > Default preferences and select this newly created Home page under Home Dashboard list.

Updating home page videos

The video panels appearing on the BMC Helix Dashboards Home page can be edited to change the videos displayed.

To configure the default data source component

As a tenant administrator or editor, you can configure the default data source component for the BMC Helix data source. While configuring a panel, this default component is displayed in the Query type list.

To configure the default data source component, perform these steps:

Open BMC Helix Dashboards.
In the left pane, click Administration > General.
Click Default preferences.
Under Preferences, select the required query type from the Query Type list.
Save the changes.

To configure the default date and time format

Configure a default format to be used for consistently displaying the date and time.

As a tenant or reporting administrator, you can configure this format at a tenant level. This format is globally applied to all dashboards, panels, and reports for displaying the date and time. You can override this global setting by configuring the date and time format at a user level or by configuring an override property. The user-level setting precedes the tenant-level setting. The override property setting precedes both the tenant-level and user-level settings.

Scenario

Jordan is a reporting administrator at Apex Global. He is responsible for generating dashboard reports and sharing them with the stakeholders. He wants to ensure that the date and time format is used consistently. He configures the date and time format at the tenant level.
Jim is a Dashboards user. He wants to view the date and format in Japanese. He changes the date and time format in his profile settings.

To configure the date and time format at the tenant level

Open BMC Helix Dashboards.
In the left pane, click Administration > General.
Click Default preferences.
Under Preferences, in the Datetime Format field, select from the available formats or define a custom date format.
Save the changes.

To configure the date and time format at the user level

Open BMC Helix Dashboards.
Select user profile > Profile > Datetime Format.
In the Datetime Format field, select the available formats or define a custom date format.
Save the changes.

To configure an override for date and time for a particular dashboard or a panel, see Modifying-date-and-time-format-in-dashboards.

Important

If you set the Datetime Format as Default at the tenant or user level, the date and time across all the dashboards and panels is displayed according to the local setting of your browser.

The following table provides some examples of custom date and time formats that you can configure:

Format	Description	Example
DD/MM/YYYY	Displays the date in the day, month, and year format. DD denotes date. MM denotes month. YYYY denotes year.	24/04/2024
dd	Displays the day. dd denotes the day of a week.	Su, Mo, Tu, and so on.
HH:mm:ss	Displays hours, minutes, and seconds in the 24-hour format. HH denotes hour in the 24-hour format. mm denotes minutes. ss denotes seconds.	16:45:00
hh:mm:ss A hh:mm:ss a	Displays hours, minutes, and seconds in the 12-hour format. hh denotes hour the 12-hour format. A denotes AM or PM as applicable. a denotes am or pm as applicable.	04:45:00 AM 04:45:00 am

To configure a variable to download dashboards and panels in the XLSX with date and time format settings

As a tenant or reporting administrator, configure the enableOverridesForExcel variable to download a dashboard or panel as a report in XLSX. The downloaded XLSX file displays the date and time values in the date format as configured in the dashboard.

Open BMC Helix Dashboards.
Click Dashboard Settings .
Click Variables.
In the Select variable type field, select Constant.
In the Name field under General, specify the variable name as enableOverridesForExcel.
Click Apply.
Save the dashboard.

Best practice
BMC recommends setting the Last 90 days as the default value of the time range to avoid fetching large amounts of data from the database. The time range can be changed to a customized range after the dashboard loads.

To add descriptions and tags to dashboards

As a reporting administrator or editor, you can configure general settings for a dashboard, where you can add a description and tags for the dashboard.

On a dashboard, click the Dashboard settings icon in the top-right corner.
On the General page, do any of these optional tasks:
- Add a description for the dashboard, add tags, or change the folder where the dashboard is saved. If you do not want other users to edit the dashboard, toggle the Editable button.
- Specify the time options. If you want to hide the time picker on the dashboard, toggle the Hide time picker button.
- Select a different graph tool tip option.
Click Save dashboard.

You can perform many other functions on the dashboards, such as annotate a point on a graph or view the history of a dashboard. To learn about these functions, click here.