Regex Based Extractor

UiPath.IntelligentOCR.Activities.DataExtraction.RegexBasedExtractor

Description

Vous permet de créer et d'utiliser une expression régulière personnalisée pour extraire des informations d'un document. Cette activité ne peut être utilisée qu’avec l’activité Data Extraction Scope.

Remarque : cette activité ne peut pas fonctionner avec les champs set ou boolean .

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Module Designer

Configurer des expressions : ouvre l’assistant Configurer des expressions régulières.

Panneau propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Configuration (Configuration) : spécifie la valeur de configuration de l'extracteur sous la forme d'une chaîne d'échappement JSON . Utilisez l'assistant d'extraction pour générer la configuration. Vous pouvez conserver la configuration dans le panneau Propriétés , sous forme de chaîne, ou la définir à l'aide de l'assistant et la lier à une variable. Il est conseillé de modifier le champ Configuration à l'aide de l'assistant et non du panneau Propriétés .
• Délai d'attente (Timeout ) - Spécifie la valeur du délai d'attente pour toute recherche Regex, en millisecondes. Un délai d'attente de 0, ou négatif, est interprété comme infini. La valeur par défaut est 2000.
• UtiliserAlignementVisuel - Lorsque cette case est cochée, les expressions régulières sont appliquées à une version de texte générée sur la base d'alignements visuels des mots. Le texte d'alignement visuel des mots contient des mots séparés par un seul espace, des lignes séparées par un seul caractère de nouvelle ligne et des pages séparées par deux caractères de nouvelle ligne. La valeur par défaut est False. Cette option peut être utilisée pour des mises en page complexes, permettant aux utilisateurs d’écrire plus facilement des expressions régulières basées sur la façon dont les mots sont organisés visuellement sur les lignes, ignorant toute phrase, tout paragraphe ou tout groupe de mise en page autrement identifié dans le document.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

L'assistant de configuration d'expressions régulières

1. Ajoutez une activité Extracteur basé sur Regex (RegEx Based Extractor) à votre workflow dans une activité Étendue de l'extraction de données (Data Extraction Scope).
2. Configurez vos expressions régulières en sélectionnant Configurer les expressions (Configure Expressions).

   La fenêtre de l'assistant (Wizard) s'ouvre.

   Image 1. Présentation de l’assistant de configuration d’expressions régulières
   

   

   
   
3. Développez une entrée de type de document afin de voir tous les champs définis et de commencer à configurer vos expressions régulières. Les types de documents et leurs champs respectifs sont automatiquement lus à partir de la taxonomie du projet. L’option de configuration Regex est disponible pour chaque champ de la taxonomie. Vous pouvez rencontrer les options de configuration suivantes dans l’assistant :
   • Vous pouvez avoir un type de document pour lequel un seul champ régulier s’affichera lorsque vous le développez.

     Pour un champ simple, une seule expression régulière peut être définie à l’aide de l’assistant Configurer des expressions régulières qui s’ouvre lorsque vous sélectionnez Modifier à côté de ce champ.

     Image 2. Un type de document dans l’assistant de configuration d’expressions régulières avec un champ régulier défini
     

     

     
     
   • Vous pouvez avoir un type de document qui affichera un champ de table une fois développé, présentant des options de configuration de table telles qu’une Expression pour l’ensemble du contenu de la table ou une Expression pour des lignes individuelles.
     Consultez la liste suivante afin de connaître les multiples paramètres et options disponibles pour configurer un champ de table :

     • L’expression régulière de la valeur de table (Table Value RegEx) peut être utilisée pour capturer une zone de table entière. Si aucune valeur n’est ajoutée dans la ligne de champ Table, l’intégralité du contenu textuel du document sera alors prise en compte dans le cadre du traitement de la table.
     • L’expression régulière de la valeur des lignes (Rows Value RegEx) peut être utilisée pour capturer une ligne entière à partir d’une capture de table donnée. Si aucune valeur n’est ajoutée sur la ligne du champ Lignes, la zone de la table sera divisée par fin de ligne. Chaque valeur capturée est désormais considérée comme une ligne sur laquelle l’extraction de colonne doit être appliquée.
     • Le RegEx de valeur de colonne (Column Value RegEx) peut être utilisé pour capturer la valeur d'une colonne particulière, à partir de chaque ligne capturée.
     Image 3. Un type de document dans l’assistant de configuration d’expressions régulières avec un champ de table défini
     

     

     
     

     Scénarios d’utilisation de l’expression régulière Table, Rows et Column

     Consultez les scénarios potentiels suivants pour utiliser les options d’expression régulière de table disponibles :

     • Si vous laissez les champs Expressions régulières de tableau (Table RegEx) et Expressions régulières de ligne (Rows RegEx) vides, toutes les lignes de la version texte du document sont utilisées pour appliquer les expressions régulières de niveau colonne (Column Level Regexes) pour l'identification de la valeur de la cellule.
     • Si vous définissez une expression régulière pour capturer la zone de tableau, mais laissez RegEx Rows vide, toutes les lignes de la capture de table sont traitées individuellement à l'aide de chaque Column RegEx pour capturer les valeurs de cellule.
     • Si vous laissez Table RegEx vide mais définissez une Rows RegEx, alors tout le texte capturé avec Rows RegEx est utilisé et les Column RegExes sont appliquées pour capturer les valeurs des cellules pour chaque ligne.
     • Si vous remplissez à la fois Table RegEx et Rows RegEx, l'activité applique la Table RegEx pour identifier la chaîne du tableau, puis applique la Rows RegEx pour identifier chaque ligne, suivie de Column Level RegEx pour capturer les valeurs des cellules.
