Zenthas

Documentation: Component Tree for Jira

Open the app

In Jira, open your project, then Project settings, then the page "Component Tree for Jira" under Apps. Only project administrators and Jira administrators can change the tree. Everyone else is blocked from saving.

Arrange components

  1. Drag a component onto another one to make it a subcomponent, or open the row menu and choose "Move to".
  2. Changes appear marked and are counted in the bar at the bottom: "N unsaved changes".
  3. Click Save to apply them, or Discard to drop them.

Create, rename, describe, set lead, delete

Use the inline fields in the tree. The lead field picks from people who can be assigned in the project. Clear the lead to remove it. Deleting a component also removes it from the tree.

Issue counts

The number next to a component opens Jira's issue search for that component, newest first. The second link "incl. subcomponents" searches the whole branch.

JQL

  • component in subcomponentsOf("Billing"): issues in Billing and everything below it.
  • component not in subcomponentsOf("Billing"): issues outside that branch.
  • component in subcomponentsOf("Billing", "SAM1"): only in project SAM1.

Without the project argument, components with the same name in several projects are merged. After every change the app refreshes the results Jira stores for the function.

History and Undo

Open History to see who changed what and when. Undo reverses one saved batch of changes. The history only covers changes made through the app, and keeps the last 500 entries per project.

Limits

Cloud only. The hierarchy exists only inside the app, Jira's own component list stays flat.

Subcomponent field

The "Subcomponent" issue field shows your component tree as a selection list. Add it to the issue screens you want, then pick one or more entries. The field is searchable in JQL, for example Subcomponent = Auth. When you set it, the issue's Jira components are kept in sync, including the parent path. Project administrators can switch the parent path off in the project settings.