Using Email Adapters with Ensemble
Settings for the Email Outbound Adapter
[Back] 
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Provides reference information for settings of the settings outbound adapter.
Summary
The outbound email adapter has the following settings:
Group Settings
Basic Settings SMTP Server, SMTP Port, Credentials
Connection Settings SSL Configuration
Additional Settings Recipient, Cc, Bcc, From, ContinueIfInvalidRecipient
The remaining settings are common to all business services. For information, see Settings for All Business Services in Configuring Ensemble Productions.
Bcc
Specifies a comma-separated list of email addresses to add to the Bcc: list of each mail message sent.
Cc
Specifies a comma-separated list of email addresses to add to the Cc: list of each mail message sent.
ContinueIfInvalidRecipient
If selected, the adapter continues to send the message if one or more of the recipients have an invalid address.
Credentials
The ID of the Ensemble credentials that can authorize a connection to the given server. For information on creating Ensemble credentials, see Configuring Ensemble Productions.
From
The default From: address to put in mail messages. May be overridden by the business operation implementation code.
Recipient
Specifies a comma-separated list of email addresses to add to the To: list of each mail message sent.
SMTP Port
The port on the SMTP server to send mail to. The default value is 25.
SMTP Server
The IP address of the SMTP server to send mail to. (Note: the timeouts for connecting and sending mail can be more than 10 minutes).
SSL Configuration
The name of an existing SSL/TLS configuration to use to authenticate this connection. Choose a client SSL/TLS configuration, because the adapter initiates the communication.
To create and manage SSL/TLS configurations, use the Management Portal. See the chapter Using SSL/TLS with Caché in the Caché Security Administration Guide. The first field on the Edit SSL/TLS Configuration form is Configuration Name. Use this string as the value for the SSLConfig setting.
If your SSL configuration requires a private key password, include that in the SSL Config setting. To do so, add a vertical bar character | after the configuration name, followed by the password. For example: MySSLItem|mypassword.
When you specify a value in this setting, the normal case is that outbound email opens a socket on default port 465 and uses SMTP over TLS/SSL. The SSL Config setting also supports the special case when you want the server interaction to begin on a normal TCP socket and then switch to SSL/TLS on the same port as the normal socket. (RFC3207 provides the details.) In this case the default port is 25 for SMTP. To use this convention, append an asterisk (*) to your entry. For example: MySSLItem* or MySSLItem|mypassword*.
For further information, see the description of the SSLConfig property in the Class Reference entry for EnsLib.EMail.OutboundAdapter.