If your current review template allows, the Remote System Links section is displayed. The section lists all pull requests, direct pushes and issue-tracking items linked with this review:
Click the image to enlarge it.
Click the image to enlarge it.
Click the image to enlarge it.
The list automatically populates with the following items:
-
Links to the remote repository for reviews created on pull requests and direct pushes to remote repositories, if any of repository hosting integrations is established and running.
-
Links to issue-tracking item identifiers that occur anywhere within the review (title, custom fields, comments and so on), if any of issue-tracking integrations is established and running.
The Remote System Links section also displays current statuses of linked items. Item statuses are updated upon webhook events (if a remote system supports webhooks), or periodically (default interval is every 2 minutes and can be adjusted via VM option). Also, participants may refresh item status manually by clicking the Refresh button in the Action column.
Besides that, participants may remove linked items or append links to issue-tracking items. Links from remote hosting systems are only added automatically and cannot be appended manually.
Work With Remote System Links
Web Client
By default, the section is displayed in the read-only mode. To add or remove links, click Edit.
To append a link to an issue-tracking item, do the following:
-
Type the item identifier (in JIRA it typically consists of a project key and an ordinal number, e.g. COLLAB-2838) into the Reference field.
-
Select the desired issue-tracking configuration in the Remote System combo box.
-
Click Add.
To refresh a link from the issue-tracking server, click the Manually Refresh Status icon (
) in the Action column.
To remove a link, click the Remove from Review icon (
) in the Remove column.
Visual Studio Extension
To append link to an issue-tracking item, do the following:
-
Click the Add remote system link button.
-
Type the item identifier (in JIRA it typically consists of a project key and an ordinal number, e.g. COLLAB-2838) into the Reference field.
-
Select the desired issue-tracking configuration in the Remote System combo box.
-
Click OK.
To refresh a link from the issue-tracking server, click the Refresh icon (
) in the Action column.
To remove a link, click the Remove icon (
).
Eclipse Plug-in
Because of a limitation of the SWT control, the Remote System Link table cannot have multi-line cells. When multiple items are linked (for example, multiple commits), the table displays only the first item. The full list of linked items will be displayed in the cell's tooltip and in the Overall Chat section.
To append link to an issue-tracking item, do the following:
-
Type the item identifier (in JIRA it typically consists of a project key and an ordinal number, e.g. COLLAB-2838) into the Reference field.
-
Select the desired issue-tracking configuration in the Remote System combo box.
-
Click Add Remote System.
To refresh a link from the issue-tracking server, click the Refresh icon (
) in the Action column.
To remove a link, click the Remove icon (
) in the Remove column.
See Also
Review Screen
Source Control Integrations
Issue-Tracking Integrations