Versions Compared

Key

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

...

You can create "Virtual Components" and "Real Components" directly inside this screen. 

Creation of Virtual Components

Since virtual components does not have any attribute other than name, just write new component name to the text field and press the button next to it. This will create a virtual component and immediately add it to virtual component list. Since this field is also used as a filter for virtual components, while entering the virtual component name all virtual components will disappear but they will be immediately visible after new virtual component is created. 

New Virtual ComponentImage Removed

Creation of Real Components

You can create a real component from JIRA's own "Component" screen or directly inside the Subcomponents screen. To create a subcomponent inside Subcomponents screen press the + button inside "Available Project Components" section. A new dialog will be opened which allows you to enter component attributes. Other than component name all other attributes are optional. Creating a component this way also adds this component to JIRA's own Component list. Even if you uninstall the add-on later the created component will remain. Actually this is a just shortcut for creating actual JIRA components.

New Project ComponentImage Removed

Organizing Subcomponent Hierarchy

You can organize components in the subcomponent hierarchy using drag&drop. You can add new virtual and real components or change parent or location of existing components using drag&drop. To remove a component from hierarchy drag and drop it to button with Image Removed icon. The component will not be deleted it will be only removed from the hierarchy and it can be add again if you want. 

Filtering

You can filter all 3 parts shown in the subcomponent screen, virtual components, project components and components hierarchy just entering filter text to the text field on top of each section. Filtering is real-time and you don't need to press enter. To clear the filter either delete all the text inside filter text area or press the button with x sign. 

Subcomponent Selection

Once you define subcomponent hierarchy, it is available on issue and issue quick edit. Since plugin adds its selection button next to "Component" field and you can open it using Image Removed icon. 

Image RemovedImage Removed


Selecting a parent component (whether it is virtual or not) will automatically select all of it’s visible

Child pages (Children Display)
of it. The same way unselecting a parent component will select all of it’s visible children. With respect to selection the difference between a virtual parent component and a real parent component is real parent components are also added to components field of the issue whereas virtual components are not. You can use filter text area to quickly narrow down large component lists. 

JQL Extensions

The plugin also adds JQL for subcomponents,  subcomponentsofUsing this JQL you can find all subcomponents of a given component. This JQL function takes at least one argument, name of component. In addition to subcomponents of the given component the plugin also returns component itself by default. You can pass a second argument to this function to instruct it not to return component itself. You can either pass virtual component or a real project component to this JQL. 

...