2.4 Creating Links

Once a connection to the Git repository has successfully been established you will see a view listing the items from the Git repository. You can switch between viewing issues, merge/pull requests, and commits. Select an item by clicking on it. This will bring up the item's details in the view on the right of the list of items. The details view contains additional information about the selected item and also a link to the item in Git. Clicking the link will open it in a new tab.

Once you have found an item that you would like to link to the current work item, you can click the blue link icon on the left. The item isn't immediately linked but rather added to a list of items that will be linked when you press save. This allows you to create links to multiple items at once without closing the widget. It also enables you to remove an item from the list of items to link if you accidentally added it or no longer want to link to it. To remove an item simply click the orange trash icon.

If necessary you can add links to multiple issues, merge/pull requests, and commits all at once. To save the links you can either use the Save or Save and Close button. As implied by the naming, the Save button will only save the changes without closing the widget. This can be useful if you want to continue working with the widget after saving (perhaps with a different Git repository). To close the widget without saving the changes just click Cancel.

When viewing the list of items you may see some items grayed out with a gray check icon on the left side instead of the blue link icon. These items have already been linked to the current work item and are disabled to prevent duplicate links from being created.

Note: If you are having a hard time finding the item that you would like to link to, please double check that you have selected the correct Git repository and also check out the Advanced Features page for detailed instructions on finding specific items.