A collaboration link is a link between two elements that belong to different applications. Typically, when a collaboration link is created from one Application A to one Application B, a backlink is created (automatically) from Application B to Application A, so both elements may have a way to navigate to each other. In this scenario, where a link can exist either because it was created on its own, or because it was created as the backlink of other link, it is often useful to distinguish their nature with a role name:
Henceforth, when a collaboration link in Jira is said to be an outgoing link, it means it is a link whose creation was triggered from Jira (creating a backlink on the Remote OSLC Application), whereas if it is an incoming link it means it is a link that was created as backlink on Jira (due to a creation triggered from the Remote OSLC Application).
To create a collaboration link, no matter its nature, it is necessary to create a custom field on Jira that allows to save them. OSLC Connect for Jira comes already with this special field, you only need to enable it and configure it as described below:
Administrationmenu (just above the
ATLASSIAN MARKETPLACEsection) click on the
Custom fieldsoption on the left panel under the
Add custom fieldbutton, at the
Custom fieldspage, in the center panel.
Advancedoption in the left panel.
Collaboration Linksfield in the right panel, probably it will be the first option.
Collaboration Linksfield row and click the
Createbutton to create the field and close the dialog.
Associate field Collaboration Links to screenspage, you need to select the
Default Screenand, for each Jira Project you want to use this field, the screen where the Jira issue is viewed or edited . Selection is done by clicking on the checkbox located in the
Custom fieldspage, you should see the
Collaboration Linksfield at the top of the table, click on the gear icon located on the last column.
Default Configuration Scheme for Collaboration Linkssection, click on the
Edit Default valuelink.
Default valuefield at the top of it, type in there an open curly brace followed with the close curly brace (no spaces):