This documentation relates to an earlier version of Application Links.
View this page in the current documentation or visit the current documentation home.

Skip to end of metadata
Go to start of metadata
Let's assume that you are managing a project or team. You would like to connect your project's Confluence space with your JIRA project, and link up your team's source repository too.

When you have connected your applications via Application Links, you can also connect the areas of those applications that contain information relating to your project or team. Using project links (also called entity links) you can associate one or more projects, spaces and repositories across the linked applications.

To connect all the information relating to the project or team that you are managing, you can link one or more of the following:

  • JIRA projects.
  • Confluence spaces.
  • FishEye repositories.
  • FishEye projects. A FishEye 'project' is the Crucible project if you have installed FishEye and Crucible, otherwise it is the paths associated via the 'FishEye Project Content' function in FishEye.
  • Crucible projects.
  • Bamboo projects.

    Icon

    Note, we do not recommend the use of project links with FishEye 2.9 and later, if you have JIRA 5.0 or later as well as the latest version of the JIRA FishEye Plugin. This is because application links now provide all of the functionality previously available with project links. However, project links are retained in FishEye and Crucible for the following reasons:

    • Setting up project links provides a way to restrict the scope of JIRA searches, which can provide performance benefits.
    • Legacy configurations can continue to use project links without any need for changes.
    • Third-party plugins may continue to rely on project links for their functionality.

On this page:

To add a project link:

  1. Log in to your application as an administrator and navigate to the administration page for the project:
  2. Choose the project in your local application that you want to link from. For example, you may want to link a FishEye repository to another type of project.
  3. The instructions for adding a project link will vary depending on whether the target application has Application Links:
    • If the target application has Application Links:
      1. Click 'Add Link'. A dropdown menu will appear listing the applications you have already linked to.
      2. In the dropdown menu, click the application that contains the project you want to link to. For example, if you want to link to a specific JIRA project, click the JIRA site that contains that project. If you want to link to a Confluence space, click the Confluence site that contains that space.
      3. Click one of the options on the 'Authorization required' screen:
        • 'Authorize' — Click this option if you want to grant your project authorised access to the target project. The target application will open in a new window, so that you can log in and authorise access.
        • 'Skip – your access is anonymous' — Click this option if you only want to allow anonymous access to the target project.
      4. In the 'Name or Key' field, enter the name/key of the project in the remote application that you want to link to. For example, if you want to link to a JIRA project, enter the project key. If you want to link to a Confluence space, enter the space key.
      5. Click the 'Create' button to create the project link.
    • If the target application does not have Application Links:
      1. Click 'Add Link'. A dropdown menu will display listing the applications you have already linked to.
      2. In the dropdown menu, click the application that contains the project you want to link to. For example, if you want to link to a specific JIRA project, click the JIRA site that contains that project. If you want to link to a Confluence space, click the Confluence site that contains that space.
      3. In the 'Key' field, enter the name/key of the project in the remote application that you want to link to. For example, if you want to link to a JIRA project, enter the project key. If you want to link to a Confluence space, enter the space key.
      4. (optional) Enter the alias for the project in the 'Alias' field. This is the display name for the project in your administration console.
      5. Click the 'Create' button to create the project link.

Screenshots above: Linking to a JIRA project (where target JIRA server includes Application Links)

Making an Entity Link the Primary Link
Delete an Entity Link

  • No labels