> ## 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.

# Éléments Group

> Les éléments Group regroupent des sous-éléments en une seule unité, ce qui simplifie les tests, limite la croissance des hypothèses et permet de partager des contraintes de recherche dans un FlexiLayout.

**Group** est une collection de plusieurs éléments (appelés sous-éléments). Les sous-éléments peuvent, à leur tour, être des éléments **Group**.

Les éléments **Group** sont signalés par <img src="https://mintcdn.com/abbyy/fmgRWFNHKYN2MLSg/images/flexi-capture/fls/Group.gif?s=ce526e276d21a413d788306923ec879d" alt="icône d’élément Group" style={{display:"inline-block",verticalAlign:"middle",margin:0}} width="18" height="12" data-path="images/flexi-capture/fls/Group.gif" /> dans l’arborescence FlexiLayout.

<Note>
  Les éléments **Group** incluent également [Header](/fr/flexi-capture/fls/template/elements-header-footer), [Footer](/fr/flexi-capture/fls/template/elements-header-footer), [First Found](/fr/flexi-capture/fls/template/first-found) et [Repeating Group](/fr/flexi-capture/fls/template/repeatable-group).

  Utilisez les éléments **Header** et **Footer** pour détecter le début et la fin d’un document. Chacun ne peut apparaître qu’une seule fois dans un document.

  **Repeating Group** est un élément **Group** récurrent. Un élément [Labeled Field](/fr/flexi-capture/fls/template/labeled-field) peut également être représenté sous forme d’élément composé.
</Note>

<div id="how-group-elements-are-detected">
  ## Détection des éléments Group
</div>

Si nécessaire, vous pouvez spécifier le nombre minimal de sous-éléments à détecter. Si moins de sous-éléments sont détectés lorsque le FlexiLayout est appliqué, l’élément composé est considéré comme non détecté.

Un élément **Group**, tout comme un élément simple, peut être obligatoire, facultatif ou prohibé. Si un élément **Group** facultatif contient un élément obligatoire, l’impossibilité d’associer cet élément à un objet entraîne une hypothèse nulle pour l’élément **Group**, et le programme continue d’essayer d’associer le FlexiLayout.

Évitez de conserver des éléments composés vides (c’est-à-dire des éléments composés sans sous-éléments). Si le programme rencontre un élément composé vide lors de la compilation d’un FlexiLayout, il affiche un message d’avertissement.

Les éléments **Header** et **Footer** sont ajoutés par défaut. Si votre FlexiLayout ne les utilise pas, supprimez ces éléments redondants.

<div id="when-to-use-group-elements">
  ## Quand utiliser les éléments Group
</div>

Les éléments **Group** sont utiles dans les cas suivants :

* Pour faciliter le test de parties indépendantes d’un FlexiLayout.

  Par exemple, un FlexiLayout composé de 100 éléments peut ne contenir que 3 éléments **Group** : le titre, le corps du document et le bas du document. Chacun de ces trois éléments **Group** contient des éléments **Group** qui décrivent des portions plus petites du document.

  Cette approche limite à la fois le nombre de variantes possibles à prendre en compte et facilite le débogage du FlexiLayout, car chaque groupe peut être modifié et testé indépendamment.
* Pour faciliter la navigation dans l’arborescence FlexiLayout.
* Pour réduire le nombre de [hypothèses d’élément](/fr/flexi-capture/fls/hypotheses/hyp-general) et ainsi accélérer l’élaboration de l’hypothèse finale.

  Le regroupement des éléments permet au programme de considérer un jeu d’éléments comme un tout, pour lequel une seule hypothèse est formulée (bien qu’elle soit constituée des hypothèses des sous-éléments) et dont la qualité peut être calculée.

  Différentes combinaisons d’hypothèses de sous-éléments sont prises en compte à l’intérieur du groupe, et seul un certain nombre des meilleures hypothèses de groupe est utilisé pour la recherche dans les niveaux inférieurs de l’arborescence. Le nombre par défaut des meilleures hypothèses pour un élément **Group** est de 1.

  <Warning>
    Il n’est pas recommandé d’augmenter le nombre maximal d’hypothèses, car cela peut entraîner une croissance incontrôlable de l’arborescence et empêcher d’associer le FlexiLayout aux images.
  </Warning>
* Pour spécifier une contrainte de recherche commune à tous les sous-éléments. La zone de recherche d’un élément particulier sera calculée comme l’intersection entre la zone de recherche spécifiée dans le sous-élément et la zone de recherche du groupe entier.

  <Tip>
    Il arrive que l’intersection entre la zone de recherche d’un élément **Group** et celle de l’un de ses sous-éléments soit vide, et que le programme ne parvienne pas à trouver le sous-élément. Essayez de ne spécifier que des relations simples pour les éléments **Group**, par exemple `Above: PageRect.Top + PageRect.Height/2;` (c’est-à-dire « rechercher l’élément dans la moitié supérieure de l’image »), ou de ne spécifier aucune relation.
  </Tip>

<div id="related-topics">
  ## Rubriques connexes
</div>

* [Créer, copier et supprimer des éléments](/fr/flexi-capture/fls/template/elements-simple)
* [Vue d’ensemble des propriétés des éléments](/fr/flexi-capture/fls/template/elements-properties)
* [Zone de recherche](/fr/flexi-capture/fls/template/search-constraints)
* [Contraintes de recherche supplémentaires](/fr/flexi-capture/fls/template/advanced-constraints)
