Fonctions pour règles et optimisations

Note : Des symboles dollar "$" encadrent toujours un nom d'attribut. S'agissant d'une entrée semi-automatique, le deuxième symbole dollar est automatiquement ajouté après le nom de l'attribut dans la fonction.

1. Les fonctions textuelles

• UPPER : Transformer tous les caractères en capitales

Syntaxe : UPPER($champ_textuel)

Exemple : Je souhaite que l'ensemble des caractères envoyés dans le champ "titre" du canal soit en lettres capitales.

• LOWER : Transformer tous les caractères en minuscule

Syntaxe : LOWER($champ_textuel)

Exemple : Je souhaite que l'ensemble des caractères envoyés dans le champ "titre" du canal soit en minuscule.

• UPPERWORD : Capitaliser la première lettre de chaque mot et les autres lettres situées après un caractère autre qu'une lettre

Syntaxe : UPPERWORD($champ_textuel)

Exemple : Je souhaite capitaliser la première lettre de chaque mot et les autres lettres situées après un caractère autre qu'une lettre, dans le champ "titre" du canal.

• UPPERSENTENCE : Capitaliser la première lettre de chaque phrase

Syntaxe : UPPERSENTENCE($champ_textuel)

Exemple : Je souhaite que chaque phrase commence par une majuscule dans le champ "description" du canal.

• TRUNC : Limiter le nombre de caractères

Syntaxe : TRUNC($champ_textuel,nombre de caractères)

Exemple : Je souhaite limiter ma description à 2000 caractères.

• SMARTTRUNC : Limiter le nombre de caractères sans couper le dernier mot

Syntaxe : SMARTTRUNC($champ_textuel,nombre de caractères)

Exemple : Je souhaite limiter ma description à 2000 caractères sans que cela coupe le dernier mot.

• TAIL : Récupérer les derniers caractères d'une chaîne de texte en fonction du nombre de caractères que vous spécifiez

Syntaxe : TAIL($champ_textuel,nombre de caractères)

Cette fonction est utile pour isoler les derniers caractères d'une chaine et les utiliser comme valeur dans mon catalogue.

Exemple : Je souhaite récupérer les 4 derniers caractères des types de produits.

• SPLIT : Diviser le contenu des valeurs autour d'un caractère

Syntaxe : SPLIT($champ_textuel,séparateur,numéro du champ)

Cette fonction est utile pour isoler une partie du texte d'une chaine en commençant par la gauche de la chaîne dans le but d’isoler cette partie de texte et de l'utiliser comme valeur dans mon catalogue.

Exemple : Dans le champ "product_type" je souhaite isoler la valeur Plug&Play.  

• $text_field = Plug&Play, SPLIT($text_field, &, 1) => Plug

• $text_field = Plug&Play, SPLIT($text_field, &, 2) => Play

• STRIPHTML : Supprimer les balises HTML

Syntaxe : STRIPHTML($champ_textuel_html)

Exemple : Je souhaite enlever les balises html de ma description.

• DECODEHTML: Décoder les caractères spéciaux des éléments HTML.

Syntaxe : DECODEHTML($champ_textuel_html)

Exemple : Les marques dans mon catalogue sont encodées en HTML (ex : "Pull & Bear") et je veux les décoder (ex : "Pull & Bear").

• URLENCODE : Encoder les valeurs à envoyer dans une URL

Syntaxe : URLENCODE($champ_textuel)

Exemple : Je souhaite ajouter le titre de mes produits dans le tracking de mes URL produits.

• CATEGORYLEVEL

Cette fonction est utile si vous utilisez une catégorisation au format "breadcrumb", c'est à dire si vous avez plusieurs niveaux de catégories dans une même ligne. 

Ex de catégorisation type "breadcrumb" : Accueil > Revêtement sol et mur > Moquette, parquet, stratifié > Lame de sol PVC

La fonction vous permet alors de sélectionner un niveau et de l'extraire pour l'utiliser comme catégorie finale auprès du canal choisi.

Syntaxe : CATEGORYLEVEL(2)

Ici je récupère la deuxième valeur de ma catégorie soit "Revêtement sol et mur" grâce à la fonction.

Autre syntaxe : CATEGORYLEVEL(-1)

Ici je récupère le dernier niveau de catégorisation soit "Lame de sol PVC" grâce à la valeur "-1"  appelée dans la fonction.

Autre syntaxe : CATEGORYLEVEL(-2)

Me permet de récupérer l'avant-dernier niveau soit "Moquette, parquet, stratifié".

