Skip to content

Convert toggl time tracks to Jira worklogs

License

Notifications You must be signed in to change notification settings

codeministry/toogle-to-jira

Repository files navigation

pipeline status latest version commits licence awesomeness

Toggl to Jira Cloud

Import your toggl time tracks to as worklogs into Jira Cloud

Add time entry

As a freelancer, I like to use toggl to track my hours. Many of the projects I am involved in use Jira as project software. Therefore,
I was looking for a simple way to transfer my hours quickly and easily as a worklog to Jira. I use the generated Jira key (e.g. SLY-242),
which every task and story has, as a unique identification key in the description of the toggl entry.

Add time entry

How to import your time trackings?

  1. Login in Jira Cloud and create a personal API token here: https://id.atlassian.com/manage-profile/security/api-tokens .

Create API token

  1. Change config in application.yml fitting you project and customers settings:
url: https://your-project.atlassian.net
user-email: you@your-company.com
api-token: some-cryptic-api-token
  1. Export time entries as csv file from toggl (use "Detailed Report") to resources/csv/time-entries.csv.

Export time entries

Example data:

User,Email,Client,Project,Task,Description,Billable,Start date,Start time,End date,End time,Duration,Tags,Amount ()
Max,max@musterman.com,the client,your project,,STC-198 The task description,No,2021-04-07,09:25:02,2021-04-07,10:00:07,00:35:05,,
  1. Set toggl-to-jira.settings.active: false in application.yml - So you can start a "dry run" first and test the output of your data without pushing them immediately to Jira.

  2. If everything is ok set toggl-to-jira.settings.active: true and start the application. It will automatically start a CommandLineRunner and process the data.

  3. Check the worklogs in the Jira Cloud.

ToDos:

  • "dockerize" app, incl. external file handling
  • add tests oO
  • more configuration to fit: e.g. CSV format, Jira settings, etc.
  • more documentations & README
  • maybe use toggl tags?
  • add more project platforms?

OpenSource

This is open source software. Use on your own risk and for personal use. If you need support or consultancy just contact me.

codeministry