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 inbound processing

Configure the data binding

Data bindings read the fields in a business object and fill the corresponding fields in an email. In the external service wizard, you add a data binding to your module and configure it to correspond with your data type. This way, the adapter knows how to populate the fields in an email with information it receives in the business object.

You must have entered service configuration properties for the connection to the mail server.

To add and configure a data binding for the module, follow this procedure.

You can configure data bindings before running the external service wizard by using IBM Integration Designer. To do this configuration, select New > Configure Binding Resource in IBM Integration Designer and complete the data binding windows described in this documentation.


Procedure

  1. In the Specify the Security and Configuration Properties window, select a value for the Data format options from the list. You can choose to use the data binding configuration for all operations or you can choose to specify a data binding for each operation. If you use the data binding configuration for all operations, then the data binding configured here is used as the default data binding configuration for all the operations.

    If you choose to specify a data binding for each operation, then configure a data binding for each operation. In these steps, the Use a data format configuration for all operations option is selected.

    If associate your inbound module with a particular user-defined business object type, the steps for defining your data binding in this section dictates which events the adapter processes at run time. At run time, inbound events that are symmetric to the custom data type are processed by the adapter. Those events that are not symmetric to the custom data type are not processed. For these events, the adapter throws an exception and logs an error message.

  2. In the Data format field, click Select.

  3. In the Select a Data Format Transformation window, select the Use existing data format transformation from the list option to use one of the data bindings included with IBM Integration Designer. Click Next. The Select your custom data format transformation from the workspace option is available for advanced users who want to use a custom data binding. A custom data binding, once placed in the class path, shows when this option is selected.

    Figure 1. Selecting a data binding

    The following data types are matched with the following data bindings.

    Data types and their data binding equivalents
    Data type Data binding
    Generic email Email Wrapper Data Binding
    Generic email with business graph Email Wrapper Data Binding
    User-defined email business object EmailFixedStructureDataBinding

  4. In Specify the Data Transformation Properties window, click Next.

    This window is used for configuring the data handlers.

  5. In Configure a New Data Transformation window, provide the data binding configuration details.

    1. In the New Data Binding Configuration window, the Module defaults to the module name you typed earlier in the wizard. To create a data binding for a different module, select New to create a module.

      Figure 2. Naming the data binding configuration

    2. If you want to select a new folder for the artifact, click Browse and select a new folder location. If you do not browse for a new folder location, the artifacts are created in the root directory for the module.
    3. Type a Name for the data binding configuration and click Finish.

    The data binding class name populates in the Specify the Security and Configuration Properties window.


Results

A data binding is configured for use with the module.


What to do next

Specify data binding properties.

Configure the module for inbound processing


Previous topic: Selecting a data type and operation name


Next topic: Configure business object properties and data handlers