Toggl Synchronization for Jira 2.5.0

Owned by Barbara Pintoflová (Unlicensed)
Last updated: 18. 09. 2018


What is new in Toggl Synchronization for Jira 2.5.0


New Features 

(lightbulb) Well first of all, we have changed the name of our app from TogglSync to Toggl Synchronizatin for Jira. It is now more likely to be found by those who seek for this solution.

(lightbulb) We are happy to announce that we have added a new background synchronization of work logs from Toggl to Jira. This new feature synchronizes work logs automatically based on a frequency each Jira user chooses. 

(lightbulb) This version brings easier work entries editing process to simplify the synchronization for you 


Bug Fixes

(tick) When synchronizing work logs with chosen option "Yesterday", our app will no longer show tasks with a running timer. 

(tick) When copying issue keys from Jira to TogglSync synchronization table, the white space that is copied along with the issue key will no longer create an error message and the synchronization will be successfull. 




How to configure Toggl Synchronization for Jira according to your preferences 

User Guide


 1. Sign up for Toggl


In case you have not used Toggl before, please follow these easy steps in order to sign up

  1. Sign up for free at Toggl website
  2. Either create a new Toggl account or use your Google account
  3. You are just few steps away from using TogglSync
 2. Connect your Toggl to Jira using Toggl Synchronization for Jira


  • Get your API token from Toggl app profile
  • Now you need to copy this token into the TogglSync configuration: you will find it at the bottom of your Jira User Profile page     

     

  • Scroll down your User Profile page till you see TogglSync Configuration part
  • Edit TogglSync Configuration by hitting a pen icon
  • Following window will pop up:


See the difference between the manual and automatic synchronization in Let's Synchronize! part of this manual.

 3. Work entry format in Toggl
  • When tracking time in Toggl, please make sure you include the Jira issue key into the work entry name.
  • The matching issue key can stand before the work entry name, behind it, in the middle or stand alone
  • Without a correct issue key, the worklog will not be synchronized into Jira issue. 

Here are some examples of correct work entry formats:

 4. Start / Stop timer from Jira Issue

You are now able to control Toggl time tracking directly from Jira issue simply either by using Start timer / Stop timer button




(lightbulb) New function in this version allows you to start Toggl timer by hitting "Enter" 


 5. Let's synchronize!

As stated in the Release notes, with version 2.5.0 you now have an option choose between manual and automatic synchronization of work logs. 



Manual Synchronization

At the end of a day, of a week, whenever you feel like, you can synchronize your Toggl work entries into Jira. Our last step includes these easy actions:


  • Check your Toggl entry and make sure there are correct Jira issue keys included 
  • Then go to your profile and choose TogglSync:



  • Please note all the fields above are editible including the worklog name, Jira issue or the duration. You can use different names in Toggl and Jira according to your preferences
  • You can check the entries when viewing a Work log tab in the Jira issue 



Automatic Synchronization

If you set to sychronize your work logs automatically in the second step Connect your Toggl to Jira using Toggl Synchronization for Jira, you will be no longer required to perform any steps in order to log your work in Jira issues.

  • Automatic Synchronization is turned on every day at 2 AM
  • If Jira is not running at this time, the synchronization will be executed after Jira is turned back on 
  • In case the synchronization fails for any reason, you will recieve a notification email
  • In the second step, you can set you would like to receive notification emails about successful synchronizations as well