Integration with your YouTrack Projects

To add your YouTrack 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. “YouTrack” or “My YouTrack”) and select “YouTrack” from the target system selector.

Afterwards you can fill the YouTrack URL field.

To fill the Permanent token field, you have to create a permanent token in YouTrack. For this, go to Profile > Account Security tab > Tokens.

Click on “New token” and give your token any name, e.g. “Whid”, set the scope to YouTrack and click on Create.

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 YouTrack.

In YouTrack you can sync your booked times to Issues. To make your sync even easier, you can set up automatic mappings between your tracked tasks and YouTrack issues.

As a first step, you have to look up your project ID in YouTrack. For this, open your project in your YouTrack 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 YouTrack 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 YouTrack issue IDs.

We recommend using the “task hierarchy” feature: you can create a task name that contains the YouTrack 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 YouTrack? 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 YouTrack 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 YouTrack issue IDs in your recorded entries, it will automatically fill the corresponding issue ID as sync ID, and set your YouTrack 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.