Création d’expressions

À propos de la création d’expressions

Vous pouvez créer des expressions pour filtre et transformer les données entrantes.

Une expression peut contenir des constantes, des zones, des fonctions et des opérateurs.

Constantes

Vous pouvez utiliser des nombres constants, des chaînes de texte et des dates pour effectuer des opérations arithmétiques et de comparaison avec et comme arguments dans les fonctions.

Remarques sur l’utilisation de constantes :

• Les chaînes de texte sont traitées comme sensibles à la casse. Utilisez les fonctions UPPER ou LOWER comme solution de contournement pour la sensibilité à la casse.
• Les chaînes de texte et les dates doivent être placées entre guillemets.
• Les nombres n’ont pas besoin de guillemets (un nombre entre guillemets est traité comme du texte).

Champs

Vous pouvez utiliser des champs numériques, de texte et de date disponibles via le connecteur pour effectuer des opérations arithmétiques et de comparaison avec et comme arguments dans les fonctions.

Pour ajouter un champ, faites-le glisser de la section Champs vers la zone Expression.

Les types de zones sont étiquetés avec les icônes suivantes :

• pour les zones de date
• pour les zones numériques
• pour les zones de texte et textuelles

Fonctions

Vous pouvez utiliser les fonctions numériques, de texte et de date répertoriées dans cette section.

Pour ajouter une fonction, faites-la glisser de la section Fonctions vers la zone Expression.

Les types de fonction sont étiquetés avec les icônes suivantes :

• pour les fonctions de date
• pour les fonctions numériques
• pour les fonctions de texte

ABS

Renvoie la valeur absolue d’un nombre.

Syntaxe : ABS(nombre)

COALESCE

Renvoie la première valeur non nulle d’une liste.

Syntaxe : COALESCE(valeur1, valeur2, valeur3)

CROISSANCE

Renvoie la valeur arrondie à la valeur supérieure d’un nombre.

Syntaxe : CEILING(nombre)

CONCAT

Regroupe plusieurs chaînes de texte en une seule.

Syntaxe : CONCAT(“chaîne 1”, “chaîne 2”, “chaîne 3”)

CONTIENT

Renvoie Vrai si une chaîne de texte (“dans le texte”) contient une autre chaîne de texte (“rechercher du texte”). Sinon, renvoie Faux.

Syntaxe : CONTAINS(“inside text”, “find text”)

CONVERT_TO_TIMEZONE

Convertit la date et l’heure d’un fuseau horaire à un autre.

Syntaxe : CONVERT_TO_TIMEZONE(“date et heure”, “fuseau horaire à partir duquel convertir”, “fuseau horaire vers lequel convertir”)

Remarques sur la mise en forme de la date :

• Indiquez les fuseaux horaires à l’aide de leurs noms de base de données tz.
• Indiquez la date et l’heure dans la norme ISO 8601 ou sous la forme aaaa-mm-jj hh:mm:ss.
• Si la date et l’heure sont fournies avec des informations sur le fuseau horaire, elles sont ignorées au profit du paramètre “Fuseau horaire à partir duquel convertir”.
• La date convertie utilise le format ISO 8601. Utilisez la fonction TODATE si vous devez la modifier.

DATETONUMBER

Convertit un champ de date en horodatage Unix.

Syntaxe : DATETONUMBER(“date”)

DATETOTEXT

Convertit un champ de date en chaîne de date au format demandé.

Syntaxe : DATETOTEXT(“date”, “format de date”)

DAYOFWEEK

Renvoie le jour de la semaine correspondant à une date.

Syntaxe : DAYOFWEEK(“date”)

DYNAMICLOOKUP

Remplace les valeurs du champ à l’aide d’une table de recherche chargée dynamiquement. Les valeurs de recherche sont reprises du champ spécifié dans le premier argument (“nom du champ”).

Syntaxe : DYNAMICLOOKUP(“nom du champ”, “valeur”)

ELEMENTOFARRAY

Extrayez la n-ième valeur d’un tableau, puis mappez les valeurs du tableau aux attributs dans XM Discover.

Syntaxe : ELEMENTOFARRAY([“élément de tableau 1”, “élément de tableau 2”, “élément de tableau 3”], nombre)

Notes :

• Si l’entrée n’est pas un tableau, la fonction renvoie une erreur.
• Si le nombre est supérieur à la taille d’un tableau, la fonction renvoie une valeur nulle. Les nombres dans l’ordre croissant commencent à partir de 0.

ZONE

Renvoie à la ligne les noms de champs contenant des espaces ou des points.

Syntaxe : FIELD(“field name”)

RECHERCHER

Localise une chaîne de texte (“rechercher du texte”) dans une autre chaîne de texte (“dans le texte”) et renvoie le numéro de la position de départ de “rechercher du texte” à partir du premier caractère de “dans le texte” (à partir de 1).

Permet d’indiquer l’ordre du caractère dans “dans le texte” auquel lancer la recherche (à partir de 1). Si vous omettez numéro_ordre, il est supposé être 1.

