--- schema_version: "1" id: 84651fe3d64118c10047cd806e2ba4f481b01edeaa8e9abb3392980dd1ab6a9c title: MEL から DataWeave への移行 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-runtime/4.3/migration-mel.md canonical_url: https://docs.mulesoft.com/jp/mule-runtime/4.3/migration-mel source_site: docs.mulesoft.com content_type: documentation content_hash: 028e34a440955c4238e0be1a684cc5ea310c4e5ea713bba5831d9b4da51760b8 description: MuleSoft Documentation Site release: "4.3" latest: false --- # MEL から DataWeave への移行 Mule 4 では Mule Expression Language (MEL) が DataWeave 式言語に要素に置き換わりました。 このセクションでは、Mule アプリケーションの MEL 式を DataWeave (2.0 以降) に移行するための指針を提供します。 ## [](#dataweave-の概要)DataWeave の概要 DataWeave は、単に値の参照と条件の評価を行う式言語として、または関数や再帰を含む複雑なデータ変換を作成するスクリプティング言語として使用できる Mule 固有の言語です。 MEL とは違い、JSON、XML、CSV など、さまざまなデータ型が標準でサポートされます。つまり、式を評価する前にデータを変更する必要がなくなりました。 また、関数のマッピングやデータの絞り込みなど、高度なユースケースもサポートされています。 DataWeave のメインデータセレクターは ​`.`​ 演算子であることに留意してください。 ほとんどキーワードは MEL と共有されるので、ほとんどのシナリオの構文は同じになります。たとえば、​`#[message.payload.name]`​ は両言語とも同じです。 MEL と DataWeave の主な違いは、DataWeave 式には副作用がないことです。DataWeave を使用してデータを抽出または生成できますが、データを変更することはできません。 それらのユースケースの対処法については、​[Java インテグレーション](https://docs.mulesoft.com/jp/mule-runtime/4.3/intro-java-integration)​の例を参照してください。 ## [](#mel-の使用法)MEL の使用法 以下のセクションでは、MEL の一部の使用法を Mule 4 に適応させる方法を説明します。 ### [](#コンテキスト変数へのアクセス)コンテキスト変数へのアクセス 次の変更を除き、DataWeave ではコンテキスト変数 (Mule Runtime 変数とも呼ばれる) は同じままです。
MEL DataWeave

フロー変数​

flowVars​

  • 例: #[flowVars.myVar]​

Mule イベント変数​

vars​

  • 例: #[vars.myVar]​

例外​

exception​

Mule エラー​:

error​

インバウンド添付ファイル​

message.inboundAttachments​

マルチパートデータ形式​

情報:

インバウンドプロパティ​

message.inboundProperties​

  • 例:

    #[inboundProperties.'http.query.params']
#[inboundProperties]

Mule メッセージ属性​ (メタデータ)

attributes​

  • 例:

    #[attributes.queryParams]
#[attributes.headers]

インバウンドプロパティが属性に​

アウトバウンド添付ファイル​

message.outboundAttachments​

マルチパートデータ形式​

情報:

アウトバウンドプロパティ​

message.outboundProperties​

削除:​

「アウトバウンドプロパティ」​を参照してください。

message.dataType

dataType​

message.id​、​message.rootId​、​message.replyTo

削除​

レコード変数​

recordVars​

  • 例: #[recordVars.myVar]​

Mule イベント変数​

vars​

  • 例: #[vars.myVar]​

セッション変数​

sessionVars​

  • 例: #[sessionVars.myVar]​

削除:​

トランスポートバリアーは Mule 4 には存在しません。情報:

server.dateTime​

削除:​