Remarque : Il n'y a pas besoin "d'appeler" la catégorie du catalogue au moyen du symbole $ car Lengow récupère ici automatiquement les valeurs de la catégorie mappée lors de l'étape du mapping Lengow.

2. Les fonctions mathématiques

• ROUND : Arrondir un nombre et définir le nombre de décimales

Syntaxe : ROUND(nombre à arrondir,nombre de chiffres souhaités après la virgule)

Faire l’arrondi à l’unité, au dixième, au centième… d’un nombre décimal, c’est couper au rang indiqué puis :

• si le chiffre qui suit est 5, 6, 7, 8 ou 9, on augmente de 1 le dernier chiffre du nombre coupé.
• si le chiffre qui suit est 0, 1, 2, 3 ou 4, on garde le nombre coupé.

Pour arrondir un nombre à son entier, indiquez "0" comme "nombre de chiffres souhaités après la virgule" ou indiquer ROUND(nombreàarrondir).

Exemple

• Pour arrondir un prix à deux chiffres après la virgule : ROUND($champ_prix,2) > Si mon prix est de "14.1576" dans mon catalogue produits, il deviendra "14.16".

• Pour supprimer les décimales des valeurs de quantité : ROUND($champ_quantite,0) ou ROUND($champ_quantite) > Si ma quantité est de "4.000" dans mon catalogue produits, il deviendra "4".

• ROUNDUP : Arrondir un nombre à l'entier supérieur

Syntaxe : ROUNDUP(nombre à arrondir à l'entier supérieur)

Exemple : Je souhaite arrondir mon prix à l'entier supérieur :

• ROUNDDOWN : Arrondir un nombre à l'entier inférieur

Syntaxe : ROUNDDOWN(nombre à arrondir à l'entier inférieur)

Exemple : Je souhaite arrondir mon prix à l'entier inférieur :

• FORMAT_NUM : Afficher un prix dans un format que vous pouvez gérer à la décimale de votre choix 

Syntaxe : FORMAT_NUM($champ_prix,nombre de décimale souhaité,"séparateur souhaité")

• Séparateur de décimal possible : le point ou la virgule

Exemple : Je souhaite afficher un prix à deux décimales

Il est possible de coupler cette fonction avec les autres fonctions mathématiques.

Pour coupler plusieurs fonctions, consultez l'étape "Concaténer plusieurs fonctions". 

• CALC : Effectuer un calcul

Syntaxe :

• Diviser : CALC(nombre1/nombre2)
• Multiplier : CALC(nombre1*nombre2)
• Additionner : CALC(nombre1+nombre2)
• Soustraire : CALC(nombre1-nombre2)

"nombre1" et "nombre2" peuvent être remplacés par "$mon_champ"

Il est possible, à l'aide de parenthèses, de faire n'importe quel calcul. La fonction suit l'ordre de priorité des calculs.

Exemple : Je souhaite calculer le pourcentage de réduction de mes produits soldés.

Je souhaite augmenter mon prix de vente de 10%, l'arrondir à l'entier supérieur, et soustraire 10 centimes.

Je souhaite baisser mon prix de vente de 15% et ajouter mes frais de port majorés de 5%

• CURRENCYCONV : Convertir un prix dans une autre devise

Syntaxe : CURRENCYCONV(prix,code_iso)

Exemple : Je souhaite convertir un prix en GBP.

Les taux de conversion sont ceux de la Banque Centrale Européenne (BCE) et sont actualisés une fois par jour.

3. Concaténer plusieurs fonctions

Concaténez autant de fonctions que vous le souhaitez en jouant avec les parenthèses !

Exemple : Je souhaite augmenter mon prix de 10% et arrondir le résultat à deux chiffres après la virgule.

Exemple : Je souhaite limiter ma description à 2000 caractères et rédiger les textes en capitales.

Exemple : Je souhaite augmenter mon prix de vente de 10% et le convertir en euros.

Exemple : Tout le texte de ma description est en majuscule. Je souhaite que la première lettre de chaque phrase reste en majuscule et que les autres lettres soient des minuscules.

Exemple : Je souhaite arrondir à deux chiffres après la virgule, le pourcentage de la promotion produit, calculée à partir des prix barrés et prix réduits issus de mon catalogue.

Dans cet exemple "Full_price" est le champ du catalogue produits correspondant au prix barré (avant promotion) et "Prix_Promo" est le champ du catalogue produits correspondant au prix réduit (prix de vente pendant la promotion/solde). 

Exemple : Je souhaite arrondir à l'entier inférieur le prix majoré de 20% et y ajouter les décimales .99 pour appliquer un prix psychologique.

Dans cet exemple, "price" est le champ du catalogue produits correspondant au prix de vente du produit.