Hello project and scrum masters,
Traffika allows you to sync your planned sprints in JIRA and here is how to set everything up (both in JIRA and Traffika) so you’ll get all the data synced successfully.
Here are the basics:
- Works with Scrum boards only (for now) – if you miss some specific type of board, jus let us know
- Issues must have a time estimates – otherwise Traffika won’t know how long time that job will take.
- No limit on number of created integrations – let the projects keep rolling in!
How to integrate JIRA with Traffika
- Step API connection & Application link – Let’s make Traffika and JIRA speak to each other
- Step New integration wizard – Let’s fetch your project and people from JIRA
- Step Issue synchronizing – Let’s keep it synced
1. Step – API connection & Application link
First you need to create the connection between Traffika and specific JIRA instance and for that you will have to configure both applications side by side.
In Traffika go to Integrations page and keep it open in the tab.
Click on Add connection.
In modal window select JIRA as a tool to connect to and fill up Name of integration and API URL of your JIRA server.
All the other inputs are read-only and you will need it’s values to set up JIRA application link correctly. To copy these values use the Copy icons on the right of each input.
In JIRA go to Administration > Applications > Application links (this path may vary depending on JIRA version).
To allow Traffika to connect with your JIRA you need to create an Application link (which is automatically generated in during the step 1.2).
In application link modal window fill in the inputs according to Traffika API connection data from the step 1.2, check the Create incoming link option and click to continue.
In next step fill the three required fields and click to continue to finish the setting of new JIRA application link.
2. New integration wizard
Once you have set up connection between Traffika and your JIRA you can create Integrations, i.e. connection between specific JIRA instance and Traffika project that will allow you to transfer JIRA issues (only those with time estimates) into Traffika jobs.
To open the wizard go to Integrations page and click on + button to the right of your API connection you’ve created in previous step.
Select JIRA as Tool to integrate and API connection you’ve just created and click Verify and after successful verification you’ll get to the Settings tab.
At settings tab you have to choose which scrum board from JIRA (project) you want to integrate with Traffika project. Be aware of that at this moment you can select only from scrum type boards. Other types like kanban boards or simple project without board cannot be integrated with Traffika at the moment.
In the people tab you have to bind JIRA users with Traffika people. You don’t need to bind all of the JIRA users (use the checkboxes for that). But keep in mind that you won’t be able to sync issues of users you have not bound in this step (you can alter this setting later in edit integration mode).
3. Issue synchronizing
Now you have finished all the necessary settings you can get Traffika to synchronize your JIRA issues. So lets dive in!
In order to synchronize issues click on the sync icon in integrations listing table.
Select sprint that you want to sync. Sprint’s start & end date (as set in JIRA) will also define jobs time boundaries.
Traffika will load all issues from the selected sprint. Than you just select which issues you want to sync and hit the SYNC button below.
Be aware of that you can sync only issues with defined assignee and estimate. Also issues’ assignees must be bound to Traffika people otherwise you won’t be able to sync those issues.
You can find yourself in situation when previously synced issue has changed.
There can be two reasons for that:
- issue’s estimate or assignee has changed
- job’s estimate or assignee has changed (job(s) which was created from syncing the issue before)
In both cases you can update already existing job(s) by syncing the issue again. In case of fail of such sync (e.g. new estimate is greater than person’s free time) you don’t have to worry – every sync operation is atomic, ie. when sync fail nothing in Traffika will be changed.
UNSYNC operation works exactly as you would expect – it removes all jobs that have been created from selected issues’ sync.
We hope this tutorial gave you all the necessary information on how to setup connection between JIRA and Traffika.
Should you have any questions or feedback contact us at firstname.lastname@example.org – we’re looking forward to hearing from you.