L'éditeur d'expressions régulières

Cette fenêtre est accessible depuis la liste des documents OCR puis clic sur le lien “regex editor”

Elle vous permet d'écrire une expression régulière dans la zone (1) et de “voir” dans la zone du bas le texte que ça extrait potentiellement.

Un exemple plus précis est visible sur cette capture d'écran: 1. l'expression régulière suivante est saisie : FACTURE\s+CAISSE\s+N.\s+([A-Z0-9-]*) 2. la zone du texte du document qui “matche” est mise en évidence 3. si l'option détails est active vous pourrez voir la zone en bas de l'écran 4. le résultat de l'extraction du texte de votre regex

Lorsque votre regex extrait UNIQUEMENT le champ que vous voulez (par exemple le numéro de facture) vous pourrez le reporter dans la fiche de création du masque d'analyse

Placez-vous sur la zone “Templates”, vous pouvez regarder les templates proposées par les autres participants … et vous pouvez cliquer sur le bouton “Nouveau” pour créer un nouveau masque d'analyse.

Description de l'interface de création de masques d'analyse (en cours de dev, cette capture d'écran risque de ne pas être “à jour” rapidement mais le principe reste le même).

• Généralités
  • NAME : saisie le nom de votre masque de saisie sous la forme suivante : fr.fournisseur-unmotcle-votrenom, par exemple fr.topoffice-ales-eric
  • FOURNISSEUR : le nom du fournisseur qui sera retourné dans le fichier json (à venir)
  • NUMÉRO DE TVA : en dur le numéro de TVA intracom de ce fournisseur
• EXPRESSIONS RÉGULIÈRES : dans ce bloc vous devrez soit laisser les champs vides, soit les compléter en copiant/collant vos expressions régulières issues de l'outil “L'éditeur d'expressions régulières” (voir paragraphe précédent)
  • MONTANT TOTAL : la regex qui permet d'extraire le TTC de la facture
  • etc. pour chaque champ
• OPTIONS
  • MOTS CLÉS : ce qui permet de détecter qu'il faut appliquer ce masque d'analyse sur votre document, si vous mettez plusieurs mots clés, la virgule doit être utilisée pour les sépparer
  • MOTS CLÉS EXCLUS : l'inverse du précédent, pour disqualifier ce fichier s'il y a un conflit d'analyse avec un autre
  • FORMAT DE DATE : voir la doc python , en bref voici les principaux mots clés utilisés
    • %d jour du mois sur 2 chiffres
    • %m Numéro du mois sur deux chiffres
    • %b Nom du mois abrégé dans la langue locale (exemple jan, fev etc.)
    • %B Nom complet du mois dans la langue locale (janvier, février etc.)
    • %y Année sur deux chiffres
    • %Y Année complète sur quatre chiffres

Quand votre masque d'analyse est terminé, pensez à le sauvegarder puis testez le via la commande “replay” de la liste des documents OCR.

Si la popup vous affiche toutes les données voulues c'est que votre masque d'analyse est bon, exemple:

Ceci n'est qu'un petit pense bête concernant l'art d'écrire des expressions régulières

• () : les parenthèses permettent d'indiquer une zone à extraire
• \w: Caractères alphanumériques, et _
• \W: Caractères ne composant pas les mots
• \s+ :
• \d : Chiffres décimaux
• \D : Autre chose qu'un chiffre décimal
• \s : Caractères d'espacement
• \S : Autre chose qu'un caractère d'espacement

Les {} permettent de définir des répétitions:

• \d{2} : 2 chiffres
• \d{4} : 4 chiffres
• \d{0,5} : entre aucun et 5 chiffres
• \/ : le / étant réservé il faut le dé-spécialiser en le précédent d'un \ ## Liste des mots clés réservés ### ScanInvoices reconnaît la grammaire suivante: * amount : montant * amounttax : montant taxe (historique avant prise en compte de 4 taxes possibles) * amounttax1: montant taxe1 * valuetax1: par exemple 0 pour pouvoir extraire le montant non taxé * amounttax2: montant taxe2 * valuetax2: par exemple 5.5 pour pouvoir extraire le montant de la taxe à 5,5% * amounttax3: montant taxe3 * valuetax3: par exemple 10 pour pouvoir extraire le montant de la taxe à 10% * amounttax4: montant taxe4 * valuetax4: par exemple 20 pour pouvoir extraire le montant de la taxe à 20% * amountuntaxed: montant ht * currency: monnaie * date: date * datedue: date due * dateformats: format de la date * decimalseparator: séparateur * description: description * ean: code ean * invoicelabel: titre ou sujet de la facture * invoicenumber: numéro de la facture * locale: locale à utiliser pour ce document * staticBIC * staticIBAN * staticpayment * staticrecipient * staticsiren * staticsupplieralias * staticsuppliername * staticsuppliernumtva * staticvat * sumamounttax * suppliernumsiret * supplier_numtva`