Adding and Synchronising Project Links via JIRA

Project links allow you to associate a particular Confluence space with a particular JIRA project, or a particular Crucible project with a JIRA project, etc.

If you have more than one instance of the same application (for example, you may have two Confluence sites), you can link a project to the primary application instance or any other instance. (If you are not sure what a primary instance is, please refer to Specifying a Primary Application Instance.)

1. In JIRA, log in as a project administrator.
2. Go to the 'Administer Project' page for the relevant project. See the example in the screenshot below:
   
   
   
3. Click the 'Select' link next to the 'Confluence Space', 'Subversion Repository', 'FishEye Repository' or 'Crucible Review' item. The 'Associate' screen appears. Below we show two examples of this screen, one for Confluence and one for FishEye:
   • The 'Associate' screen for Confluence:
     
     
     
     1. Select an application instance from the 'Instance' dropdown menu, or select '-- Default Instance --'.
     2. In the next field you will enter a space or project key as prompted, depending upon the type of application selected above. This will associate the current JIRA project with a particular space or project in the other application. For example, in the screenshot above we are linking the Confluence 'DOCS' space to our JIRA project.
     3. Click 'Associate'.
   • The 'Associate' screen for FishEye:
     
     
     
     1. Select a FishEye instance from the 'Instance' dropdown menu, or select '-- Default Instance --'.
     2. In the next field you will enter a 'FishEye repository key'. This value must match the 'Name' as defined in your 'Repository List' in FishEye. For example, in the screenshot above we have linked the FishEye 'ProductRepository' and 'LibrariesRepository' to our JIRA project.
        You can link more than one repository from the same FishEye instance, as shown on the screenshot above.
        AppLinks does not validate the repository name entered here. It is up to you to ensure that the repository key entered in AppLinks is the same as the repository name entered in FishEye.
     3. Click 'Associate'.
        
        
4. The new project link appears on the 'Administer Project' page, as shown in the screenshot below:
   

You can add a project link to your Application Links suite via the JIRA or the Confluence administration screens. The project link will then appear in the list on the administration screen where you added it.

Now you need to synchronise with the other applications in the Application Links suite. This will let the other applications know that the project link has been added. For example, if you added a project link from a JIRA project to a Confluence space via the JIRA administration screens, you should synchronise so that the Confluence space knows it is linked to the JIRA project.

1. Once you have created a project link in JIRA, the link appears on the 'Administer Project' page, as shown in the screenshot below:
   
   
   
2. Click the 'Synchronize' link to create a matching link on the remote instance.

Due to a current limitation, the instance that you are synchronising from must be called 'jira' if you are synchronising from JIRA, or 'confluence' if you are synchronising from confluence. See APL-2.