Setting Integration Gateway Properties for Gateway-Based Transformations

To apply gateway-based transformations, set the following properties in the integrationGateway.properties file.

For each message you want to transform, you must create a set of property entries using the same number, which associate a given transformation program with that message. However, you can specify the same transformation program for multiple messages.

When entering these settings, each transformation must be numbered for identification, using the convention ig.transform1, ig.transform2, ig.transform3, and so on.

Property Description

ig.isGatewayTransformationEnabled

Specify whether transformation is enabled for this gateway. Valid values are:

  • TRUE. Transformation is enabled.

  • FALSE. Transformation is disabled — the integration gateway will ignore the other transformation properties. This is the default value.

ig.DefaultServer.LocalNode

Enter the name of the node definition that will be used as the source or destination node for a given transformation if either of those values isn’t identified; for example you must specify:

ig.DefaultServer.LocalNode=DEF_NODE

All transformations require that you specify both a source node and a destination node. This property applies if either the ig.transformN.SourceNode property or the ig.transformN.DestinationNode property is empty or invalid, or if the IBRequest doesn’t specify either RequestingNode or DestinationNode.

ig.transforms

Specify the number of transformations configured in the integrationGateway.properties file; for example:

ig.transforms=7

ig.transformN.XSL

Enter the full path and filename of transformation program N.

Your path specification must use either double back slashes or single forward slashes as separators; for example:

ig.transform4.XSL=C:\\XSLProgs\\MyTransform.xsl
ig.transform4.XSL=C:/XSLProgs/MyTransform.xsl
ig.transform4.XSL=/usr/xsls/MyTransform.xsl

ig.transformN.MessageName

Enter the name of the message to be transformed by transformation program N; for example:

ig.transform4.MessageName=MY_MSG_A

ig.transformN.SourceNode

Enter the name of the source node from which the original message is being sent, or enter the value ANY; for example:

ig.transform4.SourceNode=NODE_Aig.transform4.
SourceNode=ANY

If this value is ANY, the value of the ig.DefaultServer.LocalNode property will be used instead.

ig.transformN.DestinationNode

Enter the name of the target node to which the transformed message is being sent, or enter the value ANY; for example:

ig.transform4.DestinationNode=NODE_Big.transform4.
DestinationNode=ANY

If this value is ANY, the value of the ig.DefaultServer.LocalNode property will be used instead.

ig.transformN.DestinationMessageName

(Optional.) Enter the name that the target node uses for the transformed version of the message, if it’s different from the original message name; for example:

ig.transform4.DestinationMessageName=MY_MSG_B

This enables the gateway to rename the message before sending it, so the target node will recognize and accept it.