Sur CYUP, vous pouvez créer des formules pour plusieurs types d'options :
Formules de calcul
Formules de conditions d'affichage
Formules de quantité minimal et maximal
Formules de poids
Formules de référence
Avant de se lancer dans la création de formules on vous recommande d'avoir des notions en JavaScript.
Les formules reposent toutes sur le même fonctionnement. Pour illustrer cela, nous allons utiliser l’exemple des formules de prix.
Formules de prix
En sélectionnant un(e) de vos produits/réponses, vous aurez un onglet "Prix" qui s'affichera.
Plusieurs choix s'offrira à vous, mais en sélectionnant "Formule" vous verrez apparaître "f(x)", en cliquant dessus une modal s'ouvrira :
Vous pourrez donc saisir dans la zone de texte votre formule, pour cela vous allez pouvoir vous aider des différents sélecteurs juste au-dessus de cette zone :
Sélecteur de réponses →
ENTRIE("...")
Permet de récupérer une donnée saisie par l’utilisateur dans un champ du formulaire.Sélecteur de références →
REFBYENTRY("...")
Permet de récupérer une référence associée à une réponse/entrée choisie (la référence dépend de la réponse).Sélecteur de choix →
OPTION("...")
Permet de récupérer la valeur d’un choix effectué dans une liste déroulante ou une sélection multiple.Sélecteur d’une référence →
REF("...")
Permet de faire appel à une référence fixe définie dans le configurateur (indépendante d’une saisie).Sélecteur de nombre d'éléments d'un éditeur →
NB_EDITOR_ELEMENT("...", type="text"|"image"|"upload"|"all", unique=true|false, groupId=entryId)Sélecteur de méthodes : ce sont des fonctions mathématiques
Cette fenêtre aura la même apparence pour les autres formules.
Les formules de prix permettent d’automatiser certains traitements en fonction des données disponibles (réponses saisies, références choisies, etc.).
Comme exemple, nous créons une formule qui récupère une valeur d’entrée.
var MaPremiereFormule = ENTRIE("...","...")
MaPremiereFormuleDécomposition de la formule
var MaPremiereFormule → création d’une variable nommée MaPremiereFormule.
ENTRIE("...") → fonction qui permet de récupérer une donnée provenant d’un champ du formulaire.
MaPremiereFormule (ligne 2) → renvoie la valeur stockée dans la variable pour affichage ou utilisation dans d’autres calculs.
À quoi ça sert ?
Ici, la formule permet de récupérer automatiquement la valeur saisie dans un champ donné, puis de la rendre disponible pour :
un calcul ultérieur
un affichage conditionnel
un envoi vers une autre étape de votre processus
Bonnes pratiques
Nommez vos variables avec des noms clairs (PrixProduit, Quantite, TotalHT)
Évitez les accents, espaces ou caractères spéciaux dans les noms de variables.
Commentez si nécessaire pour mieux comprendre vos formules -> Pour commenter, il suffit d’écrire "//" suivi de votre texte (ex. // Calcul du total hors taxes).
Exemple de création de formule prix
On va créer un exemple pour un produit dont le prix varie en fonction de sa longueur et de sa largeur
Pour établir la formule de calcul du prix, nous allons d’abord créer des variables afin de récupérer les données saisies dans les champs correspondant à la taille.
var Longueur =
var Largeur =
Il vous faudra donc bien sélectionner les éléments associés à la variable que vous souhaitez utiliser, à partir du sélecteur de réponses.
Une fois que vous avez choisi les bons éléments de réponse, cela ressemblera à ceci
var Longueur = ENTRIE("...","...") // Champ Longueur
var Largeur = ENTRIE("...","...") // CHamp LargeurLes valeurs saisies dans les champs Longueur et Largeur seront enregistrées dans des variables.
Par la suite, nous allons maintenant définir un prix de base, ce qui permettra de calculer automatiquement le prix final selon la taille. Nous pourrons ensuite également procéder à la formule du prix
var PrixUnitaire = 2
var PrixHT = ((Longueur * Largeur) * Prix)
PrixHT
Pour mieux comprendre, voici votre formule dans son intégralité :
var Longueur = ENTRIE("...","...") // Champ Longueur
var Largeur = ENTRIE("...","...") // CHamp Largeur
var PrixUnitaire = 2
var PrixHT = ((Longueur * Largeur) * Prix)
PrixHTVous pourrez vérifier dans la prévisualisation si votre formule fonctionne. Pour cela, saisissez une largeur et une longueur pour votre produit : le prix se mettra alors automatiquement à jour.
Cet exemple est volontairement simple, mais il est possible d’aller plus loin en créant des formules plus complexes.