Fonctions de chaîne

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

Camel Case

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

Format

{%= 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) %}

Concat

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

Format

{%= 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) %}

Contains

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

Format

{%= 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") %}
    

Does not contain

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

Format

{%= 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")%}

Does not end with

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

Format

{%= 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")

Does not start with

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

Format

{%= 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.

Format

{%= encode64(string) %}

Ends with

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

Format

{%= 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") %}

Equals

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

Format

{%= 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") %}

Equals Ignore Case

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

Format

{%= 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") %}

Extract Email Domain

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

Format

{%= extractEmailDomain(string) %}

Exemple

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

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

Is empty

La fonction isEmpty est utilisée pour déterminer si une chaîne est vide.

Format

{%= 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) %}

Left trim

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

Format

{%= leftTrim(string) %}

Length

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

Format

{%= length(string) %}

Exemple

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

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

Like

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

Format

{%= 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%")%}

Lower Case

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) %}

Matches

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.

Format

{%= 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") %}

Not equal to

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

Format

{%= 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") %}

Regular expression group

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

Format

{%= 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) %}

Replace

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

Format

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

Exemple

La fonction suivante.


Replace All

La fonction replaceAll permet de remplacer toutes les sous-chaînes d'un texte correspondant à la "cible" par la chaîne littérale de "remplacement" spécifiée. 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 ».

Format

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

Right trim

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

Format

{%= rightTrim(string) %}

Split

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

Format

{%= split(string,string) %}

Starts with

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

Format

{%= 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") %}

Title Case

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) %}

Trim

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

Syntaxe

{%= trim(string) %}

Upper Case

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) %}

Sur cette page