Overview

Linking issues with catalog entries is a great chance to enrich issue with some more or less static information. The Catalog app provides the Catalog Select (single) custom field to select a catalog entry in an issue (read below), and the Linked Issues attribute to browse the linked issues directly in the entry. You can use them independently in different combinations to meet your needs.

Catalog Select (single) – Setting Up

Read how it works in an issue.

Add a custom field and put it to the relevant screens. Check how to Add a custom field (Atlassian Documentation)

Configure the custom field.

Field configuration includes selecting the source catalog directory from the full list of available directories. Selecting a directory means the entries' titles will be used as the field options.

All new-created entries from the selected directory will be automatically added as the field options. However, if you created the field when there were already some entries in the directory, use the Import button to fetch them.

Displaying Linked Issues

Linked issues are not displayed automatically in the entries since it's not always necessary. For example, you use a Catalog directory as a simple list of references. You always can find issues linked to a particular Catalog entry via Issue Navigator.

However, sometimes it might be convenient to see the linked issues (or som of them) right within an entry.

Just add a Linked Issues attribute while setting up your directory. Set the additional filters if required. Following are several examples of displaying linked issues in Catalog. 

Examples of use

Case 1. We have a Services directory and allow our Service Desk customers to select a service from the list of available ones. We'd like to know instantly how many unresolved issues there are for a particular service.

  • Add a Catalog Select (single) custom field and put it on screens of the relevant project. Name it Service.
  • Add a Linked Issues attribute to the Services directory and set the additional JQL-filter: resolution is EMPTY. Name it Open Service Requests.


Settings

Entry View


Case 2. We have the list of Services and need to make them rated by employees. They should be able to select the best and the worst ones and we will count votes.

  • Add a Catalog Select (single) custom field, set up a selection from the Services directory. Put it on screens of the relevant project and name it The Best Service.
  • Add a Catalog Select (single) custom field, set up a selection from the Services directory. Put it on screens of the relevant project and name it The Worst Service.
  • Add a Linked Issues attribute to the Services directory and specify Linked via field(s) = The Best Service. Name it Selected as the best.
  • Add a Linked Issues attribute to the Services directory and specify Linked via field(s)The Worst Service. Name it Selected as the worst.