Content Comparison

Table of Content Zone

Table of Contents

Why subcomponents

Depending on its size, Jira project can contain a lot of components. Components help split a project into smaller parts and group project issues to simplify search and project reporting.

...

Tip

With Subcomponents you can:

organize project components in a structural and hierarchical way
visualize parent-child relations between components
add more context when selecting components from the hierarchy
search issues related to a particular part of a project represented by a subcomponents hierarchy at any level

Key features

Here is the list of key Subcomponents features:

add new or existing components
manage all component details without switching between project tabs
view all component details in the hierarchy tree grid
add components more than once in different places
group components using folders (virtual components)
search components in the hierarchy
find issues for any part of a project represented by components hierarchy
select components from hierarchy when creating (including Service Desk customer portal) or editing issues

Glossary

Throughout the documentation, we use some terms which we'd like to briefly explain before you continue.

Term	Comment
Subcomponents	Subcomponents are the hierarchy of components. Below are other ways we call subcomponents: hierarchy components hierarchy subcomponents hierarchy
Item	Item or hierarchy item is an element which is added to the hierarchy. It is the link to a project component or folder
Component	The component is a native project component
Folder	Custom hierarchy item type implemented in Subcomponents App
Subcomponents picker	The extension of Components field to select components from the hierarchy

Quick start guide

After installing the app a new project tab "Subcomponents" is added to all your Jira projects. It is the home of components hierarchy for a particular project.

...

When you first land on the Subcomponents tab and no hierarchy has been defined yet, we recommend you take our Quick Tour to familiarize yourself with key features. All project users can always access Quick Tour using the link in the Help menu.

...

Overview

Subcomponents project page consists of two parts:

hierarchy toolbar on top of the page
hierarchy itself under the toolbar

Hierarchy toolbar

All users who can browse a project can also view its subcomponents hierarchy.

...

Add existing component/folder - add one or more existing components/folders to the top of the hierarchy
Add new component/folder - create and add new component/folder to the top of the hierarchy

...

Hierarchy item toolbar

Subcomponents hierarchy consists of hierarchy items - links to corresponding components or folders.

...

Info

A confirmation dialog is displayed before the item is removed and contains the following information that:

item is removed with all its children items, number of items is included
neither components nor folders are deleted, only their references in the hierarchy are removed

Manage hierarchy

Add new component

You can add a new component to the top of the hierarchy via Add new component action of the hierarchy toolbar or under a target hierarchy item using its context menu.

...

By default new component is added as a last child of the target item. But you can change the position to add the component after the target item on the same level.

...

Add a new folder

When you start with Subcomponents app you don't have any folders.

...

When a folder is created from the item context menu its relative position can be adjusted in the same way as in components.

Add existing components

When you start with Subcomponents app your project might already have some components you want to add to the hierarchy.

...

name - free text input
usage in a hierarchy - dropdown with the options: used, unused, all

Add existing folders

Adding existing folders to hierarchy is done via Add folders dialog. It is opened when you click Add existing (folders) from Subcomponents toolbar or hierarchy item context menu.

...

name - free text input
usage in a hierarchy - dropdown with the options: used, unused, all

Manage components

In addition to adding components to hierarchy, you can fully manage components on Add components dialog without switching to Components project tab.

...

Component action

Description

Create

When a new component is created from Add components dialog it is not added to hierarchy automatically.

You will then need to select and add it explicitly.

Edit

When a component is updated the hierarchy is updated with new details automatically.

Delete

When a component is deleted all its references from hierarchy are removed.

All children items of a deleted component are removed from hierarchy as well.

If a removed component is associated with some issues a popup dialog is displayed with options to swap issues to another component.

Manage folders

Add folders dialog is where you can manage project folders.

...

Component action

Description

Create

When a new folder is created from Add folders dialog it is not added to hierarchy automatically.

You need to select and add it explicitly.

Edit

When a folder is updated the hierarchy is updated with new details automatically.

Delete

When a folder is deleted all its references from hierarchy are removed.

All children items of a deleted component are removed from hierarchy as well.

Find issues

You can find issues for a particular part of the project represented by some root component and its children items.

...

In the background View issues screen utilizes JQL search capabilities to find the required issues and you can switch to Jira Issue Navigator to get more details about the issues.

Select components in issue

Now let's explore how users can select components from the hierarchy using Subcomponents picker to add components to issue.

Subcomponents picker

Once project administrator has established subcomponents hierarchy users can select components from that hierarchy via "Subcomponents" picker available on issue operations toolbar.

...