Once the plugin is installed, a new menu appears in the Add-ons administration page left menu, as shown below (you may have to reload page if plugin was just installed).

Image RemovedImage Added

Plugin configuration

...

In the screenshot below, you can see the administration screen as it is when a context is selected, and no template is selected. This is the template creation mode.

Image RemovedImage Added

Template title

Enter a title for your template. Please note templates titles are unique. You cannot create two templates with the same title.

Subject template

The subject template is the template of the mail subject. You can enter a line of text, and include placeholders if necessary (more on placeholders later).

Body template

...

Custom Text Elements

This allows you to choose between 0 to 5 custom text zones in your templates. One custom text area will be displayed in issue view for each of them.

Allow canned texts

Allows users to use one of the prepared canned answers in the custom text areas, instead of typing them.

Canned text categories

When the allow canned texts checkbox is checked, then a list of existing canned texts groups is displayed, and you can select any combination of them. Global canned texts are canned answers that can be used in any case, not restricted to a specific category of issues.

Image Added

Subject template

The subject template is the template of the mail subject. You can enter a line of text, and include placeholders if necessary (more on placeholders later).

Body template

The body template is the template of the mail body. Note that this is an HTML template. You can enter HTML code, or just plain text, but the mail that will be sent will have the text/html mime type. You can include as many placeholders as desired.

Issue to use for preview

...

