JS7 JobScheduler

Space shortcuts

Page tree

Versions Compared

Old Version 23

changes.mady.by.user Andreas Püschel

Saved on

compared with

New Version Current

changes.mady.by.user Andreas Püschel

Saved on

Key

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

...

  • The variable names specified are selected to match those used with the JITL MailJob template.
  • Note the use of variable names that start with mail.smtp.
    • These variable names correspond to Java properties available with the JavaMail API. Any of the JavaMail properties can be specified.
    • You will find a full list of the available mail.smtp. properties from https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html
    • Required properties include (but are not limited to):
      • mail.smtp.host
      • mail.smtp.port
    • When using a secure SSL connection consider note that:
      • for to use of TLS the , the mail.smtp.starttls.enable argument has to be used with the value true, for to use with SSL SSL, the mail.smtp.ssl.enable argument has to be used with the value true.
      • different ports might be in use: for unencrypted connections port 25 is frequently used, for TLS connections port 465 or 587 is frequently used, for SSL connections port 587 is frequently used.
      • optionally use the mail.smtp.ssl.protocols argument with a value such as TLSv1.2 or TLSv1.1,TLSv1.2 to specify one or more protocol versions that limit handshake with the mail server to the protocol versions specified. Depending on the Java version in use and possible modifications of the java.security file a number of protocols could be enabled that might not match the mail server's capabilities. Typically SSL handshaking starts from the highest protocol version accepted by both parties. However, it is not guaranteed that protocol negotiation will work perfectly. In such a situation it is recommended that the protocol version is specified using this argument.
    • For authentication the following settings are used:
      • the mail.smtp.user setting is assigned the SMTP user account.
      • the mail.smtp.password setting is assigned the password.
    • When using OAuth2 authentication then the following settings are used:
      • the mail.smtp.auth setting is assigned the value true.
      • the mail.smtp.auth.mechanisms setting is assigned the value XOAUTH2.
      • the mail.smtp.user setting is assigned the OAuth2 user account.
      • the mail.smtp.password setting is assigned the OAuth2 access token.
      • Some mail servers such as smtp.office365.com might require the older SASL mechanism to be used:
        • the mail.smtp.sasl.mechanisms.oauth2.oauthToken setting is assigned the OAuth2 access token.
        • the mail.smtp.password setting is not specified.

The second part of a job resource is accessed using the "Environment Variables" sub-tab as shown here:

...

NameRequiredDefault ValuePurposeExample
toyes
list of mail recipient's e-mail address, multiple e-mail addresses are separated by comma or semicolonops@example.com

from

no

e-mail address used for sending mail

js7@example.com

from_name

no

the free-text name of the account that sends mail

JS7 JobScheduler

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

no-reply@example.com

cc

no

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


bccno
e-mail address of blind carbon copy recipient, multiple e-mail addresses are separated by comma or semicolon
subjectyes
the mail subject, consider the use of 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 semicolon
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

...

The MailJob can be used with a credential store to hold sensitive arguments. For use of the credential_store_* arguments see JS7 - Use of Credential Store with JITL Jobs.

Further Resources

...