Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sometimes, you may want to export multiples issues, without reproducing some sections of the template. For instance, you may want to create a cover section or some information to be added at the end of the document.

To provide this functionality, Xporter plugin supports a special notation. This notation allows defining allows you to define which sections of the template will be rendered for each issue, and which sections will be static. The notation is demonstrated in the example below:

Code Block
titleExpand to see the example on sample code
collapsetrue
This is the header of the Bulk Export, this section will be rendered a single timeonce.
 
&{for issues}
This section will be repeated for every issue.
Issue Key: ${Key}
Issue Summary: ${Summary}
&{end}
 
This is the footer of the Bulk Export, this section will be rendered a single timeonce.  

The image below demonstrates a Word template to bulk export multiple issues:

...

You can push the static sections functionality to another level of control by applying filters to the iterations. For instance, this This can be useful if you want to export multiple issues, and place the issues of a specific issue type (ex: e.g., Bug) in a one section of the template and the issues of another type (ex: e.g., Story) in other section of the templateanother. The notation is demonstrated in the example below:

Code Block
titleExpand to see the examples on sample code
collapsetrue
This is the header of the Bulk Export, this section will be rendered a single timeonce.
 
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 timeonce.   

The image below demonstrates a Word template to bulk export with static sections and filters applied to the iteration of issues.

...

Static Sections with Aggregator Iterations

Xporter has a feature to can aggregate each issue in a Bulk Export in to its respective aggregator value.

A Xporter Aggregator Iteration is, as its name indicates, an iteration that permits the user allows you to export each issue belonging to each aggregator value.

...

Code Block
titleExpand to see the examples on sample code
collapsetrue
This is the header of the Bulk Export,; this section will be rendered a single timeonce.
 
The following section will list each version present on a bulk export and it´sits respective issues.
 
&{for bulkFixVersions}
Version: ${BulkFixVersion}
&{for issues}
Issue Key: ${Key}
Issue Summary: ${Summary}
&{end}
&{end}

 
This is the footer of the Bulk Export, this section will be rendered a single timeonce.   

The image below demonstrates a Word template that applies the logic in the code sample above:

And

now for the resultant exportation using the template aboveThe result is as follows: