Les règles garantissent que vos clients ne composent que des configurations que vous pouvez réellement livrer. Une règle vérifie une condition – par exemple « la motorisation est solaire » – et déclenche un effet : elle masque des valeurs ou des caractéristiques entières, prédéfinit des valeurs ou affiche un message.
Le principe
- Les groupes de règles organisent vos règles, p. ex. « Motorisation », « Dimensions », « Couleurs ». Chaque nouvelle règle se crée dans un groupe de règles.
- Chaque règle se compose d'une Condition (SI) et d'un effet qui dépend du Type de validation.
- Les règles sont vérifiées à chaque sélection. Dès que la condition n'est plus remplie, l'effet prend fin – une valeur masquée réapparaît.
Étape par étape
- Ouvrez le composant et passez à gauche dans l'onglet Règles.
- Créez un groupe de règles avec + à côté de Règles (Ajouter un groupe de règles). Via la roue dentée (Paramètres du groupe), donnez-lui un nom (Nom du groupe).
- Cliquez sur + au niveau du groupe (Ajouter une règle). La règle « Nouvelle règle » de type Liste noire est créée.
- À droite, sous Paramètres de règle, attribuez une Étiquette de règle et choisissez le Type de validation.
- Au centre, construisez la condition sous Condition (SI) (voir Conditions).
- Définissez l'effet à droite – il varie selon le type de validation (voir Types de règles).
- Enregistrez et testez dans l'Aperçu. Comme toute modification, une règle ne s'applique dans la boutique qu'après la publication.
Supprimer la règle, en bas des paramètres de règle, supprime une règle. Si un groupe de règles est supprimé, toutes les règles qu'il contient disparaissent.
Types de règles
| Type de validation | Effet lorsque la condition est remplie | Moteur |
|---|---|---|
| Liste noire | Masque des valeurs individuelles ou des caractéristiques entières | Legacy et V3 |
| Valeurs prédéfinies | Définit une valeur précise dans une caractéristique | Legacy et V3, avec des différences |
| Quantité prédéfinie | Définit la quantité minimale et maximale d'une caractéristique avec saisie de quantité | Legacy uniquement |
| Min/max prédéfinis | Modifie la plage autorisée d'un champ de saisie | Legacy uniquement |
| Erreur / Avertissement | Affiche un message au client | Legacy et V3, avec des différences |
La signification de « Legacy » et « V3 » est expliquée dans Moteur frontend : Legacy ou V3.
Liste noire
À droite, vous voyez toutes les caractéristiques classées par groupe.
- Masquer des valeurs individuelles : dépliez une caractéristique et cochez les valeurs qui ne doivent plus être sélectionnables.
- Masquer une caractéristique entière : cochez la case devant le nom de la caractéristique (Bloquer toute la caractéristique). La caractéristique disparaît entièrement, y compris du prix et du récapitulatif.
Avec Tout sélectionner et Tout désélectionner, vous marquez en une fois toutes les entrées d'un groupe ou d'une caractéristique.
Valeurs prédéfinies
Pour chaque caractéristique, choisissez un mode :
| Mode | Quand la valeur est définie |
|---|---|
| Désactivé | Jamais – la caractéristique reste inchangée (par défaut) |
| appliquer toujours | Toujours, même si le client a déjà choisi autre chose |
| uniquement sur la valeur par défaut | Uniquement si rien ou la valeur par défaut est sélectionné |
| aucune sélection ou valeur par défaut | Comme uniquement sur la valeur par défaut – et en plus lorsqu'une liste noire vient de masquer la valeur choisie jusque-là |
Choisissez ensuite la valeur à définir. Une valeur actuellement bloquée par une liste noire n'est pas définie par la règle.
Valeur dynamique (Legacy uniquement) : au lieu d'une valeur fixe, la règle reprend la valeur actuelle d'une autre caractéristique. Pour les caractéristiques à valeurs, vous définissez si l'association se fait par la Valeur (Correspondance par valeur) ou par l'ID (Correspondance par ID). V3 ignore les prédéfinitions dynamiques.
Pour les champs de saisie, V3 ne prédéfinit que des nombres, Legacy aussi du texte.
Quantité prédéfinie (Legacy uniquement)
S'applique aux caractéristiques pour lesquelles la Quantité est activée. Saisissez Quantité min. et Quantité max. Avec Dynamique, vous reprenez les limites d'une autre caractéristique. V3 ignore ce type de règle.
Min/max prédéfinis (Legacy uniquement)
Modifie la plage autorisée d'un champ de saisie, p. ex. « pour le matériau bois, 180 cm de largeur au maximum ». Pour la caractéristique, réglez Oui et saisissez la plage sous la forme min-max, p. ex. 40-180 (nombres entiers). Seuls les champs de saisie avec une Saisie autorisée sont proposés. V3 ignore ce type de règle – si votre composant tourne avec V3, limitez plutôt les dimensions via une règle Erreur / Avertissement.
Erreur / Avertissement
| Paramètre | Signification |
|---|---|
| Message d'erreur | Le texte que voit le client. Vous pouvez y insérer des caractéristiques par leur nom interne, p. ex. Maximum $largeur_max cm – la boutique y affiche la valeur actuelle (pour les caractéristiques à valeurs, le champ Valeur). |
| Type d'erreur | Erreur ou avertissement |
| Exécuter lorsque | Quand le message apparaît (Legacy uniquement, voir ci-dessous) |
Comportement des moteurs :
| Legacy | V3 | |
|---|---|---|
| Erreur | S'affiche dans une fenêtre et empêche l'ajout au panier | S'affiche en rouge sous le prix total et bloque le panier et le bouton d'action tant que la condition est remplie |
| Avertissement | S'affiche dans une fenêtre avec Continuer – le client peut tout de même commander | S'affiche en jaune sous le prix total – le client peut tout de même commander |
| Exécuter lorsque | Juste après : dès que la condition est remplie. Assistant : en passant à l'étape suivante. Panier : au clic sur l'ajout au panier. La vérification a lieu dans tous les cas au moment du panier. | N'est pas évalué – le message apparaît dès que la condition est remplie |
| Caractéristiques dans le message | Sont remplacées | Sont remplacées |
Conditions
Construisez la condition au centre, sous Condition (SI) :
- Choisissez la caractéristique.
- Choisissez la comparaison (opérateur).
- Choisissez ou saisissez la valeur.
+ Règle ajoute une ligne supplémentaire, + Groupe un sous-groupe. Avec et / ou, vous définissez si toutes les lignes doivent être remplies ou si une seule suffit.
Opérateurs
| Opérateur | Signification | Pour |
|---|---|---|
| dans | L'une des valeurs indiquées est sélectionnée | toutes les caractéristiques à valeurs |
| pas dans | Aucune des valeurs indiquées n'est sélectionnée | toutes les caractéristiques à valeurs |
| est vide | Rien de sélectionné ou de saisi | toutes |
| n'est pas vide | Quelque chose est sélectionné ou saisi | toutes |
| = / ≠ | Égal / différent | Champs de saisie, calculs |
| < / ≤ / > / ≥ | Inférieur, inférieur ou égal, supérieur, supérieur ou égal | Nombres, p. ex. largeur |
Pour les caractéristiques à valeurs (Sélection, Boutons radio, Case à cocher, Liste avec images …), l'éditeur ne propose que dans, pas dans, est vide et n'est pas vide. Vous pouvez indiquer plusieurs valeurs à la fois – la condition est remplie si l'une d'elles est sélectionnée. Pour les cases à cocher et la sélection multiple, il suffit qu'une des valeurs cochées figure dans votre liste.
Ce qui peut servir de condition
| Caractéristique | Legacy | V3 |
|---|---|---|
| Sélection, Boutons radio, Liste avec images | ✓ | ✓ |
| Case à cocher, Sélection multiple | ✓ | ✓ |
| Champs de saisie (nombre, texte) | ✓ | ✓ |
| Caractéristiques calculées (Formule, Liste de prix, Combinaison) | ✓ | ✓ |
Sous-groupes : remarque pour Legacy
V3 évalue les groupes imbriqués exactement comme ils figurent dans l'éditeur. Legacy relie en revanche toujours un sous-groupe par et à la ligne qui le précède – même si ou est réglé à l'extérieur – et ne peut pas évaluer un sous-groupe placé en première position. Pour les composants Legacy : ne placez jamais un sous-groupe en tête et combinez-le uniquement avec et. Si vous avez besoin d'un ou entre groupes, créez plutôt deux règles.
En Legacy, est vide considère en outre le nombre 0 comme vide.
Quand plusieurs règles se rencontrent
- Les listes noires s'additionnent : est masqué tout ce qu'au moins une règle remplie masque.
- Chaînes : une caractéristique masquée par une règle et une valeur bloquée ne déclenchent pas d'autres règles. Les deux moteurs réévaluent jusqu'à ce que plus rien ne change. Legacy efface alors la sélection de la caractéristique masquée ; V3 la mémorise et l'affiche de nouveau dès que la règle ne s'applique plus.
- Prédéfinitions pour la même caractéristique : une seule règle l'emporte.
- En V3, c'est la Pondération qui décide : la règle avec la valeur la plus élevée l'emporte. À pondération égale, c'est la règle placée le plus bas dans la liste qui l'emporte.
- En Legacy, la Pondération n'est pas évaluée. C'est l'ordre dans la liste qui s'applique.
- V3 affiche les messages triés par pondération, le plus important en premier.
Réglez la Pondération dans les paramètres de règle (par défaut 0). Les règles avec une pondération différente de 0 la portent comme repère dans la liste, p. ex. +5.
Ordre
Modifiez l'ordre des règles et des groupes de règles en les faisant glisser par la poignée ⠿ dans la liste des règles. Les règles hors groupe sont évaluées en premier, puis les groupes de haut en bas.
Tester les règles
- Enregistrez le composant.
- Au centre, passez sur Aperçu et cliquez sur des combinaisons typiques et critiques.
- Vérifiez que les valeurs disparaissent et réapparaissent, que les prédéfinitions s'appliquent et que les messages s'affichent.
L'aperçu tourne avec le moteur frontend réglé. Si vous changez de moteur plus tard, testez à nouveau les règles – surtout les sous-groupes, les prédéfinitions et les messages d'erreur.
Les règles qui concernent une caractéristique sont visibles dans la caractéristique, à droite, dans l'onglet Référencé dans. De là, vous accédez directement à la règle.
Règles via l'agent IA
Vous pouvez aussi décrire des règles au lieu de cliquer : « Si le matériau est bois, la couleur RAL 7016 ne doit pas être sélectionnable. » L'agent IA crée la règle. Contrôlez-la ensuite dans l'onglet Règles et dans l'aperçu. Plus d'informations : Agent IA : Définir des règles via le chat.
Exemples pratiques
1. La couleur ne convient pas à la motorisation Type Liste noire. Condition : Motorisation dans Solaire. Effet : cocher la valeur Blanc pour Couleur.
2. Accessoire uniquement avec moteur Type Liste noire. Condition : Motorisation dans Manivelle. Effet : cocher Bloquer toute la caractéristique pour la caractéristique Télécommande.
3. Présélection judicieuse Type Valeurs prédéfinies. Condition : Modèle dans Basic. Effet : Couleur en mode aucune sélection ou valeur par défaut, valeur Blanc. Si le client a déjà choisi sa propre couleur, elle est conservée.
4. Dimension non livrable
Type Erreur / Avertissement. Condition : Matériau dans Bois et Largeur > 180. Type d'erreur Erreur, Message d'erreur « Le bois est livrable jusqu'à 180 cm de largeur. »
5. Legacy uniquement : limiter une plage
Type Min/max prédéfinis. Condition : Matériau dans Bois. Effet : Largeur sur Oui, plage 40-180.
Dépannage
- La règle ne s'applique pas du tout – vérifiez l'opérateur : pour les caractéristiques à valeurs, il faut dans, pas =. Vérifiez aussi si le composant est publié ; la boutique affiche la dernière version publiée.
- La règle ne s'applique que parfois – un sous-groupe est-il placé en tête ou relié par ou ? En Legacy, l'évaluation est différente (voir Sous-groupes).
- La quantité prédéfinie ou les min/max prédéfinis n'ont aucun effet – le composant tourne avec V3, qui ne connaît pas ces types de règles.
- Deux prédéfinitions se contredisent – en V3, attribuez une Pondération ; en Legacy, modifiez l'ordre.
- Le client peut commander malgré le message – vérifiez le Type d'erreur : seule une Erreur bloque le panier, un avertissement informe seulement.