Using Connector on OSLC Remote Application

This guide section is aimed for OSLC Remote Application users; it assumes the reader is familiar with general use of the application.

Creating Links

The process to create Collaboration Links can vary from one OSLC Remote Application to another; however, differences are only on how to start such process because once you reach the selection or creation dialog, the behavior within these dialogs is the same. Here is the process to start the selection/creation dialog:

  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]. The login page is here to complete the user authentication process, please provide 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 OSLC Remote 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 the 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 OSLC Remote Application accessing Jira information on behalf of 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 options to select between [7]:

Removing Links

Once the Collaboration Link is created, the process to remove it is the same as for other kind of links:

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

If everything went as planned, the dialog will be closed, the link will be removed from the 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 OSLC Connect for Jira, or any other issue before continuing. At this point, the safest is to cancel the process and wait for a resolution.

Viewing Links

Each OSLC Remote Application provides a mean to display the linked artifacts and to show the rich preview of the linked artifact when the mouse hovers it, a request which OSLC Connect for Jira fulfills.

[1] Available link types will depend on the artifact selected for creating the link and the project associations defined by an administrator. [2] If you cannot find the Jira project you expected, please contact your server administrator to check whether the selected link type corresponds to the association created to that missing project. [3] Depending on the OSLC Remote Application, the following authentication process may be launched before, for example when you get into the links section. [4] It may be the case that your browser prevented the opening of the pop-up window, some browsers notify this with a message in a top bar, others are more discrete and just show a little red icon at the end of the addresses bar; in any case, all of them allow you to authorize pop-up windows, typically by clicking on the area where they decided to show you the blocking notification and choosing the option to allow pop-up windows. Please follow the corresponding procedure of your browser to allow them and then continue. [5] The project access rights will depend directly on the privileges of the logged Jira user. [6] This confirmation will be asked, only the first time a collaboration is needed for untrusted consumers, in each OSLC Remote Application session. [7] As long as the license for OSLC Connect for Jira is still valid, otherwise you may see an error message that may vary from one OSLC Remote Application to another. If this is the case, please contact the Jira server administrator in order to check the license validity or any other issue.