Renvoie -1 si “rechercher du texte” est introuvable dans “dans le texte”.

Syntaxe : FIND(“find text”, “inside text”, order_number)

FINDFIRST

Localise la première occurrence d’une chaîne de texte (“rechercher du texte”) dans une autre chaîne de texte (“dans le texte”) et renvoie le numéro de la position de départ de “rechercher du texte” à partir du premier caractère de “dans le texte” (à partir de 1).

Syntaxe : FINDFIRST(“dans le texte”, “trouver le texte”)

FINDLAST

Localise la dernière occurrence d’une chaîne de texte (“rechercher du texte”) dans une autre chaîne de texte (“dans le texte”) et renvoie le numéro de la position de départ de “rechercher du texte” à partir du premier caractère de “dans le texte” (à partir de 1).

Syntaxe : FINDLAST(“dans le texte”, “trouver le texte”)

ÉTAGE

Renvoie la valeur arrondie à la valeur inférieure d’un nombre.

Syntaxe : FLOOR(nombre)

GENERATE_ID

Génère un ID unique. Cette fonction ne requiert pas de paramètres supplémentaires.

Syntaxe : GENERATE_ID()

GETDAYSBETWEEN

Renvoie le nombre de jours entre deux dates.

Syntaxe : GETDAYSBETWEEN(“date de début”, “date de fin”)

GETHOURSBETWEEN

Renvoie le nombre d’heures entre deux dates.

Syntaxe : GETHOURSBETWEEN(“date de début”, “date de fin”)

GETMINUTESBETWEEN

Renvoie le nombre de minutes entre deux dates.

Syntaxe : GETMINUTESBETWEEN(“date de début”, “date de fin”)

Si

Retourne une valeur si l’instruction est vraie et une autre valeur si l’instruction est fausse.

Syntaxe : IF(instruction, “value if true”, “value if false”)

ISBLANK

Renvoie TRUE lorsqu’une zone est vide et FALSE lorsqu’une zone n’est pas vide.

Syntaxe : ISBLANK(“field name”)

LEN

Renvoie le nombre de lettres d’une chaîne de texte.

Syntaxe : LEN(“text”)

PLUS FAIBLE

Convertit le texte en minuscules.

Syntaxe : LOWER(“text”)

MD5HASH

Applique le hachage MD5 aux données d’entrée pour générer des ID uniques basés sur ces données.

Syntaxe : MD5HASH(“text”)

IDM

Renvoie un nombre spécifique de caractères à partir d’une chaîne de texte, en commençant à l’emplacement spécifié.

La position (numéro_ordre) commence à partir de 1.

Syntaxe : MID(“text”, order_number, caracts_number)

MOD

Renvoie le reste lorsqu’un nombre est divisé par un diviseur.

Syntaxe : MOD(nombre, diviseur)

MAINTENANT

Renvoie la date et l’heure actuelles. Cette fonction ne requiert pas de paramètres supplémentaires.

Syntaxe : NOW()

NUMBERTODATE

Convertit un horodatage Unix en champ de date. L’horodatage Unix est le nombre de millisecondes écoulées depuis le 1er janvier 1970.

Syntaxe : NUMBERTODATE(nombre)

NUMBERTOTEXT

Convertit un nombre en texte.

Syntaxe : NUMBERTOTEXT(nombre)

POW

Renvoie le résultat de x à la puissance de y.

Syntaxe : POW(x, y)

PROPRIÉTÉ

Met en majuscule la première lettre d’une chaîne de texte.

Syntaxe : PROPERCASE(“text”)

RANDOM

Renvoie un nombre réel aléatoire compris entre 0 et 1. Cette fonction ne requiert pas de paramètres supplémentaires.

Syntaxe : RANDOM()

RANDOMBETWEEN

Renvoie un nombre entier aléatoire compris entre deux nombres.

Syntaxe : RANDOMBETWEEN(nombre minimum, nombre maximum)

REMOVEHTMLTAGS

Supprime les balises HTML d’une chaîne de texte.

Syntaxe : REMOVEHTMLTAGS(“text”)

REMPLACER

Remplace une partie d’une chaîne de texte (“ancien texte”) par une autre chaîne de texte (“nouveau texte”) un nombre défini de fois (nombre_de_remplacements) en fonction du numéro d’occurrence de “ancien texte” dans “text” (numéro_occurrence).

Syntaxe : REPLACE(“text”, “old text”, “new text”, occurrence _number, case_sensibilité, number_of_replacements)

REPLACEBYINDEX

Remplace une partie d’une chaîne de texte (“ancien texte”) par une autre chaîne de texte (“nouveau texte”), en fonction du nombre de caractères que vous spécifiez.

La position (numéro_ordre) commence à partir de 1.

Syntaxe : REPLACE(“ancien texte”, numéro_ordre, numéro_caractère, “nouveau texte”)

REPLACEBYREGEXP

Remplace les valeurs de texte à l’aide d’expressions régulières.

Syntaxe : REPLACEBYREGEXP(“texte”, “expression régulière pour la correspondance de modèles”, “expression régulière pour valeur de remplacement”)

