Integration with Jira Cloud

To add your Jira Cloud profile, first you have to open the Settings > Profile tab in Whid. Then click on the “Add Profile” button, set a name for your profile (e.g. “Jira Cloud” or “My Jira”) and select “Jira Cloud” from the target system selector.

Afterwards you can fill the Jira URL and User Email fields.

To fill the API token field, you have to create an API token in Jira. For this, open your “Atlassian account settings” from your Jira Cloud, then navigate to the Security tab and click on “Create and manage API tokens”.

Click on “Create API token” and give your token any name, e.g. “Whid”.

Set the expiry date as far in the future as possible. When it expires you will have to renew it, and update it in Whid as well.

Now you can copy the created token to Whid and save your credentials.

Whid validates your credentials on Save. If you are not connected to the internet while saving, you can choose the “Save without validation” option, but Whid will always need access when you sync your tracked times to Jira Cloud.

In Jira Cloud you can sync your booked times to Issues. These synced times will appear as Work Logs. To make your sync even easier, you can set up automatic mappings between your tracked tasks and Jira Cloud issues.

As a first step, you have to look up your project ID in Jira Cloud. For this, open your project in your Jira Cloud instance.

The project ID appears as uppercase letters in your issue IDs. On the screenshot our project ID is set to WHID, while the full issue ID is WHID-1.

Now you can open the Settings > Sync Mappings tab in Whid.

Add a new entry in the “Auto Extraction for Sync Mappings” section: select your Jira Cloud profile from the dropdown, and set the “Regex Pattern” to the following format: {project ID}-\d+. In our case the pattern is set to WHID-\d+.

Save the changes.

To put the “Auto Extraction for Sync Mappings” to work, track your times with names that include their corresponding Jira issue IDs.

We recommend using the “task hierarchy” feature: you can create a task name that contains the Jira issue ID and a short description of the issue, while it also describes the actual lower-level task you are working on in the context of that issue.

For example, if you are a developer and you work on a bugfix, one of your task names could look like this: WHID-1 UI glitch / Reproduce bug.

Now you want to see all your tracked times in Jira? Then it’s time to sync them!

To open the sync overlay, first open the Main Window by right-clicking the tray icon and selecting “Main Window”. Then click the “Sync times” button in the upper right corner.

At the top, you can choose a time range for which you want to sync your entries.

If you use your Jira issue IDs as described above, you might not have to adjust anything. But if something isn’t quite right, you can make adjustments as needed.

For each task you can enter a sync ID and select the profile which includes the system you want to sync to. You can also leave those fields empty for entries you don’t want to sync.

If Whid successfully detected Jira Cloud issue IDs in your recorded entries, it will automatically fill the corresponding issue ID as sync ID, and set your Jira Cloud profile as Target.

After selecting which entries you would like to sync and filling the corresponding sync IDs, you can click on “Sync selected”. In this example we sync to the issue with the ID WHID-1 in the WHID project.

Whid then reports the result for each synced entry: a green checkmark means the sync was successful, while a red X indicates that something went wrong.