Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The job template makes use of the SMTP protocol to send mail.
  • The job template can be used to specify settings from different sources:
    • Connection Settings
      • This includes settings such as the SMTP host, port etc.
      • It is recommended to use JS7 - Job Resources for this purpose as such settings tend to use the same values for any mail that should be sent.
    • Mail Settings
      • Such settings are specific for individual mail and include e.g. the subject and body of the mail.
  • The job template can be used with a JS7 - Credential Store.

Usage

When defining the job consider

...

NameRequiredDefault ValuePurposeExample
toyes
list of mail recipient's e-mail address, multiple e-mail addresses are separated by comma

from

no

e-mail address used for sending mail


from_name

no

the free-text name of the account that sends mail


reply_to

no

if no replies should be accepted then typically use an e-mail address such as no-reply@example.com is used for the respective domain


cc

no

e-mail address of carbon copy recipient, multiple e-mail addresses are separated by comma


bccno
e-mail address of blind carbon copy recipient, multiple e-mail addresses are separated by comma
subjectyes
the mail subject, consider to use ASCII 7bit characters
bodyyes
the mail body specified as plain text or HTML depending on the content_type setting
content_typenotext/plaina content type text/plain specifies plain text mail, a content type text/html specifies use of HTML mails.
encodingno7bitthe character encoding of subject and body, by default ASCII 7bit is used
charsetnoiso-8859-1by default Latin 1 (iso-8859-1) is used
attachmentno
the path to a file to be attached, multiple files are separated by comma
attachment_content_typenoapplication/octet-streamthe attachment content-type typically allows binary files
attachment_encodingnoBase64any attached files are encoded with printable base64 characters
attachment_charsetnoiso-8859-1by default Latin 1 (iso-8859-1) is used
mail.smtp.hostyes
the hostname or IP address of the SMTP server
mail.smtp.portno25the port of the SMTP server
mail.smtp.userno
the user account to be used in case that the SMTP server requires authentication
mail.smtp.passwordno
the password to be used in case that the SMTP server requires authentication
mail.smtp. ...no
any additional Java properties can be used as applicable to the JavaMail package
credential_store_fileno
Location of a credential store database (*.kdbx)./config/private/jobs.kdbx
credential_store_keyno
Location of a credential store key file (*.key)./config/private/jobs.key


For use of the credential_store_* arguments see JS7 - Use of Credential Store with JITL Jobs.

Further Resources

...