notifications

This module contains functionality for sending email messages. These messages are independent from the notification scheme that is used for subscriptions to issue updates in YouTrack. All of the components for these email messages are defined in the parameters for the function that is supported in this module. However, the messages are still sent by the SMTP server that is connected to your YouTrack installation.

Functions

sendEmail

        static sendEmail(message, message.fromName, message.toEmails, message.subject, message.body, issue)
    

Sends an email message to one or more email addresses. If the project that the issue belongs to uses a dedicated project 'From' email, the email is sent from this address. Otherwise, the default server 'From' address is taken.

Parameters

Name	Type	Description
message	Object	An object that contains all of the message components that are required for sendout.
message.fromName	string	The visible name of the sender. When used, the specified value is displayed as the sender name in the email message. If the sender email (whether taken from the project settings or the server setting) includes a sender name, it is overwritten with this value. If this parameter is left empty, the presentation of the sender is determined by the 'From' address that is saved in either the project or server settings.
message.toEmails	Array.<string>	A list of recipient email addresses. The first email address in the array is set as the recipient. All others are set as CC.
message.subject	string	The email message subject.
message.body	string	The email message body.
issue	Issue	The issue that the email message is related to. All email messages that are related to a single issue are combined into one thread.

Example

var issue = ctx.issue;
if (issue.comments.added.isNotEmpty()) {
  var authorName = issue.comments.added.first().author.fullName;
  var message = {
    fromName: authorName,
    toEmails: ['user1@jetbrains.com', 'user2@jetbrains.com'],
    subject: 'New comment in ' + issue.id,
    body: [
      '<div style="font-family: sans-serif">',
      '  <div style="padding: 10px 10px; font-size: 13px; border-bottom: 1px solid #D4D5D6;">',
      '    New comment was added in issue ' + issue.id + ' by ' + authorName,
      '  </div>',
      '<\div>'
    ].join('\n');
  };
  notifications.sendEmail(message, issue);
}

Last modified: 16 March 2020