July 30, 2023

tSendMail – Docs for ESB 7.x


Notifies recipients about a particular state of a Job or possible

tSendMail sends
emails and attachments to defined recipients.

tSendMail Standard properties

These properties are used to configure tSendMail running in the Standard Job framework.

The Standard
tSendMail component belongs to the Internet family.

The component in this framework is available in all Talend

Basic settings


Main recipient email address.


Sending server email address.

Show sender’s name

Select this check box if you want the sender name to show in the


Email addresses of secondary recipients of the email message
directed to another.


Email addresses of secondary recipients of the email message.
Recipients listed in the Bcc field
receive a copy of the message but are not shown on any other
recipient’s copy.


Heading of the mail.


Body message of the email. Press Ctrl+Space to display the list of available

Die if the attachment file doesn’t

This check box is selected by default. Clear this check box if you
want the message to be sent even if there are no attachments.


Specify the file(s) attached and sent along with the email
message. Click the [+] button to
add as many rows as needed and set the value of the following
columns for each row:

  • File: Enter the path
    to the attached file or the path to the folder if all
    files directly under it will be attached.

  • Content Transfer
    : Click the cell and select a
    content transfer encoding value from the list.

Other Headers

Click the plus button to add as many lines as needed where you can
type the Key and the corresponding
Value of any header information
that does not belong to the standard header.

SMTP Host and Port

IP address of SMTP server used to send emails.

SSL Support

Select this check box to authenticate the server at the client
side via an SSL protocol.


Select this check box to authenticate the server at the client
side via a STARTTLS protocol.


Select in the list the priority level of your messages.

Need authentication / Username and

Select this check box and enter a username and a password in the
corresponding fields if this is necessary to access the

To enter the password, click the […] button next to the
password field, and then in the pop-up dialog box enter the password between double quotes
and click OK to save the settings.

Die on error

This check box is selected by default. Clear the check box to skip
the row on error and complete the process for error-free

Advanced settings

MIME subtype from the ‘text’ MIME type

Select in the list the structural form for the text of the

Encoding type

Select the encoding from the list or select Custom and define it manually.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at a
Job level as well as at each component level.

Global Variables

Global Variables

ERROR_MESSAGE: the error message generated by the
component when an error occurs. This is an After variable and it returns a string. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
to access the variable list and choose the variable to use from it.

For further information about variables, see
Talend Studio

User Guide.


Usage rule

This component is typically used as one subJob but can also be
used as output or end object. It can be connected to other
components with either Row or
Iterate links.

Sending an email on error

This scenario creates a three-component Job which sends an email to defined recipients
when an error occurs.

  • Drop the following components from your Palette to the design workspace: tFileInputDelimited, tFileOutputXML, tSendMail.

  • Define tFileInputdelimited properties.
    Related topic: tFileInputDelimited.

  • Right-click on the tFileInputDelimited
    component and select Row > Main. Then drag it onto the
    tFileOutputXML component and release when
    the plug symbol shows up.

  • Define tFileOutputXML properties.

  • Drag a Run on Error link from tFileDelimited to tSendMail component.

  • Define the tSendMail component

  • Enter the recipient and sender email addresses, as well as the email

  • Enter a message containing the error code produced using the corresponding
    global variable. Access the list of variables by pressing Ctrl+Space.

  • Add attachments and extra header information if any. Type in the SMTP


In this scenario, the file containing data to be transferred to XML output cannot be
found. tSendmail runs on this error and sends a
notification email to the defined recipient.

Document get from Talend https://help.talend.com
Thank you for watching.
Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x