Exemple 3. Étape 25 : détecter les champs TotalQuantity et TotalAmount à l’aide des éléments TotalQuantity et TotalAmount

Récupérez les valeurs de quantité totale et de montant total à l’aide des éléments Character String TotalQuantity et TotalAmount dans un groupe grTotal facultatif.

L’analyse des images de test montre que les champs quantité totale et montant total apparaissent uniquement ensemble avec le nom Footer.kwTotal et sur la même ligne.

Utilisez des éléments de type Character String pour détecter les champs quantité totale et montant total. Pour définir les contraintes de recherche communes aux deux, créez un élément Group nommé grTotal.

​

Créer l’élément Group grTotal

1. Créer l’élément Group

   Dans l’élément Footer, créez un élément Group et nommez-le grTotal.

2. Rendre le groupe facultatif

   Sélectionnez Optional element afin d’arrêter la recherche de sous-éléments si le nom est absent. Pour plus d’informations, consultez La propriété Optional d’un élément Group.

3. Ajouter la contrainte de recherche

   Cliquez sur l’onglet Advanced. Les champs quantité totale et montant total apparaissent uniquement avec le nom Footer.kwTotal. Définissez donc la contrainte de recherche supplémentaire suivante dans le champ relations avancées de pré-recherche : si l’élément Footer.kwTotal n’est pas détecté, ne recherchez pas l’objet. Dans le langage FlexiLayout :

   If Footer.kwTotal.IsNull Then DontFind;
   

​

Créer l’élément TotalQuantity

Le champ Quantité totale se situe à l’intersection de la ligne Total et de la colonne Quantité. Vous avez déjà défini la première contrainte au niveau de l’élément Group. Pour définir la seconde, utilisez comme élément de référence le nom de colonne détecté précédemment.

1. Créer l’élément Character String

   Dans l’élément grTotal, créez un élément de type Character String et nommez-le TotalQuantity.

2. Définir le nombre de caractères

   Cliquez sur l’onglet Character String. Dans le champ Nombre de caractères, spécifiez cet intervalle flou : {-1, 1, 10, INF}. Il permet d’estimer la longueur de la chaîne de caractères ; supposez que les valeurs sont comprises entre 1 et 10. Toute hypothèse en dehors de cette plage est pénalisée.

   Conservez les valeurs par défaut des autres propriétés de l’élément.

3. Définir les contraintes de position

   Cliquez sur l’onglet Relations. Le champ Quantité totale se situe toujours au même niveau que les mots-clés du nom Footer.kwTotal, ou légèrement plus bas. Définissez donc les contraintes de recherche suivantes :

   • Au-dessus de l’élément Footer.kwTotal, Décalage = -200, Limite de référence = Bottom
   • En dessous de l’élément Footer.kwTotal, Décalage = -20, Limite de référence = Top

   Lorsque vous choisissez les valeurs de décalage, analysez les propriétés géométriques (taille et limites) des objets voisins détectés lors de la pré-reconnaissance. Sinon, déterminez ces valeurs par tâtonnement.

4. Ajouter la contrainte de colonne

   Cliquez sur l’onglet Advanced. Le champ Quantité totale est facultatif, mais lorsqu’il est présent, il apparaît avec la colonne Quantité, sous son nom. Définissez cette contrainte de recherche supplémentaire dans le champ relations avancées de pré-recherche : recherchez l’objet uniquement si l’élément TableHeader.kwQuantity a été détecté, et pas à plus de 50 points à gauche ou à droite des limites correspondantes du nom de la colonne. Dans le langage FlexiLayout :

   If Not (TableHeader.kwQuantity.IsNull) Then
   {
   LeftOf: TableHeader.kwQuantity.Right, -50 * dot;
   RightOf: TableHeader.kwQuantity.Left, -50 * dot;
   }
   Else DontFind;
   
5. Vérifier la correspondance

   Associez le FlexiLayout aux images de test et vérifiez que FlexiLayout Studio détecte l’élément dans chaque image où il est présent.

6. Définir l’élément source du bloc

   Pour décrire l’emplacement du bloc TotalQuantity, sélectionnez élément source, cliquez sur , puis sélectionnez l’élément TotalQuantity comme élément source.

​

Créer l’élément TotalAmount

Le champ montant total se trouve à l’intersection de la ligne Total (le pied du tableau) et de la colonne Total. Vous avez déjà défini la première contrainte au niveau de l’élément Group. Pour définir la seconde contrainte, utilisez les noms de colonnes précédemment détectés comme éléments de référence.

1. Créer l’élément Character String

   Dans l’élément grTotal, créez un élément de type Character String et nommez-le TotalAmount.

2. Définir le nombre de caractères

   Cliquez sur l’onglet Character String. Dans le champ nombre de caractères, spécifiez cet intervalle flou : [-1, 1, 20, 2147483647]. Cela permet d’estimer la longueur de la chaîne de caractères ; supposez que les valeurs sont comprises entre 1 et 20. Toute hypothèse en dehors de cette plage est pénalisée.

   Conservez les valeurs par défaut des autres propriétés de l’élément.

3. Définir les contraintes de position

   Cliquez sur l’onglet Relations. Le champ montant total se trouve toujours au même niveau que les mots-clés Footer.kwTotal ; définissez donc les contraintes de recherche suivantes :

   • Au-dessus de l’élément Footer.kwTotal, décalage = -20, limite de référence = Bottom
   • En dessous de l’élément Footer.kwTotal, décalage = -20, limite de référence = Top
4. Ajouter la contrainte de colonne

   Cliquez sur l’onglet Advanced. Le champ montant total apparaît immédiatement sous le nom de la colonne Total (éventuellement avec un léger décalage), entre les colonnes prix unitaire et Sales. Dans le champ relations avancées de pré-recherche, définissez une contrainte de recherche supplémentaire couvrant deux cas :

   • Si TableHeader.kwTotal a été détecté, recherchez l’objet à 70 dots au maximum à droite de sa limite droite et à 50 dots au maximum à gauche de sa limite gauche.
   • Sinon, si TableHeader.kwUnitPrice et TableHeader.kwSales ont été détectés, recherchez l’objet à 40 dots au maximum à droite de la limite gauche de TableHeader.kwSales et à droite de la limite droite de TableHeader.kwUnitPrice. Si aucun de ces cas ne s’applique, ne recherchez pas l’objet.

   Dans le langage FlexiLayout :

   If Not (TableHeader.kwTotal.IsNull) Then
   {
   LeftOf: TableHeader.kwTotal.Right, -70 * dot;
   RightOf: TableHeader.kwTotal.Left, -50 * dot;
   }
   Else
   If Not (TableHeader.kwUnitPrice.IsNull) and Not (TableHeader.kwSales.IsNull) Then
   {
   LeftOf: TableHeader.kwSales.Left, -40 * dot;
   RightOf: TableHeader.kwUnitPrice, 0 * dot;
   }
   Else DontFind;
   

   Lors du choix des valeurs de décalage, analysez les propriétés géométriques (taille et limites) des objets voisins détectés lors de la pré-reconnaissance. À défaut, déterminez ces valeurs par essais et erreurs.

5. Vérifier l’association

   Associez le FlexiLayout aux images de test et vérifiez que FlexiLayout Studio détecte l’élément sur chaque image où il apparaît.

6. Définir l’élément source du bloc

   Pour décrire l’emplacement du bloc TotalAmount, sélectionnez élément source, cliquez sur , puis sélectionnez l’élément TotalAmount comme élément source.