Sometimes, you may want to export the contents of multiple issues without repeating some sections of the template. For instance, you may want to create a Cover page or display some information only at the end of the document.
In order to provide this functionality, the Xporter for JIRA plugin supports a special notation. That notation allows defining which sections of the template will be rendered for each issue, and which sections will be static. The notation is demonstrated below:
This is the header of the Bulk Export, this section will be rendered a single time. &{for issues} This is the footer of the Bulk Export, this section will be rendered a single time. |
You can even push this functionality to another level of control by applying filters to the iterations. This can be useful if you want to place the issues of a specific type (ex: Bug) in a section of the template and the issues of another type (ex: Story) in another section. The notation is demonstrated below:
The following section will list the issues of the type Bug. &{for issues|filter=%{'${IssueTypeName}'.equals('Bug')}} Issue Key: ${Key} Issue Summary: ${Summary} &{end} The following section will list the issues of the type Story. &{for issues|filter=%{'${IssueTypeName}'.equals('Story')}} Issue Key: ${Key} Issue Summary: ${Summary} &{end}
This is the footer of the Bulk Export, this section will be rendered a single time. |
Using a XLSX template however, please take note that to define an iteration you need to merge columns and define the "for" inside of those merged cells. The same thing should be made to define the end of the iteration. All content between the for definition and the end will be duplicated for each iteration
Below there is a sample of how the mappings will be displayed in a Word template:
Below there is a sample of how the generated file will be populated:
Here's the Exercise 4 related Docx files:
File | Description |
---|---|
Exercise4Template | Exercise 4 Sample Template file |
Exercise4Generated | Exercise 4 Sample generated file |
Below there is a sample of how the mappings will be displayed in an Excel template:
Below there is a sample of how the generated file will be populated:
Here's the Exercise 4 related Xlsx files:
File | Description |
---|---|
Exercise4Template | Exercise 4 Sample Template file |
Exercise4Generated | Exercise 4 Sample generated file |
Info |
---|
If you like this exercise, please share your opinion on the page just leaving a comment or a Like. Your opinion is very important to us and to all the people interested in our Add-on. Thank you in advance. |