Nav

Set Payload Transformer Reference

This transformer sets the payload to whatever you define. The payload can be a literal string or a Mule Expression.

Configuration

set_payload

Field Description

Display Name

Customize to display a unique name for the transformer in your application.

Value: Set Payload
XML: doc:name="Set Payload"

Value

Enter a literal string or a Mule expression that defines how Mule should set the payload.

Value: String or Mule Expression
XML: value="#['Hello, ' + message.payload]"


    
            
         
1
2
3
4
5
6
7
# Example setting a payload to a literal string.
 
<set-payload value="MyNewPayload" doc:name="Set Payload"/>
 
# Example setting a payload using a Mule expression. This takes the current payload and transforms it by adding the string "Hello " in front of it. Thus, if your payload was "Charlie", this set-payload transformer changes it to "Hello, Charlie".
 
<set-payload value="#['Hello, ' + message.payload]" doc:name="Set Payload"/>
Element Description

set-payload

Set a payload on your message (as shown in examples above).

Element Attribute Description

value

The literal string or Mule expression that defines how Mule should set the payload.

doc:name

Customize to display a unique name for the transformer in your application.

Note: Attribute not required in Mule Standalone configuration.

Example

In this example, the Set Payload transformer sets the payload to a "Hello, World" message that includes today’s date (retrieved using a Mule expression.)

set+payload+flow

The following example sets the Set Payload to:
#['Hello World!' + ' Today is ' + server.dateTime.format('dd/MM/yy')]

This displays: "Hello World! Today is <today’s date>"

set+payload


    
            
         
1
imclude::_souces/set-payload-transformer-reference.xml[]

See Also