---
schema_version: "1"
id: 6acca1d6311b62d33051aa3af670d4b5ff59c2e46a5aff324bfaf52cd770fc6a
title: URL エンコード形式
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.6/dataweave-formats-urlencoded.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.6/dataweave-formats-urlencoded
source_site: docs.mulesoft.com
content_type: documentation
content_hash: aa49567da4f78e3abad4fdcf4a8dd6430a24f618bd4d844dddfa3aad9398b60b
description: MuleSoft Documentation Site
release: "2.6"
latest: false
---
# URL エンコード形式

MIME タイプ: `application/x-www-form-urlencoded`

ID: `urlencoded`

URL エンコードデータはキー-値ペアのコレクションを表します。DataWeave はこれらの値を、各値を文字列として含むオブジェクトとして表します。

## [](#examples)例

次の例は、URL エンコード形式の使用方法を示しています。

- [例: URL エンコードデータを DataWeave (dw) 形式で表す](#example1)
- [例: JSON オブジェクトから URL エンコードデータを生成](#example2)
- [例: キー-値ペアのコレクションから URL エンコードデータを生成](#example3)
- [例: URL エンコードデータをテキスト/プレーン形式に変換](#example4)

### [](#example1)例: URL エンコードデータを DataWeave (dw) 形式で表す

次の例は、簡単な URL エンコードデータが DataWeave でどのように表されるかを示しています。

#### [](#入力)入力

この URL エンコードデータが DataWeave ソースへの入力ペイロードとして機能します。

```form-urlencoded
name=Mariano&lastName=de+Achaval
```

#### [](#ソース)ソース

DataWeave スクリプトは、URL エンコードされた入力ペイロードを DataWeave (dw) 形式および MIME タイプに変換します。

```dataweave
%dw 2.0
output application/dw
---
payload
```

#### [](#出力)出力

出力は、入力からのキー-値ペアのコレクションを含む DataWeave オブジェクトです。

```dataweave
{
    "name": "Mariano",
    "lastName": "de Achaval"
}
```

### [](#example2)例: JSON オブジェクトから URL エンコードデータを生成

次の例は、URL エンコードデータの生成方法を示しています。

#### [](#入力-2)入力

この JSON オブジェクトが DataWeave ソースへの入力ペイロードとして機能します。

```json
{
  "name": "Mariano"
}
```

#### [](#ソース-2)ソース

DataWeave スクリプトは入力ペイロードの ​`name`​ キーの値を選択し、スクリプトの本文内のオブジェクトのすべての値を ​`urlencoded`​ 形式に変換します。

```dataweave
%dw 2.0
output urlencoded
---
{
    name: payload.name,
    age: 37
}
```

#### [](#出力-2)出力

出力は、DataWeave スクリプトの本文内のキー-値ペアから構築された URL エンコードデータです。

```form-urlencoded
name=Mariano&age=37
```

### [](#example3)例: キー-値ペアのコレクションから URL エンコードデータを生成

DataWeave スクリプトは、URL エンコードされた出力を生成します。

#### [](#ソース-3)ソース

DataWeave スクリプトは、スクリプトの本文内にある JSON 入力の形式を URL エンコード形式に変換します。

```dataweave
%dw 2.0
output application/x-www-form-urlencoded
---
{
  "key" : "value",
  "key 1": "@here",
  "key" : "other value",
  "key 2%": null
}
```

#### [](#出力-3)出力

出力は、URL エンコード形式の入力データを示します。

```text
key=value&key+1=%40here&key=other+value&key+2%25
```

### [](#example4)例: URL エンコードデータをテキスト/プレーン形式に変換

次の例では、URL エンコードされた入力をテキスト/プレーン形式および MIME タイプに変換します。

#### [](#ソース-4)ソース

DataWeave スクリプトは、URL エンコードデータを読み取って、選択されたキーの値を連結します。

```dataweave
%dw 2.0
var myData  read('key=value&key+1=%40here&key=other+value&key+2%25', 'application/x-www-form-urlencoded')
output text/plain
---
myData.*key[0] ++ myData.'key 1'
```

#### [](#出力-4)出力

出力はテキスト/プレーン形式です。

```text
value@here
```

## [](#properties)Configuration のプロパティ

DataWeave では、この形式の以下の設定プロパティがサポートされています。

### [](#reader_properties)Reader のプロパティ

この形式のリーダープロパティはありません。

### [](#writer_properties)Writer のプロパティ

この形式は、出力データを書き込むための指示を提供するプロパティを受け入れます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 16.6666%;">
<col style="width: 16.6666%;">
<col style="width: 50.0002%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">型</th>
<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"><p class="tableblock"><code>bufferSize</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Number</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>8192</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バッファライターのサイズ (バイト)。値は 8 よりも大きい必要があります。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>deferred</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>Boolean</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>true</code>​ に設定すると、出力をデータストリームとして生成し、スクリプトの実行は生成されたコンテンツがコンシュームされるまで延期されます。</p>
</div>
<div class="paragraph">
<p>有効な値は、​<code>true</code>​ または ​<code>false</code>​ です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>encoding</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>String</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>null</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>出力で使用するエンコード (UTF-8 など)。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#mime_types)サポートされる MIME タイプ

この形式では、次の MIME タイプがサポートされます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 100%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">MIME タイプ</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>application/x-www-form-urlencoded</code></p></td>
</tr>
</tbody>
</table>