StringSearcher

Effectue une correspondance d'expression régulière sur l'expression spécifiée.

Si l'expression correspond au motif, l'entité est émise via le port Matched et la partie de la chaîne de recherche originale qui correspond à l'expression régulière est stockée dans l'attribut spécifié dans l'attribut Attribut de résultat correspondant (et, éventuellement, les éléments correspondants de l'expression sont stockés dans la liste d'attributs spécifiée dans les paramètres Liste de correspondance complète et Liste des sous-expressions correspondantes, ainsi que les indices de départ de chaque élément). Dans le cas contraire, l'expression est émise via le port NotMatched.

Notes

L'ordre des entités peut être contrôlé avec le paramètre Avancé > Préserver l'ordre des entités.
Pour remplacer des sous-chaînes correspondant à une expression régulière, utilisez le Transformer StringReplacer.
Vous pouvez tester les expressions régulières avec Editeur d'expressions régulières dans le champ Contient l'expression régulière du menu contextuel.
Pour plus d'informations sur la syntaxe des expressions régulières, voir https://perldoc.perl.org/perlre#Regular-Expressions.

Configuration

Paramètres

Général

Rechercher dans

Texte en entrée dans lequel effectuer la recherche.

Expression régulière

Pour utiliser ce Transformer afin d'analyser des parties d'une chaîne de caractères, des expressions régulières sont utilisées. La partie du texte d'entrée qui correspond à l'expression régulière est stockée comme une entrée dans la liste de correspondance complète. Les éléments de cette liste peuvent ensuite être exposés dans FME Workbench en cliquant dessus avec le bouton droit de la souris et en indiquant le nombre d'éléments à exposer pour une utilisation ultérieure. Voir ci-dessous pour quelques exemples.

Les expressions régulières avancées (ARE) sont prises en charge. Pour une description complète des ARE, voir Syntaxe des expressions régulières compatibles avec Perl à l'adresse https://perldoc.perl.org/perlre#Regular-Expressions.

En résumé, une Expression Régulière Avancée est constituée d'une ou plusieurs expressions (branches) séparées par le caractère `|'.

Les caractères spéciaux suivants sont utilisés (liste incomplète) :

\|	séparateur de branches (= opérateur OU)
*	une répétition (0 ou n fois) de ce qui précède
+	une répétition (1 ou n fois) de ce qui précède
?	une répétition (0 ou 1 fois) de ce qui précède
.	correspond à n'importe quel caractère unique
^	correspond au début de la chaîne de caractères
$	correspond à la fin de la chaîne de caractères
[ ]	délimite un ensemble de caractères pouvant correspondre.
( )	délimite une sous-expression. Les parties correspondant à ces sous-expressions sont stockées dans l'attribut liste “Subexpression Matches List Name”{}.
a	any character can be listed to be matched

Exemples :

^A	correspond à n'importe quelle valeur commençant par un A
^[0-9]	correspond à n'importe quelle valeur commençant par un chiffre
^[0-9]+$	correspond aux chaînes constituées exclusivement de chiffres
^(beef\|chicken)$	correspond exclusivement aux valeurs 'beef' ou 'chicken'
^([0-9]) ([0-9])$	apparie deux nombres entités séparés par un espace et met le premier nombre en “Subexpression Matches List Name”{0} et le second en “Subexpression Matches List Name”{1}
^N([0-9][0-9])[.]([0-9][0-9])[.]([0-9][0-9])	apparie N23, 45, 11 et met 23 en "Subexpression Matches List Name”{0}, 45 dans "Subexpression Matches List Name”{1} et 11 dans Subexpression Matches List Name”{2}

Le champ Contient l'expression régulière peut aussi inclure n'importe quelle quantité de caractères spéciaux.

Les caractères peuvent être des caractères réguliers mais ils peuvent aussi comporter un certain nombre de caractères de contrôle.

Les séquences de caractères spéciaux sont interprétées selon la table suivante.

