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.

IBM Engineering Requirements Management DOORS Family
In addition to regular link display in DOORS client, information on linked Jira issues can also be displayed in a column within a DOORS module:
  1. Edit the module in the DOORS client
  2. Click Insert > Column...
  3. Select DXL Layout and click Browse...
  4. In the Browse DXL dialog, click New
  5. In the Edit Layout DXL dialog, type following text and click OK:
    #include <layout/oslcCMColumn.dxl>
  6. Enter a title for the column and click Insert
  7. Click View > Save As... to save this modified view