This package is designed to sync time tracking data from Toggl over to JIRA. For example, if there is a Toggl time entry called "ABC-1: working on ticket", the time spent will be added to a the ticket in JIRA called "ABC-1".

This makes it easier to view the total time spent on tickets, which is helpful for future work estimation.

This package has an entry point called run-toggl-jira-sync which does the following:

1. Download the last 5 days worth of Toggl data
2. Parse the ticket numbers from the Toggl data
3. Loop through each ticket and:
   1. Download full history of Toggl data for ticket
   2. Download JIRA worklogs for ticket
   3. Add/update worklogs in JIRA to sync with the total time tracked in Toggl

The following variables must defined:

Username for accessing JIRA. This should be a non-human account.

Password for accessing JIRA.

URL of JIRA (e.g. https://jira.foo.org)

Username for accessing Toggl. This user should be an admin or have the ability to read Toggl entries for the entire organization.

API key of the Toggl user.

Workspace ID in Toggl. See the Toggl API docs for how to determine this value.

Which Toggl users should be included when posting to JIRA?

Which Toggl users should be excluded when posting to JIRA? All users must exist in either JTS_EXCLUDE_USERS or JTS_INCLUDE_USERS.

This string will be appended to the beginning of the comment in JIRA worklogs that originate from this package. This makes it easier for users to understand where the Worklogs are coming from.