Customising template with visual builder

Variables

At the moment, following variables are supported -

• userName

• userEmail

• projectName

• projectId

• projectKey

• versionName

• versionDesc

• releaseDate

• timeStamp

• currentDate

• currentDatetime

• versionId

• versionURL

• startDate

JQL section

JQL section is the core of ARN release notes templates. Each JQL section represents a group of issues in Jira. Within the JQL section, you can provide additional configurations for each of the results.

We tweak Jira' JQL a bit in ARN, so that it supports runtime variables such as [versionId] and [versionName].

Variant 1

Introduction

JQL determines what issues from Jira to include in the release notes.

Issue fields selector dictates what information is shown in the release notes for the selected issues. You can choose default as well as custom fields from the dropdown.

Field customisation

Furthermore, each issue field that you’ve chosen to be a part of release notes can be further customised. Click on the already added field & that will reveal the additional settings available for the field. e.g. clicking on issue key reveals following.

Grouping

JQL section can return results grouped by any available field.

This group by field can be further configured by clicking on the left hand ‘Group by’ selection.

Variant 2

Introduction

JQL determines what issues from Jira to include in the release notes.

Issue fields selector dictates what information is shown in the release notes for the selected issues. You can choose default as well as custom fields from the dropdown.

Field customisation

JSON is a view-less, structured format & thus the customisation options are limited. One can modify the JSON structure, labels & ARN will echo the changes.

Grouping

Grouping is not possible within these JQL sections.

Exception - JSD announcement

JSD announcements is essentially an HTML text along with a title. To cater to this specific behaviour, ARN provides simple visual builder for JSD announcement type of templates.

Both, announcement subject & message fields, allow for variables to be added to them.

Stats