Concatène plusieurs valeurs dans une seule propriété. Des séparateurs peuvent être spécifiés :
CONCAT(prop1, "
| ", prop2, " |
| TRIM(text) | Supprime tous les espaces, retours à la ligne, tabulations au début et à la fin d’un texte. | ) | Retourne la première correspondance du pattern (une expression regex) dans sourceStr.
Si le troisième paramètre est défini, il retournera le groupe correspondant à l’intérieur de la correspondance.
| SELECT("From A to Z alphabet", 'A(.\*?)Z")
retourne
"A to Z"
|
| LOWER(text) | Convertit toutes les lettres majuscules d’une chaîne de texte en minuscules | LOWER("ABC")
retourne
"abc"
|
| UPPER(text) | Convertit toutes les lettres minuscules d’une chaîne de texte en majuscules | UPPER("abc")
retourne
"ABC"
|
| NUMBER(value1) | Convertit une chaîne en nombre | NUMBER("123.456") retourne
123.456
NUMBER("not a number")
retourne
null
|
| STRING(value) | Convertit un nombre ou n’importe quelle valeur en chaîne | STRING(123.456) retourne
"123.456"
STRING(true)
retourne
"true"
STRING(null)
retourne
""
|
| ENCODE\_BASE64(value1) | Encode une chaîne en base64 | ENCODE\_BASE64("hello")
retourne
"aGVsbG8="
|
| DECODE\_BASE64(value1) | Décode une chaîne depuis le base64 | DECODE\_BASE64("aGVsbG8=")
retourne
"hello"
|
| TIMESTAMP() | Retourne l’horodatage de la date actuelle | `TIMESTAMP ()` retourne une valeur comme `1674832519845` (change avec l’heure actuelle) |
| LEFT(text, length) | Retourne le nombre demandé de caractères depuis le début d’une chaîne ou d’un nombre. | LEFT("Hello world", 3)
retourne
"Hel"
|
| RIGHT(text, length) | Retourne le nombre demandé de caractères depuis la fin d’une chaîne ou d’un nombre. | RIGHT("Hello world", 2)
retourne
"ld"
|
| CHAR(text, position)\* | Retourne le caractère à la position spécifiée (commence à 0). | CHAR("Hello world", 5)
retourne
"o"
|
| IF(condition,resultIfTrue,resultIfFalse) | Retourne le deuxième argument si le premier argument est vrai, sinon le troisième argument | `IF(city="Paris", ListA, ListB)` |
| SWITCH(expression, value1, result1, \[value2, result2], ..., \[default]) | Évalue l’expression par rapport à une liste de valeurs et retourne le résultat correspondant à la première correspondance. Si aucune correspondance n’est trouvée, retourne la valeur par défaut optionnelle, ou null si aucun défaut n’est fourni. | SWITCH(country, "FR", "France", "US", "United States", "Unknown")
retourne "France" si country est "FR", "Unknown" si aucune correspondance
SWITCH(LOWER(status), "active", 1, "inactive", 0)
retourne 1 si status est "Active"
|
| ISEMPTY(value) | Retourne si la valeur est vide ou non | ISEMPTY("abc")
retourne
false
|
| SIZE(array or object) | Retourne le nombre d’éléments dans la liste | SIZE(items)
retourne le nombre d’éléments
|
| LENGTH(string) | Retourne le nombre de caractères dans la chaîne | LENGTH("abc")
retourne
3
|
| SUBSTRING(text, pos1, pos2) | Retourne une nouvelle chaîne composée des caractères entre les deux positions définies par pos1 et pos2. Les positions commencent à 0. Si un nombre négatif est donné, les positions commencent à partir de la fin de la chaîne. Si pos2 est omis, la fin de la chaîne est utilisée. | SUBSTRING("hello beautiful world", 6, 14)
retourne
"beautiful"
|
| JSON\_PARSE(string) | Analyse une chaîne JSON (fonctionne pour les objets et les tableaux).
Utile pour créer une propriété d’objet ou de tableau qui contiendra toutes les propriétés ou éléments présents dans un JSON sérialisé que vous pourriez avoir dans une autre propriété d’événement
| JSON\_PARSE('{"optin":1,"message":"ok"}')
retourne un objet avec une optin clé égale à 1 et message clé égale à "ok"
JSON\_PARSE('\["morgan","justine"]')
retourne un tableau contenant "morgan" et "justine"
|
| JSON\_STRINGIFY(value, defaultValue) | Sérialise une valeur en JSON.
(Optionnel) Vous pouvez spécifier un defaultValue dans le cas où value est undefined
| JSON\_STRINGIFY({"message":"ok"})
retourne une chaîne égale à '{"message":"ok"}'
|
| VALUE\_FROM\_JSON(string, path) | Extrait une valeur d’une chaîne de données formatée en JSON | VALUE\_FROM\_JSON('{"info":{"code":42},"message":"ok"}', 'info.code')
retourne
42
|
| GET(property name) | GET(name) retourne la valeur de la propriété d’événement donnée.
Utile pour les noms de propriété qui contiennent un caractère spécial comme "-"
| GET("droid-type")
retourne
"r2d2"
GET("invalidProperty")
retourne
null
|
| GETHEADER(name) | GETHEADER(name) retourne la valeur de l’en-tête http donné | GETHEADER("Accept-Language")
retourne
"fr,fr-FR;q=0.8,en-US;q=0.5,en;q=0.3"
|
| GETCOOKIE(name) | GETCOOKIE(name) retourne la valeur du cookie http donné | GETCOOKIE("cart")
retourne
"empty"
|
| DATEPARSE(str, format) | Prend une date dans un format spécifique et la convertit en une date correcte | DATEPARSE('2023-05-23', 'yyyy-MM-dd') retourne
2023-05-23T00:00:00.000+01:00
voir plus d’informations sur le format
|
| DATEFORMAT(date, format) | Prend une date au format ISO-8601 ou timestamp et la convertit au format spécifié | DATEFORMAT('2023-01-31T23:59:00.000+01:00', 'yyyy-MM-dd HH:mm') retourne
2023-01-31 23:59
voir plus d’informations sur le format
|
| DATEADD(date, interval, unit) | Ajoute l’intervalle comme une unité (années, mois, semaines, jours, heures, minutes, secondes) | DATEADD('2023-01-23T00:05:00.000+01:00', 3, 'days')
retourne
2023-01-26T00:05:00.000+01:00
|
| DATESUB(date, interval, unit) | Supprime l’intervalle comme une unité (années, mois, semaines, jours, heures, minutes, secondes) | DATESUB('2023-01-23T00:05:00.000+01:00', 3, 'days')
retourne
2023-01-20T00:05:00.000+01:00
|
| DATEDIFF(date1, date2, unit) | Retourne l’intervalle entre deux dates dans l’unité | DATEDIFF('2023-01-20T00:05:00.000+01:00', '2023-01-23T00:05:00.000+01:00', 'days')
retourne
0
|
| AGE(date, unit) | Retourne le temps écoulé depuis la date donnée dans l’unité (si l’unité n’est pas spécifiée, les années sont utilisées par défaut) | AGE('2022-01-20T00:05:00.000+01:00')
retourne
1 en 2023
|
| YEAR(date), MONTH(date), DAY(date), HOUR(date), MINUTES(date), SECONDS(date) | Retourne l’unité de date spécifiée | YEAR('2023-01-20T00:05:00.000+01:00')
retourne
2023, MONTH pour la même date retourne 1, etc
|
| TIMEZONE(date) | Retourne le fuseau horaire en UTC | TIMEZONE('2023-01-20T00:05:00.000+01:00')
retourne
UTC+1
|
| TODAY() | Retourne la date actuelle au format ISO-8601 | `TODAY()` peut retourner `2023-01-20T00:05:00.000+01:00`, en supposant que la date actuelle est le 20 janvier 2023 |
## Opérateurs
| **Opérateur** | **Description** | **Exemple** |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| =, == | Retourne true si la partie gauche est égale à la partie droite.
Si l’une des parties est un tableau, vérifie si certaines valeurs sont égales entre les deux parties.
| `gender = "F"` |
| !=, <> | Inverse de ce qui précède | `gender != "F"` |
| AND ou && | Effectue un AND booléen entre les deux parties | `age >18 AND gender = "M"` |
| OR ou \|\| | Effectue un OR booléen entre les deux parties | `age >18 OR gender = "M"` |
| NOT(expression) | Effectue un NOT booléen sur l’expression | `NOT(age>18)` |
| IN() | Retourne true si la partie gauche est égale à au moins une valeur à droite. | `currency IN("€", "$", "£")` |
| !IN | Retourne true si aucune des valeurs à droite n’est égale à la valeur à gauche. | `currency !IN("€", "$", "£")` |
| <, >, <=, or >= | Compare deux valeurs
Si l’une des valeurs est un tableau, vérifie qu’au moins une des valeurs correspond.
| `age > 18` |
| BETWEEN() | Vérifie si la valeur de gauche est entre les deux valeurs passées en arguments. Si la valeur de gauche est un tableau, vérifie qu’au moins une des valeurs correspond. | `age BETWEEN(7, 80)` |
| EXISTS() | Vérifie si la propriété existe | `EXISTS(my_property)` |
| \~ or !\~ | Vérifie si la valeur de gauche correspond à la regex de la valeur de droite (ou ne correspond pas si !\~). Le langage regex est celui de JavaScript.
Si la valeur de gauche est un tableau, vérifie qu’au moins une des valeurs correspond.
| `email ~ "@example.com"` |
| STARTSWITH(), ENDSWITH(), or CONTAINS() | Vérifie si la valeur de gauche commence par, se termine par, ou contient la valeur de droite.
Si la valeur de gauche est un tableau, vérifie qu’au moins une des valeurs correspond.
| `lastname STARTSWITH("DE")` |
| \* or / | Multiplication ou division | `3*5` |
| + or - | Addition / concaténation ou soustraction | `1+2` |
## Agrégations
| NOM DE LA FONCTION | CE QU’ELLE FAIT | Exemple |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AVERAGE(array, expression) | Calcule la moyenne des valeurs dans un tableau ou à partir d’une expression. Le paramètre expression est optionnel. | AVERAGE(\[0, null, 10])
Retourne 5 (les valeurs null sont ignorées)
AVERAGE(items, price)
Retourne la moyenne du prix de chaque item (les valeurs null sont ignorées)
AVERAGE(items, EXTRACT(price, "€", 0))
Extrait la valeur numérique avant € et calcule la moyenne
AVERAGE(items, IF(returned\_quantity = 0, NUMBER(EXTRACT(product.price, "€",0)), 0))
Prix moyen uniquement pour les items non retournés
|
| MIN(array, expression) | Retourne la valeur minimale d’un tableau ou d’une expression. Le paramètre expression est optionnel. | MIN(\[null, 15, 8])
Retourne 8 (ignore null)
MIN(orders, DATEPARSE(order\_date, "yyyy-MM-dd"))
Trouver la date de commande la plus ancienne
MIN(items, IF(status = "active", price, 999999))
Prix minimum uniquement parmi les items actifs
|
| MAX(array, expression) | Retourne la valeur maximale d’un tableau ou d’une expression. Le paramètre expression est optionnel. | MAX(\[null, 15, 8])
Retourne 15 (ignore null)
MAX(users, AGE(birth\_date))
Trouver l’âge de l’utilisateur le plus âgé
MAX(transactions, IF(type = "purchase", amount, 0))
Montant d’achat maximal
|
| SUM(array, expression) | Calcule la somme des valeurs dans un tableau ou à partir d’une expression. Le paramètre expression est optionnel. | SUM(items, quantity \* NUMBER(EXTRACT(unit\_price, "$", 0)))
Calcule la valeur totale de tous les items
SUM(\[5, null, 15])
Retourne 20 (ignore null)
SUM(items, IF(returned\_quantity = 0, NUMBER(EXTRACT(product.price, "€",0)), 0))
Additionne les prix uniquement pour les items avec quantité non retournée
|
| COUNT(array, expression) | Compte le nombre de valeurs non vides dans un tableau ou à partir d’une expression. Le paramètre expression est optionnel. | COUNT(users, IF(ISEMPTY(email), null, email))
Compte les clients avec une condition d’email non vide
COUNT(items, IF(status = "completed" AND amount > 100, 1, null))
Compte les items terminés au-dessus de 100
|
## Exemples
1. Scénario : créer un Flag qui indique si l’adresse principale des consommateurs se trouve en Californie\
`IF(EXTRACT(city_state, '-', 1) == " CA", "TRUE", "FALSE")`
2. Scénario : définir une valeur avec plusieurs conditions. La valeur est égale à "12345" pour le pays FR et l’environnement prod, sinon elle est égale à 98888 pour le pays DE et l’environnement dev : \\
{% code overflow="wrap" %}
````
```xquery
IF(country = "FR" AND environment_work = "prod", "12345", IF(country = "DE" AND environment_work = "dev", "98888")
```
````
{% endcode %}