Response "Mail"
Settings
(1) Channel selection: Here you can select a channel of type "Mail".
(2) SMTP host/Port: The IP address or the DNS name of the SMTP server. If this input field does not contain a value and no partner channel has been selected, the input fields SMTP Host, Port, User and Password will be overwritten by the entries in configuration file ./etc/startup.xml. See section Mail (channel). Note: A value greater than 0 for the port overrides the port of a selected channel. If value 0 is set, the port set in the channel is used.
(3) From/To/CC/Subject: Variables can be accessed with syntax @VARIABLENNAME@. If you use prefix bcc: in email addresses in input field CC, the email will be sent as BCC and not as CC. If you use prefix reply-to: you can set the email header Reply-To (a reply address other than the sender). Important note: The email header will only be set once, i.e. further entries of this kind have no effect. Please also note the corresponding system variable below.
(4) Mailbody: Text in the body of the email. Variables can be accessed with syntax {--@VARIABLENNAME@--}.
(5) Send mail body as HTML: If this checkbox is set, the email is sent in HTML format. You can either insert HTML code directly in (4) or use the integrated HTML editor (6). You can view the formatted result with (7).
(6) HTML editor: See (5).
(7) HTML display: See (5).
(8) Transmit empty data: If this checkbox is set, empty files are transferred as well.
(9) Activate optional attachments: Here you can additionally attach files from the file system. You can use the usual placeholders and variables (@MYVAR@). If you use the prefix filter:, you can use an entry to define an entire list of files instead of just one file. So all files orders*.pdf in this example. The names of the files are also used as names of the attachments. Note: The files are deleted after they have been attached. This behaviour can be prevented by creating a profile variable VAR_MAIL_SKIP_DELETE_ATTACHMENT (type "Boolean") with value "true". Phase 3 must be active for this.
(10) Attach data: Here you can select how the data is sent (body/attachment). If you have selected to attach the data and it is empty, then this Response is skipped. This means that no email will be sent.
(11) Name of attachment: The name of the main attachment. Not relevant for (9).
(12) MIME type: If the MIME type is lobster/unzip, the payload is considered a ZIP file and the files included are added as individual attachments.
(13) Mark whole job as failed if this response fails: Normally a job is not necessarily considered to be erroneous if a single Response fails (see section Status of Response - Error Behaviour). But it can be enforced with this option here.
(14) Additional text on error: Here you can specify an additional log text for the error case.
System variables
If the system variables VAR_RESPONSE_MAIL_HEADER_<name of mail header> are defined and filled with values, the corresponding email headers will be set (with these values) for the email to be sent here in the Response. Uppercase and lowercase are considered. So the system variable "VAR_RESPONSE_MAIL_HEADER_Reply-To" can be used to set the email header "Reply-To" (a reply address other than the sender). Note: If the variable has a value, it will always be used first to set the email header. See item (3) above.
Notes
Field values can be composed of static and variable components. Example: @var__FIRSTNAME@.smith@example.com.Here the first name is the value of a variable, the rest is a fixed string. Several field or variable values can be used.
It is important to note that the size of an email to be sent is not unrestricted because most mail servers normally only allow emails up to a certain maximum size.