4. Ajoutez votre expression régulière (Regular Expression) dans le champ Expression.

   Vous avez la possibilité d’écrire l’intégralité de l’expression régulière dans le champ Expression ou de la créer en utilisant le bouton Modifier (Edit).

   Attention : pour toutes les expressions régulières que vous définissez, assurez-vous d’avoir au moins un groupe de capture. Seules les parties capturées d’une expression sont utilisées dans le cadre du rapport de valeur.
5. Sélectionnez la liste déroulante dans la colonne Options de RegEx. Vous pouvez définir différentes options de RegEx à partir de cette option à sélection multiple.

   Choisissez une des options suivantes :

   • CultureInvariant - Indique que les différences culturelles linguistiques sont ignorées.
   • ScriptECMA : active le comportement conforme au script ECMA (European Computer Manufacturers Association) pour l’expression. Cette valeur ne peut être utilisée qu’avec les options IgnorerCasse et Multiligne.
   • CaptureExplicite : spécifie que les seules captures valides sont celles des groupes explicitement nommés ou numérotés et définis comme (?<name> subexpression). Toutes les parenthèses sans nom seront ignorées.
   • IgnoreCase - Spécifie que la recherche n'est pas sensible à la casse.
   • IgnorerEspaceBlancModèle : élimine l’espace blanc non échappé du modèle défini et active les commentaires marqués signalés par un # (dièse). Cette option ne s’applique pas aux classes de caractères, aux quantificateurs numériques ou aux jetons marquant le début d’un élément de langage RegEx individuel.
   • Singleline - Spécifie que la recherche est lancée sur une seule ligne. Le point (.) correspond à tous les caractères, y compris l'exception \n.
   • Multiline - Spécifie que la recherche est lancée sur plusieurs lignes. Pour cette option, les caractères spéciaux ^ et $ correspondent au début et à la fin de n'importe quelle ligne.
   • RightToLeft - Spécifie que la recherche est effectuée de droite à gauche.
     Remarque : consultez Énumération Regex pour plus d’informations sur les options d’expression régulière que vous pouvez utiliser.
   Image 4. La liste déroulante étendue des Options de Regex affichant les options disponibles
   

   

   
   

L'assistant de l'éditeur d'expressions régulières

1. Sélectionnez Modifier (Edit) pour modifier les options de ce champ et le format de l’expression régulière.

   L’assistant Générateur de RegEx s’ouvre.

   Image 5. Présentation de l’assistant Générateur de RegEx
   

   

   
   
