繰り返しグループ は、要素の繰り返しグループを検出するための要素です (繰り返し回数が事前にわからない場合があります) 。グループは、同じページ内で繰り返される場合もあれば、複数ページにまたがるシート上で繰り返される場合もあります。
プロジェクト ツリーでは、繰り返しグループ 要素は 
で示されます。
文書内で要素のグループが繰り返し現れる場合は、そのプロパティを 1 回だけ記述し、各グループを個別に記述する代わりに、想定される繰り返し回数を指定できます。
用途の例:
- 複数ページ文書の各ページで同じ名前を検索する
- 繰り返し現れるデータを検索する (繰り返し出現するインスタンスの正確な数が事前にわからない場合。たとえば、複雑な行を持つテーブル)
繰り返しグループ 要素は、追加の検索条件と繰り返しパラメーターを持つ点で、グループ 要素とは異なります。
FlexiLayout を適用して要素の繰り返しグループが検出されると、一部の要素のキャプションが画像に重なって表示されることがあります。キャプションを非表示にするには、Image ウィンドウ内の任意の場所を右クリックし、ショートカット メニューの Show Captions of Regions on Image オプションのチェックを外します。
検出するオブジェクトのプロパティは、要素のプロパティダイアログの繰り返しグループタブで指定します。
プロパティダイアログを開くには、FlexiLayoutウィンドウで要素を右クリックし、ショートカット メニューの**プロパティ…**を選択します。
繰り返しグループのインスタンスを検索する方法は 2 つあります。ドキュメント全体を対象に検索する方法と、個々のページごとに検索する方法です。これに応じて、グループ インスタンスの最小数と最大数は、ドキュメント全体に対して指定することも、個々のページに対して指定することもできます。
繰り返しグループに必須要素が含まれている場合、その要素はインスタンスをマッチングするための識別子として使用されます。たとえば、field の繰り返しグループ名を必須要素として指定すると、プログラムは検出した名前の数だけインスタンスを作成します。
ヌル仮説の品質は、インスタンスの集合全体ではなく、1 つのインスタンスに対して指定されます。このパラメーターは、インスタンスを形成するための基準としても機能します。生成された仮説の品質がヌル仮説の品質より低い場合、インスタンスは形成されません。
ドキュメント全体でグループ インスタンスを検索するには、文書モード オプションを選択し、次を指定します。
- Min repetitions — ドキュメント内のグループ インスタンスの最小数。
- Max repetitions — ドキュメント内のグループ インスタンスの最大数。
ドキュメント内でグループ インスタンスの最小数が検出されない場合、繰り返しグループは未検出と見なされます。インスタンスの最大数が検出されると、検索は停止します。この既定の検索モードでは、グループ インスタンス (通常の グループ 要素と同様に、そのサブ要素の仮説で構成されます) はドキュメントの複数ページにまたがることができます。
個々のページでグループ インスタンスを検索するには、ページ モード オプションを選択します。このモードでは、各インスタンスはドキュメント内の 1 ページにのみ存在できます。たとえば、ページごとに繰り返し現れる名前を検索する場合に、このモードを使用できます。
検索は、該当しうる最初のページから最後のページまで、上から下へ実行されます。
このモードでは、次の検索パラメーターを使用できます。
- Min repetitions on page — ページごとのインスタンスの最小数を指定します。現在のページでインスタンスの最小数が検出されない場合、繰り返しグループは未検出と見なされます。
- Max repetitions on page — ページごとのインスタンスの最大数を指定します。現在のページで必要な数のインスタンスが検出されると、そのページでの検索は停止し、次のページで続行されます。
要素のインスタンスには、次の制約があります。2 つのインスタンスが重なり合うことはできません。これは、すでに検出されたインスタンスを強制的に除外 (Exclude) することで実現されます。Relationsタブでは、すでに検出されたインスタンスに基づいて、次のインスタンスの制約を設定できます。
たとえば、各次のインスタンスを直前のインスタンスより下で探すようにプログラムに指示できます。Relationsタブで、繰り返しグループに対して Below 制約を設定します。
Specify a Nearest relation for a subelement in the group, defining its position relative to the top edge of the page.Otherwise, the program selects the next instance of the group by applying the best quality criterion to all the instances in the search area (below the last detected instance). The program then looks for the next instance below the current instance, whose quality is higher.As a result, poor-quality instances located above the higher-quality instance might not be detected at all.
