SendEmail plugin

3 minute readExtensibilityDeveloper productivity

Plugin version 1.1.2.2023011222

Revised on January 19, 2023

Dependencies

This plugin uses an updated version of Perl, the cb-perl shell (instead of the old ec-perl shell), and requires CloudBees CD/RO agent version 10.3 or later to work.

Plugin procedures

Send Email

Sends email using the CloudBees CD/RO sendEmail API.

Send Email parameters

Parameter Description

Email configuration

Required. The name of the email configuration to use. If no configuration is specified, a configuration named default is used.

To

A semicolon-separated list of To recipients for the email message. The recipient can be a user, a group name, or a complete email address. You can enter this argument more than once to specify multiple recipients.

CC

A semicolon-separated list of CC recipients for the email message. The recipient can be a user, a group name, or complete email address. You can enter this argument more than once to specify multiple recipients.

BCC

A semicolon-separated list of BCC recipients for the email message. The recipient can be a user, a group name, or a complete email address. You can enter this argument more than once to specify multiple recipients.

Subject

Required. The subject of the email message.

Message

The body of the email message, or a workspace file, containing the body. If both a plain text and an HTML message are provided, both values are sent as alternates in a multipart message. If a raw message is provided, the value should be a properly formatted RFC 822 message.

Plain text or file name

Radio button to choose either Plain text or File name.

Plain

The body of a simple text message.

Workspace file

Reads the specified client-side file and uses it as the body of a simple text message.

HTML text or file name

Radio button to choose either HTML text or File name.

HTML

The body of a simple HTML message.

Workspace file

Reads the specified client-side file and uses it as the body of a simple HTML message.

Raw text or file name

Radio button to choose either Raw text or File name.

Raw

The body of a simple raw message.

Workspace file

Reads the specified client-side file and uses it as the entire mail message, including headers.

Advanced options

Select checkbox for advanced options.

Multipart mode

The multipart mode of the email message.

  • none: Non-multipart message.

  • mixed: Single-root, multipart element of type mixed. Text, inline elements, and attachments are added to this root element.

  • related: Multipart message with a single root multipart element of related type. Text, inline elements, and attachments are added to this root element. It works on most mail clients, except Lotus Notes.

  • mixedRelated: Multipart mixed element with a nested multipart related element. Text and inline elements are added to the nested related element, while attachments are added to the mixed root element. It works on most mail clients other than Mac Mail and some situations on Outlook. If you experience problems, use the related value.

The default is none unless there are multiple parts, in which case it defaults to mixedRelated. If both text and html arguments are specified, both values are sent as alternates in a multipart message.

Header(s)

An RFC 822 message with a newline-separated list of email headers. For example, reply-to: user@example.com.

Attachment(s)

A newline-separated list of one or more file names to send as attachments.

In-line Attachment(s):

A newline-separated list of one or more inline attachments specified as a contentId and a client-side filename in the following format: contentId=fileName. The filename extension is examined to determine the content-type. The contentId can be referenced in an HTML body using the Content Interactive Delivery (CID) protocol.

Known issues

  • Sending empty file attachments only works from the CloudBees CD/RO 10.8 version.

Release notes

EC-SendEmail 1.1.2

  • Changed the Message parameter’s default option from Plain to HTML.

EC-SendEmail 1.1.1

  • Updated the To parameter to optional, as in previous versions.

EC-SendEmail 1.1.0

  • Upgraded from Perl 5.8 to Perl 5.32. The plugin is not backward compatibility with releases prior CloudBees CD/RO 10.3. Starting with this release, a new agent is required to run the plugin’s procedures.

  • This plugin has been migrated from GWT to PDK.

EC-SendEmail 1.0.7

  • Updated the documentation.

EC-SendEmail 1.0.6

  • Fixed a dropdown list.

  • Renamed from "Electric Cloud" to "CloudBees".

  • Fixed catch of formal parameters.

  • Changed the way the step retrieves the parameters.

  • Reverted the code that clears empty parameters.

  • Added bintray to repositories.

  • Checked dependencies with GCP Artifactory.

  • Checked for attachment name.

EC-SendEmail 1.0.5

  • Fixed an issue with unrecognized parameters in the application component process definition.