DataWeave ​now​ 関数を使用する。
### [](#extract_data)データの抽出 [DataWeave セレクター](#dataweave-selectors.adoc)​を使用して、MEL と同様にデータを照会できます。また、JSON などの型に対応するために、さらに変換を行う必要がありません。 以下の例では、次の JSON ペイロードの ID をログに記録します。 JSON ペイロード ```json { "name" : "Rachel Duncan", "id": "779H41" } ``` Mule 3 の例 ```xml ``` Mule 4 の例 ```xml ``` ### [](#値の割り当て)値の割り当て 前述のとおり、DataWeave では、MEL の ​`expression-component`​ で許可されていたようなデータの変更はサポートされていません。そのようなユースケースを実行するには、Scripting Module を使用する必要があります。 Java マップとして記述されている​[前述](#extract_data)​のペイロードを考えてみます。例では、​`name`​ 属性を変更します。 Mule 3 の例 ```xml ``` Mule 4 の例 ```xml payload.put('name', 'R. Duncan') return payload ``` Scripting Module を使用するには、Studio のパレットを使用してアプリケーションに追加するか、​`pom.xml`​ ファイルで次の連動関係を追加します。 ```xml org.mule.modules mule-scripting-module 1.1.0 mule-plugin ``` ### [](#java-メソッドの呼び出し)Java メソッドの呼び出し DataWeave を使用して静的メソッドを呼び出すことができます。通常のメソッドの場合は Java Module を使用できます。このモジュールは操作と関数の両方を公開して Java メソッドを呼び出します。 #### [](#静的メソッド)静的メソッド 以下の例では、Java の Locale ​`getDefault`​ 静的メソッドを Mule 3 と Mule 4 で使用しています。 Mule 3 の例 ```xml ``` Mule 4 の例 ```xml ``` DataWeave では、Java 静的メソッドが検索対象であることを示す ​`java!`​ プレフィックスと、完全修飾された (​`.`​ ではなく、​`::`​ 区切りの) クラス名が必要です。 #### [](#インスタンスメソッド)インスタンスメソッド 以下の例は、Mule 3 と Mule 4 での Java の String ​`equalsIgnoreCase`​ メソッドの使用法を示しています。 Mule 3 の例 ```xml ``` Mule 4 の例 ```xml ``` Java Module を使用するには、Studio のパレットを使用してアプリケーションに追加するか、​`pom.xml`​ ファイルで次の連動関係を追加します。 ```xml org.mule.modules mule-java-module 1.0.0 mule-plugin ``` ### [](#対象の定義)対象の定義 `enricher`​ は削除されて、すべての操作でサポートされる対象変数に置き換わりました。以下の例は、Mule 3 と Mule 4 で操作の結果を変数に送信する方法を示しています。 Mule 3 の例 ```xml ``` Mule 4 の例 ```xml ``` - 詳細は、​[「対象変数を使用したデータのエンリッチ」](https://docs.mulesoft.com/jp/mule-runtime/4.3/target-variables)​を参照してください。 ### [](#xpath-関数)XPath 関数 DataWeave では、​[セレクター](#dataweave-selectors.adoc)​を使用して XML コンテンツを照会できますが、XML Module を使用することもできます。このモジュールは操作と関数の両方を公開して XPath クエリを実行します。 以下の例は、Mule 3 と 4 で、変数から取得された特定の単語を含む行を取得する方法を示しています。 Mule 3 の例 ```xml xpath3('//LINE[contains(.,$word)]',payload,'NODESET') ``` Mule 4 の例 ```xml ``` XML Module を使用するには、Studio のパレットを使用してアプリケーションに追加するか、​`pom.xml`​ ファイルで次の連動関係を追加します。 ```xml org.mule.modules mule-xml-module 1.1.0 mule-plugin ``` ### [](#ワイルドカード関数と正規表現関数)ワイルドカード関数と正規表現関数 DataWeave のマッチング関数 ​`match`​ と ​`matches`​ を代わりに使用できます (コア DataWeave 関数を参照してください)。次の例は、DataWeave で正規表現を使用して、​`wildcard`​ MEL 関数の使用を置き換える方法を示しています。 Mule 3 の例 ```xml ``` Mule 4 の例 ```xml ``` ## [](#関連情報)関連情報 [DataWeave 言語](https://docs.mulesoft.com/jp/mule-runtime/4.3/dataweave) [Why DataWeave is the Main Expression Language in Mule 4 Beta (Mule 4 ベータ版で DataWeave が主要な式言語である理由)](https://blogs.mulesoft.com/dev/mule-dev/why-dataweave-main-expression-language-mule-4/)