[summary]
- Replaced by the issue summary
[description]
- Replaced by the issue description
[last-comment]
- Replaced by the last issue comment
[custom-field-XXX]
- Replaced by the value of the custom field identified by its id (XXX must be replaced by the custom field value) in the processed issue.
- If the field contains a date, the default format will be used : yyyy-MM-dd HH:mm:ss
[custom-text]
- Adds the custom text entered in the email sending form.
[custom
- if you have more than one custom text fields, just reuse the same placeholder [custom-text] as many times as necessary. Each subsequent placeholder will be replaced by the next custom text field (2 to 5)
[custom-field-XXX|yyyy-MM-dd HH:mm:ss]
- Same placeholder as above, but with a date/time format. If the custom field contains a date, it will be displayed using the provided format.
[issue.XXX]
- Allows to include any issue field value. XXX must be replaced by the name of the field to extract. For example, to extract the issue creation date, the placeholder must be : [issue.created]
- If the field contains a date, the default format will be used : yyyy-MM-dd HH:mm:ss
- Available issue fields :Same placeholder as above, but with a date/time format. If the issue field contains a date, it will be displayed using the provided format
  - reporter : the issue reporter
  - assignee : the issue assignee
  - reporterId : the reporter username
  - assigneeId : the assignee username
  - created : the issue creation date
  - updated : the issue update date
  - resolution : the issue resolution status
  - status : the issue workflow status
  - priority : the issue priority
  - issueType : the issue type
  - votes : the number of votes of this issue
  - watches : the number of watchers for this issue
  - resolutionDate : the issue resolution date
  - dueDate : the issue due date
  - summary : the issue summary : the issue summary
  - description : the issue description
  - key : the issue key (for example DEMO-1)
  - affectedVersion : the list of affected version for this issue
  - fixVersions : the list of fix versions for this issue
[issue.XXX|yyyy-MM-dd HH:mm:ss]
- - description : the issue description
  - key : the issue key (for example DEMO-1)
  - affectedVersion : the list of affected version for this issue
  - fixVersions : the list of fix versions for this issue
[issue.XXX|yyyy-MM-dd HH:mm:ss]
- Same placeholder as above, but with a date/time format. If the issue field contains a date, it will be displayed using the provided format.

Warning

title	HTML Formatting in issue.xxx placeholders

If you use issue.XXX placeholders (issue.summary, issue.description, ...), the generic formatter of Jira is used, and it may add some HTML formatting around your field's value.

If you want to use this placeholder but do not want HTML formatting, you can add the |markup=no at the end of the placeholder. It will remove Jira's formatting.

Ex: [issue.summary|markup=no]

But we strongly discourage this. Where possible, use the specialized placeholder (instead of issue.summary, use summary). Specialized placeholders have their own specific formatter, which will always provide a correct output.

Canned Texts

The Canned texts administration screens allows you to

create any number of canned answers groups (or categories)
Add any number of canned answers, and associate them to a group (or to the global category - default)

Image Added

To Add a canned texts group, simply click the Add Canned Text Group button, and in the pop up opening, enter the name of your group :

Image Added

Under the groups, you can find the list of canned texts, with the group they belong to.

You can add a new one, and assign a category to it, by clicking the Add Canned Text button :

Image Added

Either select a group (or leave the Global group), and enter your text. Hit save and it's available to any template using its group of canned texts.

History

History allow you to consult sent notifications

Date: date, time of the notification
Sent By: user who sent the notification
Issue: issue from which notification was raised
Recipients Lists: the recipient(s) list(s) used
Context: the context used
Template: the template used
View: allow you to view the send notification

Image Added

You can order the notification ascending or descending with following parameters:

Date
Sender
Context
Template

Image Added

Two icons can be displayed next to elements in the history :

Image Added : This element was deleted since notification was sent
Image Added : This element was renamed since notification was sent. You can move your mouse over the pen to see the new name, like this :

Image Added

View sent notification

Clic on the view button to see the notification detail
The notification is also shown as a comment in the issue

Image Added

Plugin usage

For tickets belonging to users not allowed to use the Ovyka Advanced Notifer for JIRA plugin or not belonging to one of the defined contexts, nothing special will appear in issue view.

For tickets belonging to a defined context and to one of the allowed plugin users , a new form will appear in issue view, as shown below.

Image Added

As shown in the above screenshot, an allowed user can choose:

a recipient list group
one or several recipient list in this group (a list of email addresses to which the notification emails will be sent)
the template of the notification (an email subject and body model to send to selected recipient list)

He can also add:

some custom recipients if needed in BCC (a list of email addresses separated by spaces to add to the configured email recipients)
a custom text which will be add to the generated email if the [custom-text] placeholder is added into the template.

When the template you select allows custom texts and canned texts, then you can see an "Insert Canned Text" button under each of the custom text areas.

Image Added

If you click it, you're presented with a pop in window asking you to select one of the canned texts you configured. Once a canned anwser is selected, it is copied into the custom text area.

Image Added

When you hit the Prepare email button, a popup opens with a preview of the email that will be sent, as shown below.

Image Added

This preview shows the email that will be sent if you click the Send button. Once you click it, the mail is sent to all the addresses configured in the selected recipient list.

Panel

Table of Contents

Plugin installation

The Ovyka Advanced Notifer for JIRA plugin is provided as a JAR file.

To install the plugin, go to JIRA Add-ons administration, and select the Manage Add-ons page. On the page, click the Upload add-on button, select the Ovyka Advanced Notifer for JIRA JAR, and click OK.

Image Added

Once the plugin is installed, a new menu appears in the Add-ons administration page left menu, as shown below (you may have to reload page if plugin was just installed).

Image Added

Plugin configuration

The configuration of the Ovyka Advanced Notifer for JIRA plugin is divided in five configuration elements :

Permissions : The Ovyka Advanced Notifer for JIRA plugin adds an email sending form to issue views. This form will only be displayed for users allowed to use the plugin. The Permissions administration screen allows you to select which users are allowed to use the Ovyka Advanced Notifer for JIRA plugin, and which user are allowed to administer the plugin.
Recipients Lists : Recipients Lists allow you to define lists of email addresses to which notifications will be sent. In a recipeint list, you can define multiple TO, CC and BCC email addresses.
Contexts : A Context defines which in which issues the Ovyka Advanced Notifer for JIRA email sending form will appear. It contains a list of projects, and a list of issue types. Issues in the selected project and with one of the selected issue types will have the mail sending form displayed.
History : Notification history allow you to view sent notifications

Permissions

The permissions screen allows you to see and add allowed users and administrators. The email sending form will be displayed only for users allowed to use the Ovyka Advanced Notifer for JIRA plugin. Allowed users are displayed as shown in screenshot below :

Image Added

To add a user, just start typing the name of the user you want to add, and a list of matching users will appear, as shown below. Just continue typing to refine the matching users list, until you find the desired user.

Image Added

That's it. As soon as the user is selected and displayed in Allowed users field, it is saved in the plugin configuration.

To add users to plugin administrators in addition to global administrators, you can add them to Ovyka Advanced Notifier for JIRA allowed administrators.

Recipients Lists

A recipient list is the list of email addresses to which notifications will be sent when this recipient list is selected in the email sending form (more on this later).

In the recipients lists administration screen, configured recipients lists are displayed as shown below.

Image Added

To add a new recipient list, click the Add Recipient List button. A popup window will appear, as shown in the screenshot below.

Image Added

In this window, you must enter a title and at least one address (TO, CC or BCC). If you want to enter more than one email address in one of the fields, enter one address per line.

Please note that recipients lists titles must be unique. You cannot create two recipients lists with the same title.

Groups are not JIRA groups. They are groups of recipient lists. Groups allow to group several recipient lists together.

You can create groups to make sets of recipient lists.

Enter a new or an existing group during recipient list creation or edition.
Recipient list without group are added to default group.
Groups must be unique.
Groups will allow you to quickly send a notification to all recipient lists within that group ("select all" feature)

Once you click the Save button, your recipient list is added to the list.

Contexts

Contexts define for which issues the email sending form will be displayed. To define a context, you must select :

a list of projects
- you can select one project, multiple projects, or all projects
a list of issue types
- you can select one issue type, multiple issue types or all issue types
a checkbox to allow or disallow commenting in issue when notifications are sent.

In the Context administration screen, contexts are displayed as shown below.

Image Added

To add a context, click the Add Context button. A popup window will appear, in which you will be able to enter the context's title, issue types and projects. Please note that context titles must be unique. You cannot create two contexts with the same title.

To select an issue type, just begin typing and a list of matching issue types will be displayed, as shown in the screenshot below. Just continue typing to refine the list of matching issue types until you find the desired issue type.

Image Added

To select a project, just begin typing and a list of matching projects will be displayed, as shown in the screenshot below. Just continue typing to refine the list of matching projects until you find the desired project.

Image Added

For issue types and projects, if you want to select all issue types or all projects, do not enter anything in the corresponding field.

For example, in the screenshot below, we are creating a context :

with title : My New Context
that applies to issues of type Bug or Task
that applies to all projects
that will add a comment in the issue each time a notification is sent

Image Added

Once saved, it appears in the contexts list as shown below.

Image Added

Templates

The Templates administration screens allows you to create email templates.

An email template is an email in which you add placeholders that will be replaced by values extracted from the issue you send the mail from when the mail will be generated.

The Templates administration screen is divided in two parts : context and template selection, and template edition/creation.

Context and Template selection

The first part of the screen allows you to select the context to which this email template will be associated to. This means that this template will only be available in issues belonging to the selected context (project and issue type). It appears as shown below.

Image Added

In the Select context field, a list of configured contexts is displayed. Select one of your contexts.

The Select template field has two usages. Once the context is selected, it will be filled with the list of already configured templates.

To edit an existing template, select it the the dropdown list. To create a new template, leave the Select template field empty.

Template creation

In the screenshot below, you can see the administration screen as it is when a context is selected, and no template is selected. This is the template creation mode.

Image Added