--- schema_version: "1" id: 6a6f3ba31fcd0e0bc97275ba674ec75f79b9c5cb3ca93984a2a822287ae05435 title: フラットファイル形式 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.8/dataweave-formats-flatfile.md canonical_url: https://docs.mulesoft.com/jp/dataweave/2.8/dataweave-formats-flatfile source_site: docs.mulesoft.com content_type: documentation content_hash: 0d3fa2be116a1941a3b68cff8f722638ad4984591681c144853b0bafd46cb058 description: MuleSoft Documentation Site release: "2.8" latest: false --- # フラットファイル形式 MIME タイプ: `application/flatfile` ID: `flatfile` フラットファイル形式では、1 つのメッセージ内で複数のタイプの固定幅レコードを使用できます。スキーマ構造を使用すると、異なるレコードタイプを区別する方法と、レコードを論理的にグループ化する方法を定義できます。
DataWeave のフラットファイルは最大 15 MB のファイルをサポートし、メモリ要件は約 40 対 1 です。たとえば、1 MB のファイルは処理に最大 40 MB のメモリを必要とするため、大きいフラットファイルに対する TPS のニーズと組み合わせてこのメモリ要件を考慮することが重要です。これは正確な数値ではありません。この値は、マッピング命令の複雑さによって異なる可能性があります。
## [](#examples)例: フラットファイルスキーマを指定する 次の例は、フラットファイル形式でデータを出力する DataWeave スクリプトを示しています。 `schemaPath`​ および ​`structureIndent`​ ライタープロパティが使用されています。 ```dataweave %dw 2.0 output application/flatfile schemaPath="src/main/resources/test-data/QBReqRsp.esl", structureIdent="QBResponse" --- payload ``` ## [](#properties)Configuration のプロパティ DataWeave では、この形式の以下の設定プロパティがサポートされています。 ### [](#reader_properties)Reader のプロパティ この形式は、入力データを読み取るための指示を提供するプロパティを受け入れます。
パラメーター 型 デフォルト 説明

allowLenientWithBinaryNotEndElement

Boolean

false

スキーマに型が Binary (バイナリ) または Packed (パック) の要素が含まれていると、最後の要素の形式種別に関係なく、​lenient​ オプションで短いレコードが許可されません。このプロパティを ​true​ に設定すると、検証はレコードが Binary (バイナリ) または Packed (パック) の型で終了するケースのみに適用されます。

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

enforceRequires

Boolean

false

true​ に設定されていると、必須値がない場合にエラーが発生します。

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

missingValues

String

null

欠落値を表すために使用される文字を入力します。デフォルト以外の設定をアクティブ化するには、​useMissCharAsDefaultForFill​ プロパティを ​true​ に設定し、​missingValues​ に次のいずれかの値を使用します。

  • none​ (リーダーの場合) または ​NONE​ (ライターの場合): すべてのデータを値として処理する。

  • spaces​ (リーダーの場合) または ​SPACES​ (ライターの場合): スペースのみで構成される項目を欠落値として解釈する。フラットファイルまたは固定幅形式のデフォルトです。

  • zeroes​ (リーダーの場合) または ​ZEROES​ (ライターの場合): 0​ 文字のみで構成される数値項目​と​スペースのみで構成される文字項目を欠落値として解釈する。

  • nulls​ (リーダーの場合) または ​NULLS​ (ライターの場合): 0​ バイトのみで構成される項目を欠落値として解釈する。COBOL コピーブックスキーマのデフォルトです。

有効な値は ​none​、​spaces​、​zeroes​、​nulls​ です。

notTruncateDependingOnSubjectNotPresent

Boolean (ブール)

false

DEPENDING ON の対象が存在しない場合にグループ全体を入力します。

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

recordParsing

String

'strict'

予想される、行/レコード間の分離の種別を指定します。

  • strict​: 各レコードの末尾で改行が予想される。 strict​ はデフォルトです。

  • lenient​: 改行が使用されるが、レコードがスキーマ仕様よりも短いまたは長い場合がある。ペイロードに改行がない場合は、​lenient​ を使用しないでください。​recordParsing​ のもう 1 つのオプションで改行がないレコードがサポートされます。

  • noTerminator​: レコードが分離されずに互いに続く。このオプションは、改行がない固定長のレコードでお勧めします。

  • singleRecord​: 入力全体が 1 つのレコード。

種別 ​Binary​ または ​Packed​ のスキーマでは、改行を検出できないため、​recordParsing​ を ​lenient​ に設定すると、長いレコードのみを処理でき、短いレコードは処理できません。現在、このスキーマも特定の 1 バイト文字エンコードでのみ機能します (つまり、UTF-8 などの複数バイト形式では機能しません)。

有効な値は ​strict​、​lenient​、​noTerminator​、​singleRecord​ です。

retainEmptyStringFieldsOnParsing

Boolean (ブール)

false

解析動作の出力マップで、デフォルト値が設定された文字列項目を欠落した状態のまま保持できるようにします。

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

schemaPath​ (必須)

String

null

スキーマ定義へのパス。入力を解析するスキーマファイルのローカルディスク内の場所を指定します。

segmentIdent

