Exports time entries from the Harvest timelogging tool to Jira as worklog items.

I recommend using volta to manage node versions when using this tool.

Install node dependencies with the following command:

npm i

Run the tool with:

npm start

• week: input is taken as a date; the tool will then calculate the Sunday-to-Sunday window within which the chosen date falls. This is the date range it'll use for exporting time entries
• dry run: when run in "dry" mode, the tool will log Jira worklog items to the console instead of sending them to the Jira API
• path to config file: path to your configuration file

Create a configuration file within config/projects.json (default path that the app will expect, but you can change it to a different one).

The following user information is needed:

• Harvest user ID: This can be found in the URL on your Harvest profile page
• Harvest access token: Obtained through https://id.getharvest.com/developers
• Harvest account ID: Also https://id.getharvest.com/developers

For each entry in projects:

• Harvest ID: project IDs can be found in the "reports" tab in Harvest
• Jira project key: Based on the Jira issue key the project has assigned. The code before the id number. Example: CG-1234. In this case, it would be "CG"
• Atlassian domain: the subdomain from the url you use to access Jira
• Atlassian API token: From https://id.atlassian.com/manage-profile/security/api-tokens
• Atlassian Account Email: The email you use for Jira

{
  "user": {
    "harvestUserId": 1111111,
    "harvestAccessToken": "xxxxxxx.xx.xxxxxxxxx",
    "harvestAccountId": 222222
  },
  "projects": [
    {
      "harvestId": 33333333,
      "jiraProjectKey": "PFMLPB",
      "atlassianDomain": "lwd",
      "atlassianApiToken": "zzzzzzzzzzzzzzzzzzzzzzzz",
      "atlassianAccountEmail":"[email protected]"
    },
    {
      "harvestId": 44444444,
      "jiraProjectKey": "RI",
      "atlassianDomain": "postc-massgov",
      "atlassianApiToken": "yyyyyyyyyyyyyyyyyyyyyyyy",
      "atlassianAccountEmail":"[email protected]"
    }
  ]
}

Please don't hesitate to reach out! I wrote this tool for personal use when I was feeling particularly lazy (the time spent on it so far probably won't pay off), so it's a bit rough around the edges.