Versions Compared

Key

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

...

The MailFragment element supports the following attributes:

AttributeUsageDescription
nameRequiredUnique name of the fragment.
job_resourcesRequiredA list of JS7 - Job Resources that specify mail server connection settings.
content_typeOptional

Content type of the e-mail.

Possible values:

  • text/plain
  • text/html.


Default: text/html

charsetOptional

Charset of the e-mail.


Default: ISO-8859-1

encodingOptional

Encoding of the e-mail.

Possible values:

  • 7bit
  • Quoted-Printable
  • Base64.


Default: 7bit

priorityOptional

Priority of the e-mail.

Possible values:

  • Highest
  • High
  • Normal


Default: Normal

Attributes from Job Resources 

The following attributes settings are required to be provided by one of the Job Resources that are assigned a MailFragment:

AttributeUsageDescription
mail.smtp.hostRequiredHost name or IP address of the mail server.
mail.smtp.portRequiredThe port number for SMTP access to the mail server.


Optional attributes settings include - but are not limited to - settings specific for your mail server, e.g. for authentication:

AttributeUsageDescription
mail.smtp.timeoutOptional

Socket read timeout for mail server connection.

mail.smtp.connectiontimeoutOptionalSocket connection timeout for mail server.
mail.smtp.userOptionalUser name for the account that sends e-mail.
mail.smtp.passwordOptionalPassword for the account that sends e-mail.
mail.smtp.ssl.protocolsOptionalSpecifies the TLS protocol version, e.g. TLSv1, TLSv1.1, TLSv1.2, should an SSL connection be used


Basically any settings with the prefix mail.smtp. can be assigned a Job Resource that is used with the MailFragment. JS7 makes use of JavaMail, therefore find a list of available setting settings e.g. from https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html.

...

The following elements are nested inside the MailFragment element:

ElementElement descriptionDescription
MessageRefRequired, only once inside of the MailFragment elementBody of an e-mail notification that is provided by the referenced Message element.
SubjectRequired, only once inside of the MailFragment elementSubject of an e-mail notification.
FromOptional or only once inside of the MailFragment elementE-mail address of the account that sends e-mail.
ToOptional or only once inside of the MailFragment elementE-mail address of the recipient(s) of a notification e-mail.
CCOptional or only once inside of the MailFragment elementE-mail address of the recipient(s) of a carbon copy notification e-mail.
BCCOptional or only once inside of the MailFragment elementE-mail address of recipient(s) of a blind carbon copy notification e-mail.

Subject

Subject of an e-mail notification.

...