Data Handler mediation primitive properties

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15

You can specify values for mediation primitive properties either by using the property fields in the IBM® Integration Designer user interface or by using an XML format. The property field names displayed in IBM Integration Designer are generally different from the property names used when building a mediation flow using XML code. In the following information, icons are used to identify each property name used in IBM Integration Designer and the corresponding XML name. (Where applicable, XML names that are required, but not shown in IBM Integration Designer, are also described.)

Data handler configuration dataHandlerConfig

Specify the Data handler configuration which the primitive should use, as created by the binding resource configuration wizard. The Data handler configuration will be used at run time to select the correct data handler to be invoked and pass in any associated parameter values.

Field detail	Value and notes
Required	Yes
Valid values	String Note:

Output message field refinements typeMap

You can use the Output Message field refinements property to specify which fields in the message are refined using more specific type information. By default, this property is empty.

Field detail	Value and notes
Weakly typed field path Specify the XPath of the weakly-typed field you want to refine. Actual field type assertedType Specify the data type you want to use for the refinement.

Action action

Convert from native data format to a business object calls the transform method of the data handler to deserialize the data. Convert from a business object to native data format calls the transformInto method of the data handler to serialize the data.

Field detail	Value and notes
Required	Yes
Valid values	Convert from native data format to a business object 0 Convert from a business object to native data format 1 Note:
Default	Convert from native data format to a business object

Source XPath sourceXPath

The location of the object, in the source SMO, that should be passed into the data handler, for example, /body/operation1/input1/value.

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:

Target XPath targetXPath

The location, in the target SMO, where the output from the data handler should be stored. (The target SMO is defined as the type of the output terminal.)

Field detail	Value and notes
Required	Yes
Valid values	XPath Note:

Sample XML code

<node name="DataHandler1" type="DataHandler">
  <property name="dataHandlerConfig" value="{http://www.ibm.com/xmlns/prod/
  websphere/j2ca/configuration/6.1.0}UTF8XMLDataHandler"/>
  <property name="sourceXPath" value="/body/myRequestMsg/native"/>
  <property name="targetXPath" value="/body/myRequestMsg/inflated"/>
  <inputTerminal/>
  <outputTerminal/>
  <failTerminal/>
</node>