Application Integration (On-Premises) : Integration Server Built-In Services : Client Folder : pub.client:smtp
pub.client:smtp
WmPublic. Sends a MIME-type e-mail message.
You may attach one or more content objects or files to the message.
Input Parameters
to
String Optional. E-mail address of the receiver. If you specify multiple addresses, separate them with commas.
cc
String Optional. E-mail addresses of additional receivers. If you specify multiple addresses, separate them with commas.
bcc
String Optional. E-mail addresses of additional receivers. If you specify multiple addresses, separate them with commas.
subject
String Optional. Subject of the message.
subjectCharset
String Optional. The character set used to encode the MIME message headers (including subject). If subjectCharset is not specified, then charset is used. If charset is not specified, the value in the server configuration parameter watt.server.email.charset is used. If that parameter is not set, the utf-8 encoding is used.
charset
String Optional. The character encoding of the body text. If you do not specify the value of charset, the value in the server configuration parameter watt.server.email.charset is used. If that parameter is not set, the utf-8 encoding is used.
from
String Optional. E-mail address of the sender. If you do not specify a from value, Integration Server uses the value specified for the mail.smtp.from JVM property. If no value is specified for that property, Integration Server uses the default value, user@servername, where user is the operating system user ID, and servername is the host name of the Integration Server.
mailhost
String SMTP host name for outbound messages. For example: smtp.webMethods.com
If no value is provided for the mailhost parameter, Integration Server uses the value of the Java system property mail.smtp.host set for Integration Server as the mailhost value. For more information about setting Java system properties for Integration Server, which includes modifying the custom_wrapper.conf file, see webMethods Integration Server Administrator’s Guide.
If no value is supplied for the mailhost parameter and the mail.smtp.host Java system property is not set, the pub.client:smtp service ends with an exception.
mailhostPort
String Optional. The number of the port on which the SMTP host listens. This parameter does not need to be set if the host listens on port 25 (the standard SMTP port).
auth
Document Optional. Authorization information that the SMTP service will submit.
Key
Description
user
String User name that this service will submit when requesting a protected resource.
pass
String Password associated with user.
secure
Document Optional. Parameters specifying the security protocol and truststore information for certificate validation that Integration Server uses when communicating with the SMTP server port.
Key
Description
transportLayerSecurity
String Type of security protocol Integration Server uses when communicating with the SMTP server port. Set to:
*none to use a non-secure mode when communicating with the port on the SMTP sever. This is the default.
*explicit to use explicit security when communicating with the port on the SMTP server. With explicit security, Integration Server establishes an un-encrypted connection to the e-mail server and then switches to the secure mode.
*implicit to use implicit security when communicating with the port on the SMTP server. With implicit security, Integration Server always establishes an encrypted connection to the e-mail server.
truststoreAlias
String Optional. Alias for the truststore that contains the list of certificates that Integration Server uses to validate the trust relationship.If you do not specify a truststore alias, the default truststore alias will be used.
body
String Optional. The content of the message.
mimeStream
java.io.InputStream Optional. MIME or S/MIME message that you want to send in the e-mail. A mimeStream is created by the pub.mime:getEnvelopeStream, pub.smime:createEncryptedData, pub.smime:createSignedData, or pub.smime.keystore:createSignedData services. It contains both headers and content. If the mimeStream already contains the from, to, and subject headers, you do not need to pass them as individual inputs to this service.
attachments
Document List Optional. Attachments to the message. Each attachment defines one message part in a multi-part message.
Key
Description
contenttype
String MIME type of the message. For example:
application/x-edi-message    
content
byte[ ], String, or java.io.InputStream Content of the message.
filename
String Name to assign to the attachment. If you do not specify attachment/content, the parameter specifies the file name of a local file to attach to the message. In other words:
*If you specify attachment/content and attachments/filename, the service uses the value of attachments/filename as the name to assign to the attachment specified by attachment/content .
*If you specify attachments/filename, but not attachment/content, the service attaches the local file specified by attachments/filename.
encoding
String Optional. Encoding of the message. For example: base64 or 7bit. If encoding is not specified, 7bit is used.
charset
String Optional. Character set encoding of the attachment. This value is added to the Content-Type header for the attachment. If charset is not specified, the value in the server configuration parameter watt.server.email.charset is used. If that parameter is not set, the utf-8 encoding is used.
properties
Document List Optional. SMTP system properties to send to the SMTP server. This parameter overrides the settings on the watt.config.systemProperties server configuration parameter. If you omit this properties parameter, Integration Server uses the settings specified on the watt.config.systemProperties server configuration parameter.
Key
Description
name
Name of the SMTP system property.
value
Value to specify for the SMTP property.
Output Parameters
status
String Final status of service.
Usage Notes
Any one of the recipient fields, that is the to, cc, or the bcc parameter, must be defined.
If you are using filename to attach a file to the message and the file is not a plain text file, you must set the contenttype and encoding. For example, to attach IntegrationServer_directory\instances\instance_name\mydir\myfile.doc to a pub.client:smtp service, you would invoke the service with the following values in attachments:
contenttype:application/msword
filename:instances/instance_name/mydir/myfile.doc
encoding:base64
Copyright © 2015- 2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback