--- schema_version: "1" id: cc9777196834897b817d3b87b41070cb61b5c965ff69076f9060a4c5803f9f37 title: ファイル collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.7/dw-multipart-functions-file.md canonical_url: https://docs.mulesoft.com/jp/dataweave/2.7/dw-multipart-functions-file source_site: docs.mulesoft.com content_type: documentation content_hash: a314a96a63f3e5405438091cb034f8c6213c8f270c8e5c48420e662d6f026f88 description: MuleSoft Documentation Site release: "2.7" latest: false --- # ファイル ## [](#file1)file(opts: {| name: String, path: String, mime?: String, fileName?: String |}) ソースファイルから `MultipartPart` データ構造を作成します。このバージョンの `file` 関数では引数としてキー/値ペアを含むオブジェクトが受け入れられるため、次のようにキー/値ペアを任意の順序で入力できます。 ```txt Multipart::file({ name: "myFile", path: "myClients.json", mime: "application/json", fileName: "partMyClients.json"}) ``` ### [](#パラメーター)パラメーター

名前説明

名前	説明
`opts`	次のキー/値ペアを指定するオブジェクト。 `name` (必須): パートの `Content-Disposition` ヘッダーの一意の名前。 `path` (必須): Mule アプリケーションの `src/main/resources` プロジェクトパスを基準とする相対パス。 `mime` (文字列の場合は省略可能): パート内のコンテンツに適用する MIME タイプ (例: `application/json`)。この設定を使用して入力の MIME タイプを変換することはできません。 `fileName` (省略可能): パートの `Content-Disposition` ヘッダー内の `filename` パラメーターの値。指定されていない場合、デフォルトの文字列 `"filename"` に設定されます。この値は入力ファイル名に一致する必要はありません。

opts

次のキー/値ペアを指定するオブジェクト。

name (必須): パートの Content-Disposition ヘッダーの一意の名前。
path (必須): Mule アプリケーションの src/main/resources プロジェクトパスを基準とする相対パス。
mime (文字列の場合は省略可能): パート内のコンテンツに適用する MIME タイプ (例: application/json)。この設定を使用して入力の MIME タイプを変換することはできません。
fileName (省略可能): パートの Content-Disposition ヘッダー内の filename パラメーターの値。指定されていない場合、デフォルトの文字列 "filename" に設定されます。この値は入力ファイル名に一致する必要はありません。

### [](#例)例次の例では、DataWeave 関数でアクセスできるファイルから `MultipartPart` を作成します。ファイル名は `orders.xml` で、Mule アプリケーションの `/src/main/resources` にあります。 `file` 関数は外部の `orders.xml` ファイルを見つけ、キー/値ペアを使用して `MultipartPart` の作成に必要なさまざまなパラメーターを指示します。 - `name` は任意に指定できますが、通常はこの `Multipart` ペイロードを受け入れる受信側サーバーで必要なパラメーターに合わせます。 - `path` は `./orders.xml` に設定されます。これは `MultipartPart` に読み込まれる `orders.xml` ファイルのパスと名前です。 - `mime` パラメーターではファイルの適切な MIME タイプを指定します。この場合は `application/xml` です。 - `filename` は任意の値に変更できます。実際の入力ファイルのファイル名と違ってもかまいません。この例の出力は `Multipart` 構造の一部でしかないため、`multipart/form-data` 出力種別との互換性がありません。有効な `multipart/form-data` 出力を作成するには、`Multipart::form()` 関数を 1 つ以上の `Multipart` ファイルや項目に使用します。 #### [](#ソース)ソース ```DataWeave %dw 2.0 import dw::module::Multipart output application/dw var ordersFilePath = "./orders.xml" --- Multipart::file{ name: "file", path: ordersFilePath, mime: "application/xml", fileName: "orders.xml" } ``` #### [](#入力)入力次のコンテンツを含む、`src/main/resources` に配置されている `orders.xml` という名前のファイル。 ```xml 1001 1 \$100 2001 2 \$50 ``` #### [](#出力)出力 ```json { headers: { "Content-Type": "application/xml", "Content-Disposition": { name: "file", filename: "orders.xml" } }, content: "\n\n \n \n 1001\n 1\n \$100\n \n \n 2001\n 2\n \$50\n \n \n" } ``` ### [](#例-2)例次の例では、ファイルのコンテンツを `MultipartPart` から `Multipart` に挿入して、`multipart/form-data` 出力にします。この例では `form` 関数を使用して `Multipart` を作成し、`file` を使用してパートを作成します。 `Multipart::form()` 関数は、各パートを `Multipart::field()` または `Multipart::file()` 関数を使用して作成可能な `Multipart` 項目の配列を受け入れます。 #### [](#ソース-2)ソース ```DataWeave %dw 2.0 import dw::module::Multipart output multipart/form-data var ordersFilePath = "./orders.xml" var myArgs = { name: "file", path: ordersFilePath, mime: "application/xml", fileName: "myorders.xml"} --- Multipart::form([ Multipart::file(myArgs) ]) ``` #### [](#出力-2)出力 ```json ------=_Part_5349_1228640551.1560391284935 Content-Type: application/xml Content-Disposition: form-data; name="file"; filename="myorders.xml" 1001 1 $100 2001 2 $50 ------=_Part_5349_1228640551.1560391284935-- ``` ## [](#file2)file(fieldName: String, path: String, mime: String = 'application/octet-stream', sentFileName: String = 'filename') ソースファイルから `MultipartPart` データ構造を作成します。このバージョンの `file` 関数は、次のようにカンマ区切りリストで文字列引数を受け入れます。 ```txt Multipart::field("myFile", myClients, 'application/json', "partMyClients.json") ``` ### [](#パラメーター-2)パラメーター