String

null

固定幅のスキーマまたは COBOL コピーブックスキーマのセグメント識別子。スキーマに複数のセグメント定義が含まれている場合、単一セグメントまたはレコード定義を解析するときに必要になります。

structureIdent

String

null

フラットファイルスキーマの構造識別子。スキーマに複数の構造定義が含まれている場合、構造定義を解析するときに必要になります。

substituteCharacterAsMissingValue

Boolean (ブール)

false

これを ​true​、​missingValues​ プロパティを ​none​、​useMissCharAsDefaultForFill​ を ​true​ に設定した場合、フラットファイルパーサーでは ​0x1A​ (SUB) 文字は欠落値として処理されます。
それ以外の場合、フラットファイルパーサーでは ​0x1A​ 文字は欠落値として処理されません。

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

truncateDependingOn

Boolean

false

COBOL コピーブックの DEPENDING ON 値を、使用される長さに切り捨てます。

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

useMissCharAsDefaultForFill

Boolean (ブール)

false

デフォルトでは、フラットファイルリーダーおよびライターでは、欠落文字にスペースが使用され、​missingValues​ プロパティの設定が無視されます。このプロパティを ​true​ に設定すると、DataWeave は ​missingValues​ プロパティの設定に従います。2021 年 9 月リリースの Mule 4.3.0-20210823 の DataWeave 2.3 (2.3.0-20210823) で導入されました。

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

zonedDecimalStrict

Boolean

false

COBOL コピーブックのゾーン 10 進数値に署名エンコードの 'strict' ASCII 形式を使用します。

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

bufferSize

Number

8192

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

deferred

Boolean

false

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

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

encoding

String

null

出力で使用するエンコード (UTF-8 など)。

enforceRequires

Boolean

false

true​ に設定されていると、必須値がない場合にエラーが発生します。

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

fillRedefinesByMaxLength

Boolean (ブール)

false

true​ に設定した場合、フラットファイルモジュールは、値が欠落しているとみなされる ​Redefines​ コンポーネントに、​maxLength​ パラメーターに設定された最大文字数まで入力します。
false​ に設定した場合、モジュールはすべての定義済みの表示オプションを使用して、​Redefines​ コンポーネントへの入力方法を決定します。

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

missingValues

String

null

欠落値を表すために使用される文字を入力します。デフォルト以外の設定をアクティブ化するには、​useMissCharAsDefaultForFill​ プロパティを ​true​ に設定し、​missingValues​ に次のいずれかの値を使用します。

  • none​ (リーダーの場合) または ​NONE​ (ライターの場合): すべてのデータを値として処理する。

  • spaces​ (リーダーの場合) または ​SPACES​ (ライターの場合): スペースのみで構成される項目を欠落値として解釈する。フラットファイルまたは固定幅形式のデフォルトです。

  • zeroes​ (リーダーの場合) または ​ZEROES​ (ライターの場合): 0​ 文字のみで構成される数値項目​と​スペースのみで構成される文字項目を欠落値として解釈する。

  • nulls​ (リーダーの場合) または ​NULLS​ (ライターの場合): 0​ バイトのみで構成される項目を欠落値として解釈する。COBOL コピーブックスキーマのデフォルトです。

有効な値は ​none​、​spaces​、​zeroes​、​nulls​ です。

notTruncateDependingOnSubjectNotPresent

Boolean (ブール)

false

DEPENDING ON の対象が存在しない場合にグループ全体を入力します。

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

recordTerminator

String

null

レコード区切り文字の改行。DataWeave では、複数のレコードがある場合にのみ区切り文字としてこのプロパティを使用されます。値は文字コードに直接変換されます (​none​ では各レコードの終端はありません)。

有効な値は ​lf​、​cr​、​crlf​、​none​ です。

schemaPath​ (必須)

String

null

スキーマ定義へのパス。入力を解析するスキーマファイルのローカルディスク内の場所を指定します。

segmentIdent

String

null

固定幅のスキーマまたは COBOL コピーブックスキーマのセグメント識別子。スキーマに複数のセグメント定義が含まれている場合、単一セグメントまたはレコード定義を解析するときに必要になります。

structureIdent

String

null

フラットファイルスキーマの構造識別子。スキーマに複数の構造定義が含まれている場合、構造定義を解析するときに必要になります。

trimValues

Boolean

false

項目の幅より長い値を切り捨てます。

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

truncateDependingOn

Boolean

false

COBOL コピーブックの DEPENDING ON 値を、使用される長さに切り捨てます。

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

useMissCharAsDefaultForFill

Boolean (ブール)

false

デフォルトでは、フラットファイルリーダーおよびライターでは、欠落文字にスペースが使用され、​missingValues​ プロパティの設定が無視されます。このプロパティを ​true​ に設定すると、DataWeave は ​missingValues​ プロパティの設定に従います。2021 年 9 月リリースの Mule 4.3.0-20210823 の DataWeave 2.3 (2.3.0-20210823) で導入されました。

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

zonedDecimalStrict

Boolean

false

COBOL コピーブックのゾーン 10 進数値に署名エンコードの 'strict' ASCII 形式を使用します。

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

*/flatfile