Séquence	Description
Ctrl+Shift+h (^H)	Retour arrière (0x08)
Ctrl+Shift+l (^L)	Saut de page (0x0c)
Ctrl+Shift+j (^J)	Saut de ligne (0x0a)
Ctrl+Shift+r (^M)	Retour chariot (0x0d)
Ctrl+Shift+i (^I)	Tabulation horizontale (0x09)
Ctrl+Shift+k (^K)	Tabulation verticale (0x0b)

Définir des caractères spéciaux

Vous pouvez définir des caractères spéciaux par le biais des éditeurs de texte. Cliquez sur Ouvrir l'éditeur de texte dans le menu des paramètres :

Editeur de texte

Entrer les caractères en utilisant les raccourcis de la table ci-dessus.

Note Cliquer sur le menu Options en bas à gauche et sélectionner Afficher les espaces et tabulations.

Sensibilité à la casse

Remarquez que la correspondance peut être sensible à la casse ou non en fonction du paramètre SENSIBILITE A LA CASSE du Transformer

Avancé

Conserver l'ordre des entités

Ce paramètre contrôle l'ordre dans lequel les entités quittent un Transformer.

Lorsqu'un Transformer a plus d'un port de sortie, les entités sortent généralement d'un port à la fois. Parfois, il peut être utile de garder l'ordre dans lequel les entités sont arrivées, en passant d'un port à l'autre si nécessaire. Cela permet de préserver l'ordre des entités, mais au prix d'une perte potentielle d'efficacité du traitement.

Sélectionner une méthode pour l'ordre des entités :

Par port de sortie (défaut)

Conserve seulement l'ordre d'entrée des entités tel qu'elles interviennent dans le groupe d'entités sortant d'un port de sortie donné.

Toutes les entités sortant d'un port de sortie retienne leur ordre relativement entre elles (dans le groupe) mais pas relativement aux entités sortant par d'autres ports de sortie.

Cette option est généralement la plus efficace quand de grandes quantités de textures sortent d'un port de sortie ensemble (tirant parti du traitement par lots).

Comme les entités sortants par différents ports de sortie peuvent ne pas sortir strictement dans l'ordre dans lequel elles étaient arrivées, l'ordre des ports de sortie peut être imprévisible.

Quel que soit le port de sortie

Préserve strictement l'ordre d'entrée des entités, quel que soit le port de sortie. Les entités ressortent une par une dans l'ordre où elles sont arrivées, en passant d'un port à l'autre si nécessaire.

Cette option est généralement moins efficace étant donné que les gains de traitement du traitement par lots vont moins s'appliquer. L'ordre des entités est néanmoins prévisible.

Liste correspondance complète

Le nom facultatif de l'attribut de liste pour stocker toutes les correspondances. Ce paramètre est laissé vide par défaut.

Par exemple, si Liste correspondance complète est maListe et que la chaîne "Oct 15 1915; Apr 7 1964; May 21 1937" est recherché avec l'expression régulière \d{4}, tous les groupes de quatre chiffres correspondront et nous aurons le résultat suivant :

maListe{1} = 1915

maListe{2} = 1694

maListe{3} = 1937

Note Les attributs de liste ne sont pas accessibles à partir du schéma de sortie dans FME Workbench, sauf s'ils sont d'abord traités à l'aide d'un Transformer qui opère sur eux, comme ListExploder ou ListConcatenator. Il est également possible d'utiliser AttributeExposer.

Liste des sous expressions correspondantes

Le nom facultatif de l'attribut de liste pour stocker les correspondances de sous-expressions. La différence entre cette liste et le nom de liste de correspondance complète est que les correspondances répertoriées ici proviennent de groupes de capture, qui sont des sous-expressions regex contenues entre parenthèses. Ce paramètre est laissé vide par défaut.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Définir des valeurs de paramètres

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Outils de tableau

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Ajouter une ligne
Supprimer une ligne
Déplacer la ligne en cours au dessus
Déplacer la ligne en cours en dessous
Déplacer la ligne en cours en haut de liste
Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Couper une ligne - supprime et copie dans le presse-papiers.
Copie une ligne dans le presse-papiers.
Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.

Mots clefs : Grepper