Set Payload (<set-payload/>)

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

メッセージのペイロードを設定または更新します。

ペイロードは、文字列リテラルまたは DataWeave 式です。​set-payload​ コンポーネントは、シンプルな式または変換にのみ使用してください。 複雑なシナリオの場合は、​Transform Message コンポーネント​を使用します。

コンポーネント XML

このコンポーネントは、次の XML 構造をサポートします。

<set-payload
  value=""
  doc:name="Set payload"
  doc:id="vnjpqo" />
<set-payload/>​ Attributes 説明

doc:name

コンポーネントの編集可能な名前。

doc:id

コンポーネントの自動生成された識別子。

value

文字列リテラルまたはペイロードの設定方法を定義した DataWeave 式を指定できます。例: "some string"​ または ​#[now()]​。この属性は必須です。

resource

DataWeave 変換スクリプトが格納された ​.dwl​ ファイルを参照します。これらの値は (動的ではなく) 静的に解決されます。たとえば、​<ee:set-payload resource="myscript-$site.dwl"/>​ を使用するとエラーが発生します。

mimeType

ペイロードに割り当てる値の MIME タイプ。例: text/plain​ または ​application/json​。

encoding

ペイロードに割り当てる値のエンコード方式。例: UTF-8

mimeType​ 属性と ​encoding​ 属性は、​value​ に指定された DataWeave 式には影響しません。これらの属性は、​出力​される Mule メッセージにのみ影響します。変換が必要な場合には、DataWeave 式に明示的な​出力​ディレクティブを指定する必要があります。

次の例は、静的な値または DataWeave 式を使用してペイロードを設定する方法を示しています。

例: 静的な値を使用したペイロードの設定

次の例では、静的な値を使用してペイロードを設定します。

<set-payload value="{ 'name' : 'Ana', 'office' : 'BA' }" mimeType="application/json" encoding="UTF-8"/>

例: DataWeave 式を使用したペイロードの設定

次の例では、メッセージのペイロードを​「Hello, World」​という文字列リテラルと、​#['Hello World!' ++ ' Today is ' ++ now()]​ という DataWeave 式を使用した今日の日付に設定しています。

<set-payload value="#['Hello World!' ++ ' Today is ' ++ now()]"/>