--- schema_version: "1" id: 9a6129f176b388fd0694d3cc6d0314699deae8e60de6d68ca3b66b1afe1564ed title: Excel 形式 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.7/dataweave-formats-excel.md canonical_url: https://docs.mulesoft.com/jp/dataweave/2.7/dataweave-formats-excel source_site: docs.mulesoft.com content_type: documentation content_hash: bcfcb2d9e00f5fda23def386401d6f06e1868a2f30a7c1d0f52bd777ca9d7e20 description: MuleSoft Documentation Site release: "2.7" latest: false --- # Excel 形式 MIME タイプ: `application/xlsx` ID: `excel` Excel ワークブックは一連のシートです。DataWeave では、これはオブジェクトにマップされ、各シートがキーになります。Excel シートごとに 1 つのテーブルのみが許可されます。 テーブルは行の配列として表現されます。行はオブジェクトであり、そのキーが列、値がセルのコンテンツになります。

.xlsx​ ファイルのみがサポートされます (Excel 2007)。 .xls​ ファイルは Mule ではサポートされません。
Excel 入力の DataWeave リーダーでは、次の解析戦略がサポートされています。 - メモリ内 - ストリーミング DataWeave リーダーおよびライターでこの形式に適用できる解析戦略を理解するには、​[「DataWeave 解析戦略」](https://docs.mulesoft.com/jp/dataweave/2.7/dataweave-formats#dw_readers_writers)​を参照してください。 ## [](#mapping)Excel 型のマッピング 次の表に、Excel と DataWeave の型のマッピングを示します。
Excel 型 DataWeave 型

String

String

Numeric

Number

Boolean

Boolean

Data

Date
## [](#examples)例 次の例は、Excel 形式の使用方法を示しています。 - [例: Excel を DataWeave (dw) 形式で表す](#example1) - [例: Excel テーブルを出力する](#example2) - [例: Excel 入力をストリーミングする](#example3) ### [](#example1)例: Excel を DataWeave (dw) 形式で表す 次の例は、DataWeave で Excel ワークブックを表す方法を示しています。 #### [](#入力)入力 Excel ワークブック (​`Sheet1`​) は、DataWeave ソースの入力ペイロードとして機能します。 Sheet1: . | A | B 1 | Id | Name 2 | 123 | George 3 | 456 | Lucas #### [](#ソース)ソース この DataWeave スクリプトは、Excel 入力ペイロードを DataWeave (dw) 形式と MIME タイプに変換します。 ```dataweave %dw 2.0 output application/dw --- payload ``` #### [](#出力)出力 DataWeave 出力は次のようになります。他のオブジェクトの値を選択するときと同じ方法で値を選択できます。 ```dataweave { "Sheet1": [ { "A": 123, "B": "George" }, { "A": 456, "B": "Lucas" } ] } ``` ### [](#example2)例: Excel テーブルを出力する 次の DataWeave スクリプトは、ヘッダーと項目が含まれる Excel テーブルを出力します。 この DataWeave スクリプトの本文は、Excel シートのコンテンツを定義する DataWeave オブジェクトです。シートの名前 ​`Sheet1`​ は、このオブジェクトのキーになります。値は、オブジェクトの配列になります。配列の各オブジェクトには、キー-値ペアのコレクションが含まれます。各ペアのキーは、スプレッドシートのヘッダー値として処理されます。各ペアの値は、シートの行のデータ値として処理されます。 この出力ディレクティブは、出力が Excel 形式と MIME タイプであることを示しています。​`header=true`​ 設定は、出力にヘッダー値が含まれていることを示します。 ```dataweave %dw 2.0 output application/xlsx header=true --- { Sheet1: [ { Id: 123, Name: George }, { Id: 456, Name: Lucas } ] } ``` 他の例については、​[「Excel (XLSX) ファイルのデータの参照」](https://docs.mulesoft.com/jp/dataweave/2.7/dataweave-cookbook-xlsx-lookup)​を参照してください。 ### [](#example3)例: Excel 入力をストリーミングする デフォルトでは、Excel リーダーは、ファイルが 1.5MB 以下の場合、ファイル全体から入力データをメモリ内に保存します。ファイルが 1.5 MB よりも大きい場合、データはディスクに書き込まれます。非常に大きなファイルの場合は、​`streaming`​ プロパティを ​`true`​ に設定することで、リーダーのパフォーマンスを向上できます。 Mule アプリケーションの次の設定 XML では、Excel ファイルをストリーミングして JSON に変換します。 ```xml { foo: row.a, bar: row.b })]]> ``` この例の説明: - `outputMimeType="application/xlsx; streaming=true"`​ を設定して、XLSX 入力をストリーミングするように HTTP リスナーを設定します。 Studio UI では、リスナーの ​**\[MIME Type (MIME タイプ)\]**​ を ​`application/xlsx`​ に設定し、MIME タイプの ​**\[Parameters (パラメーター)\]**​ を ​**\[Key (キー)\]**​ ​`streaming`​ と ​**\[Value (値)\]**​ ​`true`​ に設定できます。 - **Transform Message**​ コンポーネントの DataWeave スクリプトを使用して、XLSX ペイロード (​`"Sheet Name"`​ という名前の XLSX シート) の各行を反復処理し、(​`row.a`​、​`row.b`​ を使用して) 行の各セルの値を選択します。​`a`​ および ​`b`​ という名前の列を想定し、それらの列の各行の値を ​`foo`​ および ​`bar`​ にそれぞれマップします。 #### [](#出力-2)出力 次の画像は、Excel テーブルの出力を示しています。 ![ID と名前が表示されている Excel 形式のテーブル](/mulesoft/current/ja-jp/dataweave/2.7/_images/dataweave-formats-exceltable.png) ## [](#制限事項)制限事項 - マクロは現在サポートされていません。 - チャートは無視されます。 - ピボットテーブルはサポートされていません。 - 書式設定は現在サポートされていません。 ## [](#properties)Configuration のプロパティ DataWeave では、この形式の以下の設定プロパティがサポートされています。 ### [](#reader_properties)Reader のプロパティ この形式は、入力データを読み取るための指示を提供するプロパティを受け入れます。
パラメーター 型 デフォルト 説明

header

Boolean

true

出力の 1 行目にヘッダー項目名が含まれるかどうかを示します。

有効な値は、​true​ または ​false​ です。

ignoreEmptyLine

Boolean

true

デフォルトでは、空の行を無視します。

有効な値は、​true​ または ​false​ です。

maxEntrySize

Number

null

ZIP ファイル内の単一エントリの最大バイト数を設定します。

minInflateRatio

Number

null

ZIP 爆弾を検出するために、圧縮されたバイトと圧縮解除されたバイトの比率を設定します。たとえば、特定の読み取りパッケージ部分の圧縮が 1 パーセントより高い場合に値を 1 パーセント (= 0.01d) に設定すると、解析で zip 爆弾が示されません。

streaming

Boolean

false

true​ に設定すると、入力をストリーミングします。エントリを順次アクセスする場合のみ使用します。入力は最上位の配列である必要があります。​ストリーミング例​と 「DataWeave リーダー」​を参照してください。

有効な値は、​true​ または ​false​ です。

tableLimit

String

'Unbounded'

各行の最後の列の位置。パターン ​<Column>​ (たとえば、​'A'​ や ​'AB'​)、値 ​'HeaderSize'​ (最後のヘッダーの位置を使用する)、または「Unbounded (無制限)」 (各行をコンシュームする) を受け入れます。

tableOffset

String

null

最初のセルの位置を設定します。パターン ​<Column><Row>​ (たとえば、​A1​ や ​B3​) を受け入れます。

zipBombCheck

Boolean

true

false​ に設定すると、zip 爆弾 (圧縮解除爆弾) チェックを無効にします。

有効な値は、​true​ または ​false​ です。
### [](#writer_properties)Writer のプロパティ この形式は、出力データを書き込むための指示を提供するプロパティを受け入れます。
パラメーター 型 デフォルト 説明

bufferSize

Number

8192

バッファライターのサイズ (バイト)。値は ​8​ よりも大きい必要があります。

deferred

Boolean

false

true​ に設定すると、出力をデータストリームとして生成し、スクリプトの実行は生成されたコンテンツがコンシュームされるまで延期されます。

有効な値は、​true​ または ​false​ です。

header

Boolean

true

出力の 1 行目にヘッダー項目名が含まれるかどうかを示します。

有効な値は、​true​ または ​false​ です。

ignoreEmptyLine

Boolean

true

デフォルトでは、空の行を無視します。

有効な値は、​true​ または ​false​ です。

maxEntrySize

Number

null

ZIP ファイル内の単一エントリの最大バイト数を設定します。

minInflateRatio

Number

null

ZIP 爆弾を検出するために、圧縮されたバイトと圧縮解除されたバイトの比率を設定します。たとえば、特定の読み取りパッケージ部分の圧縮が 1 パーセントより高い場合に値を 1 パーセント (= 0.01d) に設定すると、解析で zip 爆弾が示されません。

tableOffset

String

null

最初のセルの位置を設定します。パターン ​<Column><Row>​ (たとえば、​A1​ や ​B3​) を受け入れます。

zipBombCheck

Boolean

true

false​ に設定すると、zip 爆弾 (圧縮解除爆弾) チェックを無効にします。

有効な値は、​true​ または ​false​ です。
## [](#mime_types)サポートされる MIME タイプ この形式では、次の MIME タイプがサポートされます。
MIME タイプ

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

application/xlsx