繰り返しグループ は、要素の繰り返しグループを検出するための要素です (繰り返し回数が事前にわからない場合があります) 。グループは、同一ページ内で繰り返される場合もあれば、複数ページにまたがるシート上で繰り返される場合もあります。
プロジェクト ツリーでは、繰り返しグループ 要素は で示されます。
文書内で要素のグループが繰り返し現れる場合は、そのプロパティを 1 回だけ記述し、各グループを個別に記述する代わりに、想定される繰り返し回数を指定できます。
用途の例:
複数ページ文書の各ページで同じ名前を検索する
繰り返し現れるデータを検索する (繰り返し出現するインスタンスの正確な数が事前にわからない場合。例: 複雑な行を持つテーブル)
繰り返しグループ要素は、追加の検索条件と繰り返しパラメーターを持つ点で、グループ要素とは異なります。
FlexiLayout を適用して要素の繰り返しグループが検出されると、一部の要素のキャプションが画像に重なって表示されることがあります。キャプションを非表示にするには、Image ウィンドウ内の任意の場所を右クリックし、ショートカット メニューの [Show Captions of Regions on Image] オプションのチェックを外します。
検出対象オブジェクトのパラメーターを定義する繰り返しグループ要素のプロパティ
検出対象オブジェクトのパラメーターを定義するプロパティは、要素のProperties ダイアログの繰り返しグループタブで指定します。Properties ダイアログを開くには、FlexiLayout ウィンドウで要素を右クリックし、ショートカットメニューから Properties… を選択します。
Properties ダイアログの[繰り返しグループ]タブを表示
繰り返しグループのインスタンスを検索する方法は 2 つあります。文書全体を対象に検索する方法と、個々のページごとに検索する方法です。これに応じて、グループインスタンスの最小数と最大数を、文書全体に対して、または各ページに対して指定します。
繰り返しグループに必須 要素が含まれている場合、その要素はインスタンスをマッチングするための識別子として機能します。たとえば、field グループの繰り返しグループ名を必須要素として指定すると、プログラムは検出された名前の数だけインスタンスを作成します。
ヌル仮説の品質は、インスタンスの集合全体ではなく、1 つのインスタンスに対して指定されます。このパラメーターは、インスタンスを形成する基準としても機能します。生成された仮説の品質がヌル仮説の品質より低い場合、インスタンスは形成されません。
文書全体でグループインスタンスを検索するには、Document モードオプションを選択し、次を指定します。
Min repetitions - 文書内のグループインスタンスの最小数
Max repetitions - 文書内のグループインスタンスの最大数
文書内で想定される数のグループインスタンスが検出されない場合、繰り返しグループは未検出と見なされます。最大数のインスタンスが検出されると、検索は停止します。このデフォルトの検索モードでは、グループインスタンス (通常のグループ要素と同様に、subelement の仮説で構成されます) が文書の複数ページにまたがることがあります。
個々のページでグループインスタンスを検索するには、Page モードオプションを選択します。このモードでは、各インスタンスは文書内の 1 ページにのみ存在できます。たとえば、通し見出しを検索する場合にこのモードを使用できます。このモードでは、最初に該当する可能性のあるページから最後のページまで、上から下へ検索が実行されます。このモードでは、次の検索パラメーターを使用できます。
Min repetitions on page – ページごとのインスタンスの最小数を指定します。現在のページで最小数のインスタンスが検出されない場合、繰り返しグループは未検出と見なされます。
Max repetitions on page – ページごとのインスタンスの最大数を指定します。現在のページで必要な数のインスタンスが検出されると、そのページでの検索は停止し、次のページに進みます。
要素のインスタンスには、次の制約があります。2 つのインスタンスが重なり合うことはできません。これは、すでに検出されたインスタンスを強制的に除外 (Exclude) することで実現されます。Relationsタブでは、すでに検出されたインスタンスに基づいて、Next instance の制約を設定できます。
たとえば、各 Next instance を直前のインスタンスより下で探すようにプログラムに指示できます。Relationsタブで、繰り返しグループに対して BELOW 制約を設定します。
グループ内の subelement には、ページ上端に対する位置を定義する Nearest リレーションを指定することをお勧めします。そうしないと、プログラムは検索領域内 (最後に検出されたインスタンスより下) にあるすべてのインスタンスに最良品質基準を適用して、グループの Next instance を選択します。すると、プログラムは現在のインスタンス (品質がより高いもの) の下で次のインスタンスを探すため、品質の高いインスタンスより上にある低品質のインスタンスがまったく検出されない可能性があります。
要素の作成、コピー、削除
要素のプロパティの概要
検索領域
追加検索条件
繰り返しグループ要素の追加検索条件