Choosing a transform to map an input message to multiple output messages

You can create a map that takes a single input message and produces either multiple instances of an output message model, or one or more instances of different output message models.

About this task

When you create a map in the New Message Map wizard, you can only select a single input and a single output. However, you can use the Add output button in the Graphical Data Mapping editor to add additional outputs.

Note: You can only split an input message into multiple output messages in main maps. This is not valid in submaps.

Procedure

Choose any of the following options to split a message in your map:

  • To produce multiple instances of a particular output message, you can use the For Each transform or the Join transform.

    A typical use of this function is message splitting, in which an input batch message is divided into individual record messages.

    When you run the map, a new message is propagated for each iteration of the For Each or Join transform.

    For more information, see Splitting an input message into multiple output messages.

  • To produce one or more instances of different output messages, you can use the If/Else transform.

    When you run the map, a new message is propagated for each conditional transform that is applied.

    For more information, see Mapping an input message into different output messages.