Once you have installed Application Links, you will need to configure the linked applications using the administration screens of each relevant application (JIRA, Confluence, etc).

On this page:

Link to Subversion Not Required

There is no need to link AppLinks to a Subversion repository unless you have a specific requirement to do so.

The integration with Subversion provides a way for plugins to know what SVN repository a project is associated with. For example, Atlassian uses AppLinks primarily in JIRA Studio, where this feature allows JIRA Studio to create, update and delete repositories. However, there are currently no publicly-available plugins that make use of this functionality.

This means that, unless you are writing a new plugin to use the Subversion linking, you will not find it useful to add Subversion to your AppLinks suite. It will not provide any extra rendering of links in JIRA or Confluence. To render links of the form source:<Filename>, you will need FishEye.

Configuring your Applications for Application Links

Below is a summary of the steps you need to take, to configure Application Links across your applications. These steps will get your Application Links up and running. For more detail and more complex setups, you will find links to further guides at the bottom of the page.

Step 1: Set the Base URL in Each Application

Make sure that the base URL is set correctly in each application which you intend to link. This is required for synchronisation to work correctly.

1. Set the base URL in Confluence: If you run into problems, please refer to the Confluence Administration Guide.
   
   
2. Set the base URL in FishEye and Crucible:
   1. In FishEye, click 'Server Settings' on the 'Admin' menu.
   2. Set the 'Site URL' to the base URL for your FishEye and Crucible instance.
      If you run into problems, please refer to the FishEye Administration Guide.
      
      
3. Set the base URL in JIRA:
   1. In JIRA, go to the 'Administration' menu.
   2. Select 'General Configuration' under 'Global Settings'.
   3. Click 'Edit Configuration'.
   4. Set the 'Base URL' to the base URL for your JIRA instance.
   5. Click 'Update' to save your changes.
      If you run into problems, please refer to the JIRA Administration Guide.

Step 2. Enable the Wiki Renderer in JIRA

You will need to do this if you are intending to use Application Links with JIRA. If JIRA's Wiki Renderer is not enabled, JIRA link rendering will not work.

In JIRA, go to JIRA field configuration and enable the Wiki Renderer for the 'Description' field and other relevant fields, as described below.

1. In JIRA, go to the 'Administration' menu.
2. Select 'Field Configurations' under 'Issue Fields'.
3. Select 'Configure' next to 'Default Field Configuration'.
   (If you have added your own field configuration schemes, you should enable Wiki Renderer for those too, where relevant.)
4. Find the 'Description' field in the list of fields, and click 'Renderers' next to it. The 'Edit Field Renderer' screen will appear, as shown in the screenshot below:
   
   
   
5. Select 'Wiki Style Renderer' and click 'Update'.
6. Confirm your selection as prompted.
7. Now perform the same steps to enable the Wiki Renderer for the 'Comment' and 'Environment' fields, and any custom fields as required.

If you run into problems, refer to the JIRA documentation for detailed instructions.

Step 3. Add an Application to your Application Links Suite

Now you will add each of your applications into the Application Links suite. The suite is the set of applications that you want to take part in the cross-application linking.

You can add applications via either Confluence or JIRA.

• In our example below, we have used the JIRA Administration screens to add Confluence to the Application Links suite.
• If you are using Confluence but not JIRA, you can perform similar steps using the Confluence Administration console. See Adding your Applications via Confluence Administration.

Step 4. Add more Applications or Application Instances

Follow the steps above, to add any of the other supported applications into your Application Links suite.

If you have two or more instances of a particular application, you can add them individually. For example, if you have two Confluence sites, you can add them both.

• Add each application instance, following the steps described above.
• If you wish to change the primary instance, select the primary instance as described in Specifying a Primary Application Instance.

If you need more information about adding multiple applications, refer to More about Adding Applications.

Step 5. Synchronise your Applications

If you need more information about synchronisation, refer to Synchronising Application Instances.

Step 6. Add your Project Links

You can add your project links via either Confluence or JIRA.

• In our example below, we have used the JIRA project administration screens to add project links to a Confluence space.
• If you are using Confluence but not JIRA, you can perform similar steps using the Confluence space administration screens. See Adding and Synchronising Project Links via Confluence.

Step 7. Synchronise your Project Links

You can synchronise your project links via either Confluence or JIRA. We have used JIRA in our example below. You can perform similar steps using the Confluence space administration screens. See Adding and Synchronising Project Links via Confluence.

RELATED TOPICS

Application Links Installation Guide
Application Links Documentation Home
Atlassian Product Integration