ItemExclude
このエレメントを使用して、 COBOL 構造の個々のデータ項目が XML メッセージのエレメントにならないようにする。
除外ルールは、以下のように適用されます。
- 基本項目だけを指定することができます。 省略するグループ項目を指定すると、警告メッセージが出され、指定は無視されます。
- グループ内のすべての基本項目を省略すると、そのグループ項目は自動的に省略されます。
- ODO (可変サイズ反復項目) カウント変数を除外する場合は、その ODO サブジェクトも除外する必要があります。 この規則に従わない場合は、エラー・メッセージが出されます。
- ItemExclude要素は、ItemExclusionArray 内で任意の順序で表示できます。
- 言語構造内で名前の競合を解決する必要がある場合は、ドット区切りの親グループ名によって完全修飾されたデータ項目名を指定する必要があります。 それ以外の場合は、修飾は必要ありません。 例えば、以下の言語構造では、「CODE」という名前の両方の基本項目に対して修飾が必要です。
次のようになります: INPUT-MSG.COUNTRY.CODE (その項目と INPUT-MSG.ACTION.CODE (その項目を除外する場合)。 この規則に従わない場合は、エラー・メッセージが出されます。01 INPUT-MSG. 02 COUNTRY. 03 CODE pic 999. 02 ACTION. 03 CODE pic 9. - ItemExclude 属性の値には、大/小文字の区別はありません。 例えば、'itemName="FoO.bAr"指定することは、'itemName="fOo.BaR"を指定することと同じである。
- ItemExclude で指定された項目がソース言語構造で見つからない場合、警告メッセージが発行されます。
保存先
ItemExclusionArray次を含む
なし属性
| フィールド | 説明 |
|---|---|
属性: itemName
有効な値: 説明を参照 必須?: はい デフォルト値: なし |
選択するデータ項目の名前を指定します。 |
例
以下の COBOL の言語構造について
01 INPUT-MSG.
02 IN-LL PICTURE S9(3) COMP.
02 IN-ZZ PICTURE S9(3) COMP.
02 IN-TRCD PICTURE X(10).
02 IN-CMD PICTURE X(8).
02 IN-NAME PICTURE X(10).
02 IN-EXTN PICTURE X(10).
以下の設定を使用して、IN-LL、IN-ZZ、および IN-EXTN データ項目が、生成された XML メッセージ内のエレメントにならないようにすることができます。
<ItemExclusionArray>
<ItemExclude itemName="IN-LL"/>
<ItemExclude itemName="IN-ZZ"/>
<ItemExclude itemName="IN-EXTN"/>
</ItemInclusionArray>