Overview

Linking issues with catalog objects is a great chance to enrich issue with some more or less static information. The Catalog app provides the Catalog Select custom field to select one or more catalog entries 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 – Setting Up

Read how it works in an issue.

Navigate to Catalog configuration → Issue Fields section and add a new field specifying its name and the directory the field should provide a selection from.

The new custom field will be added to the list of fields and can be added to screens and managed as usual.

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 some of them) right within an entry.

Just add a Linked Issues attribute while setting up your directory. Set the additional filters if required. The 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.

Case 2. We use Epics as projects and need to add a project n each Epic 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.