Managing Collaboration Links from the Remote OSLC Application

The process to create Collaboration Links vary from one Remote OSLC Application to another; however, differences are only on how to start such process, once you reach the selection or creation dialog, the behavior within these dialogs is the same. This topic assumes you are already familiar in how to start or open these dialogs and therefore, it only makes a general description of the starting process before continuing with a detailed description of the process that is equal among them. The general starting process is:

  1. Select the artifact you want to link.
  2. Look up for the links section and select the option to add a new one.
  3. On the adding dialog or page, select one of the available link types [1]
  4. In the target project field, look up and select the associated Jira project[2].
  5. As soon as you select the project[3], a pop-up window will appear [4]. If you hadn't previously started a Jira session in the same browser, the new window will show you the Jira login page and you must continue with this step, otherwise please go to the next one [5]. Login page is here to complete the user authentication process, please provide a valid user credentials [5].
  6. What happens after the user authentication process (or if you had already started a session in other browser's tab) depends on whether the Remote OSLC Application consumer was configured in Jira as trusted or not. If it is configured as trusted, the only thing you need to do is to ignore a blank page that will be displayed for a few milliseconds, and then you can go to the next step; otherwise, you will see the Authorize Application page which is a last confirmation to allow the Remote OSLC Application accessing Jira information on behalf the user you used to login [6]. Click the Allow button and then close the pop-up window when indicated if it is not closed automatically.
  7. Back on the adding dialog or page, you must have the option to select between create the link over an existing Jira issue or over a new one[7].

Creating a link to an existing Jira Issue.

Continuing with the steps defined on the parent topic...

  1. Select the option to create the link over an existing artifact and leave the default value Issue on the combo next to it.
  2. A maximum of 50 issues, sorted by priority from highest to lowest, will be displayed [1]. Click on the issue you need to select. If the issue you need is not within the first 50 matching issues, you can always search it by typing its summary in the Filter issues with summary field and pressing the Search button, this technique can be used for a rapid identification of the issue too, especially if you combine it with the two Filter combos behind; they can be used also independently and by default, they are set to display all issues. The first combo can be set to:
    The last two options will modify the sorting order to be descending based on the creation or modification date respectively. Used by its own, this combo will apply above criteria to all issue types, if you want to apply them to a specific issue type, use the second combo which values are:
  3.  
  4. To confirm your selection, click on the Select button at the bottom of the page.

If everything went ok, the dialog will be closed and you will see the new link created on the links section.

Creating a link to a new Jira Issue.

Continuing with the steps defined on the parent topic...

  1. Select the option to create the link over a new artifact and leave the default value Issue on the combo next to it.
  2. Fill out the form with the issue data [1], only Summary and Issue Type fields are required.
  3. Click on the Create button to create the new issue and then the new link to it.

If everything went ok, the dialog will be closed and you will see the new link created on the links section.


That's it, you have created a collaboration link to both: an existing and to a just-created issue. In both cases, a backlink is also created in the Jira issue, if your administrator applied the default configuration for this plugin, you should find the Collaboration Links field below the Labels field. If you cannot see the backlink in Jira, please contact your administrator.

The next time you start a Remote OSLC Application session and get to a page where collaboration links exist, you will be prompted to authenticate yourself and authorize the Jira collaboration (in the same way you did in steps 5 and 6 of the Creating Collaboration Links procedure) before you can start seeing detailed information of the link.

Removing Collaboration Links

To remove a collaboration link to a Jira issue:

  1. In links section, approach the mouse over the link to remove; the Remote OSLC Application must provide a way to remove the link, it could be a delete icon or a contextual menu with such option.
  2. Click or select the option provided by the Remote OSLC Application to remove the link.
  3. If a confirmation dialog is displayed, confirm your decision to remove such link.

If everything went ok, the dialog will be closed, the link will be removed from system and it will no longer appear in the links section. If, on the other hand, you see any kind of error message, please contact your administrator in order to check the license validity of the OSLC Connect for Jira plugin, or any other issue before continue. At this point, the safest is to cancel the process and wait for a resolution.

Updating Collaboration Links

  1. Remove the link.
  2. Create it again.