Chargeur de matrice : chargement des règles CSV

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • Utilisez le chargeur de matrice pour créer, modifier et exporter en bloc des règles dans .CPQ Définissez les conditions de règle, les actions et la logique dans un fichier CSV pour rationaliser la gestion de la configuration et automatiser les mises à jour à grande échelle.

    Le chargeur de matrice permet aux administrateurs de télécharger et de gérer efficacement tous les types de règles dans CPQ. Au lieu de créer manuellement chaque règle dans l’interface d’administration, vous pouvez les définir dans une feuille de calcul, exporter la feuille au format CSV et la charger directement dans l’environnement. Cela permet une configuration plus rapide, des tests plus faciles et une migration simplifiée entre les environnements sandbox et de production.

    Structure de chargement des règles

    Chaque ligne du fichier CSV représente un enregistrement de règle. La table suivante présente les colonnes et les données que le chargeur de matrice accepte pour les téléchargements de règles.

    Tableau 1. Colonnes et données acceptées pour les chargements de règles
    Nom de colonne Description Valeurs valides Notes
    record_type Identifie cela comme un téléchargement de règle Règle Obligatoire
    rule_name Nom affiché sur la page d’administration de la liste des règles Les chaînes valides peuvent être composées d’un maximum de 255 caractères, y compris des lettres, des chiffres, des espaces et les caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*'& %$#" ! Obligatoire
    rule_variable_name Chaîne unique utilisée par CPQ pour référencer la règle Les noms de variables de champ valides comprennent jusqu’à 128 lettres, chiffres et traits de soulignement. Le premier et le dernier caractère doivent être une lettre ou un chiffre. Requis ; doit être unique
    rule_description Description contextuelle pour référence de l’administrateur Les chaînes valides peuvent être composées d’un maximum de 255 caractères, y compris des lettres, des chiffres, des espaces et les caractères spéciaux suivants : {}[]()|\~'_^@ ?<=> ;:/.-,+*'& %$#" ! Facultatif
    rule_status Détermine si la règle est active actif, inactif Requis ; Les règles inactives sont ignorées par le moteur
    action_type Définit le type d’action exécutée lorsque la règle s’exécute visibilité, message, exclusion, inclusion, détermination, produit Obligatoire
    action_sub_type Définition complémentaire complétant action_type masquer, informations, avertissement, erreur, masqué, désactivé, ensemble, forcé, fabrication, ventes En option ; Dépend de action_type
    action_field Champ auquel l’action s’applique <nom variable de champ> Obligatoire
    action_value Valeur appliquée au action_field Varie selon le type d’action Requis pour les actions de message, d’exclusion, d’inclusion ou de détermination
    action_product Référence de produit pour les actions de nomenclature (BOM) Code produit SFDC, ID Product2 ou ID externe Requis pour les actions de produit
    action_quantity Quantité de produit ajoutée à la nomenclature <nombre flottant positif> ou <entier positif> Requis pour les actions de produit
    action_mandatory Spécifie si un produit BOM est facultatif ou obligatoire VRAI, FAUX, <vide> En option ; La valeur par défaut est TRUE
    regroupement Définit la manière dont les conditions sont regroupées et évaluées N’importe lequel, Tous, Personnalisé, Toujours Obligatoire
    Ressource/Opérateur/Valeur Définit les tuples de condition formant la logique de règle <field variableName>, opérateur, valeur La ressource, l’opérateur et la valeur définissent ensemble l’expression de condition

    Regroupements de conditions

    Les regroupements de conditions déterminent la façon dont les conditions de règle sont combinées logiquement. Les options prises en charge sont les suivantes :
    • n’importe lequel : OU toutes les conditions définies dans la ligne.
    • all : ET toutes les conditions définies dans la ligne.
    • personnalisé : autorise les expressions logiques complexes, telles que (1 OU 2) ET 3.
    • always : applique la règle sans condition.

    Opérateurs valides

    Les opérateurs suivants sont pris en charge pour l’évaluation de condition :
    • est égal à (=, ==, est égal à)
    • différent ( !=)
    • inférieur à (<)
    • inférieur ou égal à
    • supérieur à (>)
    • supérieur ou égal à (>=)
    • contient / ne contient pas
    • dans/pas dans

    Directives générales

    • Vérifiez toujours que les noms de variables correspondent exactement aux références de champ.
    • Veillez à ce que les descriptions des règles soient concises, mais descriptives pour faciliter le dépannage.
    • Utilisez l’état inactif pour tester les nouvelles règles avant l’activation en production.
    • Validez soigneusement la logique de regroupement (aucune/toute/personnalisée) pour éviter les résultats inattendus.
    • Assurez-vous que les références du produit (ID Product2 ou ID externe) s’alignent sur votre configuration Salesforce.

    Exportation des règles au format CSV

    Les administrateurs peuvent exporter toutes les définitions de règles de l’environnement CPQ au format CSV à des fins de révision ou de migration. Le fichier ZIP résultant contient un seul fichier CSV de toutes les définitions de règles exportées.
    1. Dans le volet de navigation administrateur de gauche, cliquez sur Règles.
    2. Facultatif : saisissez une chaîne de recherche et appuyez sur Entrée pour affiner les résultats.
    3. Cliquez sur Exporter. Un message confirmant l’exportation s’affiche en bas de la page.
    4. Ouvrez le Centre de notifications (en bas à gauche) et cliquez sur le lien de téléchargement .

    Information supplémentaire

    • Les chaînes valides peuvent inclure des lettres, des chiffres, des espaces et des caractères spéciaux : { } [ ] ( ) | \ ~ ' _ ^ @ ? < = > ; : / . - , + * ' & % $ # "
    • Les noms de variables de règle peuvent contenir jusqu’à 255 caractères alphanumériques et traits de soulignement. Ils doivent commencer et se terminer par une lettre ou un chiffre.
    • Les cellules avec des arrière-plans gris dans les exemples de fichiers indiquent des champs non pertinents pour le contexte actuel.
    • Utilisez les exemples de fichiers fournis (Admin → Matrix Loader → Sample Files → Rules) comme modèle de formatage.