This documentation relates to an older version 1.4 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

Structure provides a dashboard gadget that allows you to view and edit structure. The gadget may be also be imported into Confluence and included on a Confluence page.

Adding Structure Gadget to Dashboard

Structure gadget is added as any other gadget: click Add Gadget button in the top right corner of the dashboard, find "Structure" and click Add It Now. You need to have change permissions on the dashboard (if you don't have permissions to change the dashboard, you can try to create a copy using Tools | Copy Dashboard.

You can add several gadgets showing different structures to the same dashboard.

Configuring the Gadget

The table below describes available configuration parameters for the Structure gadget.

Parameter

Default Value

Description

Structure

 

The structure to display. You can pick any structure that you can view.

Visible Rows

10

The maximum number of rows to display. This is how you control the maximum height of the gadget. If there are fewer visible rows, the gadget shrinks; if more, a vertical scroll bar appears. Pick any number between 2 and 50.

Allow Changes

Yes (checked)

If selected, gadget viewers can modify the structure right within the gadget, using keyboard shortcuts. (Of course, only if they have Edit permissions on the structure or issue being changed.) If this option is not selected, the gadget will only show the structure in read-only mode.

Deselect Allow Changes to protect the structure from accidental changes, such as changes caused by drag-and-drop or hitting Delete key.

Using the Gadget

The Structure gadget contains a stripped-down version of the standard Structure widget that you see on other pages. Because the screen space available to a gadget is usually limited, it lacks features like search and secondary panels. It also doesn't have a toolbar. However, most keyboard shortcuts are functional. If the gadget allows editing, you can rearrange issues with drag-and-drop; you can also move, create, edit, and delete issues using the keyboard.

If gadget is displayed in its "home" JIRA dashboard (not in Confluence or elsewhere), the last column lets you use action drop-down for the issues.

Gadget View Configuration

When you initially configure and add Structure gadget to a dashboard, it has the default state - sub-issues are not shown (the hierarchy is collapsed), default columns are used.

You can set up columns, collapse/expand various parts of the hierarchy and switch structure into the fixed structure view.

To switch Structure into Fixed View on a particular target issue, select it and press Ctrl+.