---
schema_version: "1"
id: 56b4d5df5c55ff0500dfbbd1e3d1b7f1ae660272a54cf68b547948ad1ad352b5
title: Anypoint Code Builder での DataWeave 式と変換の使用
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/anypoint-code-builder/int-configure-dw-expressions.md
canonical_url: https://docs.mulesoft.com/jp/anypoint-code-builder/int-configure-dw-expressions
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 56587df8dad25167b95ddaa248a4cd8f98404c36536e1be568948c194e597df2
description: MuleSoft Documentation Site
latest: true
---
# Anypoint Code Builder での DataWeave 式と変換の使用

DataWeave は、データ変換と式の定義のための MuleSoft プログラミング言語です。DataWeave を使用して、コネクタ操作やその他のコンポーネントで、​`payload`​、​`attributes`​、​`vars`​ などの Mule イベントデータを処理します。​**式項目**​、​**式ビルダー**​、または​**変換ビルダー**​を使用するか、設定 XML を編集して、Mule アプリケーションで DataWeave 式と変換を開発します。入力および出力サンプルデータまたはメタデータを提供することで、AI を使用して DataWeave 変換を生成します。

![1) 式項目の fx ボタン、2) 式ビルダーボタン、3) 変換ビルダーボタンの 3 つの番号付きコールアウトが表示されている設定パネル](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-transform-ui.png)

<table><tbody><tr><td><i class="conum" data-value="1"></i><b>1</b></td><td><strong>式項目</strong>​: コンポーネント設定パネルに DataWeave 式またはスクリプトを入力します。</td></tr><tr><td><i class="conum" data-value="2"></i><b>2</b></td><td><strong>式ビルダー</strong>​: Mule アプリケーション内で式を作成および管理します。</td></tr><tr><td><i class="conum" data-value="3"></i><b>3</b></td><td><strong>変換ビルダー</strong>​: AI 支援の視覚的インターフェースで、Mule アプリケーションの DataWeave 変換を作成します。</td></tr></tbody></table>

Anypoint Code Builder での実装とインテグレーションにより、Mule Runtime Engine のインスタンスで実行される Mule アプリケーションが作成されます。

Anypoint Code Builder は、DataWeave 式と変換を Mule アプリケーション開発プロセスに統合し、次の機能をサポートします。

- 階層マッピング
- オブジェクト間および配列間の変換
- 文字列、数値、ブールの連結
- データ型の変換

Anypoint Code Builder では、次の変換マッピングユースケースがサポートされています。

- `Object`​ から ​`Object`
- `Primitive`​ から ​`Primitive`
- `Object`​ から ​`Primitive`
- `Primitive`​ から ​`Object`
- `Object`​ から ​`Array`
- `Array`​ から ​`Object`
- `Object`​ から ​`Object`​ のデータ型の変換
- シンプルな項目の連結
- `Array`​ から ​`Array`​ (同レベル)

## [](#prereq-dw-transforms)始める前に

