This topic applies only to the IBM Business Process Manager Advanced configuration.

Creating parameter mappings

Using the interface map editor, you can create the following parameter mapping types: Assign, Custom, Extract, Map, and Move.

About this task

When you create parameter connections, note the following points:

Source Input parameters can be connected only to target Input parameters
Target Output parameters can be connected only to source Output parameters
Target Faults can be connected only to source Faults

The following topics discuss when to use each type of parameter mappings:

Creating mappings to assign specific values to parameters
When a constant value must apply to a certain input or output/fault parameter, use the Assign parameter mapping. The Assign parameter mapping does not connect two parameters, it is connected to only one parameter.
Creating mappings to extract a type nested in a complex type
When you need to extract a type nested in a complex type, use the Extract parameter mapping. For example, you could have a business object representing "address" and use an Extract parameter mapping to map to a string-typed parameter "countryIN". An Extract parameter mapping pulls out the pertinent information from a complex parameter to reconcile it with output parameters. An extract parameter mapping can have only one input, but can feed multiple outputs.
Creating mappings to reconcile complex type parameters
When you have two business objects that need to be reconciled, use the Map parameter mapping. For example, you may have one business object that has five fields and one that has three fields, and the fields may have different names. By creating a Map parameter mapping, you can reconcile the differences between these two business objects. Note that Map parameter mappings can have multiple inputs and multiple outputs.
Creating mappings for same type parameters
To make a simple connection, use the Move parameter mapping. A Move parameter mapping can only be created between parameters of the same type. For example, the source and target parameter would both have the type "string" or both have the type "double" for the Move mapping to work. Note though that a Move parameter mapping may also be used between business objects of the same type, not only between simple types.
Creating Custom parameter mappings
This type of parameter mapping is employed so that arbitrary Java code can be introduced (or called out) when an interface map is invoked. Custom parameter mappings can take any parameter and change it as needed. For example, you can use the Custom parameter mapping to reconcile a simple type parameter with a business object parameter where the Java code will create an instance of business object and populate it according to the value of the simple type. A Custom parameter mapping can have only one input, but can feed multiple outputs.