Configuring Issue Linking

Often in the users' daily work, they create the same Collaboration Link type over and over for the same Issue Type; for example, an Affects Requirement link is very likely to be created from a Bug issue type, or an Implements Requirement link is very likely to be created from a Feature issue type. By using this configuration, you can define a default Collaboration Link type per Issue Type (on an Issue Type scheme), so the next time users start the creation of a Collaboration Link, the chosen type will be preselected depending on the user's working issue type.

Be aware that setting this configuration overrides the default behavior of preselecting the last Collaboration Link type created; once set, the default link type chosen will be preselected always for the configured Issue Type, no matter what was the last Collaboration Link type created. This overriding feature applies obviously only for the configured Issue Types, if one user starts creating a Collaboration Link for an Issue type that is not mapped, the last Collaboration Link type created will be preselected.

Finally, you must know that having defined a default Collaboration Link type does not prevent users from changing it once it is preselected. There is another configuration to restrict the Collaboration Link types available for an Issue Type, so that, in your context, users can't create meaningless links with unexpected remote artifact types.

It is worth saying that both configurations above work in the boundaries of a given Issue Type Scheme. This means that whatever default or available link types are chosen for a given issue type, such configuration apply for all Jira projects sharing the same Issue Type Scheme. This is really important to have in mind, especially when it is considered that the available Collaboration Links types, for a project, depend primarily on the remote project associations defined at the project-level configuration. In other words, the following server-level configurations will apply as long as the scoped project has, indeed, the associations providing the chosen default or available link types; otherwise (and for that project only), the connector will not preselect a link type (in the case of a missing Default Collaboration Link type) or it will just ignore the selected available link types, if they are missing by the project associations.

Setting Default Collaboration Link Type.

  1. Enter to the JIRA ADMINISTRATION > Manage apps page.
  2. On the left panel, click on the Link Type Mapping option in the OSLC Connect section.
  3. Select the scheme for which you want to define a default Collaboration Link type in the Scheme combo.
  4. A table with three columns will be rendered. In the first column are the Issue Types of the scheme and in the middle column, you can customize or restore the default Collaboration Link type. To customize a link type, click on the Customize link to enable the combo next to it and you can choose an available Collaboration Link type [1].
  5. Repeat last step for other issue types until you have defined all required mappings.
  6. Click on the Save button located at the top right corner of the page.

To restore (remove) a default Collaboration Link type:

  1. Locate the Issue Type whose default Collaboration Link type you want to restore.
  2. Click on the Restore button located in the second column.
  3. Click on the Save button located at the top right corner of the page.

Editing the available Collaboration Link types.

  1. Enter to the JIRA ADMINISTRATION > Manage apps page.
  2. On the left panel, click on the Link Type Mapping option in the OSLC Connect section.
  3. Select the scheme for which you want to define a default Collaboration Link type in the Scheme combo.
  4. A table with three columns will be rendered. In the first column are the Issue Types of the scheme and in the last column, you can edit the available Collaboration Link types for those issue types. By default, all Collaboration Link types are available for all Issue Types and the legend Any link type of project associations is displayed in the corresponding column. To edit the available link types, click on the Edit link to display a pop-up window with all Collaboration Link types.
  5. In the opened window, all Collaboration Link types are grouped per OSLC domain and you can select or unselect them to be available, or not, respectively [2].
  6. Click on OK when your selection is complete [3].
  7. Repeat last three steps for other issue types until you have defined all required selections.
  8. Click on the Save button located at the top right corner of the page.

For the record, when at least one Collaboration Link type is disabled for an Issue Type, the corresponding Any link type of project associations legend is changed; a list of all OSLC domains having at least one Collaboration Link type selected will be displayed instead. Next to the OSLC domain name, the actual number of selected link types will be displayed over the total number of link types in the domain. In the extreme rare case of selecting none link type, the legend None will be displayed instead.