Configuring 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.

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 you must configure a data binding for each operation. In these steps, the Use a data format configuration for all operations option is selected.
   Important: 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.

   Table 1. 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.
   Note: 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.