Get started with Atlassian Analytics
Learn how to add Atlassian Analytics to a site and understand what you need to query data and create charts.
Set up a “Calendar” control
“Calendar” controls lets you filter your charts on a single date or a date range.
Setting up a “Calendar” control requires two main steps:
Create the “Calendar” control for your dashboard.
Connect the “Calendar” control to a chart.
Create a “Calendar” control
To add a “Calendar” control to your dashboard:
Open the dashboard where you want to add the “Calendar” control.
Select Add control > Calendar from the dashboard sidebar. A pop-up will appear for you to configure the control’s settings.
Optionally, change the Name of the control.
For Calendar type, select whether you want to filter your charts on a single date or date range.
Edit the Default start and end dates using fixed dates, or use a combination of relative date variables and date and time functions for dynamic filtering.
Select Add.
Place the newly created “Calendar” control anywhere on your dashboard.
Connect a “Calendar” control to a chart
After you’ve created your “Calendar” control, you’ll need to connect it to a chart to start using it to filter. Connect it to a chart by using its corresponding dashboard variable in a query.
You can also connect controls in other Visual SQL steps. Learn more about connecting controls outside of a query.
Manually connect to charts
In a visual mode query
To connect a “Calendar” control to a chart using a visual mode query:
Open the chart editor by creating a new chart or editing an existing chart on the dashboard.
In the “Filters” section of your visual mode query:
Add the date column you want the control to filter.
Select the filter operator. Most people use between and including.
Reference your control using its dashboard variable:
If the “Data type” of your control is Date, use {CALENDAR_NAME}
If the “Data type” of your control is Date range, use {CALENDAR_NAME.START} and {CALENDAR_NAME.END} for the start and end dates, respectively.
Replace CALENDAR_NAME with the name of your control.
Select Run query. The result table will update with the new filter applied to the data.
Select Save to dashboard to save the chart.
In a SQL mode query
Connect a “Calendar” control in your SQL mode query by referencing its dashboard variable:
If the “Data type” of your control is Date, use {CALENDAR_NAME}
If the “Data type” of your control is Date range, use {CALENDAR_NAME.START} and {CALENDAR_NAME.END} for the start and end dates, respectively.
Replace CALENDAR_NAME with the name of your control.
Here’s an example of how you might get the total number of Jira issues created between the selected dates of a “Calendar” control:
1
2
3
SELECT COUNT(DISTINCT `Issue`.`issue_id`) AS `Count of unique Issue ID`
FROM `jira_issue` AS `Issue`
WHERE `Issue`.`created_at` BETWEEN {CALENDAR_NAME.START} AND {CALENDAR_NAME.END};Verify your chart is connected to the control
To make sure you’ve properly connected your chart to the control, you could verify this by updating the values of the control and seeing if your connected chart filters accordingly.
Alternatively, there are two ways you can check for all charts that are connected to the control.
One option is to:
Hover over the control.
Select its More actions () menu > Highlight connections.
The other option is to:
Select Settings from the dashboard sidebar.
Go to the Controls tab.
Select Highlight connections.
Both options highlight all elements on the dashboard that are connected to that particular control.
Was this helpful?