Connecting multiple input elements to a transform

To make additional input data available to a transform, you can add additional connections. You must define the connection type as either Primary or Supplement. A Primary connection controls the type and outcome of the transform. A Supplement connection does not change the type of the transform; it can be used to provide additional input to the transform, or in an optional condition on the transform.

The following steps show how to connect multiple input elements to a transform by using the drag and drop method:

1. Move your cursor to the element of the input object that you want to map:

   

2. Click anywhere in the input element, or on its grab handle icon , and drag the connection to the output element. A connection is created between the two elements, and a transform is assigned, based on the number and type of input elements.

   

3. Create a new connection between a second input element and the transform.

   

   When you define an additional connection between a second input element to an existing transform in your message map, you are prompted to specify if the connection is a primary connection or if it is a secondary connection (also known as a supplement connection).

4. Specify the type of the new connection as either a primary connection or a secondary connection (Supplement). If you specify a primary connection, the default transform changes to one that allows multiple primary inputs, such as Local Map, Concat, or Join.

   For example:

   

   If you choose supplement connection, the transform type is not changed and the additional connection is available to use within the transform. For example, you could use its value in a condition expression, or for nested transforms, such as For each, Join, or Local map. The additional input now appears as an extra source on the left side within the nested mapping.