Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 3.25 KB

README.md

File metadata and controls

59 lines (41 loc) · 3.25 KB
Raw

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