Setup Exply for JIRA
After you've downloaded and installed Exply in your JIRA instance you're ready to start the plugin for the first time.
Setting up Exply for JIRA is as easy as you can imagine. Your JIRA configuration is automatically detected.
The only thing you need to do is adding your Tempo API-Key.
Just follow the links provided in the welcome screen. They're leading you dirctly to your personal Tempo page.
How do I create a new Dashboard?
After you logged into Exply you'll see the welcome screen with to main options:
- Create a Dashboard
- Open a Dashboard
To create a new dashboard just click the corresponding button on the welcome screen.
After your new dashboard has been created you'll see the following screen showing you several options:
- Dashboard Title
- Group Title
- Adding new Widgets
- Adding new Widget Group
- Cancel / Save Dashboard
First of all - it's useful to give your dashboard an individual name, f.e. customer name, project name, team name, etc.
That way you'll find it easy within the dashboard overview among other dashboards. Also your customers or project teams will really appreciate the appropriate naming and it makes it way easier to talk about it.
In our example we want to get an overview regarding the project "General Products Website". So we give the dashboard this project name.
The first part of our dashboard shall provide us a quick overview and is named the same way. This also makes it easier for everyone to quickly know what they're looking at.
You'll find the corresponding fields in the upper left corner.
Right beneath the dashboard naming you'll find the data filter options for your dashboard. Depending on your imported data you'll see your corresponding values.
Cause we want to create a dashboard showing only the data related to the project "General Products Website", we're filtering them.
We therefore leave the document type filter blank and select "Name of Project" as document field.
After that we can choose from various types of operators like equals (default), contains, ends with, starts with and matches. We're using the default (equals) to choose the project directly in the next field.
To select the wanted project just start to type in the name and the integrated auto completion will show you relevant results. You don't need to fill in the complete name, just click on the result you need and it will be selected.
Repeat this step if you need to select more projects.
In our case we're typing "General" into the operand field and get all results matching the term.
After having set the dashboard data context we're ready to create the first dashboard widgets.
By clicking on the "Add new Widget" button we get to the widget overview.
At first we'll have a look at the Quota Tile.
The Quota Tile enables you to define a fixed value per time span to quickly see how much of this value has been used within the defined period and how many value per day have to be done to reach the defined value, depending on the assigned people.
For Example: Billable Hours
Ongoing projects have often a fixed amount of hours that are guaranteed to be done per month (e.g. week, quarter, year).
In our example this specific amount of hours is 240 per month.
- Set the Value Field to Billable Hours
- Select the corresponding months
- Type the amount of hours in the field behind to time span
- Repeat for further periods if needed
- Enter the appropriate unit, e.g. hours
The Quota Tile sets its background color automatically depending on the ratio between defined value and used value. You can change it to your prefered color if you want.
Please keep in mind that the Quota Tile depends on the selected time span of the corresponding widget group.
Next we create a Pivot Table showing all the team members with the epics they worked on, including the amount of time needed.
In our example we're performing the following steps to get the need pivot table:
- Choose "working time entries" as document type to pivot over
- Select "Name of Project" as first grouping field
- "Name of Creator" to get the team member second
- "Epic" to get their corresponding working time entries per Epic third
Note: The grouping field "Name of Project" is not necessary if a adequat data filter is set for the dashboard.
Next we'll want to see the billable worked hours per epic and day/month/etc. to identify peaks and valleys for this project.
We therefore add a new widget and choose Timeline Chart.
Within the configuration we set the following options:
- Time-Field set to "Date of Creation"
- Granulairty is set to "automatic" per default, showing the optimal time period for the given data
- Choose "Billable Hours" for Value Field and
- "Epic" as Stacking Field
The Timeline Chart can be viewed as vertical bar chart, showing each point in time as separate bar, or area chart where all points are connected over time.
Furthermore the Maximum Number of stacks limits, as the name suggests, the number of stacked elements. In addition to that the Maximum Number of decimals narrows down the shown decimals.
After we created the first three widgets, we're ready to save the actual state of our dashboard by clicking "save" in the upper right corner.
There you have it - your first small project overview dashboard! Congratulations! :-)