You can download the structure that you see on the screen as an XLS file and open it in Microsoft Excel or in other applications that support this format.
To export the structure to XLS, click the Export button in the toolbar and select Export to Excel.
The browser will download a new XLS file, which you can save or open. The XLS file will:
- Contain all the issues that are present in the structure.
- Preserve the structure's hierarchy.
- Include the same columns as the structure.
- Include columns in non-horizontal scrolling order, even if horizontal scrolling is turned on.
- Display only the Summary field within the Summary column. To include the issue description, add a separate Description column to the structure before exporting.
The rows are grouped together using Excel's grouping feature to form a collapsible structure in the spreadsheet – you can expand and collapse sub-issues under their parent issues.
The maximum depth of grouping in an XLS file is 8. If you have a deeper structure, it will still be exported, but the grouping will only work for the top 8 levels.
The XLS file is set up for a standard printing configuration:
- Page orientation is Landscape.
- The content is fit horizontally on the page (you might need to change that if you have too many columns or large content).
- Paper size is set to Letter if your account locale is US or Canada; otherwise it is set to A4.
The columns are formatted in the best way suitable for a spreadsheet.
The cell with an issue key is a link to the actual issue.
Cells in the Summary column have indentation just like in Structure. Note that if you change the format of a cell, you might lose the indentation level.
Progress field contains a fractional number from 0 to 1, formatted as a percent value.
Description, Environment and large text fields
The text might not fit in the column. You can increase the column size or use the Format Cells | Alignment | Wrap Text option in Excel to have a large text take up more than one line, increasing the row height. Note that a cell might not accommodate a very large text, and you might only see the first part of it.
Date values are displayed in your local date format.
Estimates, Time Worked
Duration fields contain actual numbers (fractional number of days), which you can sum or otherwise process. The display format is HH:MM, where HH is the number of hours and MM is the number of minutes. So an estimation of 5 days will be displayed as 40:00 (if you have 8-hour work days).
Standard custom fields
Standard custom fields are rendered according to their type.
Custom fields from other add-ons
Custom fields from other add-ons are displayed as they are rendered.
The exported file is compatible with Microsoft Excel 2003+.
The XLS format allows a maximum of 65536 rows in a spreadsheet. If your structure contains more items than this, use filtering to hide some of the issues.
If your structure's hierarchy is more than 15 levels deep, any items deeper than level 15 will be indented to the 15th level in the Summary column of the XLS file.
Note for Add-on Developers
If your plugin provides a new custom field type, please ensure that the field is displayed with the best compatibility with the other plugins, including Structure. In your column view velocity template, check for
$displayParams.nolink – all those parameters will be set to
true by Structure and may also be used by other plugins. See
CommonVelocityKeys.java and Jira sources for examples