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: [email protected]
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,[email protected],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

About

Convert toggl time tracks to Jira worklogs

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published