Managing Project Associations

Collaboration links are not created at application level but at project level instead, this means registering a friend application is not enough to start creating outgoing collaboration links, you still need map a Jira project to one or more Remote OSLC Application projects with a given association type.

The association type defines how two projects are meant to collaborate and therefore, which types of links can be created between their artifacts. This plugin defines the following associations and corresponding link types for collaboration links creation:

Association Type Outgoing Link Type (Remote) Incoming Link Type
Provides - Related Change Requests Related Change Request Related Change Request
Provides - Implementation Requests Implements Requirement Implemented By Requirement
Affects Requirement Affected By Requirement
Provides - Requirements Change Requests Tracks Requirement Tracked By Requirement
Provides - Change Requests Elaborated By Architecture Element Elaborates

The prerequisites to start managing project associations are:

Registering an Association.

  1. Click on the Add Association button.
  2. Select the Remote OSLC Application (e.g. SECollab) in the Friend Application combo.
  3. In the Association Type combo, and by looking at the above table, select the association type depending on the outgoing link types required.
  4. As soon as you select the association type, a pop-up window will appear [1]. If you hadn't previously started a Remote OSLC Application session in the same browser, the new window will show you the Remote OSLC Application login page and you must continue with this step, otherwise please go to the next one [2]. Login page is here to complete the user authentication process, please provide a valid user credentials, it is not necessary that such user has an admin role [2].
  5. What happens after the user authentication process (or if you had already started a session in other browser's tab) depends on whether you configured the Jira consumer on the Remote OSLC Application as trusted or not. If you configured it as trusted, the only thing you need to do is to ignore a blank page that will be displayed for some 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 Jira accessing the Remote OSLC Application information on behalf the user you used to login [3]. Click the Allow button and then close the pop-up window when indicated if it is not closed automatically.
  6. Back on the Add Association dialog, a new Project field will display the available projects for the logged-in user. Choose the project to which you want to create the association and click the Add Association button.

If everything went ok, the Add Association dialog will be closed and the new association will be displayed in the Project Associations page. You can repeat all these steps to add more association types over the same or other Remote OSLC Application projects; remember that this time, steps 4 and 5 won't be necessary as authentication and authorization is required only once per session.

Congratulations, you have completed all configurations required to allow Jira regular users to create Collaborations Links to the Remote OSLC Application artifacts. Please refer to the user guide for a detailed description of such procedure.

Removing an Association.

  1. In the Project Associations page, locate the association you want to remove and click on the trash icon at the Actions column.
  2. Confirm your decision by clicking on the OK button in the opened Confirm delete dialog.

If everything went ok, the chosen association will be removed from the system and it will no longer appear on the table.