Page tree
Skip to end of metadata
Go to start of metadata

For version: VERSION 2.0.0




Contents




Instructions


DescriptionScreenshots
1Open the administration menu via the "Add-ons" menu item.

2

Search for the heading "Agile Hive - Custom Epic Panel" on the left-hand side.

You will see two entries underneath, which will be explained below.

3

Configuration

This overview is the default configuration of the Custom Epic Panel. The screenshot on the right shows the overview after installation containing the following elements:


  1. A blue "Create new configuration" button - lets you add a new configuration.
  2. A blue information box: Indicates clearly that there are no existing configurations. This will disappear as soon as a configuration has been created.
  3. A table listing the existing configurations.

See also: Create new configuration




Creating a new configuration


DescriptionScreenshots
1

You can create as many configurations as you need. Click on the blue "Create new configuration" button to create a new configuration.

2

You'll see the "Create new configuration" dialog, containing six elements that must be filled in:

  1. Panel Name
  2. JQL
  3. Boards
  4. Link Type
  5. Link Direction
  6. Backlog Name

There is also one optional element:

Each of these elements are described in order below.

3

Panel Name

You can change the default name of the panel to be something other than "EPICS", for example, "FEATURES". By renaming the panel, you make the purpose of the panel much clearer to your users. The new title is used throughout Jira, wherever the title is displayed, so that the interface is consistent for your users.


DefaultCustom
4

JQL

Enter the filters in a JQL query so that only the issues you want to display in the Epic Panel are displayed. All JQL queries are supported (including extended queries supported by Scriptrunner or Power Scripts). You can enter the query with the usual auto-completion.

5

Boards

Select one or more boards that this configuration applies to.

6

Link Type

Of course, all issues that are dragged from the backlog view of an agile board to an issue in the Epic Panel will be linked automatically.

You can define which type of link should be used in the Link Type field. If you need a new link type, create it in Jira via:

  • Jira administration → Issues → Issue Linking

7

Link Direction

Once you have chosen the Link Type in the previous step, select a Link Direction.

You can see the directions more clearly in the "Issue Linking" overview (via: Jira administration → Issues → Issue Linking).

The example below uses the Link Type "Blocks":

Link TypeLink Direction
OutwardInward
Blocksblocksis blocked by

Example:

Parameter

  • Link Type: Blocks
  • Link Direction: Inward

When Issue B is dragged from the backlog onto Issue A in the Epic Panel, the following links will be set:

Epic PanelBacklog

Issue A

is blocked by

Issue B

Issue B

blocks

Issue A

8

Backlog Name

You can rename the backlog name by editing this field. This is useful when the issues found in your Kanplan board are not backlog issues, but have a different status, like Tunnel, Inbox or To Do. You can use the name of the initial status of your workflow and to make it clear to your users (see the screenshots with the default and custom name).

This also works in Kanban boards. Enable the "Epic Panel" option in the Kanban Board configuration under Columns, to make sure the backlog view is displayed.



DefaultCustom




9

Supports multiple Links

If this check box is disabled (empty), the Custom Epic Panel will function like the default Epic Panel, where each backlog issue with the defined issue type can only be linked to one issue in the custom epic panel. The link label will be displayed with a solid background to the right of the issue name (see the "Disabled" screenshot).

Even though "Supports multiple links" is disabled, you can add additional links within the issue itself. In this case, the most recent link will be displayed as the label in the backlog view.

If you enable the "Support multiple links" check box, this limitation will be removed. Now, when multiple links are detected, the label to the right of the issue name will be updated to show this with a white background, as you can see in the "Enabled" screenshot.

DisabledEnabled
10

Now that you have filled in all fields in the "Create new configuration" dialog and saved it, you will see the configuration in the overview table with the following information:

  • ID (configuration ID in ascending order)
  • Panel Name
  • JQL
  • Boards
  • Link Type
  • Actions (Edit / Delete)

11You can edit each configuration (pencil icon) or delete it (trash can icon).



  • No labels