Qu’est-ce que les Regex ?
Aperçu rapide
Les expressions régulières, appelées regex, vous permettent de manipuler du texte dynamique qui apparaît dans le contenu WalkMe ou qui fait partie de processus automatisés. L'utilisation La syntaxe regex est idéale pour les situations où les valeurs de texte dynamique que vous utilisez contiennent à la fois les valeurs souhaitées et d'autres caractères qui ne sont pas pertinents.
En savoir plus sur les expressions rationnelles (regex).
Cas d'utilisation
Les cas d'utilisation des regex sont les suivants :
- Lorsque le texte dynamique comprend le prénom et le nom de famille d'un utilisateur, utilisez une expression rationnelle pour sélectionner et afficher uniquement son prénom dans un ShoutOut ou un ballon afin de le rendre plus personnel (affichage visuel).
- Remplir automatiquement l'adresse électronique de vos utilisateurs (lorsqu'elle fait partie d'un objet plus grand contenant des données supplémentaires) dans un champ de texte lors du chargement de la page (automatisation).
- Ne sélectionner qu'une partie de l'URL lors de l'utilisation d'un texte dynamique pour amener automatiquement l'utilisateur à une autre page
Exemple de cas d'utilisation
Un client souhaite qu'un SmartTip s'affiche lorsqu'un élément à l'écran indiquant une date est antérieur ou égal au 31 janvier 2019.
Comment résoudre le problème :
- Décrivez les valeurs possibles que vous voulez faire correspondre et celles que vous ne voulez pas faire correspondre.
- Divisez le problème en plusieurs groupes de règles qui, une fois combinées, englobent toutes les valeurs que vous souhaitez faire correspondre.
- Dans cet exemple, nous avons quatre modèles différents que nous voulons faire correspondre :
- Toutes les dates en janvier 2019
- Toute date entre le 1er janvier 2010 et le 31 décembre 2018
- Toute date entre le 1er janvier 2000 et le 31 décembre 2009
- Toute date entre le 1er janvier 0000 et le 31 décembre 1999
- Dans cet exemple, nous avons quatre modèles différents que nous voulons faire correspondre :
- Formulez les règles pour traiter chacun des cas ci-dessus et testez-les :
- ^Jan[\s]+[0123]?[\d]+,[\s]+2019$
- ^[\w]+[\s]+[0123]?[\d]+,[\s]+201[012345678]$
- ^[\w]+[\s]+[0123]?[\d]+,[\s]+200[0123456789]$
- ^[\w]+[\s]+[0123]?[\d]+,[\s]+[01][\d]{3}$
- Après avoir testé chaque groupe, combinez-les en une seule chaîne à l'aide de la pipe (supprimez les ^ et les $ excédentaires).
- ^Jan[\s]+[0123]?[\d]+,[\s]+2019|[\w]+[\s]+[0123]?[\d]+,[\s]+201[012345678]|[\w]+[\s]+[0123]?[\d]+,[\s]+200[0123456789]|[\w]+[\s]+[0123]?[\d]+,[\s]+[01][\d]{3}$
- Implémentez le RegEx ci-dessus dans la règle du segment d'affichage du SmartTip en utilisant :
- OSE/jQuery > Le texte est par expression régulière > ^Jan[\s]+[0123]?[\d]+,[\s]+2019|[\w]+[\s]+[0123]?[\d]+,[\s]+201[012345678]|[\w]+[\s]+[0123]?[\d]+,[\s]+200[0123456789]|[\w]+[\s]+[0123]?[\d]+,[\s]+[01][\d]{3}$
- Résultat : Le SmartTip s'affichera lorsque la valeur du texte de l'élément sera comprise entre le 1er janvier 0000 et le 31 janvier 2019.
Comment ça marche
Commencez par une balise d'ouveture de regex contenant l'expression régulière, suivie de l'énoncé auquel que vous souhaitez appliquer l'expression régulière et terminez par une balise de fermeture de regex :
[regex=" {l'expression rationnelle elle-même} "] {texte sur lequel effectuer la regex}[/regex]
Structure de Regex
Dëmarcateurs de début et de fin
En dehors des crochets, ^ indique le début d'une expression rationnelle et est utilisé avec $ pour indiquer la fin de l'expression rationnelle.
Correspondance à un seul caractère
La forme la plus basique de regex effectue une correspondance directe entre les caractères.
Listes et fourchettes
[] peut être utilisé pour spécifier une liste de valeurs et, lorsqu'il est combiné avec -, peut dicter une gamme de valeurs que peut prendre un caractère correspondant dans la chaîne cible.
Répétitions
{3} et {#,#} peuvent être utilisés pour éviter d'avoir à taper les mêmes motifs plusieurs fois de suite dans une expression rationnelle.
Wildcards
Elles sont utiles si le texte de la chaîne cible est dynamique ou si le contenu n'a pas d'importance. . correspondra à n'importe quel caractère, * correspondra à zéro ou plus du motif précédent, et + correspondra à un ou plus du motif précédent.
Caractère Échap
La barre oblique inverse \ indique que les caractères qui la suivent ont une signification particulière.
Caractère d'exclusion
Lorsqu'il est contenu dans [], ^ peut indiquer que le caractère ne doit pas être présent dans la chaîne cible.
Prévision négative
(?!) spécifie que la chaîne suivante ne doit pas être présente dans la correspondance et est utile, par exemple, pour empêcher une extension WalkMe de s'injecter dans la mauvaise iFrame.
Le tuyau
| est l'opérateur logique « OU » dans regex et spécifie une chaîne cible peut correspondre à plusieurs modèles.