Versions Compared

Key

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

...

NameDescriptionTypeRequired
addresses-to-exprAn expression which results in an email address or list of addresses. The text format must adhere to the RFC822 standard. See also the Tips section below.StringYes
addresses-cc-exprAn expression which results in an email address or list of addresses. The text format must adhere to the RFC822 standard.StringNo
addresses-bcc-exprAn expression which results in an email address or list of addresses. The text format must adhere to the RFC822 standardStringNo
address-fromAn expression which results in an email address. The text format must adhere to the RFC822 standardStringYes
addresses-reply-to-expr

An expression which results in an email address or list of addresses. The text format must adhere to the RFC822 standard.

Since Blueriq 17.7

StringNo
mail-assetThe name of the asset that contains the subject and the body of the email. Note: The type of the asset must be “Email” and should contain only one line of text.StringYes
smtp-hostThe hostname of the SMTP server.StringNo
smtp-portThe port of the SMTP server.IntegerNo (defaults to 25)
smtp-userThe username to use when connecting to the SMTP server.StringNo
smtp-passwordThe password to use when connecting to the SMTP server.StringNo
smtp-usetlsIndicates if the SMTP server should be contacted using TLS.BooleanNo (defaults to false)
DocumentsSpecify all documents to be generated and attached. (deprecated, use connection instead)DocumentNo
ConnectionSpecify the connection. It is used for document attachmentsStringNo
FileIdsSpecify one or more file ids. When using this parameter, you also need to use the Connection parameter.ExpressionNo

Events

  • MailSizeExceeded: When the mail server indicates the combined size of all attachments is too large to be send, this exit is taken so that you can give a clear indication to the end user. If the max size is exceeded and this exit event is not mapped, an error is thrown.
Tip

When specifying email address values in the parameters above, expression statements are to be used.

For a simple hard coded email address, an expression containing a constant value suffices:

Code Block
"romeo@example.org"

The parameters addresses-to-expr, addresses-cc-expr or addresses-bcc-expr can deal with a list of values. In that case, the expression should reflect this:

Code Block
["romeo@example.org", "juliet@example.com"]

Using the expression, addresses can be retrieved:

Code Block
COLLECT person.mailaddress FROM ALL person WHERE (person.mailaddress != ?)

The AQ_MailService supports adding phrases to mail addresses (where the 'phrase' typically is a for humans readable identifier of the mail address. The format for an email address using a phrase is: Romeo <romeo@example.org>

Typically, phrases can be surrounded by the double-quote character ("). Within Blueriq, this character signifies the beginning or end of an expression. To prevent problems, the AQ_MailService accepts unquoted phrases (before submitting a message to an email server, the AQ_MailService makes sure that all phrases are properly formatted). As a result, each of these examples are valid mail address definitions within the AQ_MailService:

Code Block
"Romeo <romeo@example.org>"
"Romeo Capulet <romeo@example.org>"
"Capulet, R. <romeo@example.org>"
["Romeo <romeo@example.org>", "Juliet <juliet@example.com>"]
["Romeo Capulet <romeo@example.org>", "Juliet Montague <juliet@example.com>"]
["Capulet, R. <romeo@example.org>", "Montague, J. <juliet@example.com>"]

...

Code Block
languagetext
titleapplication.properties
blueriq.connection.[AQ_MailService name from Encore].email.smtp=exampleDomain.com (for the smtp-host parameter)
blueriq.connection.[AQ_MailService name from Encore].email.smtpport=25 (for the smtp-port parameter)
blueriq.connection.[AQ_MailService name from Encore].email.username=userName (for the smtp-user parameter)
blueriq.connection.[AQ_MailService name from Encore].email.password=password (for the smtp-password parameter)
blueriq.connection.[AQ_MailService name from Encore].email.usetls=true (for the use-tls parameter)
blueriq.connection.[AQ_MailService name from Encore].email.fromaddress=test@yourDomain.com (for the address-from parameter)
# repytoaddresses is available since Blueriq 17.7
blueriq.connection.[AQ_MailService name from Encore].email.replytoaddresses=reply-to@example.com (for the addresses-reply-to-expr parameter)
blueriq.connection.[AQ_MailService name from Encore].email.toaddresses=test1@example.com (for the addresses-to-expr parameter)
blueriq.connection.[AQ_MailService name from Encore].email.ccaddresses=test2@example.com (for the addresses-cc-expr parameter)
blueriq.connection.[AQ_MailService name from Encore].email.bccaddresses=test3@example.com (for the addresses-bcc-expr parameter)

...

Code Block
languagetext
titleapplication.properties
blueriq.connection.email.smtp=exampleDefaultDomain.com (for the smtp-host parameter)
blueriq.connection.email.smtpport=25 (for the smtp-port parameter)
blueriq.connection.email.username=defaultUserName (for the smtp-user parameter)
blueriq.connection.email.password=defaultPassword (for the smtp-password parameter)
blueriq.connection.email.usetls=true (for the use-tls parameter)
blueriq.connection.email.fromaddress=default@yourDomain.com (for the address-from parameter)
# repytoaddresses is available since Blueriq 17.7
blueriq.connection.email.replytoaddresses=reply-to@example.com (for the addresses-reply-to-expr parameter)
blueriq.connection.email.toaddresses=default1@example.com (for the addresses-to-expr parameter)
blueriq.connection.email.ccaddresses=default2@example.com (for the addresses-cc-expr parameter)
blueriq.connection.email.bccaddresses=default3@example.com (for the addresses-bcc-expr parameter)

...