Splitting multipart messages

If you need to map individual parts of a multipart message, you must split the message first.

Before you start:

To enable a Mapping node to propagate messages:
  1. Right-click the node in the editor view and select Properties.
  2. In Mapping Mode, select LocalEnvironment.

If a message arrives that consists of sub-units, each with a different format, each sub-unit can be converted separately, then re-assembled for transmission. The Mapping node can take multipart messages as input and all message parts in a message set using the MRM domain parser can be split (or propagated). This means that everything that is to be propagated must have an associated MRMessage. The following steps show you how to propagate a multipart message.

  1. Right-click the MRMessage in the Source pane of the Mapping Editor and click Propagate.
  2. Specify parameters to propagate the message in the Create a Message to Propagate dialog.
To modify or remove propagated messages:
  1. In the Outline view, right-click on the Propagate Message that you want to modify or remove.
  2. Click Modify Message Propagation or Remove Message Propagation in the pop-up menu.
Note: You cannot perform a transformation on a propagated message. If you want to split a message and transform it, use two mapping nodes, one for each task.

Multipart messages can contain repeating embedded messages. Each repeated instance of a message is propagated separately. The output propagated message must belong to the same message set as the input and embedded messages must be from the same message set as the parent message.

Related concepts
Mappings
Message mapping
Related tasks
Creating a multipart message
Related reference
Mapping node