> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 必須要素、オプション要素、および禁止要素

> FlexiLayout Studio で必須、オプション、禁止の要素を使用して、文書を識別し、マッチングを継続し、誤った仮説を破棄します。

半構造化文書の大きな特徴の 1 つは、フィールドのセットが文書ごとに異なる場合があることです。要素を作成する際は、その要素で記述される 1 つまたは複数のオブジェクトが一部の画像には存在せず、したがって検出されない可能性があることを念頭に置いてください。

また、不適切な scanning によって画像に暗い部分や明るい部分が生じると、画像情報が失われることがあります。そのような部分にあるオブジェクトも検出されません。

特定のオブジェクトが検出されない場合でも FlexiLayout Studio が FlexiLayout のマッチングを続行できるようにするには、そのオブジェクトをオプションとしてマークします。

<div id="required-elements">
  ## 必須要素
</div>

**必須**要素で記述されたオブジェクトは画像上に常に存在していなければならず、プログラムは画像と [FlexiLayout をマッチング](/ja/flexi-capture/fls/settings/analyze) するときにそれらを見つけなければなりません。オブジェクトが検出されない場合、FlexiLayout Studio は FlexiLayout のマッチングを停止します。

必須要素は、識別用オブジェクトを見つけるために使用します。識別用オブジェクトは、現在の FlexiLayout で記述されていない別の種類の文書に対して FlexiLayout がマッチングされるのを防ぎます。また、存在しない場合はそれ以上検索しても意味がないオブジェクトを記述するためにも、必須要素を使用できます。

<div id="optional-elements">
  ## オプション要素
</div>

それ以外のすべてのケースでは、画像オブジェクトを記述するために **オプション** 要素を使用します。

このような要素で記述されるオブジェクトは、画像上に存在していなくてもよく、また FlexiLayout のマッチング時にプログラムがそれらを検出できない場合もあります。それでもマッチングは継続され、プログラムは他の要素で記述されたオブジェクトを検出します。

デフォルトでは、すべての単純要素はオプションです。

<Note>
  単純要素とは異なり、すべてのグループ要素はデフォルトで必須です。
</Note>

<div id="prohibited-elements">
  ## 禁止要素
</div>

仮説の連鎖内に特定の要素が存在することは、その連鎖が正しくなく、破棄すべきであることを意味する場合があります。これらの要素は **禁止** 要素と呼ばれます。プログラムが禁止要素に遭遇すると、その branch での仮説生成を停止します。

したがって、要素は文書の識別 (必須要素) 、ブロックの検出 (必須要素とオプション要素) 、および誤った仮説の破棄 (禁止要素) に使用できます。たとえば、禁止要素を使用すると、誤った FlexiLayout マッチングを防ぐことができます。

<div id="specify-how-an-element-is-used">
  ## 要素の使用方法を指定する
</div>

要素の使い方は、**Properties** ダイアログ (**General** タブ) で指定できます。

必須要素と禁止要素は、次のように表示されます。

* **必須** 要素は緑色のマーカーで示されます： <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Element_Req.gif?s=8e24babc9e4b191fff427fcb1bda7a1e" alt="必須要素を示す緑色のマーカー" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="20" height="18" data-path="images/flexi-capture/fls/Element_Req.gif" />
* **禁止** 要素は赤色のマーカーで示されます： <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Element_Stop.gif?s=ae15d3d927cfd8a7e85c7dddceb2175e" alt="禁止要素を示す赤色のマーカー" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="19" height="17" data-path="images/flexi-capture/fls/Element_Stop.gif" />
