Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

If you would like to structure your components to match the real world, you can use

...

the component hierarchy in Octo to create sub-components.

On this page:

Table of Contents
minLevel1
maxLevel2
outlinefalse
styledefault
typelist
printabletrue

Where to find the component hierarchy

...

You can view the component hierarchy from Octo.

  1. In the main Jira navigation menu,

...

  1. navigate to Apps > Octo Component management.

  2. Click

...

  1. Component hierarchy in the app menu.

Here you can view and edit the component hierarchy.

...

How to access component hierarchy in Octo to create sub-components in JiraImage Added

How to create sub-components

...

There are two ways to create a sub-component in Octo. You can either use Component hierarchy to create sub-components by dragging and dropping them over other components. Another option is to assign parent components from the component detail.

1. Create sub-components using drag and drop in the

...

component hierarchy

...

  1. In the main Jira navigation menu,

...

  1. navigate to Apps > Octo Component management.

...

  1. Click the Component hierarchy tab.

  2. You need to have at least two Jira Components to create a sub-component.

...

  1. Click Create component

...

  1. to create new Jira components.

  2. Click

...

  1. one of the components in the list and drag it over the other component and then drop.

How to create Jira sub-components using drag and drop in the Component hierarchy in Octo.Image Added

The component that was dropped becomes a sub-component, the component that you dropped into becomes the parent component.

Info

If you drag and drop a sub-component outside of any component, then it’ll be in the first level in the hierarchy and its parent will be removed.

2. Create sub-components by assigning

...

parent in component detail

How to create Jira Sub-component using Parent field in the component detail.Image Modified
  1. In the main Jira navigation menu,

...

  1. navigate to Apps > Octo Component management.

  2. In the Components tab or in the Component hierarchy tab click

...

  1. the component name in the table to open the component detail.

  2. In the component detail, click

...

  1. the Parent field and select the parent component from the

...

  1. drop-down.

Note

You can’t assign a component as a parent or any of its

...

sub-components (

...

child/components assigned under it) if the component you’re choosing the parent for is already a parent of that component.

You can always visually review component hierarchy in the Component hierarchy tab to better understand relationships between components.

How to use labels to create component hierarchy

...

You can tag your components with labels 👉 Learn more about Component labels here.

If you’re using labels they’ll also appear in the Component hierarchy tab and

...

drop-downs.

Labels are great if you want to structure your components into groups and you don’t want to use Components to do so. You can also

...

think of them like tags. One component can have no labels, one, or many.

1. Assigning label by dragging and dropping in the hierarchy

How to assign a component label to the Jira component in the component hierarchy in Octo.Image Modified
  1. In the main Jira navigation menu,

...

  1. navigate to Apps > Octo Component management.

...

  1. Click the Component hierarchy tab.

  2. Drag component you would like to assign a label to over the label and drop.

The component is now assigned to the label and appears under this label in the hierarchy.

If a component has more than one label it will appear under each label in the hierarchy.

2. Assigning label from the component detail

...

  1. In the main Jira navigation menu,

...

  1. navigate to Apps > Octo Component management.

  2. In the Components tab or in the Component hierarchy tab click on the component name in the table to open the component detail.

  3. In the component detail, click

...

  1. the Label field and select the existing component label or create a new one.

How to assign a component label to the Jira component in the component hierarchy in Octo.Image Added

The component is now assigned to the label and appears under this label in the hierarchy.

Info

Component labels will be always placed on the first level of the hierarchy, there isn’t an option to create sub-labels

...

.

How to add components to issue using component hierarchy?

...

  1. Open

...

  1. the Jira issue and click the component button above the Description field. (you need to do this only once, next time you access the issue field will be visible)

  2. Click

...

  1. the Component hierarchy field and select the component from the

...

  1. drop-down.

  2. Click outside the field to save.

How to assign a component to an issue using component hierarchy and sub-components in Jira with Octo.Image Added

The component is now assigned to the issue.

Info

The component hierarchy

...

drop-down isn’t available in the Create issue screen. Unfortunately, Jira apps can’t yet create modules on this screen.

Include Page
foxmon:_Footer
foxmon:_Footer
isMissingRequiredParameterstrue