2. Saisissez le texte de votre choix dans le champ Texte de test. Il s’agit du texte auquel vous souhaitez appliquer l’expression régulière en fonction des critères de recherche que vous choisissez. Ensuite, insérez une valeur dans le champ Valeur de l’expression régulière, qui sera ensuite également surlignée dans le champ Texte de test.
   Image 6. Saisir du texte dans le champ Texte de test et mettre en évidence une valeur spécifique via le champ Valeur
   

   

   
   
3. Sélectionnez l’un des types de formule RegEx dans la liste déroulante. Cela définit l’expression régulière pour qu’elle corresponde à l’une des caractéristiques suivantes :
   • Littéral (Literal) - Correspond aux caractères exacts que vous avez spécifiés. Cette option est sensible à la casse.
   • Chiffre (Digit) - Correspond à un chiffre.
   • Un de (One of) - Correspond à un caractère unique présent dans l'ensemble.
   • Pas un de (Not one of) - Correspond à un caractère unique absent de l'ensemble.
   • N'importe quoi (Anything) - Correspond à n'importe quel caractère, à l'exception de \n.
   • N'importe quel caractère de mot (Any word character) - Correspond à toutes les lettres et tous les chiffres.
   • Espace blanc (Whitespace) - Correspond à un espace blanc.
   • Commence par (Starts with) - Lance la recherche là où la ligne commence.
   • Se termine par (Ends with) - Lance la recherche là où la ligne se termine.
   • Avancé (Advanced) - Nécessite une expression personnalisée.
   • Email - Correspond à une adresse e-mail.
   • URL - Correspond à une URL.
   • Date US (US date) - Correspond au format de date US.
   • Numéro de téléphone américain (US phone number) - Correspond au format du numéro de téléphone américain.
     Graphique 7. La liste déroulante montrant les caractéristiques disponibles pour l’expression régulière
     

     

     
     
     Remarque : consultez la section Expressions régulières .NET pour plus d’informations sur les expressions régulières dans .NET.
4. Utilisez le champ Valeur Value pour écrire la valeur de l'expression régulière.
5. Sélectionnez un quantificateur dans la liste déroulante Quantificateurs. Choisissez une des options suivantes :
   • Exactement (Exactly) - Correspond exactement à l'élément précédent selon le nombre de fois où il est spécifié. Par défaut, elle est définie sur 1 .
   • Tout (0 ou plus) (Any (0 or more)) - Correspond à l'élément précédent zéro ou plusieurs fois, mais aussi peu de fois que possible.
   • Au moins un (1 ou plusieurs) (At least one (1 or more)) - Correspond à l'élément précédent une ou plusieurs fois.
   • Zéro ou un (Zero or one) - Correspond à l'élément précédent zéro ou une fois, mais aussi peu de fois que possible.
   • Entre x et y fois (Between x and y times) - Correspond à l'élément précédent entre x et y fois, où x et y sont des entiers, mais aussi peu de fois que possible.
6. Vous pouvez utiliser les options suivantes pour modifier les champs :
   1. Sélectionnez Ajouter pour ajouter un champ RegEx supplémentaire.
   2. Sélectionnez Monter et Descendre pour déplacer les champs vers le haut et vers le bas dans la hiérarchie.
   3. Sélectionnez Supprimer pour supprimer le champ.
7. Cochez la case de l'option Capturer (Capture) si vous souhaitez extraire ce champ spécifique.
8. Le champ Expression complète affiche l’expression entière exactement comme vous l’avez personnalisée.
9. Sélectionnez une ou plusieurs options dans la liste déroulante Options Regex.
   Image 8. Options disponibles dans la liste déroulante Options de Regex
   

   

   
   
10. Sélectionnez Enregistrer une fois que toutes vos configurations sont terminées pour quitter le mode Modifier.
11. Sélectionnez à nouveau Enregistrer pour fermer l’assistant.

Intégration de Document Understanding

L’activité Extracteur basé sur les RegEx (RegEx Based Extractor) fait partie des Solutions Document Understanding.