Fonctions de chaîne

Découvrez comment utiliser les fonctions de chaîne dans l’éditeur d’expression.

Casse mixte

La fonction camelCase met en majuscule la première lettre de chaque mot d'une chaîne.

Syntaxe

{%= camelCase(string)%}

Exemple

La fonction suivante met en majuscule la première lettre du mot de l'adresse postale du profil.

{%= camelCase(profile.homeAddress.street) %}

Char code at

La fonction charCodeAt renvoie la valeur ASCII d’un caractère, comme la fonction charCodeAt dans JavaScript. Elle prend une chaîne et un entier (qui définissent la position du caractère) comme arguments d’entrée et renvoie sa valeur ASCII correspondante.

Syntaxe

{%= charCodeAt(string,int) %}: int

Exemple

La fonction suivante renvoie la valeur ASCII de o, c’est-à-dire 111.

{%= charCodeAt("some", 1)%}

Concat

La fonction concat combine deux chaînes en une seule.

Syntaxe

{%= concat(string,string) %}

Exemple

La fonction suivante combine la ville et le pays du profil dans une seule chaîne.

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Contient

La fonction contains permet de déterminer si une chaîne contient une sous-chaîne donnée.

Syntaxe

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argument	Description
STRING_1	La chaîne à vérifier.
STRING_2	La chaîne à rechercher dans la première chaîne.
CASE_SENSITIVE	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemples

• La fonction suivante vérifie si le prénom du profil contient la lettre A (en majuscule ou en minuscule). Si c'est le cas, elle renverra "true", sinon elle renverra "false".

  {%= contains(profile.person.name.firstName, "A", false) %}
  

• La requête suivante détermine si l'adresse e-mail de la personne contient la chaîne « 2010@gm » en respectant la casse.

  {%= contains(profile.person.emailAddress,"2010@gm") %}
  

Ne contient pas

La fonction doesNotContain permet de déterminer si une chaîne ne contient pas une sous-chaîne donnée.

Syntaxe

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argument	Description
STRING_1	La chaîne à vérifier.
STRING_2	La chaîne à rechercher dans la première chaîne.
CASE_SENSITIVE	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemple

La requête suivante détermine si l'adresse e-mail de la personne ne contient pas la chaîne « 2010@gm » en respectant la casse.

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

Ne se termine pas par

La fonction doesNotEndWith permet de déterminer si une chaîne ne se termine pas par une sous-chaîne donnée.

Syntaxe

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE}	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemple

La requête suivante détermine si l'adresse e-mail de la personne ne se termine pas par « .com » en respectant la casse.

doesNotEndWith(person.emailAddress,".com")

Ne commence pas par

La fonction doesNotStartWith permet de déterminer si une chaîne ne commence pas par une sous-chaîne donnée.

Syntaxe

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE}	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemple

La requête suivante détermine si le nom de la personne ne commence pas par « Joe » en respectant la casse.

{%= doesNotStartWith(person.name,"Joe")%}

Encode 64

La fonction encode64 est utilisée pour coder une chaîne afin de conserver les informations personnelles (PI) si elles doivent être incluses, par exemple, dans une URL.

Syntaxe

{%= encode64(string) %}

Se termine par

La fonction endsWith permet de déterminer si une chaîne se termine par une sous-chaîne donnée.

Syntaxe

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE}	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemple

La requête suivante détermine si l'adresse e-mail de la personne se termine par « .com » en respectant la casse.

{%= endsWith(person.emailAddress,".com") %}

Égal à

La fonction equals permet de déterminer si une chaîne est égale à une chaîne donnée, en respectant la casse.

Syntaxe