ROUND

Renvoie la valeur d’un nombre arrondi à l’entier le plus proche.

Syntaxe : ROUND(nombre)

RECHERCHE

Localise une chaîne de texte (“rechercher du texte”) dans une autre chaîne de texte (“dans le texte”) et renvoie le numéro de la position de départ de “rechercher du texte” à partir du premier caractère de “dans le texte” (à partir de 1).

Permet d’indiquer l’ordre du caractère dans “dans le texte” auquel lancer la recherche (à partir de 1). Si vous omettez numéro_ordre, il est supposé être 1.

Renvoie -1 si “rechercher du texte” est introuvable dans “dans le texte”.

Syntaxe : SEARCH(“find text”, “inside text”, order_number)

SUBSTITUTE

Remplace “ancien texte” par “nouveau texte” dans une chaîne de texte.

Permet de spécifier l’occurrence de l'”ancien texte” que vous souhaitez remplacer. Si vous indiquez le numéro d’occurrence, seule l’instance “ancien texte” est remplacée. Sinon, chaque occurrence d'”ancien texte” dans le texte est modifiée en “nouveau texte”.

Syntaxe : SUBSTITUTE(“texte”, “ancien texte”, “nouveau texte”, numéro_occurrence)

SUBSTR

Retourne une partie d’une chaîne de texte en partant du premier caractère de la chaîne et jusqu’au nombre de caractères spécifié (en commençant par 1).

Syntaxe : SUBSTR(“text”, order_number)

TITLECASE

Met en majuscule la première lettre de chaque mot dans une chaîne de texte.

Syntaxe : TITLECASE(“text”)

TEXTTODATE

Convertit une chaîne de date en une zone de date au format suivant : AAAA-MM-JJThh:mm:ssZ.

Syntaxe : TEXTTODATE(“date”, “format de date”)

TEXTTONUMBER

Convertit le texte en nombre.

Syntaxe : TEXTTONUMBER(texte)

TRANSFORMATION

Traduit les données entrantes.

Syntaxe : TRANSLATE (“code langue source”, “code langue cible”, “texte”).

Notes :

• Cette fonction est disponible uniquement pour les comptes avec des identifiants de l’API Google Translate.
• Pour obtenir la liste complète des codes langue pris en charge, reportez-vous à la documentation Google Cloud Translation.

TRIMLEFT

Supprime les espaces situés à l’extrémité gauche d’une chaîne de texte.

Syntaxe : TRIMLEFT(“text”)

TRIMRIGHT

Supprime les espaces situés à droite d’une chaîne de texte.

Syntaxe : TRIMRIGHT(“text”)

MAJUSCULES

Convertit le texte en majuscules.

Syntaxe : UPPER(“text”)

Opérateurs

Vous pouvez utiliser les opérateurs arithmétiques et de comparaison répertoriés dans les tables suivantes.

Opérateurs arithmétiques

Par exemple, l’expression suivante retournera la moyenne des deux valeurs numériques.

(RATING1 + RATING2) / 2

Opérateurs relationnels

Par exemple, l’expression suivante retournera “mauvaise notation” lorsque la notation est inférieure ou égale à 3, et “bonne notation” lorsque la notation est supérieure à 3.

IF(ÉVALUATION <= 3, "mauvaise notation", "bonne notation")

Opérateurs logiques

Utilisez des opérateurs logiques pour spécifier plusieurs conditions lors de l’utilisation de la fonction IF ou des filtres de job.

Par exemple, l’expression suivante retournera “Méditerranée” si le champ PAYS contient l’une des valeurs spécifiées. Sinon, il renverra “Non-Metiterranean”.

IF(LOWER(COUNTRY) in [“france”, “portugal”, “italy”, “spain”, “greece”, “malta”, “cyprus”], “Mediterranean”, “Non-Mediterranean”)

Conseils sur la syntaxe

Suivez ces conseils pour éviter les expressions non valides :

• Lorsque vous combinez plusieurs fonctions dans une expression, assurez-vous que le nombre de parenthèses ouvrantes et fermantes correspond.
  Exemple : IF(GETDAYSBETWEEN(feedback_date, response_date) > 3, “retardé”, “non retardé”).
• Pour chaque fonction utilisée dans l’expression, tous les arguments requis doivent être présents. Par exemple, la fonction TODATE requiert que les arguments de date et de format de date fonctionnent correctement.
• Assurez-vous d’utiliser le bon type de données pris en charge par une fonction ou une opération arithmétique ou de comparaison. Par exemple, la fonction ABS a besoin d’un nombre pour fonctionner correctement et ne fonctionnera pas sur un champ de texte ou de date.
• S’il y a des points (“.”) dans votre expression, mettez-les à l’aide de la fonction FIELD et de guillemets (soit “simple” ou “double”). Par exemple, si vous avez un champ nommé “agentParticipants.0.agentLoginName”, voici comment l’insérer dans une transformation potentielle :
  IF(CONTAINS(LOWER(FIELD(“agentParticipants.0.agentLoginName”)), “bot”),”YES”, “NO”).