名前説明

名前	説明
`fieldName`	パートの `Content-Disposition` ヘッダーの一意の名前 (必須)。
`path`	Mule アプリケーションの `src/main/resources` プロジェクトパスへの相対パス (必須)。
`mime`	パート内のコンテンツに適用する MIME タイプ (文字列の場合は省略可能)。例: `application/json`。この設定を使用して入力の MIME タイプを変換することはできません。
`sentFileName`	パートの `Content-Disposition` ヘッダー内の `filename` パラメーターの省略可能なファイル名の値。指定されていない場合、デフォルトで文字列 `"filename"` になります。この値は入力ファイル名に一致する必要はありません。

fieldName

パートの Content-Disposition ヘッダーの一意の名前 (必須)。

path

Mule アプリケーションの src/main/resources プロジェクトパスへの相対パス (必須)。

mime

パート内のコンテンツに適用する MIME タイプ (文字列の場合は省略可能)。例: application/json。この設定を使用して入力の MIME タイプを変換することはできません。

sentFileName

パートの Content-Disposition ヘッダー内の filename パラメーターの省略可能なファイル名の値。指定されていない場合、デフォルトで文字列 "filename" になります。この値は入力ファイル名に一致する必要はありません。

### [](#例-3)例次の例では、ファイルの内容を `MultipartPart` から `Multipart` データ構造に挿入します。`form` 関数を使用して `Multipart` 型を作成し、`file` を使用して外部ファイル `myClients.json` の JSON コンテンツを含む `myClient` という名前のパートを作成します。また、`filename` パラメーターの値として `partMyClients.json` を指定します。 #### [](#ソース-3)ソース ```DataWeave %dw 2.0 import dw::module::Multipart var myClients = "myClients.json" output multipart/form-data --- Multipart::form([ Multipart::file("myFile", myClients, 'application/json', "partMyClients.json") ]) ``` #### [](#入力-2)入力次のコンテンツを含む、`src/main/resources` に配置されている `myClients.json` という名前のファイル。 ```JSON clients: { client: { id: 1, name: "Mariano" }, client: { id: 2, name: "Shoki" } } ``` #### [](#出力-3)出力 ```txt ------=_Part_1586_1887987980.1542569342438 Content-Type: application/json Content-Disposition: form-data; name="myFile"; filename="partMyClients.json" { clients: { client: { id: 1, name: "Mariano" }, client: { id: 2, name: "Shoki" } } } ------=_Part_1586_1887987980.1542569342438-- ```