Configuring Project Links across Applications

Adding a project link

In the following example, we'll create an two-way project link between a JIRA project (project key is 'MYPROJECT') and a FishEye repository (repository key is 'MYREPO'). We assume that you have already added an application link.

To link a FishEye project to a project in another application:

1. Go to the FishEye administration console and find the repository that you want to link from.
2. Click the icon and choose Application Links.
3. The instructions for adding a project link will vary depending on whether the target application has the Application Links functionality installed:
   
   • If the target application has Application Links:
     1. Click Add Link. Then, in the dropdown menu, click the application that contains the project you want to link to, such as a Jira Software site containing a project. or a Confluence site containing a space.
     2. Select either:
        • Authorize — to grant your project authorized access to the target project. You will be taken to the remote application, so that you can log in and authorize access.
        • Skip – your access is anonymous — to allow anonymous access to the target project.
     3. In the Name or Key field, enter the name/key of the project in the remote application, such as a Jira Software project key, or a Confluence space key.
     4. Click Create.
   • If the target application does not have Application Links:
     1. Click Add Link. Then, in the dropdown menu, click the application that contains the project you want to link to, such as a Jira Software site containing a project. or a Confluence site containing a space.
     2. In the Key field, enter the name/key of the project in the remote application, such as a Jira Software project key, or a Confluence space key.
     3. (optional) Enter a display name for the project in the Alias field.
     4. Click Create.

Deleting a project link

If you have set up multiple project links to the same application, for example you have linked a FishEye project to multiple JIRA projects, deleting the primary link will mean that another of the links will be made the primary link.

To delete a project link:

1. Go to the FishEye administration console and find the repository that you want to link from.
2. Click the icon and choose Application Links.
3. Click Delete next to the link that you want to delete.
4. Click Confirm to delete the link.

Making a project link the primary link

If you have set up project links to more than one project in the same application, for example you have linked your FishEye project to two JIRA projects, then one of the project links will be marked as the primary link. All outgoing requests will be directed to the primary link.

For example, if you have a FishEye project that is linked to two JIRA projects, you can nominate the link to one of the JIRA projects as the primary link. Every time FishEye requests JIRA information, it will request it from the primary link's JIRA project. Both JIRA projects can still request information from the FishEye project.

To make a project link the primary link:

1. Go to the FishEye administration console and find the repository that you want to link from.
2. Click the icon and choose Application Links.
3. Click the 'Make Primary' link in the 'Action' column for the project link that you want to make the primary link. A symbol will display in the 'Primary' column next to the link.
   Note: The 'Primary' column and 'Make Primary' link will appear only if you have set up multiple project links to the same application, for example you have linked a Confluence space to a number of JIRA projects.