Fonctions Chaîne de workflow
Une fonction chaîne exécute des opérations sur des données de texte. Utilisez une fonction chaîne pour nettoyer les données, convertir des données dans un autre format ou casse, calculer des métriques relatives aux données ou effectuer d'autres manipulations. Une fonction chaîne ne peut être utilisée qu'avec des données de type chaîne (String).
Contient
Contains (String, Target, CaseInsensitive = 1) : recherche l'occurrence d'une chaîne particulière dans une chaîne. Renvoie la valeur vraie si la chaîne (String) contient la chaîne cible (Target), sinon renvoie la valeur fausse.
Exemple
Contains('123ABC', 'ABC') renvoie True (Vrai).
Contains('123ABC', 'abc') renvoie True (Vrai).
Contains('123ABC', 'abc', 0) renvoie False (Faux).
CountWords
CountWords(string): renvoie le nombre de mots dans la chaîne spécifiée. Les mots sont définis comme des ensembles de caractères séparés par un espace.
Exemple
CountWords("Basic Variables Households")renvoie 3.
CountWords("Basic Variables Age:Female (Pop)Age 1") renvoie 5.
DecomposeUnicodeForMatch
DecomposeUnicodeForMatch(String): retire les accents et développe les caractères composés pendant la conversion en chaîne étroite. Tous les accents et similaires sont enlevés.
Important
Cette fonction n’est utile que pour les opérations de concordance. Son résultat n’est pas considéré comme une chaîne normalisée.
La fonction n'est pas conçue pour être utilisée avec des jeux de caractères non occidentaux comme le japonais. Vous devriez éviter d'utiliser cette fonction dans des chaînes qui peuvent contenir des caractères étendus. Sachez que les caractères étendus sont convertis en « ? ».
Exemple
DecomposeUnicodeForMatch("Prénoms français")renvoie les prénoms français.
EndsWith
EndsWith(String, Target, CaseInsensitive=1): vérifie si une chaîne se termine par une chaîne particulière. Renvoie True si la chaîne (String) se termine par la chaîne cible (Target), sinon renvoie False. Par défaut, il est insensible à la casse.
Exemple
EndsWith('123ABC', 'ABC')renvoie True (Vrai).
EndsWith('123ABC', 'abc')renvoie True (Vrai).
EndsWith('123ABC', 'abc', 0)renvoie False (Faux).
FindNth
FindNth(Initial String, Target, Instance): recherche l'instance (la Nième occurrence) de la cible dans la chaîne initiale et renvoie la position indexée 0 de l'instance. Cette fonction est sensible à la casse et ne prend pas en charge les paramètres négatifs.
Important
En mode Cloud-natif, la Cible et l'Instance doivent être des valeurs littérales statiques.
Exemple
FindNth("Hello World","o",2)renvoie 7. La fonction recherche la 2e instance de « o » dans la chaîne fournie et renvoie la position indexée 0, en l'occurrence 7.
FindNth("Hello World","World",1)renvoie 6. La fonction recherche la 1re instance de « World » dans la chaîne fournie et renvoie la position indexée 0 du premier caractère, en l'occurrence 6.
FindNth("Hello World","o",1.8)renvoie 7. La fonction recherche la 2e instance (arrondissement de 1.8 à l'entier le plus proche) de « o » dans la chaîne fournie et renvoie la position indexée 0 du 2e caractère, en l'occurrence 7.
FindNth("Hello World","world",1)renvoie -1. La fonction recherche la 1re instance de « world » dans la chaîne fournie et renvoie la position indexée 0 du premier caractère, en l'occurrence -1 (aucune correspondance en raison de la sensibilité à la casse).
FindNth("Hello World","l",0)renvoie -1. La fonction recherche la 0e instance de « l » dans la chaîne fournie et renvoie la position indexée 0, en l'occurrence -1 (introuvable, car la 0e position n'existe pas).
FindNth("Hello World","l",-1)renvoie -1. Dans la mesure où les paramètres négatifs ne sont pas applicables, la fonction renvoie -1 (introuvable).
FindNth("Hello World", Null(), 1)renvoie -1. Les valeurs nulles et vides sont introuvables.
FindNth(Hello world, "l", 1)renvoie une erreur. La fonction exige que les 2 premiers paramètres soient des chaînes.
FindString
La fonction FindString est sensible à la casse.
FindString(String,Target): recherche l'occurrence d'une chaîne particulière (Target) dans une autre chaîne (String) et renvoie la position numérique de son occurrence dans la chaîne.
Renvoie l’index de base 0 de la première occurrence de la cible (Target) dans la chaîne (String). Renvoie -1 en l'absence d'occurrence.
Exemple
FindString([Name], "John") renvoie 0 lorsque la chaîne commence par John et renvoie -1 dans le cas contraire.
IF (FINDSTRING([Name], "John") '0) THEN "John Smith" ELSE "Other" ENDIF renvoie John Smith si la chaîne contient John et renvoie Other dans le cas contraire.
GetLeft
GetLeft(String, Delimiter): renvoie la partie gauche de la chaîne fournie jusqu'à la première instance du ou des délimiteurs spécifiés. En mode Cloud-natif, le délimiteur doit être une valeur littérale statique.
Note
L'opérateur Délimiteur est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
Exemple
GetLeft("Automated Analytics for All", " ") renvoie « Automated ».
GetLeft("Enable fast, confident decisions across the enterprise.", ",") renvoie « Enable fast ».
GetPart
GetPart(String, Delimiter, Index): utilise le ou les délimiteurs spécifiés pour diviser la chaîne en sous-chaînes et renvoie la sous-chaîne à la position indiquée dans l'index. En mode Cloud-natif, le délimiteur doit être une valeur littérale statique.
Cette fonction utilise un index en base 0. Par exemple, si Index est égal à 2, la fonction renvoie la chaîne à partir de la position dans index 2, qui est la troisième sous-chaîne.
Note
L'opérateur Délimiteur est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
Exemple
GetPart("Automated Analytics for All", " ", 1) renvoie « Analytics ».
GetPart("Automated Analytics for All", " ", 0) renvoie « Automated ».
GetPart("Enable fast, confident decisions across the enterprise.", ", ", 5) renvoie « across ». Notez que cet exemple utilise 2 délimiteurs : une virgule et un espace. La fonction divise la chaîne lorsqu'elle rencontre l'un ou l'autre des délimiteurs.
GetPart("January 1, 2023", " ", 2) renvoie « 2023 ».
GetRight
GetRight(String, Delimiter): renvoie la partie droite de la chaîne fournie après la première instance du ou des délimiteurs spécifiés. En mode Cloud-natif, le délimiteur doit être une valeur littérale statique.
Note
L'opérateur Délimiteur est sensible à la casse. Si vous spécifiez « a » comme délimiteur, la fonction utilise uniquement « a » comme délimiteur, et non « A ».
Exemple
GetRight("Automated Analytics for All", " ")renvoie « Analytics for All ».
GetRight("Enable fast, confident decisions across the enterprise.", ",") renvoie « confident decisions across the enterprise ». (notez l'espace devant confident dans la valeur renvoyée).
GetWord
GetWord(string, n): renvoie le Nième mot (base 0) de la chaîne. Les mots sont définis comme des ensembles de caractères séparés par une espace. L’index en base 0 signifie que le premier mot se trouve à la position 0.
Exemple
GetWord("Basic Variables Households", 0)renvoie « Basic ».
GetWord("Basic Variables Households", 1)renvoie « Variables ».
Left
Left(String, len) : renvoie les premiers caractères (len) de la chaîne (String). Si len est inférieur à 0 ou supérieur à la longueur de la chaîne (String), la chaîne reste inchangée.
Exemple
Left("92688", 3) renvoie la valeur « 926 ».
Length
Length(String) : renvoie la longueur de la chaîne (String).
Exemple
Length("92688") renvoie la valeur 5.
LowerCase
LowerCase(String): convertit une chaîne en minuscules.
Exemple
LowerCase("M1P 1G6")renvoie « m1p 1g6 ».
MD5_ASCII
MD5_ASCII(String): calcule le hachage MD5 de la chaîne. La chaîne ne devrait comporter que des caractères étroits. Les caractères étendus sont convertis en « ? » avant de calculer le hachage. À utiliser pour les types String. Vous devez éviter d'utiliser cette fonction sur des chaînes pouvant contenir des caractères étendus.
MD5_UTF8
MD5_UTF8(String): calcule le hachage MD5 de la chaîne stockée avec le codage UTF-8.
Exemple
Md5_Ascii("Lá"), stocké en Latin1, occupe 2 octets, 4C E1. La fonction calcule le hachage MD5 des octets, donnant le résultat « 0c0ee86cc87d87125ad8923562be952e ».
Md5_Ascii("Lá ☢"), le caractère ☢, étant étendu, est remplacé par un « ? », c'est donc comme si vous saisissiez Md5_Ascii("Lá?"). Il est stocké en Latin1 sur 3 octets, 4C E1 3F. La fonction calcule le hachage MD5 des octets, donnant le résultat « a5a308ab19acf900efea8fc7b5b77b4d »
Md5_Unicode("Lá"), stocké en UTF-16, occupe 4 octets, 4C 00 E1 00. La fonction calcule le hachage MD5 des octets, donnant le résultat « aa9969dfcca04249842cc457e5b3dd01 ».
Md5_Unicode("Lá ☢"), lorsqu'il est stocké en UTF-16, occupe 8 octets, 4C 00 E1 00 3C D8 C8 DF. La fonction calcule le hachage MD5 des octets, donnant le résultat « 7c4762d93572dd02a8a405232e966b18 »
Md5_Utf8("Lá"), stocké en UTF-8, occupe 3 octets, 4C C3 A1. La fonction calcule le hachage MD5 des octets, donnant le résultat « 68f00289dc3be140b1dfd4e031d733f1 ».
Md5_Utf8("Lá ☢"), lorsqu'il est stocké en UTF-8, occupe 7 octets, 4C C3 A1 F0 9F 8F 88. La fonction calcule le hachage MD5 des octets, donnant le résultat « 383fc0355db728a2078ce41a2ab6211b ».
PadLeft
PadLeft(String, len, char) : remplit la chaîne à gauche avec le caractère spécifié à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.
Exemple
PadLeft("M", 4, "x")renvoie « xxxM ».
PadRight
PadRight(String, len, char) : remplit la chaîne à droite avec le caractère spécifié à la longueur spécifiée. Si le remplissage (char) est supérieur à un caractère, seul le premier caractère est utilisé.
Exemple
PadRight("M", 4, "x")renvoie « Mxxx ».
REGEX_CountMatches
REGEX_CountMatches(String,pattern,icase): renvoie le nombre de concordances dans la chaîne avec le schéma.
icase est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 (signifie que la casse est ignorée). S’il est défini sur 0, la casse doit concorder.
REGEX_Match
REGEX_Match(String,pattern,icase): recherche une occurrence d'une expression régulière dans une chaîne.
Indique si la chaîne concorde avec le schéma du premier caractère jusqu’à la fin.
Pour rechercher un élément qui ne commence pas nécessairement au début de la chaîne, commencez le schéma par « .* ».
Pour rechercher un élément qui ne s’arrête pas nécessairement à la fin de la chaîne, terminez le schéma par « .* ».
Pour plus d’informations sur la construction d’une expression régulière, voir Syntaxe des expressions régulières Perl dans Boost.Regex.
icase est un paramètre facultatif. S’il est spécifié, la casse doit concorder. Par défaut, icase=1 signifie que la casse est ignorée. S’il est défini sur 0, la casse doit concorder.
Exemple
REGEX_Match("123-45-6789", "\d{3}-\d{2}-\d{4}")renvoie -1 (Vrai).
REGEX_Replace
REGEX_Replace(String, pattern, replace, icase): renvoie la chaîne résultant du modèle de recherche RegEx et de la chaîne de remplacement.
Le paramètre de remplacement peut être une valeur spécifiée (comme indiqué ci-dessous) ou un groupe marqué, par exemple « $1 ». Assurez-vous de placer les groupes marqués entre guillemets doubles.
icase est un paramètre facultatif. S’il est spécifié, la casse doit concorder.
Par défaut, icase=1 signifie que la casse est ignorée.
S’il est défini sur 0, la casse doit concorder.
Exemple
REGEX_Replace("Don't reveal your Social Security number, 123-45-6789","\d{3}-\d{2}-\d{4}", "CLASSIFIED") renvoie « Don't reveal your Social Security number, CLASSIFIED ».
REGEX_Replace("Change all domain names from alteryx@Alteryx.com","@.*\.", "@extendthereach.") renvoie « Change all domain names from alteryx@extendthereach.com ».
REGEX_Replace("25 test","(\d+)\s.*","$1") renvoie 25.
Replace
Replace(String, Target, Replacement) : retourne la chaîne (String) après avoir remplacé chaque occurrence de la chaîne (Target) par la chaîne (Replacement).
Exemple
Replace("Good judgment comes from experience", "experience", "awareness") renvoie « Good judgement comes from awareness ».
ReplaceChar
ReplaceChar(String, y, z) : renvoie la chaîne (String) après le remplacement de chaque occurrence du caractère (y) par le caractère (z). Si le caractère de remplacement (z) est une chaîne comportant plusieurs caractères, seul le premier caractère est utilisé. Si (z) est vide, chaque caractère (String) qui correspond à n’importe quel caractère dans (y) est simplement supprimé.
Exemple
ReplaceChar("abcdefb", "b", "_")renvoie « a_cdef_ ».
ReplaceChar("@a#b%c", "@,#,%", "_")renvoie « _a_b_c ».
ReplaceFirst
ReplaceFirst(String, Target, Replacement): renvoie la chaîne (String) après le remplacement de la première occurrence de la chaîne (Target) par la chaîne de remplacement (Replacement).
Exemple
ReplaceFirst("abcdefb", "b", "_")renvoie « a_cdefb ».
ReverseString
ReverseString(String): inverse tous les caractères de la chaîne.
Exemple
ReverseString("abcdefb") renvoie « bfedcba ».
Right
Right(String, Len) : retourne les derniers caractères (Len) de la chaîne. Si len est inférieur à 0 ou supérieur à la longueur de String, la chaîne reste inchangée.
Exemple
Right("92688", 3) renvoie la valeur « 688 ».
StartsWith
StartsWith(String, Target, CaseInsensitive=1): vérifie si une chaîne commence par une chaîne particulière. Renvoie la valeur vraie si la chaîne commence par une chaîne cible (Target) spécifique, sinon renvoie la valeur fausse.
Exemple
StartsWith('ABC123', 'ABC') renvoie True (Vrai).
StartsWith('ABC123', 'abc') renvoie True (Vrai).
StartsWith('ABC123', 'abc', 0) renvoie False (Faux).
STRCSPN
STRCSPN(String, y): renvoie la longueur du segment initial de la chaîne (String) composé de caractères qui ne sont pas dans la chaîne(y).
Exemple
STRCSPN("Bob's Amaco", "~!@#$%^&*'()")renvoie 3. Cette fonction est utile pour contrôler l’absence de ponctuation dans la chaîne.
StripQuotes
StripQuotes(String) : supprime un jeu de guillemets ou d'apostrophes comparé aux extrémités de la chaîne.
Exemple
StripQuotes("Hello there")renvoie Hello there.StripQuotes("'Hello there,' she said.")renvoie 'Hello there,' she said.StripQuotes('"Hello there," she said.')renvoie « Hello there, » she said.
STRSPN
STRSPN(String, y): renvoie la longueur du segment initial de la chaîne (String) composé de caractères de la chaîne (y).
Exemple
STRSPN("3034408896x105", "0123456789") renvoie 10. Ceci est un test utile pour s'assurer qu'une chaîne est formée par un ensemble de caractères.
Substring
Substring(String, start, length) : retourne la sous-chaîne de la chaîne (String), en commençant par (start) et en s’arrêtant après la longueur indiquée par (lenght), si elle est fournie.
Exemple
Substring("949-222-4356", 4, 8) renvoie « 222-4356 ».
Substring("949-222-4356", 4, 6) renvoie « 222-43 ».
Substring("949-222-4356", 4) renvoie « 222-4356 ».
TitleCase
TitleCase(String): convertit la chaîne en majuscules.
Exemple
TitleCase("john smith")renvoie "John Smith".
Trim
Trim(String, y) : supprime le(s) caractère(s) de la chaîne (y) du début et de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides. Notez dans les exemples de la fonction TRIM que les caractères spécifiés sont supprimés. L’ordre des caractères n’a pas d’importance.
Exemple
Trim("!see instructions!!!", "!") renvoie « see instructions ».
Trim(" Test123 ") renvoie « Test123 ».
TrimLeft
TrimLeft(String, y): supprime les caractères de la chaîne (y) du début de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.
Exemple
TrimLeft("** special invitation ", " *") renvoie "special invitation ".
TrimRight
TrimRight(String, y): supprime les caractères de la chaîne (y) de la fin de la chaîne (String). Y est optionnel, et par défaut, cette fonction supprime les espaces vides.
Exemple
TrimRight("John Smith ")renvoie "John Smith".
TrimRight("John Smith**","*")renvoie "John Smith".
Même si vous indiquez une chaîne de caractères à ajuster, la fonction TRIM ne respecte pas l'ordre des caractères et traite la chaîne plutôt comme une liste. Par conséquent, elle ajuste TOUS les caractères de la liste. Si vous cherchez à remplacer une chaîne, utilisez une fonction REPLACE ou REGEX dans votre expression.
Uppercase
Uppercase(String) : convertit la chaîne (String) en lettres majuscules.
Exemple
Uppercase("John Smith") renvoie « JOHN SMITH ».