Deprecation Note
All HTML has been removed from the description of the templates that were in the Template Store and in the future this page will no longer support HTML.
The Templates screen allows administrators to add, edit, delete and download the templates that will be available to the users.
Managing Templates
The operations available on this screen are:
- Add New Template: Allows you to create a new template.
- Store: With this option, you'll be able to install templates from the Template Store in this screen.
- Download Template: Allows you to download the template file. This operation is available in the hyperlink with the template file name.
- Edit Template: Allows you to change an existing template, changing the template name, template description and template file.
- Delete Template: Allows you to delete an existing template.
Template Details
Each template has the following attributes:
- Name: the name that is displayed to the users in order to select the template to export the issue(s) information.
- Description: here you can describe what is the goal of the template up to a maximum of 500 characters.
- Scopes: where the template will be available.
- Entities: a group of issues or issue types that are available as Xray Entities.
- Output formats: list of available template formats for a given input format. For more information go to Outputs Matrix Page.
- Default output format: one of the output formats allowed to be displayed as default.
- Default break page type: handles how Xray - Document Generator should break pages. The following break pages are supported:
- Never
- Issues
- Components
- Issue Types
- Projects
- Include Attachments: define if single exportation with that template will include attachments.
File: the file with template content. The following formats are supported:
- DOCX (Word Document)
- DOCM (Word Document with Macros)
- DOTX (Word Template)
- DOTM (Word Template with Macros)
- XLSX (Excel Document)
- XLSM (Excel Template with Macros)
Template Scopes
Template scopes define where the template will be available. The following scopes are available:
Scope | Location |
|---|---|
| Issue Navigator | Multiple Issues export (Issue Navigator screen) or Bulk action |
| Issue Detail | Export one issue at Issue detail screen |
| Agile Boards | This scope refers to Backlog and Active Sprint and Kanban |
| Releases | Manage Release on Agile/Kanban boards. Document Generator is available on Release list and detail screen. |
| [Board] Test Repository | Available on Testing Board → Test Repository from Project Settings. |
| [Board]Test Plan | Available on Testing Board → Test Plans from Project Settings for exporting a specific Test Plan. |
| [Board]Test Plans | Available on Testing Board → Test Executions from Project Settings for exporting Test Plans from a list. |
| [Board] Test Execution | Available on Testing Board → Test Executions from Project Settings for exporting a specific Test Execution. |
| [Board] Test Executions | Available on Testing Board → Test Executions from Project Settings for exporting Test Executions from a list. |
Template Entities
Template Entities define the issue types or group of issues (Coverables or Defects) that are considered as Xray entities and are available to be exported.
Template Store
Document Generator provides another way to get awesome templates. Use the Template Store to access and install templates provided by us, free of charge.
The Store will be displayed in the dialogue and allows you to install and re-install all of the available templates.
Furthermore, the template store also shows a thumbnail with the report generated based on the template selected.
Managing Templates at Project Settings
All features related to Templates management on App Administration are included at Project level.
