Adding an Entity Link

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.

On this page:

Adding a Project Link (Also Called an Entity Link)

Adding a Project Link (Also Called an Entity Link)

To add a project link:

Log in to your application as an administrator and navigate to the administration page for the project:
- JIRA project administration
- Confluence wiki administration
- FishEye repository administration
- FishEye/Crucible project administration
- Bamboo-to-JIRA project links – configured via JIRA project administration
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.
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.