---
schema_version: "1"
id: 987222e6b924bc47736234184bc6ad7b968c735efb1af9145f25e8c2c0c58340
title: フラットファイルスキーマ
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/dataweave/2.5/dataweave-flat-file-schemas.md
canonical_url: https://docs.mulesoft.com/jp/dataweave/2.5/dataweave-flat-file-schemas
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 434886df2f354c5cacff3d40300c952f3157e9263ec5840a7c8c4b66dbf37a5a
description: MuleSoft Documentation Site
release: "2.5"
latest: false
---
# フラットファイルスキーマ

DataWeave ではさまざまな種別のデータを処理できます。このほとんどの種別で、入力構造を記述するスキーマをインポートし、設計時に価値あるメタデータにアクセスできます。 開始する前に、Mule 4 アプリケーションでは DataWeave のバージョン 2.x が使用されることに注意してください。Mule 3 アプリケーションでの DataWeave については、​[DataWeave バージョン 1.2 のドキュメント](#1.2@dataweave::index.adoc)​を参照してください。 他の Mule バージョンの場合は、DataWeave の目次のバージョンセレクターを使用できます。

DataWeave では、フラットファイルスキーマを表す FFD (Flat File Definition) と呼ばれる YAML 形式を使用します。FFD 形式は、広範なユースケースをサポートするのに十分な柔軟姓を備え、要素、複合、セグメント、グループ、および構造の概念に基づきます。

スキーマはフラットファイルスキーマ言語で記述する必要があり、慣例により ​`.ffd`​ 拡張子を使用します。この言語は、Anypoint Studio でも受け入れることができる EDI スキーマ言語 (ESL) によく似ています。

DataWeave では、プロパティを使用して入力または出力をフラットファイルスキーマにバインドできます。

固定幅の簡単な形式を使用する場合、​`Fixed Width`​ 型を使用してデータ型を Transform コンポーネントから直接セットアップできます。Studio でこの型のインスタンスを作成すると、一致するスキーマ定義が自動的に生成されます。

## [](#スキーマ内のコンポーネントの種別)スキーマ内のコンポーネントの種別

フラットファイルスキーマを構成するさまざまな種別のコンポーネントを、最も基本的なものからより複雑なものまで以下に示します。要素とセグメントは常に必須です。複合、グループ、構造は、​[ドキュメントの最上位構造](#top_level_structure)​に応じて必要になる場合があります。

- 要素 - 要素は基本データ項目です。これには、型と固定幅が関連付けられているほか、データ値の読み書きの方法を示す書式オプションがあります。
- 複合 - (省略可能) 要素のグループ。これには、他の子複合を含めることもできます。
- セグメント - 反復可能な任意の数の要素または複合で構成される一行のデータ (レコード)。
- グループ - (省略可能) まとめられた複数のセグメント。これには、他の子グループを含めることもできます。
- 構造 - セグメントの階層構成。これには、データの一部として一意の識別子コードが含まれている必要があります。

## [](#top_level_structure)FFD ドキュメントの最上位構造

FFD ドキュメントの最上位定義はスキーマの形式から始まります。この場合は、常に「FLATFILE」、「COPYBOOK」、または「FIXEDWIDTH」である必要があります。これらの形式の違いはわずかで、そのほとんどは、Studio での処理方法に関連します。残りは、ファイルに含まれる定義のフォームに依存し、次の選択肢があります。

- 単一セグメント - 最上位に直接配置されたセグメント情報 (セグメントの要素または複合の詳細を提供する ​`values`​ キーを含む)。
- 複数セグメント - 1 つの ​`segments`​ キーと複数の子オブジェクト。各オブジェクトで 1 つのセグメントを定義します。
- 複数構造 - 1 つの ​`structures`​ キーと複数の子オブジェクト。各オブジェクトで 1 つの構造を定義します。

### [](#単一セグメント)単一セグメント

1 つのタイプのレコードのみを使用する場合、FFD ではそのレコードタイプのセグメント定義のみが必要です。

![複数の要素とセグメントを含むフラットファイルスキーマ](/mulesoft/current/ja-jp/dataweave/2.5/_images/dataweave-flat-file-schemas-22788.png)

これは 1 つのセグメントのみを持つ単純なスキーマです。

```yaml
form: FLATFILE
id: 'RQH'
name: Request Header Record
values:
- { name: 'Organization Code', type: String, length: 10 }
- { name: 'File Creation Date', type: Date, length: 8 }
- { name: 'File Creation Time', type: Time, length: 4 }
```

上の例では、単一セグメント内で要素のリストを定義しているのみです。これらの要素をまとめる複合はありません。

別の例を次に示します。

```yaml
form: FIXEDWIDTH
name: my-flat-file
values:
- { name: 'Row-id', type: String, length: 2 }
- { name: 'Total', type: Decimal, length: 11 }
- { name: 'Module', type: String, length: 8 }
- { name: 'Cost', type: Decimal, length: 8, format: { implicit: 2 } }
- { name: 'Program-id', type: String, length: 8 }
- { name: 'user-id', type: String, length: 8 }
- { name: 'return-sign', type: String, length: 1 }
```

単にわかりやすくすることを目的として形式を簡略化しています。1 つの子セグメント定義のみの場合も ​`segments`​ キーを使用できます。

### [](#複数セグメント)複数セグメント

同じ変換で複数のタイプのレコードを使用する場合、その異なるレコードの組み合わせ方法を制御する構造定義を使用する必要があります。

![要素とセグメントを含むフラットファイルスキーマ](/mulesoft/current/ja-jp/dataweave/2.5/_images/dataweave-flat-file-schemas-680c6.png)

ほとんどの場合、異なるタイプのレコードの識別方法を定義する必要があります。これを行うには、レコード定義の一部として ​`tagValue`​ 項目を識別します。パーサーは、各レコードの項目のコンテンツを確認し、レコードタイプを識別した後、定義された構造にレコードがどのように収められているかを確認します。

複数のコンポーネントレコードタイプを持つ完全な構造スキーマの例を次に示します。

```yaml
form: FIXEDWIDTH
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - groupId: 'Batch'
    count: '>1'
    items:
    - { idRef: 'BCH' }
    - { idRef: 'TDR', count: '>1' }
    - { idRef: 'BCF' }
  - { idRef: 'RQF' }
segments:
- id: 'RQH'
  ...
```

この例は完全ではありません。参照する各セグメントを最後に定義する必要があります。この例でこれらのセグメントを参照する方法については、​[「参照された定義とインライン化された定義の比較」](#referenced_vs_inlined_defs)​を参照してください。

### [](#複数構造)複数構造

FFD に複数の構造またはセグメント定義がある場合、スキーマを Transform コンポーネントのメタデータ記述に適用するときに、どれを使用するかを指定する必要があります。

![グループ、セグメント、要素が表示されているフラットファイルスキーマ](/mulesoft/current/ja-jp/dataweave/2.5/_images/dataweave-flat-file-schemas-4e1eb.png)

複数構造を持つスキーマの最上位構造は次のようになります。

```yaml
form: FIXEDWIDTH
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - groupId: 'Batch'
    usage: O
    count: '>1'
    items:
    - { idRef: 'BCH' }
    - { idRef: 'TDR', count: '>1' }
    - { idRef: 'BCF' }
  - { idRef: 'RQF' }
- id: 'BatchRsp'
  name: Batch Response
  data:
  - { idRef: 'RSH' }
  - groupId: 'Batch'
    usage: O
    count: '>1'
    items:
    - { idRef: 'BCH' }
    - { idRef: 'TDR', count: '>1' }
    - { idRef: 'BCF' }
  - { idRef: 'RSF' }
segments:
- id: 'RQH'
  ...
```

この例では、2 つの異なる構造 (​`BatchReq`​ 構造と ​`BatchRsp`​ 構造) を定義します。この各構造で特定のセグメント順序およびセグメントグループを使用します。グループ ​`Batch`​ は両方の構造で反復されます。Batch グループは 1 つの BCH 行、複数の TDR 行、および 1 つの BCF 行で構成されます。

この例は完全ではありません。参照する各セグメントを最後に定義する必要があります。この例でこれらのセグメントを参照する方法については、​[「参照された定義とインライン化された定義の比較」](#referenced_vs_inlined_defs)​を参照してください。

## [](#要素定義)要素定義

要素定義は、標準特性の基本的なキー-値ペアで構成される、アプリケーションデータの基本構成要素です。フラットファイルスキーマではインライン要素定義が一般的に使用されます。この定義では、各要素がセグメントまたは複合構造内の各要素の使用場所で定義されますが、要素を個別に定義して必要に応じて参照することもできます。参考用に定義したいくつかの要素定義を次に示します。

```yaml
  - { id: 'OrgCode', name: 'Organization Code', type: String, length: 10 }
  - { id: 'CreateDate', name: 'File Creation Date', type: Date, length: 8 }
  - { id: 'CreateTime', name: 'File Creation Time', type: Time, length: 4 }
  - { id: 'BatchTransCount', name: 'Batch Transaction Count', type: Integer, format: { justify: zeroes }, length: 6 }
  - { id: 'BatchTransAmount', name: 'Batch Transaction Amount', type: Integer, format: { justify: zeroes }, length: 10 }
```

指定された ​`id`​ 値は、セグメントまたは複合の一部としてこれらの定義のいずれかを参照する場合に ​`idRef`​ 値として使用されます。要素をセグメント定義内でインラインで定義する場合 (ドキュメントの最後に要素を定義して参照する方法とは対照的)、​`id`​ 項目は不要です。

要素定義には次の属性が含まれる可能性があります。これらは、インライン定義、参照された定義 (上の例を参照)、または定義への参照に適用されるものとして、「形式」によって分類されます。

<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 1. 属性</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</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>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>count</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">出現数 (省略可能、デフォルトは ​<code>1</code>​)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インラインまたは参照</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>id</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要素識別子</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">参照された定義</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>idRef</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要素識別子</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">参照</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要素名 (省略可能)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">すべて</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">値の型コード (以下のリストを参照)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン、または参照された定義</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>format</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">型固有の書式情報</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン、または参照された定義</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>length</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">値の文字位置の数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン、または参照された定義</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>tagValue</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">セグメントを識別するために使用するこの要素の値 (​<a href="#full_schema_ex">「スキーマの完全な例」</a>​を参照)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン、または参照された定義</p></td>
</tr>
</tbody>
</table>

要素の定義で許可される型を次に示します。

<table class="tableblock frame-all grid-all fit-content spread">
<caption class="title">Table 2. 型</caption>
<colgroup>
<col>
<col>
</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"><p class="tableblock">Binary (バイナリ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">バイナリ値 (COBOL 形式、2、4、8 バイト)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean (ブール)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ブール値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Date (日付)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">年、月、および日コンポーネントを持つ非ゾーン日付値 (一部はテキスト形式で表示されない場合があります)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DateTime</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">年、月、日、時、分、秒、およびミリ秒コンポーネントを持つ非ゾーン日時値 (一部はテキスト形式で表示されない場合があります)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Decimal (10 進数)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">10 進数値。テキスト形式に明示的な小数点が含まれる場合と含まれない場合があります</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Integer (整数)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">整数値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Packed (パック)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">10 進数値のパック 10 進数表現 (COBOL 形式)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">文字列値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Time (時刻)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">時、分、秒、およびミリ秒コンポーネントを持つ非ゾーン時刻値 (一部はテキスト形式で表示されない場合があります)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Zoned (ゾーン)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ゾーン 10 進数 (COBOL 形式)</p></td>
</tr>
</tbody>
</table>

値の型では、値のテキスト形式に影響するさまざまな書式オプションがサポートされます。主なオプションと適用先の型を以下に示します。

<table class="tableblock frame-all grid-all fit-content spread">
<caption class="title">Table 3. 書式オプション</caption>
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Key (キー)</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">digits (桁数)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">許可される桁数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Binary (バイナリ)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">implicit (暗黙的)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">暗黙的な小数点以下桁数 (テキスト形式で小数点のない固定小数点値で使用されます)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Binary (バイナリ)、Decimal (10 進数)、Packed (パック)、Zoned (ゾーン)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">justify (行揃え)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">項目内の行揃え (LEFT、RIGHT、NONE、または ZEROES。ZEROES は数値のみで使用)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Binary (バイナリ) と Packed (パック) 以外のすべて</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">pattern (パターン)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">数値の場合、解析および書き込み用の ​<code>java.text.DecimalFormat</code>​ パターン。日時値の場合、​<code>java.time.format.DateTimeFormatter</code>​ パターン。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Date (日付)、DateTime、Decimal (10 進数)、Integer (整数)、Time (時刻)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">署名</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">数値の符号の使用方法 (UNSIGNED、​NEGATIVE_ONLY​、OPTIONAL、​ALWAYS_LEFT​、​ALWAYS_RIGHT​)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Decimal (10 進数)、Integer (整数)、Zoned (ゾーン)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">signed (符号あり)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">符号ありか符号なしかを示すフラグ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Binary (バイナリ)、Packed (パック)</p></td>
</tr>
</tbody>
</table>

## [](#複合定義)複合定義

複合は、通常一緒に存在する要素のリストを参照するのに役立ちます。たとえば、​`firstName`​ と ​`lastName`​ はグループとして参照される可能性があるため、それらをまとめて 1 つの複合にバンドルすることができます。要素を複合にまとめると、リストを反復することもできます。

複合定義は、セグメント定義によく似ており、標準特性のいくつかのキー-値ペアおよび値のリストで構成されます。複合には、要素または他のネストされた複合とインライン化された定義への両方の参照が含まれる可能性があります。複合定義の例を次に示します。

```yaml
- id: 'DateTime'
  name: 'Date/Time pair'
  values:
   - { name: 'File Creation Date', type: Date, length: 8 }
   - { name: 'File Creation Time', type: Time, length: 4 }
```

複合定義には、次の属性が含まれる可能性があります。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
</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>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>controlVal</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">実際の出現数を提供する、包含するレベルからの値 (​<code>count</code>​ != 1 でのみ使用)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン定義、または​<a href="#referenced_vs_inlined_defs">参照</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>count</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">出現数 (または ​<code>controlVal</code>​ が使用されている場合は最大数) (省略可能、デフォルトは ​<code>1</code>​)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インライン定義、または​<a href="#referenced_vs_inlined_defs">参照</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>id</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">参照の複合識別子</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#referenced_vs_inlined_defs">参照された定義</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">複合名 (省略可能)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インラインまたは​<a href="#referenced_vs_inlined_defs">参照された定義</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>values</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">複合内の要素と複合のリスト。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">インラインまたは​<a href="#referenced_vs_inlined_defs">参照された定義</a></p></td>
</tr>
</tbody>
</table>

この値リストはセグメント定義の値リストと同じ形式を使用します。

## [](#segment_definitions)セグメント定義

セグメントはデータ内のレコードのタイプを記述します。セグメントは主に要素と複合の参照または直接定義と、セグメントを記述するいくつかのキー-値ペアで構成されます。少し複雑なスキーマでは、2 つの異なるセグメントを含む構造を使用し、その 1 つのセグメントで部品表の単一ヘッダーに含める項目 (日付、人など) を記述し、もう 1 つのセグメントで部品表内の実際の各項目に含める繰り返し項目を記述することができます。

これは、1 つの簡単な要素と、2 つの要素が入っている複合を含むサンプルのセグメント定義です。

```yaml
- id: 'RQH'
  name: Request Header Record
  values:
   - { name: 'Organization Code', type: String, length: 10 }
   - id: 'DateTime'
     name: 'Date/Time pair'
     values:
      - { name: 'File Creation Date', type: Date, length: 8 }
      - { name: 'File Creation Time', type: Time, length: 4 }
```

セグメント定義には、次の属性が含まれる可能性があります。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</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"><p class="tableblock"><code>id</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">セグメント識別子 (インライン定義では使用せず、​<a href="#referenced_vs_inlined_defs">参照された定義</a>​では必須)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">セグメント名 (省略可能)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>values</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">セグメント内の要素と複合のリスト (インライン化、または​<a href="#referenced_vs_inlined_defs">参照</a>​)</p></td>
</tr>
</tbody>
</table>

## [](#structure_definitions)構造定義

構造定義はセグメントとグループ定義への参照のリスト、および標準特性の一連のキー-値ペアで構成されます。セグメントは、反復する可能性のある一連のセグメントで構成されるグループにさらに整理することができます。

サンプルの構造定義を次に示します。

```yaml
form: FIXEDWIDTH
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - groupId: 'Batch'
    count: '>1'
    items:
    - { idRef: 'BCH' }
    - { idRef: 'TDR', count: '>1' }
    - { idRef: 'BCF' }
  - { idRef: 'RQF' }
segments:
- id: 'RQH'
  ...
```

この例には、最上位の 2 つのセグメント (​`RQH`​ と ​`RQF`​) への参照、および他のセグメント (​`BCH`​、​`TDR`​、および ​`BCF`​) への参照を含むグループ定義 ​`Batch`​ が含まれます。この構造を機能させるには、​[参照された各セグメント](#segment_definitions)​を定義する必要があります。この例でセグメントを参照する方法については、​[「参照された定義とインライン化された定義の比較」](#referenced_vs_inlined_defs)​を参照してください。

構造定義には、次の属性が含まれる可能性があります。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</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"><p class="tableblock"><code>id</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">構造識別子</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">構造名 (省略可能)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>data</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">構造内のセグメント (およびグループ) のリスト</p></td>
</tr>
</tbody>
</table>

セグメントリスト内の各項目はセグメント参照 (またはインライン定義) またはグループ定義 (常にインライン) です。

### [](#グループ定義)グループ定義

グループ定義には、次の属性が含まれる可能性があります。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</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"><p class="tableblock"><code>groupId</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グループ識別子</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>usage</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">使用方法コード。必須 (Mandatory) を表す ​<code>M</code>​、省略可能 (Optional) を表す ​<code>O</code>​、未使用 (Unused) を表す ​<code>U</code>​ を使用できます (省略可能、デフォルトは ​<code>M</code>​)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>count</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">最大反復数の値。数値、または任意の反復数を意味する特別な値 ​<code>&gt;1</code>​ を使用できます (省略可能、指定しない場合は count 値 ​<code>1</code>​ を使用)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>items</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グループを構成するセグメント (およびネストされている可能性のあるグループ) のリスト。</p></td>
</tr>
</tbody>
</table>

## [](#referenced_vs_inlined_defs)参照された定義とインライン化された定義の比較

最上位形式の選択肢以外にも、構造、セグメント、または複合のコンポーネントを表すことに関して選択肢が用意されています。コンポーネントのセグメント、複合、および要素を使用場所でインラインで定義するか、それらをテーブル内で定義して任意の場所から参照できます。インライン定義のほうがより簡単でコンパクトですが、テーブル形式では定義を再利用できます。テーブル形式の例には ​`id`​ 値を含める必要があり、その定義への各参照で ​`idRef`​ を使用します。次の例は、構造を構成するセグメントにこれを適用する方法を示しています。

```yaml
form: FIXEDWIDTH
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - { idRef: 'RQF' }
segments:
- id: 'RQH'
  name: "Request File Header Record"
  values:
  - { idref: createDate }
  - { idref: createTime }
  - { idref: fileId }
  - { idref: currency }
- id: 'RQF'
  name: "Request File Footer Record"
  values:
  - { idref: batchCount }
  - { idref: transactionCount }
  - { idref: transactionAmount }
  - { idref: debitCredit }
  - { idref: fileId }
elements:
  - { id: createDate, type: Date, length: 8 }
  - { id: createTime, type: Time, length: 4 }
  - { id: fileId, type: String, length: 10 }
  - { id: currency, type: String, length: 3 }
  - { id: batchCount, type: Integer, format: { justify: zeroes }, length: 4 }
  - { id: transactionCount, type: Integer, format: { justify: zeroes }, length: 6 }
  - { id: transactionAmount, type: Integer, format: { justify: zeroes }, length: 12 }
  - { id: debitCredit, type: String, length: 2 }
```

上の例では、​`BatchReq`​ 構造は ​`data`​ 定義セクションのセグメントを参照しています。次に、スキーマの最上位の ​`segments`​ セクションでセグメントがそれぞれ定義され、後の ​`elements`​ セクションで定義されている要素を参照しています。

同じ構造のインライン化された定義は次のようになります。

```yaml
form: FIXEDWIDTH
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - { idRef: 'RQF' }
segments:
- id: 'RQH'
  name: "Request File Header Record"
  values:
  - { name: 'File Creation Date', type: Date, length: 8 }
  - { name: 'File Creation Time', type: Time, length: 4 }
  - { name: 'Unique File Identifier', type: String, length: 10 }
  - { name: 'Currency', type: String, length: 3 }
- id: 'RQF'
  name: "Request File Footer Record"
  values:
  - { name: 'File Batch Count', type: Integer, format: { justify: zeroes }, length: 4 }
  - { name: 'File Transaction Count', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'File Transaction Amount', type: Integer, format: { justify: zeroes }, length: 12 }
  - { name: 'Type', type: String, length: 2 }
  - { name: 'Unique File Identifier', type: String, length: 10 }
```

## [](#full_schema_ex)スキーマの完全な例

```yaml
form: FLATFILE
structures:
- id: 'BatchReq'
  name: Batch Request
  data:
  - { idRef: 'RQH' }
  - groupId: 'Batch'
    count: '>1'
    items:
    - { idRef: 'BCH' }
    - { idRef: 'TDR', count: '>1' }
    - { idRef: 'BCF' }
  - { idRef: 'RQF' }
segments:
- id: 'RQH'
  name: "Request File Header Record"
  values:
  - { name: 'Record Type', type: String, length: 3, tagValue: 'RQH' }
  - { name: 'File Creation Date', type: Date, length: 8 }
  - { name: 'File Creation Time', type: Time, length: 4 }
  - { name: 'Unique File Identifier', type: String, length: 10 }
  - { name: 'Currency', type: String, length: 3 }
- id: 'BCH'
  name: "Batch Header Record"
  values:
  - { name: 'Record Type', type: String, length: 3, tagValue: 'BAT' }
  - { name: 'Sequence Number', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'Batch Function', type: String, length: 1, tagValue: 'H' }
  - { name: 'Company Name', type: String, length: 30 }
  - { name: 'Unique Batch Identifier', type: String, length: 10 }
- id: 'TDR'
  name: "Transaction Detail Record"
  values:
  - { name: 'Record Type', type: String, length: 3, tagValue: 'BAT' }
  - { name: 'Sequence Number', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'Batch Function', type: String, length: 1, tagValue: 'D' }
  - { name: 'Account Number', type: String, length: 10 }
  - { name: 'Amount', type: Integer, format: { justify: zeroes }, length: 10 }
  - { name: 'Type', type: String, length: 2 }
- id: 'BCF'
  name: "Batch Footer Record"
  values:
  - { name: 'Record Type', type: String, length: 3, tagValue: 'BAT' }
  - { name: 'Sequence Number', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'Batch Function', type: String, length: 1, tagValue: 'T' }
  - { name: 'Batch Transaction Amount', type: Integer, format: { justify: zeroes }, length: 10 }
  - { name: 'Type', type: String, length: 2 }
  - { name: 'Batch Transaction Count', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'Unique Batch Identifier', type: String, length: 10 }
- id: 'RQF'
  name: "Request File Footer Record"
  values:
  - { name: 'Record Type', type: String, length: 3, tagValue: 'RQF' }
  - { name: 'File Batch Count', type: Integer, format: { justify: zeroes }, length: 4 }
  - { name: 'File Transaction Count', type: Integer, format: { justify: zeroes }, length: 6 }
  - { name: 'File Transaction Amount', type: Integer, format: { justify: zeroes }, length: 12 }
  - { name: 'Type', type: String, length: 2 }
  - { name: 'Unique File Identifier', type: String, length: 10 }
```

この例には、5 個のコンポーネント​[セグメント](#segment_definitions)​を持つ「BatchReq」という名前の 1 つの​[構造](#structure_definitions)​が含まれ、ファイルおよびセグメントのバッチデータの 2 重にネストされた構造を使用しています。各バッチには反復する詳細レコードが含まれています。すべての要素定義がインライン化されています。

`BatchReq`​ 構造定義では、データが次のレコードで構成されている必要があります。

- セグメント ​`RQH`​ に対応する 1 つのレコード
- セグメント ​`BCH`​ に対応する 1 つ以上のレコード
- `BCH`​ レコードごとに、特定のトランザクションの詳細を提供する 1 つ以上の ​`TDR`​ レコード
- `BCH`​ レコードごとに、包含する ​`TDR`​ レコードに続く ​`BCF`​ レコード
- 最後に、セグメント ​`RQF`​ に対応する 1 つのレコード

この例では、各レコードは、​`tagValue`​ が指定された 3 文字の「Record Type (レコードタイプ)」項目で始まります。バッチレコードの場合、レコードタイプは「Batch Function (バッチ関数)」の ​`tagValue`​ によってさらに指定されます。

スキーマ例に一致するデータのサンプルを次に示します。

```text
RQH201809011010A000000001USD
BAT000001HACME RESEARCH                 A000000001
BAT000002D01234567890000032876CR
BAT000003D01234567880000087326CR
BAT000004T0000120202CR000002A000000001
BAT000005HAJAX EXPLOSIVES               A000000002
BAT000006D12345678900000003582DB
BAT000007D12345678910000000256CR
BAT000008T0000003326DB000002A000000002
RQF0002000008000000116876CRA000000001
```

例内のインラインは、次のように定義された構造に一致します。

- 1 ​`RQH`​ (要求ファイルのヘッダーレコード) 最初の 3 文字の「RQH」値によって識別
- 2 ​`BCH`​ (バッチのヘッダーレコード) 最初の 3 文字の「BAT」値と位置 10 の「H」文字を組み合わせて識別
- 3-4 ​`TDR`​ (トランザクションの詳細レコード) 最初の 3 文字の「BAT」値と位置 10 の「D」文字を組み合わせて識別
- 5 ​`BCF`​ (バッチのフッターレコード) 最初の 3 文字の「BAT」値と位置 10 の「T」文字を組み合わせて識別
- 6 ​`BCH`​ (バッチのヘッダーレコード) 最初の 3 文字の「BAT」値と位置 10 の「H」文字を組み合わせて識別
- 7-8 ​`TDR`​ (トランザクションの詳細レコード) 最初の 3 文字の「BAT」値と位置 10 の「D」文字を組み合わせて識別
- 9 ​`BCF`​ (バッチのフッターレコード) 最初の 3 文字の「BAT」値と位置 10 の「T」文字を組み合わせて識別
- 10 ​`RQF`​ (要求ファイルのフッターレコード) 最初の 3 文字の「RQF」値によって識別

`tagValue`​ 項目は高い柔軟性を提供します。上の例では、一部のレコードタイプで単一の ​`tagValue`​ を使用し、他のレコードタイプで 2 番目の ​`tagValue`​ を追加していますが、さまざまなタイプのレコードをパーサーが識別できるように十分な詳細が提供されている限り、​`tagValue`​ でまったく異なる項目を (または、分離された一連の項目も) 使用することもできます。

古いバージョンのドキュメントでは、構造には ​`tagStart`​ と ​`tagLength`​ 値、セグメントには ​`tag`​ 値を使用して、タグ値に基づく異なる方法でレコードを識別していました。セグメントのこの識別方法は、​`tagValue`​ の方法よりも非常に多くの制限があり、廃止されました。

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

[サポートされるデータ形式](https://docs.mulesoft.com/jp/dataweave/2.5/dataweave-formats#format_flat_file)