{%= equals(STRING_1, STRING_2) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à comparer à la première chaîne.

Exemple

La requête suivante détermine si le nom de la personne est « John » en respectant la casse.

{%=equals(profile.person.name,"John") %}

Égal à ignorer la casse

La fonction equalsIgnoreCase permet de déterminer si une chaîne est égale à la chaîne donnée, en respectant la casse.

Syntaxe

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à comparer à la première chaîne.

Exemple

La requête suivante détermine si le nom de la personne est « John » sans respect de la casse.

{%= equalsIgnoreCase(profile.person.name,"John") %}

Extraire le domaine e-mail

La fonction extractEmailDomain permet d'extraire le domaine d'une adresse e-mail.

Syntaxe

{%= extractEmailDomain(string) %}

Exemple

La requête suivante extrait le domaine de l'adresse e-mail personnelle.

{%= extractEmailDomain(profile.personalEmail.address) %}

Format currency

La fonction formatCurrency est utilisée pour convertir n’importe quel nombre en sa représentation monétaire sensible à la langue correspondante en fonction des paramètres régionaux transmis sous forme de chaîne dans le deuxième argument.

Syntaxe

{%= formatCurrency(number/double,string) %}: string

Exemple

Cette requête renvoie 56.00 £.

{%= formatCurrency(56L,"en_GB") %}

Obtenir l’hôte d’URL

La fonction getUrlHost sert à récupérer le nom d’hôte d’une URL.

Syntaxe

{%= getUrlHost(string) %}: string

Exemple

{%= getUrlHost("https://www.myurl.com/contact") %}

Renvoie « www.myurl.com »

Obtenir le chemin d’accès à l’URL

La fonction getUrlPath sert à récupérer le chemin d’accès d’après le nom de domaine d’une URL.

Syntaxe

{%= getUrlPath(string) %}: string

Exemple

{%= getUrlPath("https://www.myurl.com/contact.html") %}

Renvoie « /contact.html »

Obtenir le protocole d’URL

La fonction getUrlProtocol est utilisée pour récupérer le protocole d’une URL.

Syntaxe

{%= getUrlProtocol(string) %}: string

Exemple

{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

Renvoie « http »

Index de

La fonction indexOf est utilisée pour renvoyer la position (dans le premier argument) de la première occurrence du deuxième paramètre. Renvoie -1 s’il n’existe aucune correspondance.

Syntaxe

{%= indexOf(STRING_1, STRING_2) %}: integer

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	Chaîne à rechercher dans le premier paramètre

Exemple

{%= indexOf("hello world","world" ) %}

Renvoie 6.

Est vide

La fonction isEmpty permet de déterminer si une chaîne contient une chaîne est vide.

Syntaxe

{%= isEmpty(string) %}

Exemple

La fonction suivante renvoie "true" si le numéro de téléphone mobile du profil est vide. Sinon, elle renverra "false".

{%= isEmpty(profile.mobilePhone.number) %}

N’est pas vide

La fonction isNotEmpty sert à déterminer si une chaîne n’est pas vide.

Syntaxe

{= isNotEmpty(string) %}: boolean

Exemple

La fonction suivante renvoie "true" si le numéro de téléphone mobile du profil n’est pas vide. Sinon, elle renverra "false".

{%= isNotEmpty(profile.mobilePhone.number) %}

Dernier index de

La fonction lastIndexOf est utilisée pour renvoyer la position (dans le premier argument) de la dernière occurrence du deuxième paramètre. Renvoie -1 s’il n’existe aucune correspondance.

Syntaxe

{= lastIndexOf(STRING_1, STRING_2) %}: integer

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	Chaîne à rechercher dans le premier paramètre

Exemple

{%= lastIndexOf("hello world","o" ) %}

Renvoie 7.

Supprimer à gauche

La fonction leftTrim est utilisée pour supprimer les espaces blancs au début d'une chaîne.

Syntaxe

{%= leftTrim(string) %}

Longueur

La fonction length est utilisée pour obtenir le nombre de caractères d'une chaîne ou d'une expression.

Syntaxe

{%= length(string) %}

Exemple

La fonction suivante renvoie la longueur du nom de ville du profil.

{%= length(profile.homeAddress.city) %}

Comme

La fonction like permet de déterminer si une chaîne correspond à un modèle donné.

Syntaxe

{%= like(STRING_1, STRING_2) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	L'expression à laquelle comparer la première chaîne. Les deux caractères spéciaux pris en charge pour créer une expression sont % et _. % est utilisé pour représenter aucun ou plusieurs caractères. _ est utilisé pour représenter exactement un caractère.

Exemple

La requête suivante récupère toutes les villes où vivent les profils contenant le modèle ''es''.

{%= like(profile.homeAddress.city, "%es%")%}

Minuscules

La fonction lowerCase convertit une chaîne en minuscules.

Syntaxe

{%= lowerCase(string) %}

Exemple

Cette fonction convertit le prénom du profil en minuscules.

{%= lowerCase(profile.person.name.firstName) %}

Correspond à

La fonction matches permet de déterminer si une chaîne correspond à une expression régulière donnée. Reportez-vous à ce document pour plus d'informations concernant les modèles correspondants dans les expressions régulières.

Syntaxe

{%= matches(STRING_1, STRING_2) %}

Exemple

La requête suivante détermine si le nom de la personne commence par « John » sans respect de la casse.

{%= matches(person.name.,"(?i)^John") %}

Masque

La fonction Mask est utilisée pour remplacer une partie d’une chaîne par des caractères « X ».

Syntaxe

{%= mask(string,integer,integer) %}

Exemple

La requête suivante remplace la chaîne « 123456789 » par des caractères « X », à l’exception des deux premiers et derniers caractères.

{%= mask("123456789",1,2) %}

La requête renvoie 1XXXXXX89.

MD5

La fonction md5 est utilisée pour calculer et renvoyer le hachage md5 d’une chaîne.

Syntaxe

{%= md5(string) %}: string

Exemple

{%= md5("hello world") %}

Renvoie « 5eb63bbe01eeed093cb22bb8f5acdc3 »

Différent de

La fonction notEqualTo permet de déterminer si une chaîne est différente d'une chaîne donnée.

Syntaxe

{%= notEqualTo(STRING_1, STRING_2) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à comparer à la première chaîne.

Exemple

La requête suivante détermine si le nom de la personne n'est pas « John » en respectant la casse.

{%= notEqualTo(profile.person.name,"John") %}

Différent de Ignorer la casse

La fonction notEqualWithIgnoreCase sert à comparer deux chaînes qui ne respectent pas la casse.

Syntaxe

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à comparer à la première chaîne.

Exemple

La requête suivante détermine si le nom de la personne n’est pas « john » sans respect de la casse.

{%= notEqualTo(profile.person.name,"john") %}

Groupe d’expressions régulières

La fonction Group est utilisée pour extraire des informations spécifiques en fonction de l'expression régulière fournie.

Syntaxe

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

Argument	Description
{STRING}	La chaîne à vérifier.
{EXPRESSION}	L'expression régulière avec laquelle comparer la première chaîne.
{GROUP}	Groupe d'expressions à comparer.

Exemple

La requête suivante est utilisée pour extraire le nom de domaine d'une adresse e-mail.

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

Remplacer

La fonction replace permet de remplacer une sous-chaîne donnée dans une chaîne par une autre sous-chaîne.

Syntaxe

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

Argument	Description
{STRING_1}	Chaîne dans laquelle la sous-chaîne doit être remplacée.
{STRING_2}	Sous-chaîne à remplacer.
{STRING_3}	Sous-chaîne de remplacement.

Exemple

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

Renvoie « Bonjour Marc, voici votre newsletter mensuelle ! »

Tout remplacer

La fonction replaceAll permet de remplacer toutes les sous-chaînes d’un texte correspondant à l’expression « RegEx » par la chaîne littérale de « remplacement » spécifiée. Les expressiones régulières (RegEx) ont une gestion spéciale de « \ » et « + », et toutes les expressions RegEx suivent la stratégie d’échappement PQL. Le remplacement s’effectue du début à la fin de la chaîne. Par exemple, le remplacement de « aa » par « b » dans la chaîne « aaa » donnera « ba » et non « ab ».

Syntaxe

{%= replaceAll(string,string,string) %}

Supprimer à droite

La fonction rightTrim est utilisée pour supprimer les espaces blancs de la fin d'une chaîne.

Syntaxe

{%= rightTrim(string) %}

Fractionner

La fonction split est utilisée pour fractionner une chaîne selon un caractère donné.

Syntaxe

{%= split(string,string) %}

Commence par

La fonction startsWith permet de déterminer si une chaîne commence par une sous-chaîne donnée.

Syntaxe

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argument	Description
{STRING_1}	La chaîne à vérifier.
{STRING_2}	La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE}	Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur vraie.

Exemple

La requête suivante détermine si le nom de la personne commence par « Joe » en respectant la casse.

{%= startsWith(person.name,"Joe") %}

Chaîne en date

La fonction stringToDate convertit une valeur de chaîne en valeur date / heure. Elle comporte deux arguments : représentation sous forme de chaîne d’une date et d’une heure et sous forme de chaîne du formateur.

Syntaxe

{= stringToDate("date-time value","formatter" %}

Exemple

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

Chaîne en entier

La fonction string_to_integer est utilisée pour convertir une valeur de chaîne en valeur entière.

Syntaxe

{= string_to_integer(string) %}: int

Chaîne en nombre

La fonction stringToNumber est utilisée pour convertir une chaîne en nombre. Elle renvoie la même chaîne que la sortie pour une entrée non valide.

Syntaxe

{%= stringToNumber(string) %}: double

Sous-chaîne

La fonction Count string est utilisée pour renvoyer la sous-chaîne de l’expression de chaîne entre l’index de début et l’index de fin.
Syntaxe

{= substr(string, integer, integer) %}: string

Casse du titre

La fonction titleCase permet de mettre en majuscules les premières lettres de chaque mot d'une chaîne.

Syntaxe

{%= titleCase(string) %}

Exemple

Si la personne vit dans Washington high street, cette fonction renverra Washington High Street.

{%= titleCase(profile.person.location.Street) %}

En valeur booléenne

La fonction toBool est utilisée pour convertir une valeur d’argument en valeur booléenne, selon son type.

Syntaxe

{= toBool(string) %}: boolean

En date/heure

La fonction toDateTime est utilisée pour convertir une chaîne en date. Elle renvoie la date de l’époque comme sortie pour une entrée non valide.

Syntaxe

{%= toDateTime(string, string) %}: date-time

To Date Time Only

La fonction toDateTimeOnly est utilisée pour convertir une valeur d’argument en une valeur de date et d’heure uniquement. Elle renvoie la date de l’époque comme sortie pour une entrée non valide. Cette fonction accepte les types de champs chaîne, date, long et int.

Syntaxe

{%= toDateTimeOnly(string/date/long/int) %}: date-time

Taille

La fonction trim supprime tous les espaces blancs du début et de la fin d'une chaîne.

Syntaxe

{%= trim(string) %}

Majuscules

La fonction upperCase convertit une chaîne en majuscules.

Syntaxe

{%= upperCase(string) %}

Exemple

Cette fonction convertit le nom du profil en majuscules.

{%= upperCase(profile.person.name.lastName) %}

Décodage de l’URL

La fonction urlDecode est utilisée pour décoder une chaîne codée en URL.

Syntaxe

{%= urlDecode(string) %}: string

Encodage de l’URL

La fonction Count only null est utilisée pour encoder une chaîne en URL.

Syntaxe

{%= urlEncode(string) %}: string