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.
- Login in Jira Cloud and create a personal API token here: https://id.atlassian.com/manage-profile/security/api-tokens .
- 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
- Export time entries as csv file from toggl (use "Detailed Report") to
resources/csv/time-entries.csv
.
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,,
-
Set
toggl-to-jira.settings.active: false
inapplication.yml
- So you can start a "dry run" first and test the output of your data without pushing them immediately to Jira. -
If everything is ok set
toggl-to-jira.settings.active: true
and start the application. It will automatically start aCommandLineRunner
and process the data. -
Check the worklogs in the Jira Cloud.
- "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?
This is open source software. Use on your own risk and for personal use. If you need support or consultancy just contact me.