- DataWeave 式の関数、演算子、変数、セレクターを理解します。
    
    詳細は、[DataWeave Reference](https://docs.mulesoft.com/dataweave/latest/dw-functions)を参照してください。
- IDE が提供する関数の組み込みドキュメントを確認します。例については、​[DataWeave 関数のリストの表示およびドキュメントの取得](#tab-functions)​を参照してください。
    
    - [定義済みの Mule イベント変数](https://docs.mulesoft.com/dataweave/latest/dataweave-variables-context)​ (​`payload`​、​`attributes`​、​`vars`​ など)。
    - [DataWeave セレクター](https://docs.mulesoft.com/dataweave/latest/dataweave-selectors)​。​[Mule イベント](https://docs.mulesoft.com/mule-runtime/latest/about-mule-event)​内のペイロード内の項目、属性、または変数の値を取得します。
        
        その他のリソースについては、[DataWeave Overview](https://docs.mulesoft.com/dataweave/latest/)を参照してください。
- Anypoint Code Builder AI 機能を使用するには、次の権限があることを確認します。
    
    - Anypoint Code Builder Developer (Anypoint Code Builder 開発者)
    - Mule Developer Generative AI User (Mule 開発者生成 AI ユーザー)
- \[Access Management (アクセス管理)\] で Einstein を有効にします。詳細は、​[「Enabling Einstein for Anypoint Platform (Anypoint Platform での Einstein の有効化)」](#access-management::enabling-einstein.adoc)​を参照してください。
- AI 支援変換で問題がある場合は、​[AI 支援変換のトラブルシューティング](#troubleshoot-ai-assisted-transformations)​を参照してください。

## [](#open-fx-field)式項目を開く

ほとんどのコネクタ操作およびコンポーネントで、DataWeave 式とスクリプトを受け入れる 1 つ以上の項目が提供されます。コンポーネントの設定パネルの ​**\[fx\]**​ ボタンは、項目が式を受け入れることを示します。XML では、これらの項目には ​`#[]`​ マークアップが含まれます。式項目は、DataWeave 関数と Mule イベントデータ (​`payload`​、​`attributes`​、​`vars`​ など) を含め DataWeave 式を受け入れます。

コンポーネントの式項目 (​**fx**​) を開く手順は、次のとおりです。

1. 実装またはインテグレーションプロジェクトのキャンバスから、式を受け入れるコンポーネントを開きます。
2. **\[fx\]**​ をクリックして、項目を文字列項目から式項目に変更します。
    
    ![\*\[値\]\* 項目の横にある \*\[fx\]\* ボタンが強調表示されている \[変数を設定\] コンポーネント設定パネル](_images/int-dw-fx-field-set-variable.png)
    
    XML では ​**fx**​ 項目にマークアップ ​`#[]`​ も表示されるため、式の項目であることが示されます。
    
    <set-variable variableName="variableName" value="#\[\]"
                  doc:name="Set variable" doc:id="ndpiap" />
3. コンポーネントを設定するには、​**式ビルダー**​をクリックします。
    
    ![\*式ビルダー\*インターフェースの \[Set Variable (変数を設定)\] コンポーネントに DataWeave 式を作成するための \*\[Data (データ)\]\*、\*\[Functions (関数)\]\*、および \*\[Preview (プレビュー)\]\* タブが表示されています](_images/int-dw-fx-expression-builder.png)
    
    **\[Data (データ)\]**​、​**\[Functions (関数)\]**​、​**\[Preview (プレビュー)\]**​ タブを使用すると、コンポーネントの式を容易に設定できます。外部ソースのデータで Mule アプリケーションを実行せずに、式の出力をプレビューします。
    
    - [データ構造の確認](#tab-data)
    - [DataWeave 関数のリストの表示およびドキュメントの取得](#tab-functions)
    - [DataWeave 式の出力のプレビュー](#tab-preview)

## [](#open-expression-builder)式ビルダーを開く

**式ビルダー**​を使用すると、Mule アプリケーション内で式を作成および管理するプロセスが簡略化されます。ビルダーでは、DataWeave 式と変換を作成するための視覚的インターフェースが提供されます。

### [](#tab-data)データ構造の確認

ペイロード、属性、Mule 変数を含め Mule イベントのデータ構造を確認するには、​**\[Data (データ)\]**​ タブを使用します。サンプルデータが含まれるこのタブは、コンポーネントの ​**fx**​ 項目の​**式ビルダー**​に含まれます。次に例を示します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top"><strong>[Data (データ)]</strong>​ タブ (自動生成データを含む)</th>
<th class="tableblock halign-left valign-top"><strong>[Data (データ)]</strong>​ タブ (拡張済み)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-data-tab.png" alt="&quot;式項目の [Data (データ)"></span> タブ"]</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-data-tab-attributes.png" alt="&quot;式項目の [Data (データ)"></span> タブとモック属性"]</p>
</div></div></td>
</tr>
</tbody>
</table>

自動生成された文字列はモック値として表示され、​[\[Preview (プレビュー)\]](#tab-preview)​ タブなどにプレビューの出力を生成するために使用されます。例の属性メタデータキーはフローの ​`HTTP Listener`​ コンポーネントの設定から取得されます。

**\[Input/Output (入力/出力)\]**​ タブには、データ入力 (​**Input (入力)**​) コンポーネントとデータ出力 (​**Output (出力)**​) コンポーネントの構造が表示されます。次に例を示します。

!["コンポーネントの \[Input/Output (入出力)](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-fx-input-output-sample.png) タブ"\]

### [](#tab-functions)DataWeave 関数のリストの表示およびドキュメントの取得

コンポーネントの ​**\[Functions (関数)\]**​ タブ、​**fx**​ 項目、または XML エディターのオートコンプリートメニューから使用可能な関数のリストを取得する手順は、次のとおりです。

1. **fx**​ 式項目を持つコンポーネントを開きます。
    
    案内については、​[式項目を開く](#open-fx-field)​を参照してください。
2. 使用可能な関数のリストを表示します。
    
    - 空の ​**fx**​ 項目からコアモジュールの DataWeave 関数のリストを表示するには、​_空_​の ​**fx**​ 項目内で Ctrl+Space を押します。次に例を示します。
        
        ![DataWeave オートコンプリートドロップダウンメニューに、abs、avg、ceil、floor などの使用可能な Core モジュール関数とその説明が表示されています](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-fx-field-autocomplete.png)
    - `String`​ モジュール、​`Array`​ モジュール、​`Core`​ モジュールなど、すべての ​[DataWeave モジュール](https://docs.mulesoft.com/dataweave/latest/dw-functions#dw_modules)​から関数を表示する手順は、次のとおりです。
        
        1. **fx**​ 項目をクリックして、​**式ビルダー**​を開きます。
        2. **\[Functions (関数)\]**​ タブをクリックします。
            
            <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">DataWeave 関数</th>
<th class="tableblock halign-left valign-top">関数リファレンス</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>関数にマウスポインターを置くと、短い説明が表示されます。</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-functions-tab.png" alt="&quot;式ビルダーの [Functions (関数)"></span> タブに、検索機能を備えた Array、Core、Object、String モジュールを含む分類済み DataWeave 関数が表示されています"]</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>[Details (詳細)]</strong>​ をクリックすると、完全なドキュメントが表示されます。</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-functions-tab-details.png" alt="関数の詳細ポップアップに、構文、パラメーター、使用例など、DataWeave 関数の完全なドキュメントが表示されています"></span></p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#tab-preview)DataWeave 式の出力のプレビュー

キャンバスまたは XML エディターで DataWeave 式の出力をプレビューします。プレビュー機能の動作は、​**fx**​ (式) 項目のペイロード (​`payload`​) や Mule 変数 (​`vars.somevar`​ など) の設定 XML から提供されたサンプルデータに基づきます。

独自のサンプルデータを提供するには、​[DataWeave 式のサンプルデータを提供する](#sample-data)​を参照してください。

- [UI での結果のプレビュー](#preview-results-fx)
- [XML エディターからの結果のプレビュー](#preview-results-xml)

#### [](#preview-results-fx)UI での結果のプレビュー

自動生成されたサンプルデータをプレビューするか、独自のサンプルデータをプレビューします。出力は、コンポーネントの式項目の​**式ビルダー**​の ​**\[Preview (プレビュー)\]**​ タブでプレビューします。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">自動生成されたサンプルデータのプレビュー</th>
<th class="tableblock halign-left valign-top">サンプルデータのプレビュー</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>自動生成されたサンプルデータからの出力結果</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-preview-tab.png" alt="&quot;自動生成されたサンプルデータを使用した DataWeave 式の出力が表示されている式ビルダーの [Preview (プレビュー)"></span> タブ"]</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーが作成したサンプルデータを使用した式からの出力結果</p>
</div>
<div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/anypoint-code-builder/_images/int-dw-fx-preview-tab-output.png" alt="&quot;ユーザーが提供したサンプルデータを使用した DataWeave 式の評価結果が表示されている式ビルダーの [Preview (プレビュー)"></span> タブ"]</p>
</div></div></td>
</tr>
</tbody>
</table>

DataWeave セレクターと関数をサンプルデータに適用することができます。想定される構造とデータ型を持つサンプルデータを作成するには、​[DataWeave 式のサンプルデータを提供する](#sample-data)​を参照してください。

#### [](#preview-results-xml)XML エディターからの結果のプレビュー

設定 XML から結果をプレビューするには、DataWeave コードにマウスポインターを置いて ​**\[Show Code Actions (コードアクションを表示)\]**​ アイコンをクリックし、​**\[Run Preview (プレビューを実行)\]**​ をクリックします。

![XML エディターの \[Code Actions (コードアクション)\] メニューで、DataWeave 式を実行するための \[Run Preview (プレビューを実行)\] オプションが強調表示されています](_images/function-validation-run-preview.png)

Anypoint Code Builder では、関数の結果を含む新しい ​**\[Preview Output (出力をプレビュー)\]**​ タブが開きます。

![JSON 形式の出力で DataWeave 関数の実行結果が表示されている \[Preview Output (出力をプレビュー)\] タブ](_images/dataweave-function-preview-output.png)

## [](#open-transformation-builder)変換ビルダーを開く

Einstein 生成 AI 支援の​**変換ビルダー**​を使用して、Mule アプリケーションで DataWeave 変換を作成します。DataWeave スクリプトを生成するために、入力および出力のサンプルメタデータまたはデータを提供します。

![\*変換ビルダー\*ウィンドウとその強調表示されたセクション](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-transform-builder-ui.png)

**変換ビルダー**​で、ニーズに最適なオプションを選択します。

- [Map with AI (AI を使用したマップ)](#map-with-ai)
- [Map and Transform with AI (AI を使用したマップと変換)](#map-and-transform-with-ai)

### [](#considerations-for-transformation-builder-with-ai)AI 支援変換に関する考慮事項

AI 支援変換を使用する場合は、次の考慮事項を評価します。

- メタデータは、出力の形状を提供します。
- サンプルデータは、計算、条件、その他の操作のための関数または式を生成するためのコンテキストを提供します。サンプルデータを含む Web Services Description Language (WSDL) ファイルを提供できます。サンプルデータでサポートされているデータ形式 (MIME タイプ) については、​[DataWeave 式のサンプルデータを提供する](#sample-data)​を参照してください。
- AI では、変換スクリプトを作成するために有効なデータが必要です。必要に応じて、手動で記述します。
- AI チャット履歴は、​**変換ビルダー**​では使用できません。
- サンプルデータや AI 入力では、実際の個人識別情報 (PII) を使用しないでください。架空のデータまたはマスクされたデータのみを含む入力および出力のサンプルデータを提供します。

### [](#map-with-ai)AI を使用したマップ

**変換ビルダー**​にアクセスするときに、項目間の自動マッピングを取得します。

**\[Map with AI (AI を使用したマップ)\]**​ にアクセスできない場合、次の作業を行う必要があります。

- 設定が AI 支援変換を使用するための前提条件を満たしていることを確認する。​[始める前に](#prereq-dw-transforms)​を参照してください。
- 提供された入力メタデータと出力メタデータが有効であることを確認する。
    
    1. Mule プロジェクトを開きます。
    2. **fx**​ 項目を持つコンポーネントを開きます。
    3. **変換ビルダー**​を開きます。
        
        ![AI 支援マッピング機能の読み込みインジケーターと共に \[Fetching metadata (メタデータを取得中)\] 状況メッセージが表示されている変換ビルダー](_images/int-map-with-ai.png)
        
        提供されたサンプルデータを考慮して、マッピングが自動的に開始されます。
        
        マッピングは XML ファイルに適用されます。
        
        **\[Preview (プレビュー)\]**​ タブに変換の出力が表示されます。
    4. マッピングが完了したら、次の作業を行う必要があります。
        
        1. **\[Apply Mapping (マッピングを適用)\]**​ をクリックして、提案されたマッピングをプロジェクトに適用します。
        2. AI から新しい提案を取得するには、​**\[Revise Mapping (マッピングを修正)\]**​ をクリックします。

### [](#map-and-transform-with-ai)Map and Transform with AI (AI を使用したマップと変換)

AI 支援 DataWeave 変換スクリプトを作成します。入力および出力サンプルデータ、入力および出力メタデータ、および AI をガイドするための省略可能な指示を提供します。

1. Mule プロジェクトを開きます。
2. **fx**​ 項目を持つコンポーネントを開きます。
3. **変換ビルダー**​を開きます。
    
    ![AI 支援マッピング機能の読み込みインジケーターと共に \[Fetching metadata (メタデータを取得中)\] 状況メッセージが表示されている変換ビルダー](_images/int-map-with-ai.png)
    
    提供されたデータを考慮して、マッピングが自動的に開始されます。マッピングは XML ファイルに適用されます。
4. **\[Map and Transform with AI (AI を使用したマップと変換)\]**​ をクリックします。
5. 必要に応じて、次の情報を提供するか変更します。
    
    - **\[Input sample (入力サンプル)\]**​ データ
    - **\[Output sample (出力サンプル)\]**​ データ
    - AI をガイドする省略可能な指示
        
        <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">入力および出力サンプルデータを変更する場合は、AI が意図した変換を理解できるように同じ情報を提供します。入力データは、ペイロード、属性、または変数から取得できます。</td></tr></tbody></table>
6. **\[Transform (変換)\]**​ をクリックします。
    
    Einstein AI は、入力および出力サンプル、指示 (ある場合) を分析して、推奨変換を実行することを目的とした DataWeave スクリプトの提案を生成します。
7. 該当する場合は ​**\[View Suggested Scripts (推奨スクリプトを表示)\]**​ をクリックしてスクリプトを挿入するか、推奨スクリプトをその形式のままでクリップボードにコピーします。
    
    スクリプトを挿入すると、XML ファイルが更新され、​**\[Revise (修正)\]**​ をクリックしてスクリプトを再生成できます。

### [](#troubleshoot-ai-assisted-transformations)AI 支援変換のトラブルシューティング

AI 支援変換で問題が発生した場合は、次の手順に従います。

1. Anypoint Platform にログインして再試行します。
2. Anypoint Platform 管理者に問い合わせて、組織で生成 AI が有効になっていることを確認します。
3. Anypoint Platform にログインしており、組織が Einstein 生成 AI にアクセスできる場合は、Einstein 生成 AI の使用条件に同意します。

### [](#manually-add-data-sources-targets)データソースと対象を手動で追加する

変換スクリプトにデータソースと対象を手動で追加できます。

1. **\[Transformation Workspace (変換ワークスペース)\]**​ セクションで、ソース項目を入力ペイロードから対象項目にドラッグして、ソースデータを対象データにマップします。
    
    マップされた項目には緑色のドットが表示され、マッピングが成功したことを示すために強調表示されます。​**\[Script (スクリプト)\]**​ セクションが新しいマッピングで更新され、​**\[Output Preview (出力プレビュー)\]**​ セクションに変換の出力が表示されます。
    
    必要に応じて、複数のソース項目を対象項目にマップし、変換ビルダーでそれらを連結します。
2. メタデータを更新したりすべてのマッピングを削除したりするには、​**\[More Actions (その他のアクション)\]**​ をクリックします。
3. 項目マッピングから生成された入力サンプルを確認します。
    
    生成されたサンプルを選択するか、独自の​[サンプルデータ](#sample-data)​を提供できます。

## [](#sample-data)DataWeave 式のサンプルデータを提供する

Anypoint Code Builder で DataWeave 式をローカルでテストおよびプレビューします。アプリケーションを実行せずに出力をプレビューするには、​**fx**​ の項目で ​`payload`​ などの Mule 変数のサンプルデータを追加します。AI 支援変換の場合、サンプル入力および出力データを提供すると、AI が意図した変換を理解し、正しい DataWeave スクリプトを生成するのに役立ちます。

サンプルデータは次の形式で作成することができます。

- JSON
- XML
- CSV
- Java
- Text (テキスト)
- YAML
- Avro
- Excel
- NDJSON
- URL エンコード
- Protobuf
- Multipart

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="ulist">
<ul>
<li>
<p>実際のデータでアプリケーションを実行したときにエラーが発生しないようにするには、式で期待されるデータの基本構造、形式、およびデータ型に一致するサンプルデータを提供します。</p>
</li>
<li>
<p>キャンバスからコンポーネントを再度開くと、サンプルデータは上書きされます。</p>
</li>
</ul>
</div>
</td>
</tr>
</tbody></table>

Mule 変数のサンプルデータを作成する手順は、次のとおりです。

1. プロジェクトを開きます。
2. XML エディターで Mule イベント変数 (​`payload`​ など) にマウスポインターを置きます。次に例を示します。
    
    ![ペイロード変数の上にマウスポインターが置かれ、サンプルデータを作成するための \[Quick Fix (クイック修正)\] が表示されている XML エディター](_images/int-dw-sample-quick-fix-hover.png)
3. **\[Quick Fix (クイック修正)\]**​ をクリックして ​**\[Quick Fix (クイック修正)\]**​ メニューを開きます。
4. **\[Create sample data for payload (ペイロードのサンプルデータを作成)\]**​ など、​**\[Create sample data for ​_your-value_​ (your-value のサンプルデータを作成)\]**​ を選択します。次に例を示します。
    
    ![XML エディターのコンテキストメニューに \[Create sample data for payload (ペイロードのサンプルデータを作成)\] オプションが表示されている \[Quick Fix (クイック修正)\] メニュー](_images/int-dw-sample-quick-fix-create.png)
5. 開いたメニューで、サンプルデータの形式 (JSON など) を選択します。
    
    ![JSON、XML、CSV、Java、Text (テキスト)、YAML、Avro、Excel、その他のサポートされている形式を含むオプションが表示されているサンプルデータ形式選択メニュー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/dw-issue-sample-data-formats.png)
    
    IDE にサンプルデータのタブが開きます。
6. 選択した形式のコンテンツをサンプルデータファイルに追加します。たとえば、JSON の場合は次のようになります。
    
    ![src/test/resources ディレクトリ構造に保存されている payload.json などのサンプルデータファイルが表示されている Project Explorer](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-sample-quick-fix-example-dir.png)
    
    ファイル名は ​`payload.json`​ です。独自のサンプルデータと自動作成されたサンプルデータのファイルはプロジェクトディレクトリ ​`src/test/resources`​ に保存されます。
    
    サンプルデータを追加する前に​[「重要」](#important)​を参照してください。
    
    XML エディター内の値にマウスポインターを置くと、サンプルデータの構造、データキー、データ型が表示されます。次に例を示します。
    
    ![XML にマウスポインターを置いてサンプルデータを表示](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-sample-quick-fix-example-hover-xml.png)
7. **式ビルダー**​でサンプルデータをプレビューします。
    
    1. キャンバスから、サンプルデータが含まれるコンポーネントをクリックして、その項目の​**式ビルダー**​を開きます。
    2. サンプルデータが含まれるコンポーネントの ​**fx**​ をクリックして、その項目の​**式ビルダー**​を開きます。
    3. **\[Preview (プレビュー)\]**​ をクリックして、サンプルデータを表示します。次に例を示します。
        
        ![\*式ビルダー\*でのサンプルデータのプレビュー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-sample-quick-fix-example-preview.png)
        
        値は変更できます。たとえば、DataWeave セレクターまたは関数を追加します。
        
        ![変更したサンプルデータのプレビュー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-sample-quick-fix-example-preview-modified.png)
        
        この例では ​`id`​ 値の配列が返されるようになりました。

## [](#address-dw-errors)DataWeave エラーへの対処

DataWeave コードに構文エラーやセマンティックエラーが含まれている場合、Anypoint Code Builder ではエラーが強調表示され、推奨の修正方法が提供されます。次のような問題があります。

- [DataWeave モジュールで欠落している Import ディレクティブを追加する](#fix-dw-add-import)
- [未定義関数エラーを修正する](#fix-dw-error)

### [](#fix-dw-add-import)DataWeave モジュールで欠落している Import ディレクティブを追加する

多くの DataWeave モジュールでは、式に明示的な ​`import`​ ディレクティブが必要です。このディレクティブを必要としないモジュールはコアモジュールのみです。

たとえば、この関数が属している String モジュールをインポートしていない場合、関数 ​`camelize( "hello world")`​ では、​`「Unable to resolve the reference of 'camelize' (「camelize」の参照を解決できません)」`​というエラーが発生します。

```xml
<set-payload value='#[ camelize( "hello world")]' doc:name="Set payload" doc:id="vyvcds" />
```

**式ビルダー**​ではエラーが識別されます。次に例を示します。

![「インポートが必要」エラー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-fx-error-add-import.png)

この問題を修正するには、クリックして import ディレクティブを自動で追加します。次に例を示します。

![「インポートが必要」エラー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-fx-error-fix-import.png)

この修正の XML は次の例のようになります。

```xml
<set-payload value='#[%dw 2.0
import camelize from dw::core::Strings
---
 camelize( "hello world")]' doc:name="Set payload" doc:id="vyvcds" />
```

### [](#fix-dw-error)未定義関数エラーを修正する

Anypoint Code Builder では未定義の関数が自動的にフラグ付けされます。

たとえば、次のコードでは、DataWeave により ​`toUpper`​ がエラーとしてフラグ付けされています。

![未定義関数エラー](/mulesoft/current/ja-jp/anypoint-code-builder/_images/dw-error.png)

カーソルを関数の上に置くと、DataWeave によりエラーに関する情報が提供されます。

![未定義関数エラーに関する情報](/mulesoft/current/ja-jp/anypoint-code-builder/_images/undefined-function.png)

この問題を修正する手順は、次のとおりです。

1. エラーをクリックしてポップアップを表示します。
2. **\[Quick Fix (クイック修正)\]**​、​**\[Create Function (関数を作成)\]**​ の順にクリックします。
    
    Anypoint Code Builder では ​`???`​ プレースホルダー付きの関数定義が自動的に追加されます。このプレースホルダーにユーザーは関数を定義できます。
    
    ```DataWeave
    fun toUpper(param0: String) = ???
    ```
3. `upper`​ 関数を使用して、指定された文字列を大文字で返すように関数を更新します。
    
    ```DataWeave
    <set-payload value="#[%dw 2.0
    fun toUpper(param0: String) = upper(param0)
    output application/json
    ---
    toUpper('hello')]" doc:name="Set payload" doc:id="xiyfpa" />
    ```

## [](#import-library)DataWeave ライブラリをインポートする

Anypoint Code Builder を使用して、Exchange から Mule アプリケーションに DataWeave ライブラリをインポートします。

DataWeave ライブラリは、DataWeave モジュール、マッピングファイル、およびリソースファイル (JSON、XML、CSV ファイルなど) の再利用可能なパッケージです。

DataWeave ライブラリをインポートする方法は、Exchange から他のアセットをインポートする方法と同じです。

1. Anypoint Code Builder でインテグレーションプロジェクトを開きます。
2. コマンドパレットを開きます。
    
    手順を表示
    
    - キーボードショートカットを使用する。
        
        - Mac: Cmd+Shift+p
        - Windows: Ctrl+Shift+p
    - デスクトップ IDE で、​**\[View (表示)\]**​ > ​**\[Command Palette (コマンドパレット)\]**​ を選択する。
    - クラウド IDE で、​![](/mulesoft/current/ja-jp/anypoint-code-builder/_images/icon-menu.png)​ (メニュー) アイコンをクリックし、​**\[View (表示)\]**​ > ​**\[Command Palette (コマンドパレット)\]**​ を選択する。
3. `「import」`​と入力し、次のコマンドを選択します。
    
    ```command
    MuleSoft: Import Asset from Exchange
    ```
4. **\[DataWeave Library (DataWeave ライブラリ)\]**​ を選択します。
    
    ライブラリを検索するには、検索語を入力して Enter キーを押します。たとえば、​**「DataWeave」**​と入力します。
    
    ![DataWeave ライブラリの検索](/mulesoft/current/ja-jp/anypoint-code-builder/_images/int-dw-libraries.png)
5. **\[Assets From Exchange (Exchange のアセット)\]**​ メニューから DataWeave ライブラリを選択します。
6. DataWeave ライブラリのバージョンを選択します。
    
    ステータスバーに進行状況が表示されます。

完了したら、連動関係がプロジェクトに正常に追加されたことを示すメッセージが Anypoint Code Builder に表示されます。

## [](#関連情報)関連情報

- [Mule アプリケーションのデバッグ](https://docs.mulesoft.com/jp/anypoint-code-builder/int-debug-mule-apps)
- [DataWeave の問題とエラー](https://docs.mulesoft.com/jp/anypoint-code-builder/troubleshoot-dataweave)
- [プロジェクトにコンポーネントを追加する](https://docs.mulesoft.com/jp/anypoint-code-builder/int-create-integrations#add-components)
- [参照](https://docs.mulesoft.com/jp/anypoint-code-builder/acb-reference)