Champs

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 5 minutes de lecture
  • Découvrez comment les champs fournissent le modèle de données de base pour CPQ les configurations : ce qu’ils sont, comment ils sont liés aux plans, aux règles et aux mises en page, et comment choisir le type et l’affichage appropriés pour des expériences fiables et réutilisables.

    Les champs sont la plus petite unité du modèle de CPQ configuration et représentent un seul élément de données (par exemple, une quantité, un choix ou une note). Ils alimentent l’expérience utilisateur (ce que l’utilisateur voit et modifie), le modèle logique (ce que les règles lisent et sur quoi il agit) et les sorties en aval (ce qui est écrit dans la nomenclature ou transmis à des systèmes externes). Étant donné que les champs sont globaux dans un environnement, le même champ peut être réutilisé dans les plans, les règles et les mises en page pour garantir la cohérence et réduire les doublons.

    Les champs font partie d’une configuration spécifique uniquement lorsqu’ils sont associés à un plan. Lorsque tous les champs référencés par une règle sont associés à un plan, la règle est intrinsèquement liée au plan : aucune étape de liaison supplémentaire n’est requise.

    Comment les champs s’intègrent dans le modèle de configuration

    • Plans : déclarez quels champs globaux participent à une configuration. L’association permet la réutilisation sans clonage.
    • Règles : lisez les valeurs de champ en tant qu’entrées et effectuez des actions sur les champs (déterminer les valeurs, afficher/masquer, valider, filtrer les options, ajouter des produits).
    • Mises en page : placez visuellement les champs et sélectionnez un type d’affichage de composant pour contrôler la façon dont l’utilisateur interagit avec chaque champ.
    • BOM/liste de produits : les valeurs de champ peuvent être mappées à l’attribution du produit ou à des propriétés étendues pour le traitement en aval.

    Champ d’application et cycle de vie

    Les champs sont créés une seule fois et disponibles globalement. Leur cycle de vie est léger et conçu pour être réutilisé :
    1. Créer : définissez le type de champ, le nom et le nom d’une variable unique (identificateur global).
    2. Associer : ajoutez le champ à un ou plusieurs plans pour le rendre disponible dans ces configurations.
    3. Affichage de l’emplacement : choisissez le type d’affichage de composant approprié dans une mise en page (par exemple, grille, sélecteur visuel, curseur, lecture seule).
    4. Orchestrer : appliquez des règles pour lire ou définir des valeurs de champ, contrôler la visibilité, présenter des messages et inciter les actions du produit.

    Choisir le type de champ approprié

    La sélection du type correct garantit des données valides et des règles plus simples :
    • Texte : entrée de chaîne de forme libre (jusqu’à 2000 caractères), avec des contraintes de longueur facultatives et par défaut.
    • Nombre : Entrée numérique avec min/max en option ; Les options de mise en page peuvent appliquer l’étape ou la précision et le formatage (devise/pourcentage/devise en lecture seule).
    • Booléen : Vrai/Faux avec des étiquettes personnalisables et un état par défaut.
    • Liste déroulante (à sélection simple ou multiple) : choix contraints avec des options définissables, des valeurs par défaut et des extensions de liste déroulante pour des données d’option riches et en colonnes et un filtrage implicite.
    • Sélecteur de produit : sélecteur spécialisé pour les produits qui peut ajouter des éléments à la nomenclature et mapper des données supplémentaires aux champs de liste de produits, ce qui élimine souvent le besoin de règles distinctes.
    • Jeux : collections tabulaires où les sous-champs de chaque ligne interagissent en local (idéal pour les scénarios de type calendrier ou d’élément de ligne).
    Remarque :
    Préférez les types contraints (nombre, liste déroulante, sélecteur de produit) lorsque cela est possible. Des contraintes claires réduisent la logique de validation et améliorent les conseils aux utilisateurs finaux.

    Modèle de données et modèle d’affichage

    Le type de champ définit le modèle de données et spécifie les valeurs valides. Le type d’affichage de composant définit la façon dont les utilisateurs interagissent avec le champ dans une mise en page (par exemple, bouton d’option, menu ou grille). Un seul champ peut être rendu différemment d’une mise en page à l’autre tout en préservant un modèle de données cohérent.

    Exemples :
    • Nombre : affiché sous forme d’entrée numérique, de nombre avec soumission, de curseur, de texte/devise en lecture seule ou de nombre formaté.
    • Liste déroulante : affichée sous forme de menu traditionnel, de cases d’option verticales ou de cases à cocher, de tuiles visuelles ou de grille (avec des colonnes d’extension de liste déroulante).
    • Sélecteur de produit : affiché sous la forme d’une grille ou d’une expérience de vignette visuelle avec des sous-champs et des agrégats.

    Association et réutilisation

    Les champs étant globaux, la réutilisation est la valeur par défaut. Associez un champ à n’importe quel plan qui en a besoin ; Le champ est ensuite disponible pour les mises en page et les règles du plan. Si tous les champs référencés dans une règle sont associés au plan, la règle est automatiquement considérée comme associée au plan.

    Ce modèle évite le clonage, réduit la dérive et simplifie la maintenance des produits et des expériences.

    Gouvernance et affectation de noms

    • Noms de variables : utilisez des noms clairs et stables (avec des mots séparés par des traits de soulignement, comme dans shipping_method) pour rendre les scripts de règles expressifs et durables.
    • Descriptions : Documentez l’intention et les plages valides (minimum et maximum, signification sémantique) pour faciliter la réutilisation future.
    • Valeurs par défaut : uniquement lorsque la logique métier attend un état de démarrage ; sinon, laissez les règles déterminer les valeurs de manière contextuelle.

    Accessibilité et internationalisation

    • Préférez les types d’affichage qui rendent les choix évidents (radios/tuiles) lorsque les jeux d’options sont petits.
    • Fournir des étiquettes et un texte d’aide lisibles par l’homme ; utilisez du texte en lecture seule avec Markdown pour obtenir des conseils structurés.
    • Utilisez la mise en forme au niveau de la mise en page pour les nombres et la devise afin de respecter les conventions locales.

    Conseils de performance et de fiabilité

    • Choisissez le type de champ le plus simple qui répond au besoin. Moins de règles et de validations signifie des temps d’exécution plus rapides.
    • Utilisez des extensions de liste déroulante ou des sélecteurs de produits pour encapsuler des données d’options enrichies et réduire le nombre de règles.
    • Réserver les règles de détermination « permanentes » aux véritables valeurs par défaut du système ; préférez les conditions contextuelles ailleurs.

    Quand utiliser les opérations en bloc

    Pour des modifications plus importantes ou des migrations d’environnement, utilisez le chargeur de matrice pour créer et modifier en bloc des champs et des options de champ. L’artefact de feuille de calcul sert également de documentation et accélère le flux du développement au test et à la production.