Règles

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 11 minutes de lecture
  • Découvrez comment créer et gérer des règles pour fournir des expériences de configuration dynamiques. Définissez des conditions et des actions pour afficher ou masquer des champs, afficher des messages, calculer des valeurs et générer des nomenclatures (BOM). Explorez les types de règles, notamment la visibilité, le message, l’inclusion, l’exclusion, la détermination et les actions du produit, afin de créer efficacement des configurations intelligentes et dynamiques.

    Au fur et à mesure que l’utilisateur final navigue dans l’expérience de configuration et renseigne les informations, les règles fournissent ses éléments dynamiques : masquage et affichage du contenu, calcul des valeurs, livraison de recommandations et de messages, et élaboration de la nomenclature (BOM).

    En mettant l’accent sur l’administration des règles dans l’interface utilisateur d’administration, cet article traite des deux composants des règles, des conditions et des actions, ainsi que des six types d’actions disponibles dans CPQ. Tout comme d’autres éléments de l’application, l’interface utilisateur est un bon endroit pour ajouter ou modifier un petit nombre de règles. Lorsque de nombreuses règles doivent être manipulées, nous vous recommandons d’utiliser le chargeur de matrice. Pour plus d'informations, consultez Chargeur de matrice : chargement des règles CSV.

    Dans l’interface utilisateur d’administration, les règles sont accessibles de deux manières :

    • Règles globales : dans le volet de navigation, cliquez sur Règles. La page d’administration de la liste de règles affiche toutes les règles définies dans l’environnement. Si votre tâche consiste à ajouter de nouvelles règles, il s’agit du seul emplacement dans l’interface utilisateur d’administration où vous pouvez lancer une nouvelle règle.
    • Règles associées à un seul plan : Cliquez sur Plans, puis cliquez sur un plan. Cliquez sur l’onglet Règles pour afficher les règles. Cliquez sur une règle pour l’ouvrir.

    Conditions

    CPQ Les conditions de règle consistent en une expression logique. Lors de l’exécution, le moteur de règles exécute la règle si l’expression est évaluée comme vraie.

    L’administrateur peut définir plusieurs types de conditions :

    • Toute condition est remplie : OU les expressions logiques définies.
    • Toutes les conditions sont remplies : ET les expressions logiques définies.
    • Toujours (changement d’entrée d’action) : exécute la règle chaque fois que l’utilisateur final modifie une entrée pertinente.
    • La logique personnalisée est respectée : permet à l’administrateur de définir une logique personnalisée, y compris ET et OR, parmi les expressions.
    • Fonction avancée : permet à l’administrateur d’écrire un script pour définir la condition de la règle.

    Actions

    La section Actions d’une règle définit les tâches que la règle accomplit lorsqu’elle s’exécute (lorsque sa condition est définie sur vrai). CPQ, contrairement à d’autres moteurs, permet plusieurs actions et types d’actions sous une seule condition. Il s’agit d’une fonctionnalité d’organisation pratique qui consolide toutes les tâches qui doivent être effectuées dans le même scénario en une seule règle. La consolidation de plusieurs tâches avec une seule condition augmente également l’efficacité avec laquelle le moteur de règles évalue et accomplit les tâches. Une efficacité accrue se traduit par des performances que l’utilisateur final peut voir.

    Sur la page d’administration des règles, examinez la section Actions située sous la zone Résumé et conditions.

    • Liste d’actions : actions définies dans cette règle. L’entrée Filtre vous permet de trouver rapidement une ou plusieurs actions, en particulier lorsque de nombreuses actions sont définies.
    • Volet de l’éditeur d’action : permet à l’administrateur d’examiner et de modifier l’action sélectionnée dans la liste des actions.
    • Bouton Ajouter une nouvelle action : définissez une nouvelle action pour cette règle. Six types d’actions disponibles sont affichés dans le volet de l’éditeur d’action.

    Masquage des actions

    Masquage des actions masquez un champ entier à la vue de l’utilisateur final. Utilisez des actions de masquage pour attirer l’attention de l’utilisateur final en présentant uniquement les champs pertinents pour la solution en cours de configuration. Un champ masqué conserve sa valeur.

    Actions de messages

    Les actions de message fournissent des informations contextuelles à mesure que l’utilisateur final effectue la configuration. Le message est situé par rapport à un champ désigné dans la mise en page. Quatre types de messages sont disponibles.

    Tableau 1. Actions de messages
    Type du message Exemple Notes
    Info Message d’informations Aucun effet sur l’expérience de configuration au-delà du message
    Warning Message d’avertissement Aucun effet sur l’expérience de configuration au-delà du message
    Erreur Message d’erreur Désactive le bouton Devis afin que l’utilisateur ne puisse pas avancer tant que l’état d’erreur n’est pas atténué.
    Personnalisé L’apparence est déterminée par l’utilisateur L’utilisateur peut contrôler si cela n’a aucun effet sur l’expérience de configuration au-delà du message indiquant si cela désactive le bouton Devis, de sorte que l’utilisateur ne puisse pas avancer tant que l’état d’erreur n’est pas atténué.

    Actions d’inclusion/d’exclusion

    Contrôlez les options de champ de la liste déroulante à l’aide d’actions d’inclusion et d’exclusion. Les deux types d’actions permettent à l’administrateur de définir l’ensemble des options de champ de la manière la plus pratique possible. Les règles d’inclusion et d’exclusion peuvent fonctionner sur le même champ de liste déroulante. Pour une liste déroulante, les options affichées sont déterminées comme suit :

    1. Les règles d’inclusion sont appliquées à l’ensemble d’options défini dans le champ de liste déroulante. Si aucune règle d’inclusion n’est définie pour le champ, toutes les options de la liste déroulante continuent au-delà de cette étape. Le résultat de cette étape est l’ensemble inclus d’options de liste déroulante.
    2. L’ensemble inclus est ensuite évalué par rapport aux règles d’exclusion applicables. Le résultat est l’ensemble d’options affichées.

    Les options de liste déroulante qui sont éliminées à la suite d’actions d’inclusion/exclusion peuvent être supprimées ou désactivées du menu de la liste déroulante des options visibles par l’utilisateur final.

    Pendant l’exécution, si une option de liste déroulante est sélectionnée (soit par un utilisateur final, soit via une action de détermination), mais que les règles d’inclusion/exclusion déterminent ultérieurement qu’il s’agit d’une option non valide, les utilisateurs peuvent spécifier ce qui se passe si les options actuellement sélectionnées sont exclues. L’utilisateur peut choisir de laisser les sélections inchangées, de désélectionner les sélections ou de désélectionner les sélections, puis de sélectionner la première option valide à la place. Le bouton Devis est désactivé jusqu’à ce que l’utilisateur final corrige cet état d’erreur.

    Actions de détermination

    Une action de détermination définit la valeur d’un champ par programmation. L’administrateur peut choisir si la valeur déterminée est paramétrée ou en lecture seule (forfait).

    Si un utilisateur final modifie la valeur d’un champ qui avait été paramétré par une règle de détermination, CPQ affiche un message à l’utilisateur lui rappelant la valeur recommandée. Le message n’empêche pas l’utilisateur de citer la configuration ; il est uniquement informatif. Si l’utilisateur rétablit la valeur du champ sur la valeur déterminée-recommandée, le message disparaît. L’administrateur peut choisir de ne pas afficher ce message.

    Actions de produit

    Les actions de produit entraînent des ajouts à la nomenclature (BOM). Lorsque le type de nomenclature est défini sur Ventes, une simple action de produit affiche le produit à l’utilisateur sous forme de ligne dans le panier. Ces éléments de nomenclature des ventes sont transférés vers Salesforce Quote Line Editor (SFDC QLE) lorsque la configuration est indiquée. Si le type de nomenclature est défini sur Fabrication, les administrateurs n’affichent généralement pas ces lignes aux utilisateurs finaux dans le panier. Les éléments BOM de fabrication sont toutefois enregistrés et transférés vers l’objet d’élément de ligne de configuration SFDC pour la communication avec ERP et les applications de provisionnement en aval.

    Tableau 2. Entrées
    Entrée Notes
    Produit

    Lorsque Type BOM = Ventes, la valeur dans Produit peut être un <SFDC Product2 Id> de 15 à 18 chiffres avec le format 01t5f0000001tElAAI. CPQ extrait le code produit, la description et le prix de l’enregistrement SFDC Product2, <SFDC Product2 Product Code> ou de l’ID externe en fonction des paramètres du champ ID de produit de l’environnement.

    Lorsque Type de nomenclature = Fabrication, quatre options sont disponibles :
    • <ID du produit SFDC 2>
    • <Code produit SFDC Product2>
    • ID externe
    • Une chaîne valide composée de lettres, de chiffres, d’espaces et des caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*ʼ& %$#" !
    Quantité <nombre entier positif>
    BOM Type

    Soldes : affichage dans le panier. Le devis envoie l’élément aux objets SFDC QLE et Configuration Line Items.

    Fabrication : généralement non montrée à l’utilisateur final. Le devis envoie l’élément à l’objet Éléments de ligne de configuration SFDC.

    Tout : tous les types de nomenclature s’affichent dans le panier. Le devis envoie les éléments de vente et de fabrication à l’objet Éléments de ligne de configuration et les ventes à l’objet SFDC QLE.

    Obligatoire

    VRAI : l’utilisateur final ne peut pas supprimer l’élément du panier.

    FAUX : l’utilisateur final est autorisé à supprimer l’élément du panier.

    Actions avancées sur les produits

    Si votre cas d’utilisation nécessite des nomenclatures à plusieurs niveaux, la définition d’une quantité dynamique ou l’attribution de produit au-delà de ce qui est disponible dans les actions de produit simples, une action avancée sur le produit est nécessaire. L’action avancée du produit vous permet d’écrire un script qui génère des enregistrements dans l’objet ProductList.

    La matrice suivante décrit les attributions ProductList disponibles.

    Tableau 3. Attributions de ProductList
    Liste de produits.<param> Demande Valeurs valides Notes
    bomType R Ventes, fabrication, tout Dans les cas d’utilisation intégrés à Salesforce, les éléments de fabrication ne sont écrits que sur LGK__Configurat ionLineItem__c ; Les articles de vente sont écrits dans le QLE et LGK__Configurat ionLineItem__c
    description O <texte>
    étendu O <objet JSON> composé de paires clé/valeur (voir note 1) Si elles sont renseignées, ces informations sont transférées vers LGK_Extended_I nformation__c sur l’objet Élément de ligne de configuration dans Salesforce, une fois que l’utilisateur a cliqué sur le bouton Devis
    id R Quand le cas d’utilisation intégré à SF ET bomType = Ventes...
    Product2.Id, Product2.ProductCode ou ID externe Voir note 2
    Lorsque Headless/eCommerce AND bomType = Sales...
    ProductId ou ProductCode Voir note 2
    Quand SF-integrated AND bomType = Fabrication...

    <text>, Product2.Id, Product2.ProductCode ou ID externe

    Les administrateurs peuvent ajouter des éléments non stockés dans Product2. Si vous faites référence à des enregistrements stockés dans Product2, la note 2 s’applique
    Lorsque Headless/eCommerce AND bomType = Manufacturing...
    <text>, ProductId ou ProductCode Les administrateurs peuvent ajouter des éléments qui ne sont pas stockés dans l’objet Produit. Si vous faites référence à des enregistrements stockés dans le produit, la note 2 s’applique
    niveau O <entier> En option ; pour référence administrative ; ne pilote pas la logique de l’application
    notes O <texte>
    Numéro d’ordre O <entier>

    Renseignez ce paramètre avec des valeurs numériques qui déterminent le numéro de séquence des lignes. Remarque : l’objet ProductList est rempli par toutes les actions de produit qui se déclenchent dans le plan. Limité à 28 chiffres.

    parentProduct O <texte>

    Si elle est renseignée, elle doit correspondre à uniqueIdentifier de la ligne parente. Dans les cas d’utilisation intégrés à SF, le produit parent le plus élevé est le produit configurable. Définissez cette valeur sur le Product2.Id ou Product2.ProductCode du produit configurable.

    prix O < flottant > Négatif et zéro autorisé. Si l’affectation n’est pas affectée, CPQ récupère le prix de base à partir de l’élément principal de produit.
    Qté O < flottant > Négatif et zéro autorisé. Si la valeur n’est pas affectée, la valeur par défaut est 1.
    selectionType O Obligatoire, facultatif Si ce champ n’est pas renseigné, la valeur par défaut est Obligatoire
    identificateur unique R <texte unique> Chaîne qui identifie de manière unique cette ligne parmi les autres dans cette session de configuration (voir la section Attribut d’identificateur unique ci-dessous)
    UdM O <texte> Unité de mesure
    Remarque :
    1. Le paramètre ProductList.extended peut prendre un objet JSON peu profond. Exemple : { « key1 » : « val1 », « key2 » : « val2 » } En outre, l’administrateur peut définir les paires clé/valeur étendues pour un enregistrement ProductList à l’aide de JavaScript. Exemples :ProductList.extended["key"] = « val » ; ProductList.extended.key = « val » ;
    2. Pour simplifier la migration des données produit entre les environnements de test et de production, en particulier dans les environnements intégrés à SF, les administrateurs peuvent demander des actions produit pour référencer un ProductCode ou un ID externe plutôt que ProductId. Dans Admin CPQ , accédez au menu Utilitaires du volet de navigation, puis cliquez sur Paramètres. Vous pouvez ensuite définir le champ ID du produit sur Code produit, ID de partenaire ou ID externe. Si vous envisagez de migrer de ProductId vers ProductCode après la mise en service, vous devez coordonner le changement de paramètre avec les valeurs référencées dans vos actions de produit et les actions de produit implicites dans toutes les données d’extension de liste déroulante que vous avez définies.

    Attribut d’identificateur unique

    CPQ transmet l’identificateur unique d’un produit au CPQ champ ID de ligne unique sur la ligne de devis Salesforce, ce qui permet aux utilisateurs d’affecter des ID uniques à des lignes de devis Salesforce spécifiques.

    Lors de l’utilisation des attributs parentProduct et uniqueIdentifier pour la hiérarchie de produits, si deux produits enfants ont le même produit parent et le même ID de produit, mais doivent être affichés séparément dans la nomenclature, chacun nécessite un « uniqueIdentifier » unique. Cela garantit que l’interface utilisateur les traite comme des produits uniques lorsqu’elle les répertorie.

    Consultez l’exemple de script suivant pour observer comment la hiérarchie des éléments, la différenciation des éléments parents via uniqueIdentifier, bomTypes et l’itération dans les enregistrements ProductList peuvent fonctionner : Action de produit avancée : exemple de nomenclature hiérarchique.