IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > Email > Configure the module for deployment > Configure the module for outbound processing > Configure the module using the user-defined data type

Setting deployment and runtime properties for user-defined data type

To select and configure your module for outbound or inbound communication with the mail server, you specify the configuration properties using the external service wizard in IBM Integration Designer. Then, configure the managed connection factory properties. Managed connection factory properties are stored in the business object and contain the information the adapter needs to make the connection between the outbound module and the mail server.

To perform this task, create a module. The module name is displayed in the Project Explorer view of IBM Integration Designer.

To set connection properties, follow this procedure. See Managed connection factory properties.


Procedure

  1. In the Select the Processing Direction window, select Outbound and click Next.

    Figure 1. Selecting inbound or outbound in the external service wizard

    The Specify the Security and Configuration Properties window is displayed.

  2. In the Deploy connector project field, specify whether to include the adapter files in the module. Select one of the following values:

    • With module for use by single application: With the adapter files embedded in the module, you can deploy the module to any application server. Use an embedded adapter when you have a single module using the adapter or if multiple modules need to run different versions of the adapter. Using an embedded adapter enables you to upgrade the adapter in a single module without the risk of destabilizing other modules by changing their adapter version.

    • On server for use by multiple applications: If you do not include the adapter files in a module, install them as a stand-alone adapter on each application server where you want to run the module. Use a stand-alone adapter when multiple modules can use the same version of the adapter and you want to administer the adapter in a central location. A stand-alone adapter can also reduce the resources required by running a single adapter instance for multiple modules.

  3. Under the E-mail system connection information, type the Host name. The properties on this window correspond to the managed connection factory properties. For detailed information about these properties, see Managed connection factory properties.

    Figure 2. Security and configuration properties window

  4. Type the Port number. The default value for the SMTP protocol is 25. If your SMTP mail server is listening on a different port number, change this value.
  5. Clear the Select when antivirus or firewall software is running check box if you do not want the adapter to close the managed connection after each outbound request. If an antivirus program or firewall is running on your system (the machine on which the adapter is deployed or the one that hosts the mail server) and this check box is cleared, the adapter might fail to send outbound emails. Leaving this check box selected is recommended.

  6. Click Advanced and expand the Additional properties, Logging and tracing , or Bidi properties sections as needed.

    • Additional configuration

      1. Select Enable transport security (SSL) check box to specify if secure socket layers are enabled for outbound communication. See Secure connection (SSL) (enableSSL).

      2. In the Alternate e-mail ID in case of delivery failure field, specify an alternate email address to receive undeliverable mail notifications. This email address can be a different email address than the one you specified in the From email address. For more details about this property, see Alternate email ID in case of delivery failure.

      3. In the Maximum retries in case of system connection failure field, type the number of times the adapter tries the connection before reporting a polling error. See Maximum retries on connection failure (connectionRetryLimit).

      4. In the Connection retry interval (in milliseconds) field, specify the time interval between the attempts to reconnect to the mail server if the connection fails. See Retry interval if connection fails (in milliseconds) entities.

    • Logging and tracing

      1. If you have multiple instances of the adapter, expand Logging and tracing and enter a value in the Adapter ID field that is unique for this instance. For more information about this property, see Resource adapter properties.

      2. If you want to mask certain information so that the information is not displayed in the logs or traces, select Disguise user data as "XXX" in log and trace files. See Disguise user data as "XXX" in log and trace files (HideConfidentialTrace).
    • Bidi properties

      1. Select the Bidi transformation check box to specify bidirectional format. For more information about setting the Bidi properties, see Globalization.

  7. In Service properties, specify how you want the adapter to connect to the mail server by selecting any one of these authentication methods.

    • To use a J2C authentication alias, click Using an existing JAAS alias (recommended) and type the name of the alias in the J2C Authentication data entry field.

      You can either specify an existing authentication alias or create one at any time before deploying the module. The name is case-sensitive and includes the node name.

    • To use the security properties from the managed connection specification, click Using security properties from the managed connection factory enter the following information:

      • In the User name field, type the user name for the mail server.

      • In the Password field, type the password for the mail server.

        The security properties are not encrypted and stored as plain text. If you are using an authentication alias, a user name and password are not necessary. Also, for outbound communication you do not need to enter a user name and password because a mail server uses an anonymous user name and password to send the emails.

    • To administer the user name and password from another mechanism, click Other.

  8. Select the Change logging properties for wizard check box, if you want to define the level of logging for this module.

  9. For Data format, select Specify a data binding for each operation. Although the default value is Use a data binding configuration for all operations, select Specify a data binding for each operation, because the adapter has a different data binding for each supported business object. These data bindings have different properties, and are configured differently.

    Important: Do not click Next in this window until you complete the steps to create a data binding or browse for an existing one.


What to do next

Select the data type and operation name.

Configure the module using the user-defined data type


Related concepts:

Outbound processing


Related tasks:

Setting deployment and runtime properties for simple email data type

Setting deployment and runtime properties for generic email data type


Related reference:

Managed connection factory properties

Resource adapter properties

Interaction specification properties

Connection properties for the external service wizard